Aide du Hub TheSocle · apps.install.installer

Installer

Monte l'application en une fois : base, secrets, DNS, certificat, conteneur, route. Le bouton se grise pendant l'opération.

Voir l'élément dans l'écran : apps/install

Explication

Le clic envoie le formulaire ; le bouton passe à « Installation en cours… » et refuse un second clic. L'opération se déroule pendant la requête : la page suivante n'arrive qu'à la fin.

Le Hub revient ensuite sur la liste des applications, avec un message vert ou rouge.

Dans ce démonstrateur, essayez : choisissez une carte, réglez le sous-domaine, cliquez sur Installer. La page d'arrivée montre l'appel exact que le vrai Hub aurait fait.

Fiche complète

Requête

POST /hub/apps/install (formulaire, jeton CSRF) → docker_worker.install_app

Paramètre Obligatoire Vient du champ Remarque
app_id oui Identifiant (app_id) libre
catalog_app_id oui — (clic sur la carte) modèle du catalogue
subdomain oui Sous-domaine adresse unique
docker_tag non Version latest par défaut
sso_mode non Authentification SSO none par défaut
sso_protected_paths non Mode d'accès au site sinon valeur du catalogue
cache_enabled, cache_preset non Cache HTTP envoyés si la case est cochée et le préréglage ≠ Désactivé
env_vars non Variables d'environnement { NOM: valeur }
additional_subdomain_0…9 non Sous-domaines additionnels
tenant non — (pas à l'écran) slug du tenant propriétaire

Les six étapes

Étape Ce qui est fait
validate identifiant et adresse libres
provision base de données, secrets dans Vault
network enregistrement DNS, certificat TLS
docker pull de l'image, création et démarrage du conteneur
routing route du proxy, SSO, cache
register ligne dans apps.applications (statut running)

Une étape en échec déclenche la compensation des précédentes.

Réponses

Cas Message Où l'on arrive
succès « Application app_id installation started successfully. » /hub/apps
échec « Failed to install app_id : Installation failed for … at stage '…' : … » /hub/apps

Pièges

Sommaire du démonstrateur