Atualizar o conector do Active Directory

Artigo
10/16/2024

Este artigo descreve como atualizar o conector do Active Directory.

Pré-requisitos

Antes de prosseguir com as tarefas deste artigo, será necessário:

Conectar e autenticar a um cluster do Kubernetes
Um contexto do Kubernetes existente selecionado
Controlador de dados do Azure Arc implantado, no modo direct ou indirect
Conector do Active Directory implantado

Instalar ferramentas

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

Os exemplos neste artigo usarão kubectl, mas abordagens semelhantes podem ser usadas com outras ferramentas de Kubernetes como, por exemplo, o painel do Kubernetes, oc ou helm se você estiver familiarizado com essas ferramentas e yaml/json de Kubernetes.

Instalar ferramenta kubectl

Limitações

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

O conector do Active Directory (adc) deverá estar na mesma versão que o 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 Active Directory para versões anteriores

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

Use um comando kubectl para exibir a especificação existente em yaml.

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

Execute kubectl patch 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 o kubectl como segue:

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

Saída

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

Durante a atualização, State o 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 for concluída, o 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

Solução de problemas

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

Execute o comando abaixo para ver se algum dos pods mostra um status Error ou se tem um alto número de reinicializações:
```
kubectl get pods --namespace <namespace>
```

Para examinar eventos em busca de um erro, execute

kubectl describe pod <pod name> --namespace <namespace>

Para obter uma lista dos contêineres nos pods, execute

kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'

Para obter os logs de um contêiner, execute

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

Para ver erros comuns e saber como solucioná-los, acesse Solução de problemas de recursos.

Compartilhar via