Cycle de vie d'un tenant
Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.
Un tenant se crée en une commande et se détruit en une autre. Entre les deux, il vit sa vie : des policies, des manifestes, un tier. Cette page décrit chaque étape et ce que vous obtenez.
Créer
sng tenant create acme
La CLI confirme la création et vous indique la suite :
next: sng tenant use acme
Conditions :
- vous êtes connecté (
sng sso login) avec un compte StackNGO ; - le nom respecte la règle de nommage et n'est ni réservé ni déjà pris
(
409 conflict) ; - vous n'avez pas atteint la limite de 5 tenants par compte (voir ci-dessous).
Ce que vous obtenez : un tenant isolé, en tier 3XS, avec ses policies par défaut, dont vous
êtes administrateur (assume-role et admin), et son sous-domaine acme.dev.stackngo.app.
Comptez une à deux minutes avant qu'il soit utilisable.
Limite de 5 tenants par compte
Chaque compte peut avoir au plus 5 tenants à son nom, tous clusters confondus : le
compte qui crée un tenant en est le payeur. Au-delà, la création est refusée avec un 403
tenant_quota_exceeded, accompagné du nombre de tenants déjà utilisés. La console grise alors
le bouton « Créer un tenant » et affiche votre usage sous la forme « n / 5 ».
Détruire un tenant libère immédiatement une place.
Les premières minutes
Tant que le tenant n'est pas prêt, toute tentative d'ouvrir une session répond
409 policies_pending avec Retry-After: 10. sng tenant use gère l'attente :
sng tenant use acme
waiting for the tenant default policies…
current tenant: acme
Si l'attente dépasse six minutes, la CLI abandonne : réessayez, et si cela persiste, contactez le support avec le nom du tenant.
Utilisateurs de vos applications (optionnel)
L'annuaire des comptes de vos utilisateurs finaux et la connexion à vos applications sont disponibles dès la création du tenant, sans étape d'activation (Utilisateurs de vos applications). Ce n'est pas nécessaire pour déployer : si vous n'avez pas d'utilisateurs finaux à gérer, ignorez cette section.
Donner accès à d'autres personnes
Les accès sont des policies attachées à des identités. Pour qu'un collègue puisse
travailler sur le tenant, il lui faut au minimum assume-role (ouvrir une session) et une
policy qui décrit ses droits :
sng tenant policy attach assume-role --user bob
sng tenant policy attach readwrite --user bob
readonly, readwrite et admin couvrent les cas courants ; des policies sur mesure sont
possibles (Policies). Pour une CI, préférez un
trust OIDC ; pour une machine, une
application machine.
Travailler sur plusieurs tenants
sng tenant list
sng tenant use labs # change le tenant courant
sng tenant assume labs # session temporaire, sans changer le tenant courant
sng tenant list montre les tenants où vous détenez une policy, directement ou par un rôle.
assume exige iam:AssumeRole sur le tenant visé, déclaré dans ce tenant.
Changer de payeur ou se retirer de la facturation
Le payeur d'un tenant est le compte qui le paie : son créateur au départ. Un administrateur du
tenant peut inviter un autre compte à reprendre la facturation, depuis la console ou avec
sng tenant billing set acme jane@example.com ; le payeur ne change qu'une fois l'invitation
acceptée, et le tenant passe alors dans la limite de tenants du nouveau payeur.
Le payeur peut aussi se retirer à tout moment, depuis la console, en saisissant le nom du tenant pour confirmer :
- si le créateur du tenant en est encore membre et qu'il lui reste de la place dans sa limite de tenants, il reprend la facturation ;
- sinon, le tenant entre en préavis de 7 jours : il reste utilisable, ses administrateurs sont prévenus par e-mail (puis la veille de l'échéance), et il est supprimé avec ses données à la fin du préavis. Pour le garder, un administrateur invite un compte à reprendre la facturation : dès que ce compte accepte, le préavis est levé.
Changer de tier
Voir Tiers et quotas. Monter est immédiat ; descendre exige que la consommation tienne.
Détruire
sng tenant destroy acme
⚠ Suppression définitive du tenant "acme".
Tapez « oui » pour confirmer : oui
Conditions : une session sur ce tenant avec iam:admin (policy admin). Vous ne pouvez
pas détruire un tenant depuis la session d'un autre tenant, ni l'organisation StackNGO.
Ce qui disparaît : tout ce que le tenant contient (applications, volumes, certificats), l'état désiré, les policies, l'organisation d'identité et ses utilisateurs, les dépôts d'images du tenant. Les secrets sont supprimés et ne sont pas restaurables (Versions et restauration) ; un domaine apporté redevient disponible pour un autre tenant une fois la zone supprimée.
Il n'y a pas de corbeille de tenant. Exportez d'abord ce que vous voulez garder :
sng pull pour les manifestes, sng secret get pour les valeurs que vous ne pourriez pas
régénérer.
Environnements et restauration
La plateforme garde l'historique de ce que vous appliquez : vous pouvez revenir à une version
figée (sng env restore <ref>) ou créer un tenant à partir de l'état d'un autre
(sng env create-tenant <nom> [ref]). Voir
Environnements et restauration.
Si ça ne marche pas
| Message | Cause | Correction |
|---|---|---|
invalid organization: … | Nom invalide ou réservé | Voir Noms de tenant |
409 conflict | Le nom est déjà pris | En choisir un autre |
403 tenant_quota_exceeded à la création | Vous avez déjà 5 tenants | Détruire un tenant inutilisé, puis recommencer |
policies_pending après six minutes d'attente | Le tenant n'est toujours pas prêt | Réessayer ; si cela persiste, contacter le support avec le nom du tenant |
forbidden (…) sur sng tenant destroy | La session n'est pas sur ce tenant, ou n'a pas iam:admin | sng tenant use <tenant> avec un compte administrateur |