Vorbereitende Schritte

Wenn Sie eine 32-Bit-Version oder eine frühere Version, die nicht die neueste ist, für IBM Cloud verwenden müssen Dedizierte Umgebungen, siehe IBM Cloud CLI-Versionen.

Installation mit einem Installationsprogramm

Führen Sie zum Einrichten der aktuellsten, eigenständigen IBM Cloud-Befehlszeilenschnittstelle die folgenden Schritte aus:

1. Verwenden Sie einen Browser, um auf das offizielle GitHub-Repository ibm-cloud-cli-releases zuzugreifen, und wählen Sie das Installationsprogramm Ihres Betriebssystems aus, um den Download zu starten. Die folgenden Betriebssysteme werden unterstützt: macOS X 64-bit, Windows™ 64-bit, Linux™ x86 64-bit und Linux™ LE 64-bitppc64le).

2. Führen Sie das Installationsprogramm aus.

   • Führen Sie für Mac und Windows™ das Installationsprogramm aus.
   • Extrahieren Sie für Linux™ das Paket und führen Sie das Script install aus.

3. Melden Sie sich bei IBM Cloud an:

   ibmcloud login
   

   Jetzt können Sie IBM Cloud-Ressourcen verwalten. Geben Sie ibmcloud help ein, damit Beschreibungen der einzelnen Befehle angezeigt werden.

   Wenn Sie eine föderierte ID verwenden, melden Sie sich mit einem einmaligen Kenncode oder einem API-Schlüssel an.

Installation über die Shell

Wenn Sie die neueste Befehlszeilenschnittstelle für Ihr Betriebssystem manuell über die Shell installieren möchten, verwenden Sie den folgenden Befehl für Ihr Betriebssystem:

Wenn Sie nicht von der Shell aus installieren möchten, weil sie Root-Berechtigungen verwenden könnte, können Sie das Installationsprogramm herunterladen und ausführen.

• Für Mac kopieren Sie den folgenden Befehl, fügen ihn in einem Terminal ein und führen ihn aus.

  curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
  

• Unter Linux™ kopieren Sie den folgenden Befehl in ein Terminal und führen ihn aus:

  curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
  

• Unter Windows™ kopieren Sie den folgenden Befehl, fügen ihn in eine Windows™ PowerShell 5-Terminkonsole ein und führen ihn aus:

  iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
  

  Wenn Sie auf Fehler wie " The underlying connection was closed: An unexpected error occurred on a send stoßen, stellen Sie sicher, dass Sie .Net Framework 4.5 oder höher installiert haben. Versuchen Sie außerdem, das TLS 1.2-Protokoll durch Ausführen des folgenden Befehls zu aktivieren:

  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  

Installation in einem benutzerdefinierten Verzeichnis

Wenn Sie Installationsprogramme oder ein Shell-Script für die Installation der IBM Cloud-Befehlszeilenschnittstelle verwenden, wird sie in Ihren Systemverzeichnissen gespeichert. Wenn Sie ein anderes Verzeichnis angeben möchten, führen Sie die folgenden Schritte aus.

Wenn Sie die IBM Cloud-Befehlszeilenschnittstelle in einem angepassten Verzeichnis installieren, kann der Befehl ibmcloud update nicht zum Aktualisieren der Befehlszeilenschnittstelle verwendet werden.

1. Verwenden Sie einen Browser, um auf das offizielle GitHub-Repository ibm-cloud-cli-releases zuzugreifen, und wählen Sie die passende Binärdatei aus, um den Download zu starten. Die folgenden Plattformen werden unterstützt: macOS, linux32, linux64, ppc64le, win32 und win64.

2. Paket in ein Verzeichnis extrahieren, das Sie angeben.

   Sie können den folgenden extrahierten Inhalt sehen:

   Für Linux™ und Mac:

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

   Für Windows™:

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

3. Angabe zur Umgebungsvariablen PATH hinzufügen und automatische Vervollständigung für die Shell aktivieren.

   • Fügen Sie die Angabe {YOUR_DIRECTORY}/IBM_CLOUD_CLI zur Umgebungsvariablen PATH hinzu.
   • Informationen zur Unterstützung der automatischen Vervollständigung für die Shell (nur Mac und Linux™) finden Sie unter Automatische Vervollständigung der Shell für die IBM Cloud-Befehlszeilenschnittstelle aktivieren.

Aktualisierung der IBM Cloud-CLI

Verwenden Sie die neueste Version der CLI. Wenn Sie die neueste Version nicht verwenden, führen Sie den folgenden Befehl aus, um die Befehlszeilenschnittstelle zu aktualisieren:

ibmcloud update

Führen Sie folgenden Befehl, um Ihre IBM Cloud-CLI-Version zu ermitteln:

ibmcloud -v

Wenn Sie das aktuelle Release ausführen, wird die folgende Ausgabe angezeigt:

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

Wenn Sie über neue IBM Cloud CLI-Releases zu erhalten, abonnieren Sie das IBM Cloud CLI-Releases-Repository.