Storage CLI installieren und konfigurieren

Auf dieser Seite erfahren Sie, wie Sie die gdcloud CLI installieren und konfigurieren, um den Objektspeicher bei der Arbeit mit Google Distributed Cloud (GDC) mit Air Gap-Projekten zu verwalten. Es wird beschrieben, wie Sie die erforderlichen Komponenten und Einstellungen herunterladen, installieren und konfigurieren, die für die effektive Verwendung von Speicher-Buckets und -Objekten in dieser isolierten Umgebung erforderlich sind.

Diese Seite richtet sich an Zielgruppen wie IT-Administratoren in der Gruppe der Infrastrukturbetreiber oder Entwickler in der Gruppe der Anwendungsbetreiber, die Objektspeicher-Buckets für Projekte in GDC-Umgebungen mit Air Gap bereitstellen und verwalten möchten. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

gdcloud CLI herunterladen

Folgen Sie der Anleitung, um die gdcloud CLI herunterzuladen.

gdcloud CLI installieren

Damit Sie die Befehlsstruktur für den Speicher verwenden können, muss die Komponente für Speicherabhängigkeiten installiert sein.

  1. Folgen Sie der Anleitung unter gdcloud CLI installieren.

  2. Führen Sie die folgenden Befehle aus, um die Komponente für Speicherabhängigkeiten zu installieren:

    gdcloud components install storage-cli-dependencies

    Weitere Informationen zum Befehl components install finden Sie unter gdcloud CLI installieren.

gdcloud CLI für Objektspeicher konfigurieren

Die folgenden Konfigurationen müssen festgelegt werden, um die gdcloud CLI für den Objektspeicher zu verwenden.

  1. Ersetzen Sie ACCESS_KEY_ID durch die Zugriffsschlüssel-ID, die Sie aus dem Secret unter Zugriffsschlüssel abrufen erhalten haben:

    gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID

  2. Ersetzen Sie SECRET_ACCESS_KEY durch den geheimen Schlüssel, den Sie aus dem Secret unter Zugriffsschlüssel abrufen erhalten haben:

    gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY

  3. Ersetzen Sie CA_BUNDLE_FILE durch den Pfad zum CA-Zertifikat. Dies ist ein digitales Zertifikat, das zu einer Zertifizierungsstelle (Certificate Authority, CA) gehört, einer vertrauenswürdigen Organisation, die für Identitäten bürgt:

    gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE

  4. Ersetzen Sie ENDPOINT durch den Endpunkt, den Ihr Infrastrukturbetreiber bereitstellt:

    gdcloud config set storage/s3_endpoint ENDPOINT

    Dieser Schritt unterscheidet sich leicht für Buckets mit zwei Zonen. Jeder Bucket mit zwei Zonen bietet drei Endpunkte, über die Sie auf den Bucket zugreifen können. In den meisten Fällen ist der globale Endpunkt geeignet, um automatische Failover zu nutzen:

    • Endpunkt für Zone 1: Dieser Endpunkt wird immer von Zone 1 empfangen. Wenn Sie diesen Endpunkt verwenden, haben Sie eine Read-after-Write-Konsistenz für alle Objekte, die in Zone 1 geschrieben wurden. Wenn Zone 1 jedoch ausfällt, muss ein Client entweder den Endpunkt für Zone 2 oder den globalen Endpunkt verwenden, um weiterhin Daten in diesen Bucket zu lesen oder zu schreiben. Wenn der Client von einem Nutzercluster stammt, ist dieser Endpunkt nur innerhalb von Zone 1 zugänglich.
    • Endpunkt für Zone 2: Dieser Endpunkt wird immer von Zone 2 empfangen. Wenn Sie diesen Endpunkt verwenden, haben Sie eine Read-after-Write-Konsistenz für alle Objekte, die in Zone 2 geschrieben wurden. Wenn Zone 2 jedoch ausfällt, muss ein Client entweder den Endpunkt für Zone 1 oder den globalen Endpunkt verwenden, um weiterhin Daten in diesen Bucket zu lesen oder zu schreiben. Wenn der Client von einem Nutzercluster stammt, ist dieser Endpunkt nur innerhalb von Zone 2 zugänglich.
    • Globaler Endpunkt: Bei diesem Endpunkt wird Ihre Anfrage entweder an Zone 1 oder Zone 2 weitergeleitet. Diese Option bietet keine Sitzungsaffinität. Das bedeutet, dass Anfragen, die mit derselben Sitzung gestellt werden, entweder in Zone 1 oder Zone 2 eingehen können. Daher gibt es keine Read-after-Write-Garantie für Anfragen, die an den globalen Endpunkt gesendet werden. Der globale Endpunkt bietet ein automatisches Failover, falls eine Zone ausfällt. Nutzer müssen die Endpunkte in ihren Arbeitslasten also nicht so ändern, wie sie es bei Verwendung des zonalen Endpunkts tun müssten. Außerdem ist dieser Endpunkt von Nutzerclustern in allen Zonen aus zugänglich.

    Führen Sie die folgenden Befehle auf dem Verwaltungsserver aus, um die globalen und zonalen Endpunkte für Ihren Bucket aufzurufen und den gewünschten Endpunkt auszuwählen:

    kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.globalEndpoint}" --kubeconfig MANAGEMENT_API_SERVER

kubectl get buckets BUCKET_NAME -n PROJECT_NAME -o jsonpath="{.status.zonalEndpoints}" --kubeconfig MANAGEMENT_API_SERVER