Exportar registros para um bucket remoto

Nesta página, descrevemos como exportar os registros de auditoria e operacionais no appliance isolado do Google Distributed Cloud (GDC) para um bucket remoto usando a ferramenta de transferência de armazenamento.

Receber papéis do IAM

Para receber as permissões necessárias para exportar registros, peça ao administrador do IAM da organização para conceder a você a função de administrador da transferência de registros (logs-transfer-admin) no namespace obs-system no cluster de infraestrutura e a função de leitor do bucket de registros (logs-bucket-viewer)) no namespace obs-system no plano de gerenciamento.

Para mais informações sobre esses papéis, consulte Preparar permissões do IAM.

Extrair o endpoint e o nome totalmente qualificado do bucket de origem

1. Defina KUBECONFIG como a API Organization Management:

   export KUBECONFIG=MANAGEMENT_API_KUBECONFIG_PATH
   

2. Receba o endpoint do bucket de origem:

   • Para registros de auditoria:

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

   • Para registros operacionais:

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

3. Receba o nome totalmente qualificado do bucket de origem:

   • Para registros de auditoria:

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

   • Para registros operacionais:

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

Receber credenciais de acesso do bucket de origem

1. Defina KUBECONFIG como o cluster de infraestrutura da organização:

     export KUBECONFIG=INFRA_CLUSTER_KUBECONFIG_PATH
   

2. Consiga o ID da chave de acesso do bucket de origem:

   • Para registros de auditoria:

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

   • Para registros operacionais:

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

3. Extraia a chave de acesso secreta do bucket de origem:

   • Para registros de auditoria:

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

   • Para registros operacionais:

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

Registros de transferência

1. Defina KUBECONFIG como o cluster da infraestrutura da organização:

   export KUBECONFIG=INFRA_CLUSTER_KUBECONFIG_PATH
   

2. Crie um secret com as credenciais de acesso do bucket de origem:

   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. Crie um secret com as credenciais de acesso do bucket de destino:

   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. Crie um secret com a autoridade certificadora para autenticar o endpoint do bucket de destino:

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

5. Crie um job de transferência de registros:

   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. Aguarde a conclusão do job de transferência:

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