Accédez à une instance ECS Linux dépourvue d'adresse IP publique depuis votre ligne de commande locale, sans mot de passe. Effectuez des connexions interactives, exécutez des commandes à distance et transférez des fichiers. Workbench CLI est également nativement adapté aux agents d'IA : sa sortie JSON structurée permet aux agents d'analyser directement les résultats et de déterminer le succès ou l'échec en fonction des codes de sortie des commandes.
Présentation de Workbench CLI
Workbench CLI prend actuellement en charge la connexion uniquement aux instances Linux (via le protocole SSH). Il ne prend pas en charge la connexion aux instances Windows. Pour vous connecter à une instance Windows, consultez la rubrique Connexion à une instance à l'aide de Workbench.
Workbench CLI (la commande est workbench) est un outil en ligne de commande fourni par Alibaba Cloud ECS pour se connecter aux instances. Il convient aux utilisateurs suivants :
Utilisateurs humains : Lorsqu'aucune adresse IP publique n'est attribuée à une instance, utilisez la ligne de commande pour effectuer une connexion interactive, exécuter des commandes à distance et transférer des fichiers (téléchargement et envoi), en alternative à une connexion SSH directe.
Agents d'IA : Grâce à la sortie JSON structurée (
--output json) et à la transmission des codes de sortie, les outils de programmation IA (tels que Wukong et opencode) peuvent appeler directement la commandeworkbenchpour gérer les instances ECS, sans adaptation supplémentaire.
Les fonctionnalités principales de Workbench CLI sont les suivantes :
Connexion interactive : La commande
workbench connectouvre une session PTY et prend en charge trois méthodes d'authentification : sans mot de passe, par mot de passe et par clé.Exécution de commandes à distance : La commande
workbench execexécute une seule commande sur une instance et renvoie le résultat au format texte ou JSON.Transfert de fichiers : Les commandes
workbench uploadetworkbench downloadtransfèrent des fichiers entre votre ordinateur et une instance en utilisant OSS comme relais.Gestion des sessions et du daemon : Les commandes
workbench sessionetworkbench daemonservent au diagnostic et au nettoyage manuel. Aucune intervention n'est requise pour une utilisation quotidienne.Assistant IA en session : Dans une session interactive
connect, appuyez sur Tab ou Ctrl+A pour invoquer l'assistant IA et utiliser le langage naturel afin que l'IA exécute des commandes sur l'instance.
Comparaison avec les autres méthodes de connexion aux instances ECS
Alibaba Cloud ECS propose trois méthodes de connexion basées sur Workbench ou Session Manager qui ne nécessitent pas d'adresse IP publique. Le tableau suivant compare ces méthodes.
|
Fonctionnalité |
Workbench (web) |
Workbench CLI |
CLI Session Manager (ali-instance-cli) |
|
Interaction |
Interface graphique du navigateur |
Ligne de commande locale |
Ligne de commande locale |
|
Adresse IP publique requise |
Non |
Non |
Non |
|
Systèmes d'exploitation d'instance pris en charge |
Linux et Windows |
Linux uniquement (via le protocole SSH) |
Linux et Windows |
|
Commandes à distance et transfert de fichiers |
Opérations manuelles dans le terminal web |
Commandes natives : exec, upload et download |
Sessions de terminal uniquement ; nécessite des scripts supplémentaires |
|
Conçu pour les agents d'IA |
Non |
Oui (sortie JSON structurée et transmission des codes de sortie) |
Non |
|
Scénarios typiques |
Dépannage ponctuel et accès au bureau Windows |
Scripts d'exploitation et de maintenance quotidiens et assistants de programmation IA |
Scripts existants nécessitant uniquement des sessions de terminal |
Recommandations pour sélectionner une méthode :
Si vous avez besoin d'une interface graphique ou si vous devez vous connecter à une instance Windows, utilisez la méthode décrite dans la rubrique Connexion à une instance à l'aide de Workbench.
Pour gérer des instances Linux depuis la ligne de commande ou via des outils de programmation IA, utilisez Workbench CLI.
Si vous disposez déjà de scripts ali-instance-cli et n'avez besoin que de sessions de terminal, vous pouvez continuer à les utiliser. Pour plus d'informations, consultez la rubrique Connexion à une instance à l'aide d'ali-instance-cli.
Limites
Système d'exploitation de l'instance : Seules les instances Linux sont prises en charge (via le protocole SSH). Les instances Windows ne sont pas prises en charge.
Agent Cloud Assistant : L'instance cible doit avoir l'agent Cloud Assistant installé et en cours d'exécution correcte. Les instances ECS créées à partir d'images publiques officielles après le 1er décembre 2017 disposent de l'agent Cloud Assistant préinstallé par défaut. Dans le cas contraire, vous devez l'installer manuellement.
Règles de groupe de sécurité : Lors de la première connexion, la CLI ajoute automatiquement une règle de groupe de sécurité interne pour l'instance (port TCP 22, avec
100.104.0.0/16autorisé). Si votre compte ne dispose pas des autorisations de groupe de sécurité, ajoutez la règle manuellement dans la console ECS.Connectivité réseau : Votre ordinateur doit pouvoir accéder à
*.aliyuncs.comet au point de terminaison WebSocket backend de Workbench. Les commandesuploadetdownloadnécessitent que l'instance puisse accéder au point de terminaison OSS interne de la région correspondante.
Les instances Windows ne sont actuellement pas prises en charge par Workbench CLI. N'utilisez pas workbench connect pour les instances Windows.
Démarrage rapide
Effectuez votre première connexion en 5 minutes en suivant les trois étapes ci-dessous. Pour des instructions détaillées sur l'installation, les identifiants et les commandes, consultez les rubriques Installation de Workbench CLI et configuration des identifiants et Gestion des instances ECS à l'aide de Workbench CLI.
Étape 1 : Installer Workbench CLI
Sélectionnez une commande d'installation en fonction du système d'exploitation de votre ordinateur. Le script d'installation détecte automatiquement l'architecture (amd64 ou arm64) et installe l'outil dans le chemin système par défaut.
Linux ou macOS
curl -fsSL https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.sh | bash
Windows
irm https://workbench-cli.oss-cn-hangzhou.aliyuncs.com/install.ps1 | iex
Étape 2 : Configurer une paire AccessKey
Exécutez la commande suivante et saisissez l'AccessKey ID et l'AccessKey secret lorsque vous y êtes invité.
workbench config
Une fois la configuration terminée, les identifiants sont enregistrés dans ~/.workbench/config.json et les permissions du fichier sont automatiquement définies sur 0600 (lecture et écriture pour l'utilisateur actuel uniquement). Dans les environnements de production, nous vous recommandons d'utiliser les identifiants de rôle RAM plutôt qu'une paire AccessKey statique. Pour plus d'informations sur la méthode de configuration, consultez la rubrique Installation de Workbench CLI et configuration des identifiants.
Étape 3 : Se connecter à une instance
Exécutez la commande suivante pour vous connecter à l'instance cible. Remplacez i-bp1a2b3c4d5e6f par votre ID d'instance.
workbench connect -i i-bp1a2b3c4d5e6f
La région est automatiquement déduite du préfixe de l'ID d'instance, il n'est donc généralement pas nécessaire de la spécifier manuellement à l'aide de -r. Une fois dans le shell interactif, appuyez sur Tab pour afficher le panneau de commandes slash (telles que /upload, /download et /agent), et appuyez sur Ctrl+D pour quitter la session.
Présentation des commandes
|
Commande |
Description |
|
|
Interroge la liste des instances ECS par région, état ou tag. |
|
|
Ouvre une session PTY interactive pour se connecter à une instance. Prend en charge l'authentification sans mot de passe, par mot de passe et par clé. |
|
|
Exécute une seule commande sur une instance et renvoie le résultat. Prend en charge la sortie texte et JSON. |
|
|
Télécharge ou envoie des fichiers entre votre ordinateur et une instance en utilisant OSS comme relais. |
|
|
Interroge et ferme manuellement les sessions. Aucune intervention n'est requise pour une utilisation quotidienne. |
|
|
Affiche ou arrête le daemon en arrière-plan. Il démarre automatiquement lors du premier appel et s'arrête automatiquement après 60 secondes d'inactivité. |
|
|
Configure les identifiants. Prend en charge cinq modes (AK, StsToken, RamRoleArn, CredentialsCmd et CredentialsURI) et plusieurs profils. |
|
|
Met à jour vers la dernière version ou une version spécifiée. |
|
|
Affiche le numéro de version actuel, le commit et la date de build. |
Toutes les commandes précédentes prennent en charge les paramètres globaux --output json, --region et --profile. Pour connaître la liste complète des paramètres, les exemples et la structure de sortie JSON de chaque commande, consultez la rubrique Gestion des instances ECS à l'aide de Workbench CLI.
Références
Installation de Workbench CLI et configuration des identifiants : Installez la CLI sur Linux, macOS et Windows, et configurez les cinq modes d'identifiants (AK, StsToken, RamRoleArn, CredentialsCmd et CredentialsURI) ainsi que la stratégie d'autorisation RAM minimale.
Gestion des instances ECS à l'aide de Workbench CLI : Paramètres, exemples, scénarios typiques et dépannage pour les commandes list, connect, exec, upload, download, session et daemon.
Exploitation des instances ECS à l'aide de Workbench CLI dans les agents d'IA : Comment charger la compétence Workbench CLI dans des outils de programmation IA tels que Wukong et opencode, ainsi que les scénarios de conversation typiques et les recommandations de sécurité.