Como 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.

Como conseguir detalhes de configuração do cluster

Depois de criar clusters de administrador, híbrido, independente ou de usuário com o comando bmctl get config, é possível usar o comando a seguir 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 especifica o caminho até 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 especifica o caminho até o arquivo kubeconfig do cluster de administrador;

Em ambos os casos, os recursos personalizados são gravados em um arquivo YAML, 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 será semelhante a este:

---
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
 nodeConfig:
   containerRuntime: docker
---
apiVersion: baremetal.cluster.gke.io/v1
kind: NodePool
metadata:
 name: nodepool1
 namespace: cluster-admin1
spec:
 clusterName: admin1
 nodes:
 - address: 172.18.0.9

Como receber credenciais de cluster

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

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 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;

Em ambos os casos, 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.