다음을 통해 공유


Active Directory 커넥터 업그레이드

이 문서에서는 Active Directory 커넥터를 업그레이드하는 방법을 설명합니다.

필수 조건

이 문서의 작업을 진행하려면 다음이 필요합니다.

  • Kubernetes 클러스터에 연결하고 인증하려면
  • 선택한 기존 Kubernetes 컨텍스트
  • direct 또는 indirect 모드에서 배포된 Azure Arc 데이터 컨트롤러
  • 배포된 Active Directory 커넥터

도구 설치

adc(Active Directory 커넥터)를 업그레이드하려면 kubectl과 같은 Kubernetes 도구가 설치되어 있어야 합니다.

이 문서의 예제에서는 kubectl을 사용하지만 이와 마찬가지로, 관련 도구와 Kubernetes yaml/json에 익숙하다면 Kubernetes 대시보드, oc 또는 helm 등의 다른 Kubernetes 도구를 사용할 수도 있습니다.

kubectl 도구 설치

제한 사항

Active Directory 커넥터의 자동 업그레이드는 imageTag v1.12.0_2022-10-11 이상에서 적용할 수 있으며 Arc 데이터 컨트롤러는 버전 v1.11.0_2022-09-13 이상이어야 합니다.

adc(Active Directory 커넥터)는 데이터 컨트롤러가 업그레이드되기 전에 데이터 컨트롤러와 동일한 버전이어야 합니다.

현재 사용 가능한 일괄 처리 업그레이드 프로세스가 없습니다.

이전 버전의 Active Directory 커넥터 업그레이드

imageTag 버전 v1.11.0_2022-09-13 이하의 경우 Active Directory 커넥터를 아래와 같이 수동으로 업그레이드해야 합니다.

kubectl 명령을 사용하여 yaml에서 기존 사양을 봅니다.

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

kubectl 패치를 실행하여 원하는 버전을 업데이트합니다.

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

Monitor

다음과 같이 kubectl을 사용하여 업그레이드 진행 상황을 모니터링할 수 있습니다.

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

출력

명령에 대한 출력은 리소스 정보를 표시합니다. 업그레이드 정보는 상태가 됩니다.

업그레이드하는 동안 StateUpdating을 표시하고 Running Version이 현재 버전이 됩니다.

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

업그레이드가 완료되면 StateReady를 표시하고 Running Version이 새 버전이 됩니다.

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

문제 해결

원하는 버전이 특정 버전으로 설정되면 부트스트래퍼 작업은 성공할 때까지 해당 버전으로 업그레이드를 시도합니다. 업그레이드에 성공하면 사양의 RunningVersion 속성이 새 버전으로 업데이트됩니다. 잘못된 이미지 태그, 레지스트리 또는 리포지토리에 연결할 수 없음, 컨테이너에 할당된 CPU 또는 메모리 부족 또는 스토리지 부족과 같은 시나리오의 경우 업그레이드가 실패할 수 있습니다.

  1. 아래 명령을 실행하여 Pod가 Error 상태를 표시하거나 다시 시작 횟수가 많은지 확인합니다.

    kubectl get pods --namespace <namespace>
    
  2. 오류가 있는지 확인하기 위해 이벤트를 보려면 다음을 실행합니다.

    kubectl describe pod <pod name> --namespace <namespace>
    
  3. Pod의 컨테이너 목록을 가져오려면 다음을 실행합니다.

    kubectl get pods <pod name> --namespace <namespace> -o jsonpath='{.spec.containers[*].name}*'
    
  4. 컨테이너에 대한 로그를 가져오려면 다음을 실행합니다.

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

일반적인 오류와 문제 해결 방법을 보려면 문제 해결 리소스로 이동합니다.