Add manual setup checks for self hosted deployments

Đang mở
#153 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
docker, node.js, postgresql, typescript
Lĩnh vực
backend, databases, devops

Hướng nghiên cứu

Start with the linked work in #157 and #158 to trace dependency checks and the dashboard flow, then identify the backend entry points for Cloudflare Workers and Node/Docker. Read the setup and operations documentation and inspect existing tests for both runtimes. Done means operators can run checks manually, understand passed, failed, or unavailable results, and PostgreSQL checks never keep a serverless database awake.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

enhancement good first issue help wanted

Goal

Give self hosted Codra operators a simple way to find setup and service problems without requiring any service, especially a serverless PostgreSQL database, to stay awake all the time.

What the check should cover

Check GitHub App setup, webhook delivery information, model provider credentials, the configured queue or worker, and PostgreSQL when the current runtime can check them. A result should say whether a check passed, failed, or could not be checked, and give a useful next step.

Serverless PostgreSQL requirement

Run a PostgreSQL check only when an operator asks for it or when Codra already needs a database connection for normal work. Let an ordinary connection attempt wake a suspended database. Do not poll it on a timer, keep a connection open to prevent suspension, or call it unhealthy only because it was idle. Explain cold start delays or timeouts when they can be identified.

Work breakdown

Done when

  • Operators can run checks manually and understand each result.
  • Checks are available in both Cloudflare Workers and Node/Docker where the runtime can support them.
  • A service the runtime cannot check is shown as unavailable, not failed.
  • PostgreSQL is never kept awake by health checks.
  • Setup and operations documentation explains the checks and their on demand behavior.

Before closing

  • npm run typecheck, npm test, and npm run lint all pass.
  • Backend checks work in both Cloudflare Workers and Node/Docker.
  • Tests cover the changed behavior in each affected runtime.
Ngôn ngữ chính
TypeScript
Star
125
Fork
23
Merge trung bình
2 ngày 13 giờ
Pull request đã merge (30 ngày)
12

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của devarshishimpi/codra

Tất cả issue của devarshishimpi/codra

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.