Add manual setup checks for self hosted deployments

Ouverte
#153 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
5/5
Temps estimé
Plus d'une semaine
Accessibilité débutants
35/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Active
Stack technique
docker, node.js, postgresql, typescript

Piste de recherche

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.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.
Langage dominant
TypeScript
Étoiles
125
Forks
23
Merge moyen
2 j 13 h
PR mergées (30 j)
12

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de devarshishimpi/codra

Toutes les issues de devarshishimpi/codra

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.