sng env
Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.
sng env choisit la révision de l'état désiré que suit votre tenant. Par défaut un tenant suit
main : chaque apply est déployé immédiatement. Les commandes de ce groupe permettent de
figer, de rattraper, de restaurer et de cloner. Le concept est expliqué dans
Environnements et restauration.
Toutes exigent une session de tenant. Actions IAM : env:read (list), env:write
(checkout, refresh), env:admin (restore, create-tenant).
sng env list
sng env list
Affiche la configuration d'environnement du tenant courant.
branch main
follow-main false
--json : {"tenant":"acme","branch":"main","follow_main":false,"raw":"…"}.
| Clé | Sens |
|---|---|
branch | main, ou le nom de la version sur laquelle le tenant est figé |
follow-main | true si la branche figée avance automatiquement quand main avance |
sng env checkout
sng env checkout NAME [--follow]
Fige le tenant sur la branche NAME, créée depuis l'état courant si elle
n'existe pas. checkout main revient au suivi normal.
| Flag | Défaut | Effet |
|---|---|---|
--follow | désactivé | La branche avance en fast-forward à chaque fois que main avance sans divergence |
NAME est un segment de chemin simple (lettres, chiffres, tirets). La commande répond
202 Accepted : la bascule est effective en moins d'une minute.
sng env refresh
sng env refresh
Active follow-main sur l'environnement courant et déclenche une avance immédiate. Erreur
400 already on main si le tenant n'est pas figé.
sng env restore
sng env restore REF
Remplace l'état désiré du tenant par le contenu de REF (main, env/<tenant>/<nom>, ou
une révision précise de l'historique), puis l'applique. Les manifestes absents de REF sont supprimés. Les
secrets ne sont pas concernés.
Action env:admin. Pas de confirmation interactive : faites un sng pull avant.
sng env create-tenant
sng env create-tenant NAME [REF]
Crée le tenant NAME et y copie l'état désiré du tenant courant à la révision REF (par
défaut : la révision suivie). NAME obéit aux règles de nommage
et doit être libre. Le nouveau tenant reçoit ses policies par défaut ; vous en êtes
administrateur. Les secrets ne sont pas copiés.
Répond 202 Accepted ; comme après sng tenant create, les premières sessions peuvent
répondre policies_pending pendant une ou deux minutes.
Erreurs typiques
| Message | Cause |
|---|---|
forbidden (no policy of this tenant allows it: see sng tenant policy list) | Il manque env:write ou env:admin |
already on main | refresh sur un tenant non figé |
invalid organization: … | Nom de tenant invalide ou réservé (create-tenant) |
conflict | Le nom de tenant est déjà pris |