Esportare i log in un bucket remoto

Questa pagina descrive come esportare i log operativi e di controllo nell'appliance air-gapped Google Distributed Cloud (GDC) in un bucket remoto utilizzando lo strumento di trasferimento dello spazio di archiviazione.

Ottenere ruoli IAM

Per ottenere le autorizzazioni necessarie per esportare i log, chiedi all'amministratore IAM dell'organizzazione di concederti il ruolo Amministratore trasferimento log (logs-transfer-admin) nello spazio dei nomi obs-system nel cluster di infrastruttura e il ruolo Visualizzatore bucket log (logs-bucket-viewer)) nello spazio dei nomi obs-system nel management plane.

Per saperne di più su questi ruoli, consulta Preparare le autorizzazioni IAM.

Ottieni l'endpoint e il nome completo del bucket di origine

1. Imposta KUBECONFIG sull'API Org Management:

   export KUBECONFIG=MANAGEMENT_API_KUBECONFIG_PATH
   

2. Ottieni l'endpoint del bucket di origine:

   • Per i log di controllo:

     kubectl get bucket audit-logs-loki-all -n obs-system -o json | jq '.status.endpoint'
     

   • Per i log operativi:

     kubectl get bucket ops-logs-loki-all -n obs-system -o json | jq '.status.endpoint'
     

3. Recupera il nome completo del bucket di origine:

   • Per i log di controllo:

     kubectl get bucket audit-logs-loki-all -n obs-system -o json | jq '.status.fullyQualifiedName'
     

   • Per i log operativi:

     kubectl get bucket ops-logs-loki-all -n obs-system -o json | jq '.status.fullyQualifiedName'
     

Ottieni le credenziali di accesso del bucket di origine

1. Imposta KUBECONFIG sul cluster Org Infra:

     export KUBECONFIG=INFRA_CLUSTER_KUBECONFIG_PATH
   

2. Ottieni l'ID chiave di accesso del bucket di origine:

   • Per i log di controllo:

     kubectl get secret audit-logs-loki-all-s3-auth -n obs-system -o json | jq -r '.data."access-key-id"' | base64 -di
     

   • Per i log operativi:

     kubectl get secret ops-logs-loki-all-s3-auth -n obs-system -o json | jq -r '.data."access-key-id"' | base64 -di
     

3. Recupera la chiave di accesso segreta del bucket di origine:

   • Per i log di controllo:

     kubectl get secret audit-logs-loki-all-s3-auth -n obs-system -o json | jq -r '.data."secret-access-key"' | base64 -di
     

   • Per i log operativi:

     kubectl get secret ops-logs-loki-all-s3-auth -n obs-system -o json | jq -r '.data."secret-access-key"' | base64 -di
     

Log di trasferimento

1. Imposta KUBECONFIG sul cluster dell'infrastruttura dell'organizzazione:

   export KUBECONFIG=INFRA_CLUSTER_KUBECONFIG_PATH
   

2. Crea un secret con le credenziali di accesso del bucket di origine:

   kubectl create secret generic -n obs-system SRC_BUCKET_SECRET_NAME
   --from-literal=access-key-id=SRC_BUCKET_ACCESS_KEY_ID
   --from-literal=secret-access-key=SRC_BUCKET_SECRET_ACCESS_KEY
   

3. Crea un secret con le credenziali di accesso del bucket di destinazione:

   kubectl create secret generic -n obs-system DST_BUCKET_SECRET_NAME 
   --from-literal=access-key-id=DST_BUCKET_ACCESS_KEY_ID   
   --from-literal=secret-access-key=DST_BUCKET_SECRET_ACCESS_KEY
   

4. Crea un secret con l'autorità di certificazione per autenticare l'endpoint del bucket di destinazione:

   kubectl create secret generic -n obs-system DST_BUCKET_CA_SECRET_NAME 
   --from-file="ca.crt"=CA_FILE
   

5. Crea un job di trasferimento dei log:

   apiVersion: batch/v1
   kind: Job
   metadata:
     name: JOB_NAME
     namespace: obs-system
   spec:
     template:
       spec:
         serviceAccountName: logs-transfer-sa
         containers:
           - name: storage-transfer-pod
             image: gcr.io/private-cloud-staging/storage-transfer:latest
             imagePullPolicy: Always
             command:
               - /storage-transfer
             args:
               - '--src_endpoint=SRC_BUCKET_ENDPOINT'
               - '--dst_endpoint=DST_BUCKET_ENDPOINT'
               - '--src_path=SRC_BUCKET_FULLY_QUALIFIED_NAME'
               - '--dst_path=DST_BUCKET_FULLY_QUALIFIED_NAME'
               - '--src_credentials=obs-system/SRC_BUCKET_SECRET_NAME'
               - '--dst_credentials=obs-system/DST_BUCKET_SECRET_NAME'
               - '--dst_ca_certificate_reference=obs-system/DST_BUCKET_CA_SECRET_NAME'
               - '--src_ca_certificate_reference=obs-system/trust-store-root-ext'
               - '--src_type=s3'
               - '--dst_type=s3'
               - '--bandwidth_limit=1G'
         restartPolicy: OnFailure.
   ---
   

6. Attendi il completamento del job di trasferimento:

   kubectl wait --for=condition=complete job/JOB_NAME -n obs-system