Installation de l'interface de ligne de commande IBM Cloud autonome

L'interface de ligne de commande IBM Cloud® fournit des commandes de gestion des ressources dans IBM Cloud. Lorsque vous installez le CLI autonome IBM Cloud, vous n'obtenez que le CLI lui-même, sans aucun des plug-ins ou outils recommandés.

Si vous souhaitez installer à la fois la dernière version de IBM Cloud CLI et d'autres plug-ins et outils recommandés pour le développement d'applications pour IBM Cloud, consultez les sections Getting started with the IBM Cloud CLI et Extending IBM Cloud CLI with plug-ins.

Avant de commencer

Si vous devez utiliser une version 32 bits ou une version antérieure autre que la dernière pour les environnements dédiés à IBM Cloud, consultez IBM Cloud CLI releases.

Installation à l'aide d'un programme d'installation

Procédez comme suit pour installer la dernière version autonome de l'interface de ligne de commande IBM Cloud :

Utilisez un navigateur pour accéder au référentiel GitHub ibm-cloud-cli-releases officiel et sélectionnez le programme d'installation de votre système d'exploitation pour lancer le téléchargement. Les systèmes d'exploitation suivants sont pris en charge : macOS X 64 bits, Windows™ 64 bits, Linux™ x86 64 bits et Linux™ LE 64 bits ( ppc64le ).
Exécutez le programme d'installation :
- Pour Mac et Windows™, exécutez le programme d'installation.
- Pour Linux™, extrayez le package et exécutez le script install.
Connectez-vous à IBM Cloud :
```
ibmcloud login
```
Vous êtes maintenant prêt à gérer les ressources IBM Cloud. Entrez ibmcloud help pour visualiser les descriptions de commande.

Si vous utilisez un ID fédéré, connectez-vous avec un code d'accès unique ou une clé d'API.

Installation à partir du shell

Pour installer manuellement la dernière interface de ligne de commande pour votre système d'exploitation à partir du shell, utilisez la commande suivante :

Si vous ne souhaitez pas effectuer l'installation à partir du shell car il peut utiliser des droits d'accès superutilisateur (root), vous pouvez télécharger et exécuter le programme d'installation.

Pour Mac, copiez et collez la commande suivante sur un terminal et exécutez-la :
```
curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
```
Pour Linux™ copier et coller la commande suivante dans un terminal et l'exécuter :
```
curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
```
Pour Windows™, copiez et collez la commande suivante dans une console de terminal Windows™ PowerShell 5 et exécutez-la :
```
iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
```
Si vous rencontrez des erreurs telles que The underlying connection was closed: An unexpected error occurred on a send, assurez-vous que vous avez installé.Net Framework 4.5 ou une version ultérieure. Tentez également d'activer le protocole TLS 1.2 en exécutant la commande suivante :
```
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
```

Installation dans un répertoire personnalisé

Lorsque vous utilisez des programmes d'installation ou un script shell pour installer l'interface de ligne de commande IBM Cloud, elle est installée dans votre répertoires système. Si vous souhaitez indiquer un autre répertoire, procédez comme suit :

Si vous installez l'interface de ligne de commande IBM Cloud dans un répertoire personnalisé, il n'est pas possible d'utiliser la commande ibmcloud update pour mettre à jour l'interface de ligne de commande.

Utilisez un navigateur pour accéder au référentiel GitHub ibm-cloud-cli-releases officiel et sélectionnez le fichier binaire correspondant pour votre plateforme afin de lancer le téléchargement. Les plateformes suivantes sont prises en charge : macOS, linux32, linux64, ppc64le, win32 et win64.

Extrayez le package dans un répertoire défini.

Vous pouvez voir le contenu extrait suivant :

Pour Linux™ et Mac :

IBM_Cloud_CLI
├── LICENSE
├── NOTICE
├── autocomplete
│   ├── bash_autocomplete
│   └── zsh_autocomplete
├── ibmcloud
└── ibmcloud-analytics

Pour Windows™ :

IBM_Cloud_CLI
├── LICENSE
├── NOTICE
├── ibmcloud-analytics.exe
└── ibmcloud.exe

Ajoutez la variable d'environnement PATH et activez l'exécution automatique de shell.
- Ajoutez {YOUR_DIRECTORY}/IBM_CLOUD_CLI à la variable d'environnement PATH.
- Pour la prise en charge de l'exécution automatique de shell (Mac et Linux™ uniquement), voir Activation de l'exécution automatique de shell pour IBM Cloud CLI.

Mise à jour de l'interface de ligne de commande IBM Cloud

Utilisez la dernière version de l'interface de programmation. Si vous n'utilisez pas la dernière version, exécutez la commande suivante pour mettre à jour votre interface de ligne de commande :

ibmcloud update

Pour déterminer la version de votre interface de ligne de commande IBM Cloud, exécutez la commande suivante :

ibmcloud -v

Si vous exécutez l'édition en cours, le résultat suivant s'affiche :

Checking for updates...
No update required. Your CLI is already up-to-date.

Pour être informé des nouvelles versions de IBM Cloud CLI, abonnez-vous au dépôt de versions de IBM Cloud CLI.