Aide du Hub TheSocle · apps.install.ecran

Installer une application

Choisir une application du catalogue, la régler, et l'installer sur le Hub : base, secrets, DNS, certificat, conteneur et route en un clic.

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

Explication

Cet écran installe une application sur le Hub lui-même, à partir du catalogue. Il se lit de haut en bas, en trois blocs :

  1. Choisir dans le catalogue : une grille de cartes, 15 par page, avec recherche et filtres ;
  2. Configuration : le formulaire de l'application choisie. Il n'apparaît qu'après un clic sur une carte ;
  3. Ajouter une application personnalisée au catalogue : un bloc replié, pour inscrire une image Docker qui n'est pas encore au catalogue.

Le catalogue mêle deux origines : le catalogue local livré avec le Hub, et les catalogues distants des sources synchronisées (menu Sources). Chaque carte porte le nom de sa source.

Un clic sur Installer déroule tout le montage en une fois : vérification que l'identifiant et le sous-domaine sont libres, base de données et secrets, DNS et certificat, conteneur Docker, route du proxy avec son SSO, puis inscription dans la liste des applications. Si une étape échoue, le Hub défait les précédentes.

Fiche complète

Ce que l'écran appelle

GET /hub/apps/install → app_registry_worker.list_catalog (catalogue local), plus une lecture directe des catalogues distants en base (apps.repository_catalog_caches, sources actives seulement).

Paramètre d'URL Rôle
q recherche dans l'identifiant, le nom et la description (insensible à la casse)
source ne garder qu'une source (local pour le catalogue livré)
tag ne garder que les applications d'une source portant ce tag
page page de 15 cartes, à partir de 1

Filtres et pagination sont appliqués par le Hub, pas par le navigateur.

Ce que l'installation enchaîne

POST /hub/apps/install → docker_worker.install_app, qui délègue à un pipeline en six étapes : validate → provision (base + Vault) → network (DNS + TLS) → docker (pull, création, démarrage) → routing (route du proxy + SSO) → register (ligne dans apps.applications). En cas d'échec, les étapes déjà faites sont compensées.

Par l'API ou par un agent

{ "name": "docker_worker__install_app",
  "arguments": { "app_id": "things", "catalog_app_id": "things",
                 "subdomain": "things", "docker_tag": "latest" } }
Sommaire du démonstrateur