Configuration de l'interface de ligne de commande (CLI)

Installez, mettez à jour et supprimez les interfaces de ligne de commande et configurez votre environnement pour utiliser IBM Cloud® Code Engine.

Environnements pris en charge pour le CLI Code Engine

L'interface de ligne de commande Code Engine prend en charge les environnements suivants :

  • Linux 64 bits
  • Linux 64 bits ARM
  • Linux 32 bits
  • Mac OS X 64 bits
  • Mac OS X M1/ARM
  • Windows 64 bits
  • Windows 32 bits

Installation de l'interface de ligne de commande IBM Cloud

Installez la dernière version de l'interface de ligne de commande IBM Cloud.

Avant de commencer

Vous devez créer un compteIBM Cloud.

  1. Téléchargez et installez l'interface de ligne de commande IBM Cloud.

    Cette installation inclut les fichiers suivants :

    • Plug-in IBM Cloud Functions
    • Plug-in IBM Cloud Object Storage
    • Plug-in IBM Cloud Container Registry
    • Plug-in IBM Cloud Kubernetes Service

    Pour plus d'informations, voir Interface CLI IBM Cloud.

  2. Connectez-vous à l'interface de ligne de commande IBM Cloud.

    ibmcloud login

  3. Si vous possédez plusieurs comptes, vous êtes invité à sélectionner celui que vous souhaitez utiliser. Suivez les invites ou utilisez la commande target pour sélectionner votre compte IBM Cloud.

    ibmcloud target -c <account_id>

  4. Vous devez également indiquer une région. Vous pouvez utiliser la commande target pour cibler ou modifier des régions.

    ibmcloud target -r <region>

  5. Vous devez indiquer un groupe de ressources. Pour obtenir la liste de vos groupes de ressources, exécutez la commande suivante :

    ibmcloud resource groups

    Exemple de sortie

    Retrieving all resource groups under account <account_name> as email@ibm.com...
OK
Name      ID                                 Default Group   State   
default   a8a12accd63b437bbd6d58fb8b462ca7   true            ACTIVE
test      a8a12abbbd63b437cca6d58fb8b462ca7  false           ACTIVE

  6. Ciblez un groupe de ressources en exécutant la commande suivante :

    ibmcloud target -g <resource_group>

    Exemple de sortie

    Targeted resource group default

Installation du plug-in d'interface de ligne de commande Code Engine

Installez la dernière version de l'interface de ligne de commande Code Engine.

Vérifiez que vous avez installé la dernière version de l'interface de ligne de commande IBM Cloud. Sinon, l'installation de votre interface de ligne de commande Code Engine peut échouer avec un message tel que le suivant : Could not find compatible binary to install for plug-in code-engine.

  1. Installez le plug-in Code Engine.

    ibmcloud plugin install code-engine

  2. Utilisez la commande ibmcloud plugin show code-engine pour vérifier que le plug-in est installé.

    ibmcloud plugin show code-engine

    Exemple de sortie

    Plugin Name                              code-engine[ce]
Plugin Version                           1.31.0
Plugin SDK Version                       0.9.0
Minimal IBM Cloud CLI version required   1.0.0
Private endpoints supported              true

Commands:
code-engine,ce                    Manage Code Engine components.
[...]

  3. Pour exécuter des commandes Code Engine, utilisez ibmcloud code-engine ou ibmcloud ce. Pour voir tout ce que vous pouvez faire avec le plug-in Code Engine, exécutez la commande ibmcloud ce sans indiquer d'arguments.

    ibmcloud ce

Vous pouvez éventuellement installer le package jq. De nombreuses commandes Code Engine incluent une option (--output JSON) pour créer une sortie JSON. Avec ce package, vous pouvez visualiser des réponses JSON et en faire l'analyse syntaxique à partir de la ligne de commande.

Pour plus d'informations sur les commandes Code Engine, voir les informations relatives aux commandes ibmcloud ce.

Mise à jour de l'interface de ligne de commande Code Engine

Mettez régulièrement à jour l'interface de ligne de commande pour bénéficier de nouvelles fonctions.

  1. Affichez votre liste de plug-in en cours en exécutant la commande ibmcloud plugin list.

    ibmcloud plugin list

    Exemple de sortie

    Listing installed plug-ins...

Plugin Name                                  Version   Status             Private endpoints supported
code-engine[ce]                              1.31.0                       true
container-registry                           0.1.571                      true
container-service[kubernetes-service]        1.0.408                      false

  2. Si une mise à jour est disponible, exécutez la commande ibmcloud plugin update.

    ibmcloud plugin update code-engine

Désinstallation de l'interface CLI

Si vous n'avez plus besoin de l'interface de ligne de commande, vous pouvez la désinstaller.

  1. Répertoriez les plug-in qui sont installés.

    ibmcloud plugin list

  2. Désinstallez les plug-in. Par exemple, pour désinstaller le plug-in d'interface de ligne de commande Code Engine :

    ibmcloud plugin uninstall code-engine

  3. Vérifiez que les plug-in ont bien été désinstallés en exécutant la commande suivante et en examinant la liste des plug-in installés.

    ibmcloud plugin list

Les plug-in que vous avez supprimés ne sont pas affichés dans les résultats.

Accès à IBM Cloud Shell dans votre navigateur Web

Avec l'interface de ligne de commande IBM® Cloud Shell, vous pouvez utiliser l'interface de ligne de commande IBM Cloud et d'autres plug-in d'interface de ligne de commande directement à partir de votre navigateur Web.

IBM Cloud Shell est activé avec plusieurs plug-in et outils, y compris l'interface de ligne de commande IBM Cloud de base (ibmcloud) et l'interface de ligne de commande Code Engine .

Lorsque vous utilisez Cloud Shell, gardez à l'esprit les limitations suivantes.

  • Vous pouvez ouvrir jusqu'à cinq sessions simultanées, fonctionnant de manière indépendante et rendant possible l'utilisation en parallèle de ressources, de régions et de comptes différents.
  • Tous les fichiers que vous téléchargez et éditez localement, tels que les fichiers YAML, sont stockés temporairement dans Cloud Shell et ne sont pas conservés d'une session à l'autre.
  • Cloud Shell est associé à un quota d'utilisation qui vous limite à 50 heures d'utilisation par semaine.

Pour lancer et utiliser la barre de menus IBM Cloud Shell, dans la console IBM Cloud , cliquez sur l'icône Cloud Shell IBM Cloud Shell. Une session démarre et vous connecte automatiquement à l'interface de ligne de commande IBM Cloud avec vos données d'identification de compte en cours.