Fluxo de trabalho para clusters de Tanzu Kubernetes provisionamento

Você provisiona Tanzu Kubernetes clusters invocando a API declarativa Tanzu Kubernetes Grid Service usando kubectl e uma especificação de cluster definida usando YAML. Depois de provisionar um cluster, você o opera e implanta cargas de trabalho nele usando kubectl.

O fluxo de trabalho fornece um procedimento de ponta a ponta para o processo de provisionamento do cluster. Cada uma das etapas tem links para mais informações sobre a tarefa específica.

Pré-requisitos

Conclua os seguintes pré-requisitos:

Instale ou atualize seu ambiente para oferecer suporte à API Tanzu Kubernetes Grid Service v1alpha2. Consulte o Requisitos para usar a API do Tanzu Kubernetes Grid Service v1alpha2.
Observação: Se você estiver usando a API do Tanzu Kubernetes Grid Service v1alpha1, consulte Fluxo de trabalho para o provisionamento de Tanzu Kubernetes clusters usando a API Tanzu Kubernetes Grid Service v1alpha1.
Crie um vSphere Namespace onde você planeja provisionar Tanzu Kubernetes clusters. Consulte o Criar e configurar um vSphere Namespace.
A configuração inicial do namespace requer o seguinte:
- Edite as permissões para um ou mais engenheiros de DevOps acessarem o namespace usando as credenciais do vCenter Single Sign-On.
- Política de armazenamento compartilhado baseada em tag para o namespace.
- Cotas de capacidade e uso para o namespace, verificadas e ajustadas, conforme necessário.
Crie uma biblioteca de conteúdo para Tanzu Kubernetes releases em um armazenamento de dados compartilhado e sincronize as versões que você deseja usar. Consulte o Criação e gerenciamento de bibliotecas de conteúdo para Tanzu Kubernetes releases.
Associe a biblioteca de conteúdo e as classes de máquina virtual ao vSphere Namespace. Consulte o Configure um vSphere Namespace para Tanzu Kubernetes releases.

Procedimento

Baixe e instale o Kubernetes CLI Tools for vSphere. Consulte o Baixe e instale o Kubernetes CLI Tools for vSphere.
Usando o vSphere Plugin for kubectl, autentique-se com o Supervisor Cluster. Consulte o Conecte-se ao Supervisor Cluster como um usuário do vCenter Single Sign-On.
```
kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME
```
Usando kubectl, alterne o contexto para o vSphere Namespace no qual você planeja provisionar o cluster do Tanzu Kubernetes.
```
kubectl config get-contexts
```
```
kubectl config use-context SUPERVISOR-NAMESPACE
```
Por exemplo:
```
kubectl config use-context tkgs-cluster-ns
```
Liste as associações de classe de máquina virtual disponíveis. Consulte o Classes de máquina virtual para Tanzu Kubernetes clusters.
Use o seguinte comando para listar todas as associações de classe de VM que estão disponíveis no vSphere Namespace onde você implanta o cluster.
```
kubectl get virtualmachineclassbindings
```
Observação: O comando kubectl get virtualmachineclasses lista todas as classes de VM presentes no Supervisor Cluster. Como você deve associar classes de VM ao vSphere Namespace, só pode usar as classes de VM que estão vinculadas ao namespace de destino.
Obtenha as classes de armazenamento de volume persistente disponíveis.
```
kubectl describe storageclasses
```
Liste os Tanzu Kubernetes releases disponíveis.
```
kubectl get tanzukubernetesreleases
```
Ou, usando o atalho:
```
kubectl get tkr
```
Observação: A versão mínima de Tanzu Kubernetes que oferece suporte à API v1alpah2 é v1.21.2---vmware.1-tkg.1.13da849. Consulte o Lista de Tanzu Kubernetes releases.
Construa o arquivo YAML para provisionar um cluster do Tanzu Kubernetes.
1. Comece com um dos arquivos YAML de exemplo.
  
  Consulte o Exemplo de YAML para provisionamento de clusters Tanzu Kubernetes usando a API Tanzu Kubernetes Grid Service v1alpha2.
2. Use as informações coletadas da saída dos comandos anteriores para preencher o YAML do cluster, incluindo o seguinte:
  - vSphere Namespace de destino
  - Classe de armazenamento para o plano de controle e nós de trabalho e cargas de trabalho do Kubernetes
  - Aulas de máquina virtual
  - NOME DO TKR
3. Personalize o cluster conforme necessário, consultando a lista completa de parâmetros de configuração do cluster.
  
  Consulte o Parâmetros de configuração para o provisionamento de clusters Tanzu Kubernetes usando a API do Tanzu Kubernetes Grid Service v1alpha2.
4. Salve o arquivo como tkgs-cluster-1.yaml ou semelhante.

Provisione o cluster executando o seguinte comando kubectl.

kubectl apply -f CLUSTER-NAME.yaml

Por exemplo:

kubectl apply -f tkgs-cluster-1.yaml

Resultado esperado:

tanzukubernetescluster.run.tanzu.vmware.com/tkgs-cluster-1 created

Monitore a implantação de nós do cluster usando kubectl. Consulte o Monitore o Tanzu Kubernetes status do cluster usando o kubectl.

kubectl get tanzukubernetesclusters

Resultado da amostra:

NAMESPACE      NAME              CONTROL PLANE   WORKER   TKR NAME                           AGE    READY   TKR COMPATIBLE   UPDATES AVAILABLE
tkgs-cluster   tkgs-cluster-1    3               3        v1.21.2---vmware.1-tkg.1.13da849   38h    True    True             [1.21.2+vmware.1-tkg.1.13da849]

Monitore a implantação de nós do cluster usando o vSphere Client. Consulte o Monitore o status do Tanzu Kubernetes cluster usando o vSphere Client.
Por exemplo, no inventário do vSphere, você deve ver os nós da máquina virtual sendo implantados no namespace.
Execute comandos adicionais para verificar o provisionamento do cluster. Consulte Usar comandos operacionais de cluster do Tanzu Kubernetes .
Por exemplo:
```
kubectl get tanzukubernetescluster,cluster-api,virtualmachinesetresourcepolicy,virtualmachineservice,virtualmachine
```
Observação: Para solução de problemas adicional, consulte Solução de problemas de clusters Tanzu Kubernetes .

Usando o vSphere Plugin for kubectl, faça login no cluster. Consulte o Conectar-se a um Tanzu Kubernetes cluster como um vCenter Single Sign-On usuário.

kubectl vsphere login --server=IP-ADDRESS --vsphere-username USERNAME \
--tanzu-kubernetes-cluster-name CLUSTER-NAME --tanzu-kubernetes-cluster-namespace NAMESPACE-NAME

Verifique o provisionamento do cluster usando os seguintes comandos kubectl.

kubectl cluster-info

kubectl get nodes

kubectl get namespaces

kubectl api-resources

Implante uma carga de trabalho de exemplo e verifique a criação do cluster. Consulte o Implantar cargas de trabalho em Tanzu Kubernetes clusters.

Observação: Os clusters Tanzu Kubernetes têm a política de segurança de pod ativada. Dependendo da carga de trabalho e do usuário, talvez seja necessário criar uma RoleBinding apropriada ou uma PodSecurityPolicy personalizada. Consulte o Usando políticas de segurança de pod com clusters do Tanzu Kubernetes.
Operacionalize o cluster implantando extensões TKG. Consulte o Implantar extensões TKG em Tanzu Kubernetes clusters.