Se connecter à Encore Cloud

Créer des apps sur Encore Cloud et les déployer nécessitent une connexion. L'exécution locale (encore run, encore test, encore check) ne la nécessite pas.

Instructions

1. Vérifier qui est connecté

encore auth whoami

logged in as <email>: c'est bon.
logged in as app <app-id>: connecté avec une clé d'auth. Cela fonctionne seulement pour cette app et ne peut pas créer d'apps. Si vous avez besoin de créer une app, allez à l'étape 2.
not logged in.: allez à l'étape 2. Si aucune personne ne peut approuver une connexion, comme en CI, allez à l'étape 3.

2. Se connecter avec l'approbation d'une personne

Lancez encore auth login comme commande de fond. Elle n'existe pas tant que quelqu'un n'approuve pas la connexion.
Son résultat affiche Your pairing code is <code> et une URL. Envoyez les deux à l'utilisateur immédiatement. Demandez-lui d'ouvrir l'URL sur n'importe quel appareil, de vérifier que le code correspond, et d'approuver. Les nouveaux utilisateurs peuvent s'inscrire sur la même page.
Attendez Successfully logged in!, puis exécutez encore auth whoami pour confirmer.

Cela fonctionne en SSH, dans les conteneurs, et dans les bacs à sable cloud aussi, car l'utilisateur peut ouvrir l'URL n'importe où.

3. Se connecter sans personne : clé d'auth

Demandez à l'utilisateur de créer une clé d'auth dans le Cloud Dashboard (App Settings > Auth Keys) et de la définir comme variable d'environnement ENCORE_AUTH_KEY pour l'agent, par exemple depuis un gestionnaire de secrets.
Exécutez encore auth whoami. Cela devrait afficher logged in as app <app-id>. Chaque commande encore se connecte automatiquement avec la clé quand personne n'est connecté.

Limites des clés d'auth :

Une app: la clé peut cloner, lier et déployer sa propre app.
Pas de nouvelles apps: encore app create et encore app init nécessitent la connexion d'une personne. Pour une nouvelle app, demandez à l'utilisateur de la créer dans le Cloud Dashboard, puis clonez-la avec encore app clone <app-id>.
Ignorée quand quelqu'un est connecté: exécutez encore auth logout d'abord pour utiliser la clé à la place.
warning: ENCORE_AUTH_KEY login failed: <error>: la clé est erronée ou a été supprimée. Demandez-en une nouvelle.

Se déconnecter

encore auth logout

Cela arrête aussi le daemon Encore. Il redémarre avec la prochaine commande encore.

Directives

Ne demandez jamais à l'utilisateur de coller une clé d'auth dans le chat, et ne la passez jamais en ligne de commande avec encore auth login --auth-key : elle finit dans l'historique du shell et les listes de processus.
Connectez-vous avant encore app create si l'app doit se déployer sur Encore Cloud. Lier une app créée déconnectée prend des étapes supplémentaires (voir encore-link-app).
Suivant : créer une app (encore-create-app) ou en déployer une (encore-deploy).
Docs : https://encore.dev/docs/cli/cli-reference

encore-login