46 lines
2.2 KiB
Markdown
46 lines
2.2 KiB
Markdown
# Contrat `app.json`
|
||
|
||
Le dashboard et le portail applicatif utilisent exclusivement le manifeste placé dans le dossier de chaque application déployée :
|
||
|
||
```text
|
||
/opt/manus-deploy/apps/<dossier-technique>/app.json
|
||
```
|
||
|
||
> Une application sans manifeste valide n’est pas considérée comme déployée. Elle n’apparaît donc ni dans le dashboard ni dans le portail.
|
||
|
||
## Schéma minimal
|
||
|
||
```json
|
||
{
|
||
"id": "itinova-contacts",
|
||
"name": "Itinova Contacts",
|
||
"category": "ITINOVA",
|
||
"containerName": "itinova-contacts",
|
||
"giteaRepo": "itinova-contacts",
|
||
"giteaOwner": "manus-admin",
|
||
"image": "images/itinova-contacts.png",
|
||
"urls": {
|
||
"recette": "https://contacts.recette.santinova-soft.org",
|
||
"prod": "https://contacts.santinova-soft.org"
|
||
}
|
||
}
|
||
```
|
||
|
||
| Champ | Rôle | Règle |
|
||
|---|---|---|
|
||
| `id` | Identifiant stable de l’application | Minuscules, chiffres et tirets uniquement. |
|
||
| `name` | Libellé affiché | Chaîne non vide. |
|
||
| `category` | Emplacement dans le portail | `ITINOVA`, `SANTINOVA` ou `INFRA`. Les applications `INFRA` restent visibles dans le dashboard mais sont exclues du portail. |
|
||
| `containerName` | Conteneur géré par Docker | Obligatoire pour le contrôle de démarrage et de statut. À défaut, le dashboard utilise `id`. |
|
||
| `giteaRepo` | Dépôt source | Sert au webhook CI/CD et à l’inventaire. |
|
||
| `giteaOwner` | Organisation/propriétaire Gitea | Facultatif si la valeur par défaut suffit. |
|
||
| `image` | Image locale du portail | Chemin relatif à `portail-santinova/images/`. |
|
||
| `urls.recette` | URL de recette | Obligatoire et HTTPS pour un dashboard recette. |
|
||
| `urls.prod` | URL de production | Obligatoire et HTTPS pour un dashboard de production. |
|
||
|
||
## Règles de déploiement
|
||
|
||
Chaque premier déploiement doit créer ou mettre à jour le manifeste dans le même commit que le `docker-compose.yml` et les éléments nécessaires à l’application. Lorsqu’une application est promue, son manifeste de production doit contenir l’URL de production avant le démarrage du dashboard.
|
||
|
||
Le dashboard ne maintient plus de liste statique d’applications, et le portail ne maintient plus de tuiles codées en dur. Cette règle élimine les écarts de version, d’URL, de catégorie et de statut entre les deux interfaces.
|