Eigenständige IBM Cloud-Befehlszeilenschnittstelle installieren

Mit der IBM Cloud®-Befehlszeilenschnittstelle (CLI) stehen Befehle für die Verwaltung von Ressourcen in IBM Cloud zur Verfügung. Wenn Sie die eigenständige IBM Cloud CLI installieren, erhalten Sie nur die CLI selbst ohne empfohlene Plug-ins oder Tools.

Wenn Sie sowohl die neueste IBM Cloud CLI als auch andere empfohlene Plug-ins und Tools für die Entwicklung von Anwendungen für IBM Cloud installieren möchten, lesen Sie bitte Erste Schritte mit der IBM Cloud CLI und Erweitern von IBM Cloud CLI mit Plug-ins.

Vorbereitende Schritte

Wenn Sie eine 32-Bit-Version oder eine frühere Version als die neueste für IBM Cloud Dedicated-Umgebungen verwenden müssen, lesen Sie IBM Cloud CLI releases.

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-bit ( ppc64le ).

  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
    
  • Für Linux™ kopieren Sie den folgenden Befehl, fügen ihn in ein Terminal ein 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-Terminal-Konsole 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.

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.

Um über neue IBM Cloud CLI-Releases informiert zu werden, abonnieren Sie das IBM Cloud CLI-Releases-Repository.