Private Endpunkte installieren und verwenden
Um sicherzustellen, dass bei der Verwendung der IBM Cloud-Befehlszeilenschnittstelle (CLI) eine erweiterte Steuerung und Sicherheit für Ihre Daten vorhanden ist, haben Sie die Möglichkeit, private Routen zu IBM Cloud-Endpunkten zu verwenden. Private Routen sind über das Internet nicht zugänglich oder erreichbar. Durch die Verwendung des IBM Cloud-Features für private Endpunkte können Sie Ihre Daten vor den Sicherheitsrisiken des öffentlichen Netzes schützen und Ihr privates Netz logisch erweitern.
Die Befehlszeilenschnittstelle (CLI) verwendet die Unterstützung für private Endpunkte, die von der IBM Cloud®-Plattform bereitgestellt wird. Plattformservices, die von der Kern-CLI verwendet werden, stellen Unterstützung für den privaten Endpunkt bereit.
Vorbereitende Schritte
Aktivieren Sie zunächst virtuelles Routing und Weiterleitung in Ihrem Konto, und aktivieren Sie dann die Verwendung von IBM Cloud privaten Service-Endpunkten. Weitere Informationen zum Einrichten Ihres Kontos zwecks Unterstützung der Option
der privaten Konnektivität enthält der Abschnitt VRF und Serviceendpunkte aktivieren. Neben der Aktivierung von VRF müssen Sie sich in einem privaten Netzwerk unter ibmcloud
befinden. Weitere Informationen finden Sie im Abschnitt zum Herstellen einer Verbindung zum IBM Cloud-VPN.
Weitere Informationen zu privaten Verbindungen unter IBM Cloudfinden Sie unter Zugriff auf Services sichern mithilfe von Serviceendpunkten.
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.
-
Kopieren Sie für Macden folgenden Befehl und fügen Sie ihn in eine Befehlszeile ein und führen Sie ihn aus:
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/osx_private | sh
-
Kopieren Sie für Mac aus einer IBM Cloud Virtual Private Cloud den folgenden Befehl und fügen Sie ihn in eine Befehlszeile ein und führen Sie ihn aus:
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/osx_vpc | sh
-
Kopieren Sie für Linux™ den folgenden Befehl in eine Befehlszeile und führen Sie ihn aus:
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/linux_private | sh
-
Kopieren Sie für Linux aus IBM Cloud Virtual Private Cloud den folgenden Befehl und fügen Sie ihn in eine Befehlszeile ein und führen Sie ihn aus:
curl -fsSL https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/linux_vpc | sh
-
Kopieren Sie unter Windows™den folgenden Befehl und fügen Sie ihn in eine Windows-™ PowerShell-Eingabeaufforderung ein und führen Sie ihn aus:
iex (New-Object Net.WebClient).DownloadString('https://ibm-cloud-cli-installer-scripts.s3.private.us.cloud-object-storage.appdomain.cloud/powershell_private')
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 zu aktivieren, indem Sie den folgenden Befehl ausführen:[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
-
Kopieren Sie für Windows™aus einer IBM Cloud Virtual Private Cloud den folgenden Befehl und fügen Sie ihn in eine Windows™ PowerShell-Eingabeaufforderung ein und führen Sie ihn aus:
iex (New-Object Net.WebClient).DownloadString('https://ibm-cloud-cli-installer-scripts.s3.direct.us.cloud-object-storage.appdomain.cloud/powershell_vpc')
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 zu aktivieren, indem Sie den folgenden Befehl ausführen:[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Installationspakete mit privaten Endpunkten herunterladen
Führen Sie zum Einrichten der aktuellsten, eigenständigen IBM Cloud-Befehlszeilenschnittstelle die folgenden Schritte aus:
-
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, Linux™ LE 64 Bit (ppc64le) und System/390 Linux™.
-
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.
Installationsprogramme:
-
Melden Sie sich über die Befehlszeilenschnittstelle 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.
Pakete aus früheren Releases für private Endpunkte installieren
Wenn Sie diese Pakete aus früheren Releases installieren möchten, führen Sie diese Vorlage aus, um den privaten Endpunkt-Link des Pakets zu erstellen, das Sie herunterladen möchten, indem Sie release_tag durch die Releaseversion ersetzen, die Sie herunterladen möchten.
Wenn Sie frühere Releases anzeigen möchten, greifen Sie auf das offizielle GitHub-Repository ibm-cloud-cli-releases zu.
Mac OS X 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>.pkg
Windows™ (64-Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_amd64.exe
Windows™ (32 Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_386.exe
Linux™ (64 Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_amd64.tar.gz
Linux™ (32 Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_386.tar.gz
PowerLinux™ (64 Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_ppc64le.tar.gz
System/390 Linux™ (64 Bit)
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/IBM_Cloud_CLI_<release_tag>_s390x.tar.gz
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.
-
Wählen Sie die passende Binärdatei Ihrer Plattform aus, um mit dem Download zu beginnen. Die folgenden Plattformen werden unterstützt: macOS, linux32, linux64, ppc64le, win32, win64, und s390x.
-
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
Für Windows™:
IBM_Cloud_CLI ├── LICENSE ├── NOTICE └── ibmcloud.exe
-
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 UmgebungsvariablenPATH
hinzu.
- Fügen Sie die Angabe
Binärdateien
- Mac OS X 64-Bit
- Windows™ (64 Bit)
- Windows™ (32 Bit)
- Linux™ (64 Bit)
- Linux™ (64-Bit-ARM)
- Linux™ (32 Bit)
- PowerLinux™ (64 Bit)
- System/390 Linux™ (64 Bit)
Wenn Sie Binärprogramme aus früheren Releases installieren möchten, führen Sie diese Vorlage aus, um den privaten Endpunkt-Link des Binärwerts zu erstellen, den Sie herunterladen möchten, indem Sie release_tag durch die Releaseversion ersetzen, die Sie herunterladen möchten.
Um frühere Releases anzuzeigen, greifen Sie auf das offizielle Github-Repository ibm-cloud-cli-releases zu.
Mac OS X 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_macos.tgz
Windows 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_windows_amd64.zip
Windows 32-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_windows_386.zip
Linux 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_amd64.tgz
Linux 32-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_386.tgz
Power Linux 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_ppc64le.tgz
System/390 Linux 64-Bit
https://ibm-cloud-cli.s3.private.us.cloud-object-storage.appdomain.cloud/<release_tag>/binaries/IBM_Cloud_CLI_<release_tag>_linux_s390x.tgz
Private Endpunkte in der Befehlszeilenschnittstelle verwenden
Anweisungen zur Verwendung von privaten Endpunkten in der Befehlszeilenschnittstelle und zum Anzeigen der Liste der Befehle, die private Endpunkte unterstützen, finden Sie unter Anmelden bei der Befehlszeilenschnittstelle mit einem privaten Endpunkt.