Galon Cloud
Galon Cloud

Démarrer avec Deploy

English · Référence de l'API · Accueil de la documentation

Vue d'ensemble

Ouverture progressive : les routes de cette page répondent quand le service est ouvert à votre compte. D'ici là, elles rendent 404 not_found. Demandez l'ouverture au support.

Galon Deploy compile un commit de votre dépôt dans un bac à sable isolé, le sert en aperçu à sa propre adresse, puis promeut un aperçu vérifié en production sur votre domaine. Chaque étape existe dans la console, dans la CLI galon et par l'API.

1. Connecter un dépôt GitHub

Console › Deploy › Connecter GitHub. Installez l'application GitHub de Galon sur les dépôts de votre choix : Galon ne lit que ceux-là. L'identifiant de connexion (ins_…) la désigne dans la CLI et l'API. Galon détecte le cadre, le gestionnaire de paquets (npm, pnpm ou yarn) et la commande de compilation ; vous pouvez les remplacer dans les réglages de compilation.

2. Votre premier aperçu

Une clé de test portant deploy:create et job:read lance un aperçu. Avec --follow, la CLI enchaîne les étapes jusqu'à l'aperçu prêt ou en échec.

export GALON_API_BASE="https://api.galon.ai/v1"
export GALON_API_KEY="gln_test_..."

galon deploy start --repository acme/site --commit <40-char sha> \
  --installation ins_... --domain site.example --follow
galon deploy logs djy_... --follow
galon deploy list

API : POST /v1/deploy/journeys avec une Idempotency-Key, puis POST /v1/deploy/journeys/{journey_id}/resume jusqu'à status = ready (202 tant qu'une étape tourne, avec Retry-After). Quotas des aperçus gratuits et bornes de compilation : Limites.

3. Passer en production

La production demande une clé live et un forfait de production (GET /v1/deploy/production/plans, POST /v1/deploy/production/plan, prix en USD). Une clé de test ne fait que des aperçus : une écriture de production avec elle rend 403 deploy_production_live_key_required. La promotion sert l'aperçu vérifié du projet de test jumeau.

galon promote djy_... --yes
galon deploy status

4. Domaine personnalisé et TLS

POST /v1/deploy/production/domains avec {"domain": "www.example.com"} rend les enregistrements à publier chez votre hébergeur DNS : un TXT _galon-challenge.<domaine> prouve la propriété, puis un CNAME (sous-domaine) ou des A (apex) routent le trafic. Appelez POST /v1/deploy/production/domains/{domain}/verify une fois publiés. Le certificat TLS est émis automatiquement, à la demande, pour un domaine vérifié ; rien à téléverser.

5. Revenir en arrière

La production garde la release précédente. Un retour arrière rebascule aussitôt, sans nouvelle compilation. Le choix d'une release plus ancienne par son identifiant est disponible sur demande.

galon rollback --yes

Variables d'environnement

Les variables se règlent dans la console (Projet › Variables). galon env pull écrit les noms de toutes les variables et les valeurs des seules variables publiques dans .env.local (mode 0600). La valeur d'un secret n'est jamais rendue par l'API.

galon env pull --file .env.local
galon logs rti_... --lines 200

Webhooks de déploiement

Abonnez un point de réception (console › Webhooks) à deploy.created, deploy.succeeded, deploy.failed, deploy.promoted, deploy.rolled_back. Ils sont signés comme tout webhook Galon (Galon-Signature).