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 o administrador, o híbrido, o usuário autônomo ou o usuário clusters com o comando bmctl get config.

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