Dell 자동화 플랫폼: 업그레이드 문제 Portal Vault가 시작되지 않음

요약: 이 문서에서는 Portal Vault 포드가 표시되지 않을 때 발생하는 Dell Automation Platform 업그레이드 문제에 대한 솔루션을 설명합니다.

이 문서는 다음에 적용됩니다. 이 문서는 다음에 적용되지 않습니다. 이 문서는 특정 제품과 관련이 없습니다. 모든 제품 버전이 이 문서에 나와 있는 것은 아닙니다.

증상

Dell Automation Platform을 업그레이드할 때 Webhook 변경 충돌로 인해 문제가 발생할 수 있습니다.

첫 번째 증상은 업그레이드 단계에서 장시간(25분 이상) 중단되는 것입니다. PORTAL ChartKey 전개. 기본 설치 로그에는 다음이 표시됩니다.

...
Orchestrator chart exists. Skip unarchive...
Portal chart exists. Skip unarchive...
Portal Installation has started
OperationType: INSTALL OperationStatus: IN_PROGRESS ChartKey: PORTAL

이 문제는 일반적으로 포털 볼트 배포가 포드 목록에 표시되는 순간에 업그레이드를 차단합니다. 볼트는 두 가지 배포에 대해 2/3 READY 상태를 표시합니다. 같이:

#kubectl get po -A
...
dapp              edgevault-0                                          3/3     Running     0             30m
dapp              edgevault-1                                          2/3     Running     0             30m
dapp              edgevault-2                                          2/3     Running     0             30m
...

로그에는 볼트가 노드 간에 통신할 수 없음이 표시됩니다.

2025-10-30T15:27:26.896Z [INFO]  core: attempting to join possible raft leader node: leader_addr=http://edgevault-2.edgevault-internal:8200
2025-10-30T15:27:26.900Z [ERROR] core: failed to retry join raft cluster: retry=2s err="failed to send answer to raft leader node: error bootstrapping cluster: cluster already has state"
2025-10-30T15:27:28.664Z [ERROR] core: failed to get raft challenge: leader_addr=http://edgevault-1.edgevault-internal:8200 error="error during raft bootstrap init call: context deadline exceeded"
2025-10-30T15:27:28.664Z [ERROR] core: failed to get raft challenge: leader_addr=http://edgevault-0.edgevault-internal:8200 error="error during raft bootstrap init call: context deadline exceeded"

원인

이 문제의 근본 원인은 Orchestrator에서 충돌하는 변경 Webhook이 포털을 방해하기 때문입니다.

이 충돌은 오케스트레이터의 변경 Webhook이 제대로 구성되지 않아 사이드카가 송신 트래픽을 암호화하지 못할 때 발생합니다. 그 결과 SSL 종료 논리가 트래픽을 제대로 처리할 수 없어 네임스페이스에 혼란이 발생합니다. 이 문제는 일반적으로 2.2 NEO(NativeEdge Orchestrator) 이하 릴리스와 함께 처음 설치된 후 나중에 업그레이드한 설치 환경에서 발생합니다. 


설명

변경 웹훅은 포드와 같은 리소스를 생성하거나 업데이트하기 전에 수정할 수 있는 Kubernetes 기능입니다. Dell 자동화 플랫폼과 관련하여 Orchestrator의 Mutating Webhook은 사이드카를 포드에 삽입하는 데 중요한 역할을 합니다. 과거에는 단일 네임스페이스에서 설치가 수행되어 네임스페이스 선택기가 필요하지 않았습니다. 그러나 최신 버전에서는 Orchestrator의 변경 Webhook이 다른 구성 요소를 방해하지 않도록 하기 위해 네임스페이스 선택기가 필요합니다. 이렇게 하면 사이드카 삽입이 올바른 네임스페이스 내에서 수행됩니다.
 

참고:문제는 오 케스트레이터가 2.2 NEO 또는 이전 릴리스 와 함께 설치된 후 나중에 업그레이드된 경우에 발생합니다. 이 문제는 오케스트레이터가 3.0 NEO 이상 릴리스에서 설치된 후 나중에 업그레이드되는 경우에는 발생하지 않습니다.

해결

이 문제를 해결하려면 업그레이드 프로세스를 시작하기 전에 Orchestrator의 변경 Webhook 구성을 수정해야 합니다.
 

중요 사항: 이러한 증상으로 인해 이전 업그레이드 시도가 실패한 경우 다음 개선 조치 중 하나를 수행하는 것이 좋습니다.
  • 업그레이드 전 스냅샷으로 롤백
또는
  • 에서 체크포인트 데이터를 제거합니다. ConfigMaps. 이렇게 하면 깔끔하고 성공적인 업그레이드 프로세스가 보장됩니다. 제거하려면 ConfigMaps에서 다음 명령을 사용합니다.
#kubectl get cm -A | grep check
hzp               checkpoint-data                                        7      31m
#kubectl delete cm checkpoint-data -n hzp


웹훅 수정:
업그레이드를 시작(또는 재시작)하기 전에 webhooks.namespaceSelector.matchExpressions 오케스트레이터의 변경 Webhook 구성의 경로입니다. 

kubectl edit mutatingwebhookconfigurations hzp-iam-sidecar-injector

다음 섹션을 찾습니다.

....
 namespaceSelector:
      matchExpressions:
...

이 섹션에 이 스니펫이 포함되어 있지 않은 경우 이 스니펫을 추가합니다. 들여쓰기가 중요합니다!

    - key: kubernetes.io/metadata.name
      operator: In
      values:
      - hzp

이렇게 하면 오케스트레이터 변경 웹후크가 포털을 방해하지 않습니다. 사이드카 삽입을 적용하면 "포털" 네임스페이스에 적용되지 않습니다. 이렇게 하면 모든 포드에서 발생하는 문제가 해결됩니다. 

해당 제품

Dell Automation Platform, Dell Distributed Private Cloud, Dell Automation Platform Components, NativeEdge
문서 속성
문서 번호: 000390269
문서 유형: Solution
마지막 수정 시간: 24 5월 2026
버전:  3
다른 Dell 사용자에게 질문에 대한 답변 찾기
지원 서비스
디바이스에 지원 서비스가 적용되는지 확인하십시오.