Recuperar informações do cluster

Neste documento, descrevemos como usar o comando bmctl get para recuperar informações importantes de configuração e credencial dos clusters atuais. Essas informações podem ser úteis para solucionar problemas de cluster.

Receber detalhes de configuração do cluster

Depois de criar os clusters de admin, híbrido, independente ou de usuário, é possível usar o comando bmctl get config para recuperar os detalhes de configuração do cluster.

Use o seguinte comando para recuperar todos os recursos personalizados de um cluster de autogerenciamento, como um cluster de administrador:

bmctl get config --cluster CLUSTER_NAME \
    --kubeconfig ADMIN_KUBECONFIG_PATH

Substitua:

  • CLUSTER_NAME: o nome do cluster de destino.

  • ADMIN_KUBECONFIG_PATH: o caminho para o arquivo kubeconfig do cluster de administrador.

Use o seguinte comando para recuperar todos os recursos personalizados de um cluster de usuário:

bmctl aceita o uso de --kubeconfig como um alias para a sinalização --admin-kubeconfig.

bmctl get config --cluster CLUSTER_NAME  \
    --admin-kubeconfig ADMIN_KUBECONFIG_PATH

Substitua:

  • CLUSTER_NAME: o nome do cluster de usuário de destino.

  • ADMIN_KUBECONFIG_PATH: o caminho para o arquivo kubeconfig do cluster de administrador.

Em ambos os comandos, os recursos personalizados são gravados em um arquivo YAML chamado: bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-TIMESTAMP.yaml. O TIMESTAMP no nome do arquivo indica a data e a hora em que o arquivo foi criado.

O arquivo YAML produzido pelo comando bmctl get config é semelhante ao exemplo a seguir:

---
apiVersion: v1
kind: Namespace
metadata:
 name: cluster-admin1
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
 name: admin1
 namespace: cluster-admin1
spec:
 clusterNetwork:
   services:
     cidrBlocks:
     - 10.96.0.0/20
   pods:
     cidrBlocks:
     - 192.168.0.0/16
 controlPlane:
   nodePoolSpec:
     nodes:
     - address: 172.18.0.13
 loadBalancer:
   mode: bundled
   ports:
     controlPlaneLBPort: 6443
   vips:
     controlPlaneVIP: 172.18.0.254
 storage:
   lvpShare:
     path: /mnt/localpv-share/
     storageclassname: standard
     numpvundersharedpath: 5
   lvpNodeMounts:
     path: /mnt/localpv-disk
     storageclassname: node-disk
 authentication:
   oidc:
     issuerURL: https://accounts.google.com
     kubectlRedirectURL: http://localhost:9879/callback
     clientID: 611080206796-9qq355g2q1coed5t78ckfmm1c6ini3et.apps.googleusercontent.com
     clientSecret: FTPbx3INYJcxBSQhMRlbk3tX
     username: email
     scopes: email
     extraParams: prompt=consent,access_type=offline
 clusterOperations:
   projectID: baremetal-test
   location: us-central1
 type: admin
 anthosBareMetalVersion: 0.0.0
 bypassPreflightCheck: false
---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
 name: nodepool1
 namespace: cluster-admin1
spec:
 clusterName: admin1
 nodes:
 - address: 172.18.0.9

Receber credenciais do cluster

Use o comando bmctl get credentials para recuperar credenciais de um determinado cluster de usuário.

Para recuperar todos os recursos personalizados de um cluster de usuário, use o seguinte comando:

bmctl aceita o uso de --kubeconfig como um alias para a sinalização --admin-kubeconfig.

bmctl get credentials --cluster CLUSTER_NAME  \
    --admin-kubeconfig ADMIN_KUBECONFIG_PATH

Substitua:

  • CLUSTER_NAME: o nome do cluster de usuário de destino.

  • ADMIN_KUBECONFIG_PATH especifica o caminho até o arquivo kubeconfig do cluster de administrador;

As credenciais do cluster são gravadas em um arquivo, bmctl-workspace/CLUSTER_NAME/CLUSTER_NAME-TIMESTAMP-kubeconfig. O TIMESTAMP no nome do arquivo indica a data e a hora em que o arquivo foi criado.

Como esse arquivo contém credenciais de autenticação para o cluster, armazene-o em um local seguro com acesso restrito.