Installa e configura l'interfaccia a riga di comando di archiviazione per i progetti

Questa pagina ti guida nell'installazione e nella configurazione di gcloud CLI per la gestione dell'archiviazione di oggetti quando lavori con progetti air-gapped di Google Distributed Cloud (GDC). Descrive come scaricare, installare e configurare i componenti e le impostazioni necessari per utilizzare in modo efficace i bucket e gli oggetti di archiviazione in questo ambiente isolato.

Questa pagina è rivolta a un pubblico come gli amministratori IT del gruppo di operatori dell'infrastruttura o gli sviluppatori del gruppo di operatori dell'applicazione che vogliono eseguire il provisioning e gestire i bucket di archiviazione di oggetti per i progetti negli ambienti air-gapped di GDC. Per saperne di più, consulta la sezione Pubblico per la documentazione air-gapped di GDC.

Scarica gcloud CLI

Segui le istruzioni per scaricare gcloud CLI.

Installa gcloud CLI

Per utilizzare l'albero dei comandi di archiviazione, è necessario installare il componente delle dipendenze di archiviazione.

  1. Segui le istruzioni riportate in Installare gcloud CLI.

  2. Per installare il componente delle dipendenze di archiviazione, esegui i seguenti comandi:

    gdcloud components install storage-cli-dependencies

    Per saperne di più sul comando components install, consulta Installare gcloud CLI.

Configura gcloud CLI per l'archiviazione di oggetti

Per utilizzare gcloud CLI per l'archiviazione di oggetti, devi impostare le seguenti configurazioni.

  1. Sostituisci ACCESS_KEY_ID con l'ID della chiave di accesso ottenuto dal secret in Recuperare le credenziali di accesso:

    gdcloud config set storage/s3_access_key_id ACCESS_KEY_ID

  2. Sostituisci SECRET_ACCESS_KEY con la chiave segreta ottenuta dal secret in Recuperare le credenziali di accesso:

    gdcloud config set storage/s3_secret_access_key SECRET_ACCESS_KEY

  3. Sostituisci CA_BUNDLE_FILE con il percorso del certificato CA. Si tratta di un certificato digitale appartenente a un'autorità di certificazione (CA), un'organizzazione attendibile che garantisce le identità:

    gdcloud config set storage/s3_custom_ca_certs_file CA_BUNDLE_FILE

  4. Sostituisci ENDPOINT con l'endpoint fornito dall'operatore dell'infrastruttura (IO):

    gdcloud config set storage/s3_endpoint ENDPOINT

    Questo passaggio è leggermente diverso per i bucket a doppia zona. Ogni bucket a doppia zona fornisce tre endpoint che puoi scegliere per accedere al bucket. Nella maggior parte dei casi, l'endpoint globale è appropriato per sfruttare i failover automatici:

    • Endpoint della zona 1: questo endpoint viene sempre ricevuto dalla zona 1. Se utilizzi questo endpoint, hai una coerenza di lettura dopo scrittura per tutti gli oggetti scritti nella zona 1. Tuttavia, se la zona 1 non è disponibile, un client deve passare all'utilizzo dell'endpoint della zona 2 o dell'endpoint globale per continuare a leggere/scrivere in questo bucket. Se il client proviene da un cluster utente, questo endpoint sarà accessibile solo dall'interno della zona 1.
    • Endpoint della zona 2: questo endpoint viene sempre ricevuto dalla zona 2. Se utilizzi questo endpoint, hai una coerenza di lettura dopo scrittura per tutti gli oggetti scritti nella zona 2. Tuttavia, se la zona 2 non è disponibile, un client deve passare all'utilizzo dell'endpoint della zona 1 o dell'endpoint globale per continuare a leggere/scrivere in questo bucket. Se il client proviene da un cluster utente, questo endpoint sarà accessibile solo dall'interno della zona 2.
    • Endpoint globale: questo endpoint fa sì che la richiesta venga indirizzata alla zona 1 o alla zona 2. Questa opzione non fornisce l'affinità sessione, il che significa che le richieste effettuate utilizzando la stessa sessione potrebbero arrivare nella zona 1 o nella zona 2. Ciò significa che non esiste alcuna garanzia di lettura dopo scrittura per le richieste effettuate all'endpoint globale. L'endpoint globale fornisce il failover automatico nel caso in cui una zona non sia disponibile, quindi gli utenti non dovranno modificare gli endpoint nei carichi di lavoro come dovrebbero fare se utilizzassero l'endpoint zonale. Inoltre, questo endpoint è accessibile dai cluster utente in tutte le zone.

    Esegui i seguenti comandi sul server API di gestione per visualizzare gli endpoint globali e zonali del bucket e scegliere quello che vuoi utilizzare:

    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