Partilhar via


Atualizar conector do Ative Directory

Este artigo descreve como atualizar o conector do Ative Directory.

Pré-requisitos

Antes de prosseguir com as tarefas neste artigo, você precisa:

  • Para conectar-se e autenticar em um cluster Kubernetes
  • Um contexto Kubernetes existente selecionado
  • Controlador de dados do Azure Arc implantado, em direct modo ou indirect
  • Conector do Ative Directory implantado

Instalar ferramentas

Para atualizar o conector do Ative Directory (adc), você precisa ter as ferramentas do Kubernetes, como o kubectl, instaladas.

Os exemplos neste artigo usam kubectl, mas abordagens semelhantes podem ser usadas com outras ferramentas do Kubernetes, como o painel do Kubernetes, ocou helm, se você estiver familiarizado com essas ferramentas e o Kubernetes yaml/json.

Instale a ferramenta kubectl

Limitações

A atualização automática do conector do Ative Directory é aplicável a partir de imageTag v1.12.0_2022-10-11 e acima e o controlador de dados Arc deve ter pelo menos v1.11.0_2022-09-13 a versão.

O conector do Ative Directory (adc) deve estar na mesma versão do controlador de dados antes que um controlador de dados seja atualizado.

Não há nenhum processo de atualização em lote disponível no momento.

Atualizar o conector do Ative Directory para versões anteriores

Para versões v1.11.0_2022-09-13 imageTag ou inferiores, o conector do Ative Directory deve ser atualizado manualmente conforme abaixo:

Use um comando kubectl para visualizar a especificação existente no yaml.

kubectl get adc <adc-name> --namespace <namespace> --output yaml

Execute o patch kubectl para atualizar a versão desejada.

kubectl patch adc <adc-name> --namespace <namespace> --type merge --patch '{"spec": {"update": {"desiredVersion": "v1.11.0_2022-09-13"}}}'

Monitor

Você pode monitorar o progresso da atualização com kubectl da seguinte maneira:

kubectl describe adc <adc-name> --namespace <namespace>

Saída

A saída para o comando mostrará as informações do recurso. As informações de atualização estarão em Status.

Durante a atualização, State mostrará Updating e Running Version será a versão atual:

Status:
  Last Update Time:     2022-09-20T16:01:48.449512Z
  Observed Generation:  1
  Running Version:      v1.10.0_2022-08-09
  State:                Updating

Quando a atualização estiver concluída, State mostrará Ready e Running Version será a nova versão:

Status:
  Last Update Time:     2022-09-20T16:01:54.279612Z
  Observed Generation:  2
  Running Version:      v1.11.0_2022-09-13
  State:                Ready

Resolução de Problemas

Quando a versão desejada é definida para uma versão específica, o trabalho de bootstrapper tentará atualizar para essa versão até que seja bem-sucedido. Se a atualização for bem-sucedida, a RunningVersion propriedade da especificação será atualizada para a nova versão. As atualizações podem falhar em cenários como uma marca de imagem incorreta, incapacidade de se conectar ao registro ou repositório, CPU ou memória insuficientes alocadas para os contêineres ou armazenamento insuficiente.

  1. Execute o comando abaixo para ver se algum dos pods mostra um Error status ou tem um alto número de reinicializações:

    kubectl get pods --namespace <namespace>
    
  2. Para examinar Eventos para ver se há um erro, execute

    kubectl describe pod <pod name> --namespace <namespace>
    
  3. Para obter uma lista dos contêineres nos pods, execute

    kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'
    
  4. Para obter os logs de um contêiner, execute

    kubectl logs <pod name> <container name> --namespace <namespace>
    

Para exibir erros comuns e como solucioná-los, vá para Recursos de solução de problemas.