Add manual setup checks for self hosted deployments

Aberta
#153 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
35/100
Tipo de issue
Funcionalidade
Clareza
Razoavelmente clara
Status de atividade
Ativa
Stack de tecnologia
docker, node.js, postgresql, typescript
Domínio
backend, databases, devops

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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.
Linguagem predominante
TypeScript
Estrelas
125
Forks
23
Merge médio
2d 13h
PRs com merge (30d)
12

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de devarshishimpi/codra

Todas as issues de devarshishimpi/codra

Issues semelhantes

Mais issues de TypeScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.