Se connecter
Fonctionnalité déployée et prise en charge. Les champs et commandes décrits ici sont stables au sein de la version v1alpha1.
En trois commandes, vous êtes authentifié et positionné sur un tenant prêt à recevoir vos manifestes.
1. Se connecter
sng sso login
La CLI ouvre votre navigateur sur la page de connexion StackNGO (auth.dev.stackngo.app),
puis récupère le jeton par un retour local sur 127.0.0.1. Rien à copier-coller.
Ouvrez votre navigateur : https://auth.dev.stackngo.app/login/oauth/authorize?...
connecté : jane (jane@example.com)
Vérifiez qui vous êtes :
sng sso whoami
organization: stackngo
username: jane
email: jane@example.com
roles: -
Votre compte StackNGO est créé lors de votre inscription auprès de l'équipe StackNGO. L'auto-inscription n'est pas ouverte pour l'instant.
2. Créer un tenant, ou en rejoindre un
Un tenant se crée en une commande. Son nom devient votre sous-domaine : choisissez-le court, en minuscules, sans caractère spécial.
sng tenant create acme
La CLI confirme la création et vous indique la suite :
next: sng tenant use acme
Vos droits d'administrateur sur le nouveau tenant sont actifs en une à deux minutes.
Certains noms sont réservés et certains sont déjà pris : la commande vous le dit immédiatement (voir Noms réservés).
Si quelqu'un vous a donné accès à un tenant existant, il apparaît dans la liste :
sng tenant list
TENANT POLICIES CURRENT
acme assume-role,admin
labs assume-role,readonly
3. Choisir le tenant courant
sng tenant use acme
current tenant: acme
Un tenant tout juste créé peut mettre une ou deux minutes à devenir utilisable : la CLI
attend et réessaie d'elle-même (jusqu'à six minutes) en affichant policies pending.
4. Cluster et tenant
La CLI parle à un cluster et à un tenant. Le tenant est celui que vous venez de choisir ; le cluster par défaut convient pour commencer. Vérifiez :
sng config create # crée ~/.config/stackngo/config.yaml
sng config show
cluster: (default)
tenant: acme-dev
api_url: https://api.dev.stackngo.fr
Pour viser un autre cluster : sng config use-cluster NOM. Un environnement, c'est un tenant :
créez acme-dev et acme-prod et passez de l'un à l'autre avec sng tenant use (voir
Environnements et restauration).
Et si je gère plusieurs tenants ?
sng tenant use change le tenant courant. Pour agir ponctuellement sur un autre tenant sans
changer de session, sng tenant assume <tenant> ouvre une session temporaire (il faut y
détenir la policy assume-role). Voir sng tenant.
Se déconnecter
sng sso logout
signed out
Les jetons locaux sont effacés et toutes les sessions de tenant ouvertes avec votre compte
prennent fin, sur ce poste comme ailleurs (autre terminal, copie dans un script), en quelques
secondes. Une session terminée est refusée (401) : il faut se reconnecter (sng sso login,
puis sng tenant use).
Étape suivante : Première application.