Documentation de l’interface de Command-Line (CLI)

L’interface de ligne de commande App Center est un outil unifié permettant d’exécuter des services App Center à partir de la ligne de commande. CLI est un outil puissant pour utiliser les services App Center et pour script les séquences de commandes à exécuter. Vous pouvez actuellement vous connecter et afficher ou configurer toutes les applications auxquelles vous avez accès dans App Center.

Pour obtenir plus d’informations sur l’installation de l’interface CLI et les commandes actuellement prises en charge, reportez-vous au dépôt GitHub de l’interface CLI App Center.

Pour commencer

Conditions préalables

La version recommandée Node.js est la 12 ou ultérieure.

Installation

Ouvrez un terminal/invite de commandes, puis exécutez npm install -g appcenter-cli.

Connexion

1. Ouvrez une fenêtre terminal/commande.
2. Exécutez appcenter login. Cela ouvre un navigateur et génère un nouveau API token.
3. Copiez l’élément API token à partir du navigateur et collez-le dans la fenêtre de commande.
4. La fenêtre de commande affichera Logged in as {user-name}.
5. Félicitations! Vous êtes connecté avec succès et pouvez exécuter des commandes CLI.

Il existe deux façons d’utiliser les commandes CLI App Center sans exécuter appcenter login préalablement :

Utilisation du --token paramètre

1. Créez un jeton d’APIFull Access (voir les étapes 1 à 5).
2. Ouvrez une fenêtre terminal/commande.
3. Ajoutez le --token commutateur à la commande CLI que vous exécutez. Par exemple, exécutez appcenter apps list --token {API-token} pour obtenir la liste de vos applications configurées.

À l’aide de la variable d’environnementAPPCENTER_ACCESS_TOKEN, vous pouvez définir la APPCENTER_ACCESS_TOKEN variable d’environnement avec votre jeton d’API. Cela fonctionne sans avoir à ajouter le --token commutateur à chaque commande CLI.

Exécution de votre première commande CLI

1. Ouvrez une fenêtre terminal/commande.
2. Exécutez appcenter pour afficher la liste des commandes CLI.
3. Exécutez appcenter profile list pour obtenir les informations sur l’utilisateur connecté.

Pour plus d’informations sur la liste des commandes CLI, reportez-vous au dépôt GitHub de l’interface CLI App Center.

Remarque sur l’utilisation du --app paramètre :

En raison de restrictions dans la façon dont l’analyse des noms d’application est effectuée, les noms d’application ne doivent pas commencer par des traits d’union ou d’autres caractères ambigus susceptibles de confondre les analyseurs de style GNU. Vous pouvez en savoir plus sur ce problème dans le problème CLI associé.

Utilisation d’un proxy

Vous pouvez utiliser l’interface CLI via un proxy. Pour cela, vous devez configurer npm config et spécifier la variable d’environnement avec l’adresse proxy. Notez que les adresses proxy doivent être spécifiées avec des protocoles (par exemple http://).

NPM Configuration

Pour configurer l’utilisation du proxy dans npm, vous devez exécuter des commandes :

npm config set proxy http://username:password@host:port
npm config set https-proxy http://username:password@host:port

Variable d'environnement

Pour configurer la commande d’exécution de variable d’environnement :

Bash :

export HTTP_PROXY="http://host:port"

PowerShell :

$Env:HTTP_PROXY="http://host:port"