클러스터 생성 또는 업데이트 문제 해결

이 페이지에서는 Azure용 GKE 설치 또는 업그레이드와 관련된 문제를 해결하는 방법을 보여줍니다.

추가 지원이 필요하면 Cloud Customer Care에 연락합니다.

클러스터 만들기 실패

클러스터 만들기를 요청하면 Azure용 GKE에서 먼저 일련의 프리플라이트 테스트를 실행하여 요청을 확인합니다. 클러스터 생성에 실패한다면 프리플라이트 테스트 중 하나가 실패했거나 클러스터 생성 프로세스 자체의 단계가 완료되지 않았기 때문일 수 있습니다.

실행 전 테스트가 실패하면 클러스터가 리소스를 만들지 않고 오류에 대한 정보를 사용자에게 직접 반환합니다. 예를 들어 이름이 invalid%%%name인 클러스터를 만들려고 하면 유효한 클러스터 이름에 대한 실행 전 테스트가 실패하고 요청에서 다음과 같은 오류를 반환합니다.

ERROR: (gcloud.container.azure.clusters.create) INVALID_ARGUMENT: must be
between 1-63 characters, valid characters are /[a-z][0-9]-/, should start with a
letter, and end with a letter or a number: "invalid%%%name",
field: azure_cluster_id

프리플라이트 테스트를 통과한 후에도 클러스터 생성에 실패할 수 있습니다. 이런 일은 클러스터 생성이 시작된 후, Azure용 GKE가 Google Cloud 및 Azure에서 리소스를 생성한 지 몇 분 후에 일어나기도 합니다. 이 경우 Azure 리소스는 상태가 ERROR로 설정된 Google Cloud 프로젝트에 위치하게 됩니다.

실패에 대한 세부정보를 확인하려면 다음 명령어를 실행합니다.

gcloud container azure clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --format "value(state, errors)"

다음을 바꿉니다.

  • CLUSTER_NAME: 상태를 쿼리하는 클러스터의 이름
  • GOOGLE_CLOUD_LOCATION: 이 Azure 클러스터를 관리하는 Google Cloud 리전의 이름

또는 생성 클러스터 API 호출과 연결된 Operation 리소스를 설명하여 생성 실패에 대한 세부정보를 가져올 수 있습니다.

gcloud container azure operations describe OPERATION_ID

OPERATION_ID: 클러스터를 만든 작업의 ID. 클러스터 만들기 요청의 작업 ID가 없으면 다음 명령어를 사용하여 이 ID를 가져올 수 있습니다.

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

타임스탬프 또는 관련 정보를 사용하여 원하는 클러스터 만들기 작업을 식별하세요.

클러스터 업데이트 실패

클러스터를 업데이트할 때, 새 클러스터를 만들 때와 마찬가지로 Azure용 GKE는 먼저 프리플라이트 테스트 집합을 실행하여 요청을 확인합니다. 클러스터 업데이트에 실패한다면 프리플라이트 테스트 중 하나가 실패했거나 클러스터 업데이트 프로세스 자체의 단계가 완료되지 않았기 때문일 수 있습니다.

실행 전 테스트가 실패하면 클러스터가 리소스를 업데이트하지 않고 오류에 대한 정보를 사용자에게 직접 반환합니다. 예를 들어 이름이 test_ec2_keypair인 SSH 키 쌍을 사용하도록 클러스터를 업데이트하려고 하면 실행 전 테스트는 EC2 키 쌍을 가져오려고 시도하지만 실패하며 요청은 다음과 같은 오류를 반환합니다.

ERROR: (gcloud.container.azure.clusters.update) INVALID_ARGUMENT: key pair
"test_ec2_keypair" not found,
field: azure_cluster.control_plane.ssh_config.ec2_key_pair

프리플라이트 테스트를 통과한 후에도 클러스터 업데이트에 실패할 수 있습니다. 클러스터 업데이트는 시작된 후 몇 분 정도 걸릴 수 있으며 Google Cloud 프로젝트의 Azure 리소스 상태는 DEGRADED로 설정됩니다.

실패 및 관련 작업에 대한 세부정보를 가져오려면 클러스터 만들기 실패에 설명된 단계를 따르세요.

다음 단계