Google Distributed Cloud 소프트웨어 오류

Google Distributed Cloud 소프트웨어 전용 제품, 베어메탈, VMware의 오류 카탈로그입니다.

각 오류 항목은 다음 정보로 구성됩니다.

  • 오류 ID: E###### 형식의 짧은 고유 식별자입니다. 여기서 ###### 은 고유 번호입니다.

  • 오류 제목: 오류에 대한 간략한 사람이 읽을 수 있는 설명입니다.

  • 오류 설명: 오류 원인을 파악하고 해결하는 데 도움이 되는 세부정보입니다.

E000000: Kubeconfig 파일이 지정되지 않음

kubeconfig 파일을 지정하지 않고 bmctl 명령어가 실행됩니다.

계속하려면 --kubeconfig 플래그를 사용하여 kubeconfig 파일을 제공해야 합니다.

예:

bmctl [command] --kubeconfig [kubeconfig-file]

E000001: 잘못된 Kubeconfig 파일

제공된 kubeconfig 파일이 일반 파일 모드가 아닙니다.

유효한 kubeconfig 파일을 지정했는지 확인하고 다시 시도하세요.

E000002: Bootstrap.Run 함수가 이미 호출됨

Bootstrap.Run 함수는 로깅 디렉터리와 파일을 초기화하고 필요한 경우 부트스트랩 클러스터를 만들도록 워크플로를 실행합니다.

이 함수는 bmctl 명령어를 실행하는 동안 여러 부트스트랩 클러스터가 생성되지 않도록 한 번만 호출되도록 설계되었습니다.

이 오류는 Bootstrap.Run 함수가 두 번 이상 호출되는 경우 발생하며 이는 의도된 동작이 아닙니다.

기존 bmctl 프로세스가 완료될 때까지 기다린 후 작업을 다시 시도하세요.

E000003: 일치하는 지역 또는 영역을 찾을 수 없음

클러스터 구성 파일의 spec.clusterOperations.location에 제공된 위치가 Google Cloud 프로젝트에 있는지 확인합니다.

다음 명령어를 실행하여 프로젝트의 모든 리전과 영역 목록을 확인할 수 있습니다.

gcloud compute regions list

제공한 리전 또는 영역이 프로젝트에 있는 경우 올바른 대소문자를 사용하고 있는지 확인하세요. 리전과 영역은 대소문자를 구분합니다.

E000004: 잘못된 네임스페이스에 저장된 보안 비밀

예를 들어 반환된 오류 메시지는 다음과 같을 수 있습니다.

The secret 'x' should be stored in the namespace 'y'.
Please remove 'x' from the path "p" in the configuration file of cluster 'c'.

이 문제를 해결하려면 잘못된 네임스페이스에서 참조된 보안 비밀을 클러스터 구성 파일에서 삭제하세요.

E000005: HTTP 상태 코드 불일치

Google Cloud API 또는 Google Container Registry API에 액세스하려고 할 때 예기치 않은 HTTP 상태 코드가 반환됩니다.

해당하는 경우 프록시 URL을 사용하여 프록시 구성이 올바르게 설정되어 있는지 확인합니다.

다음 중 하나를 실행하여 서비스 계정 키가 제공되었는지 확인합니다.

  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 사용자 인증 정보가 포함된 파일의 경로로 설정합니다.

  • 다음 명령어를 실행하여 기본 사용자 인증 정보를 사용하여 Google Cloud로 인증합니다.

    gcloud auth application-default login

자세한 내용은 https://cloud.google.com/docs/authentication#adc를 참고하세요.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

서비스 계정의 역할과 권한을 확인하고 다시 시도하세요. 만들고 구성해야 하는 Google Cloud 리소스에 관한 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa를 참고하세요.

E000006: 관리자 클러스터의 kubeconfig 없이 사용자 클러스터를 관리할 수 없음

관리자 클러스터의 kubeconfig 경로가 없으면 사용자 클러스터를 관리할 수 없습니다. 사용자 클러스터를 관리하려면 관리자 클러스터의 kubeconfig 경로가 필요합니다.

이 오류를 해결하려면 사용자 클러스터를 관리할 때 --kubeconfig 플래그를 사용하여 관리자 클러스터의 kubeconfig 경로를 제공해야 합니다.

이렇게 하면 사용자 클러스터를 관리하는 데 필요한 인증 및 권한이 올바르게 구성됩니다.

E000007: 버전 불일치

클러스터 구성 파일의 spec.anthosBareMetalVersion 아래에 지정된 버전이 클러스터를 관리하는 데 사용되는 bmctl 바이너리 버전과 일치하지 않습니다.

이 오류를 해결하려면 다음 단계를 따르세요.

  • bmctl 바이너리를 클러스터 버전과 일치하는 적절한 버전으로 업데이트합니다.
  • 업그레이드의 경우 클러스터 구성에 지정된 버전을 업데이트하여 bmctl 바이너리 버전을 반영합니다.

E000008: ClusterOperations 구성이 지정되지 않음

클러스터에는 ClusterOperations 구성이 필요합니다.

클러스터 구성 파일의 spec.clusterOperations 아래에 있는 클러스터에 대해 ClusterOperations 구성이 올바르게 정의되어 있는지 확인합니다.

E000009: ClusterOperations에 ProjectID가 지정되지 않음

ClusterOperations 구성에서 ProjectID 필드가 비어 있습니다. 클러스터 작업을 관리하려면 ProjectID가 필요합니다.

클러스터 구성 파일의 spec.clusterOperations.projectID 아래에 ProjectID가 올바르게 정의되어 있는지 확인합니다.

E000010: ClusterOperations의 위치가 지정되지 않음

ClusterOperations 구성에서 위치 필드가 비어 있습니다. 클러스터 작업을 관리하려면 위치가 필요합니다.

클러스터 구성 파일의 spec.clusterOperations.location 아래에 위치가 올바르게 정의되어 있는지 확인합니다.

E000011: 액세스 토큰을 사용하는 동안 서비스 계정을 사용할 수 없음

액세스 토큰을 사용하여 클러스터를 만든 경우 클러스터 구성 파일에 지정된 서비스 계정 키 경로를 삭제해야 합니다.

다음을 확인하세요.

  1. GCP_ACCESS_TOKEN_X 환경 변수가 설정됩니다.
  2. 클러스터 구성 파일에 참조된 서비스 계정 키 경로가 삭제됩니다.

E000012: 액세스 토큰을 사용하는 동안 서비스 계정을 사용할 수 없음

서비스 계정 키를 사용하여 클러스터를 만든 경우 다음 사항을 확인하세요.

  1. 환경 변수 GCP_ACCESS_TOKEN_X가 설정되지 않았습니다.
  2. 필요한 모든 서비스 계정 키 경로가 클러스터 구성 파일에 설정되어 있습니다.

E000013: --force 없이 Google Cloud 사전 검사 실패 우회

--bypass-gcp-preflight-errors 플래그는 --force과 함께 설정해야 합니다.

계속하려면 두 플래그를 함께 사용해야 합니다.

E000014: Docker 컨테이너 런타임이 지원되지 않음

Docker 컨테이너 런타임은 더 이상 지원되지 않습니다.

클러스터 구성 파일의 spec.nodeConfig.containerRuntime 아래에서 컨테이너 런타임을 containerd로 설정합니다.

E000015: 사용 설정되지 않은 API

프로젝트에 일부 필수 API가 사용 설정되지 않았습니다.

계속하려면 프로젝트에 필요한 모든 API가 사용 설정되어 있어야 합니다. 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa를 참고하세요.

E000016: Kubeconfig 파일 통계 오류

제공된 kubeconfig 파일이 존재하지 않거나 액세스할 수 없습니다.

kubeconfig 파일이 있고 bmctl 명령어에 액세스하는 데 필요한 권한이 있는지 확인합니다.

E000017: IPV4 전달이 사용 설정되지 않음

관리자 워크스테이션에서 IPv4 전달이 사용 설정되어 있지 않습니다. IPv4 전달이 사용 설정되어 있어야 합니다.

이 오류를 해결하려면 다음 단계를 따르세요.

  1. /proc/sys/net/ipv4/ip_forward 파일이 있는지 확인합니다.
  2. 다음 명령어를 실행하여 IPv4 전달을 사용 설정합니다.
echo '1' > /proc/sys/net/ipv4/ip_forward

E000018: 구성 파일을 파싱할 수 없음

클러스터의 구성 파일을 파싱할 수 없습니다. 이 문제는 여러 가지 문제로 인해 발생할 수 있습니다.

구성 파일 bmctl-workspace/[cluster-name]/[cluster-name].yaml이 존재하고 bmctl 명령어에 액세스하는 데 필요한 권한이 있는지 확인합니다.

구성 파일에 구문 오류나 누락된 필드가 있는지 확인합니다.

구성 파일을 업데이트해야 하는 경우 올바른 형식과 구조를 따라야 합니다. 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/reference/cluster-config를 참고하세요.

E000019: 컨트롤 플레인 부하 분산기 작업이 완료되지 않음

이는 제어 영역 또는 부하 분산기 작업이 완료되기를 기다리는 동안 오류가 발생했음을 나타냅니다.

클러스터의 컨트롤 플레인 또는 부하 분산기 작업 상태를 확인합니다.

kubectl describe jobs -A

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000020: HTTP 클라이언트를 만들 수 없음

워크스테이션에서 Google Cloud API 및 Container Registry에 연결할 수 있는지 확인하기 위한 HTTP 클라이언트를 만들 수 없습니다.

해당하는 경우 프록시 URL을 사용하여 프록시 구성이 올바르게 설정되어 있는지 확인합니다.

E000021: Google API에 연결할 수 없음

Google Cloud API 또는 Google Container Registry API에 대한 연결을 확인할 수 없습니다.

워크스테이션이 제대로 작동하려면 Google Cloud API 및 Container Registry에 연결할 수 있어야 합니다.

다음 중 하나를 실행하여 서비스 계정 키가 제공되었는지 확인합니다.

  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 사용자 인증 정보가 포함된 파일의 경로로 설정합니다.

  • 다음 명령어를 실행하여 기본 사용자 인증 정보를 사용하여 Google Cloud로 인증합니다.

    gcloud auth application-default login

자세한 내용은 https://cloud.google.com/docs/authentication#adc를 참고하세요.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

서비스 계정의 역할과 권한을 확인하고 다시 시도하세요. 만들고 구성해야 하는 Google Cloud 리소스에 관한 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa를 참고하세요.

E000022: 클러스터 버전을 파싱할 수 없음

클러스터 구성 파일에서 버전을 파싱할 수 없습니다.

이 오류를 해결하려면 클러스터 구성 파일의 spec.anthosBareMetalVersion에 지정된 버전이 유효하고 예상되는 형식을 따르는지 확인하세요.

E000023: GKE 멤버십 클라이언트 오류

GKE 허브 멤버십 등록을 설정하기 위한 클라이언트를 가져올 수 없습니다.

클러스터 구성 파일의 spec.gkeConnect 아래에 GKE 연결이 구성된 경우 GKE 멤버십이 필요합니다.

gcpAccessToken 또는 gkeConnectAgentServiceAccountKeyPath이 클러스터 구성 파일에 지정되어 있는지 확인합니다.

E000024: GKE 등록 확인을 만들 수 없음

새 GKE 등록 확인을 만들 수 없습니다.

이 확인은 다음 사항을 확인하는 데 필수적입니다.

  • GKE Connect 등록이 아직 없습니다.
  • 서비스 계정에 GKE Connect 등록을 변경할 수 있는 충분한 권한이 있습니다.

Google Cloud 콘솔 -> Kubernetes Engine -> 클러스터에 클러스터의 기존 GKE Connect 멤버십이 없는지 확인합니다. 클러스터에 멤버십이 이미 있는 경우 다음 중 하나를 수행합니다.

  • 다른 클러스터 이름을 선택하세요.

  • Google Cloud 콘솔에서 기존 클러스터를 등록 취소하거나 다음을 실행합니다.

    gcloud container hub memberships unregister <CLUSTER_NAME> --gke-cluster=<LOCATION>/<CLUSTER_NAME>

    참조: https://cloud.google.com/sdk/gcloud/reference/container/hub/memberships/unregister

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000025: GKE 등록 확인 실패

이는 GKE 등록 확인을 실행하는 중에 오류가 발생했음을 나타냅니다.

이 검사는 다음을 확인하는 데 필수적입니다.

  • GKE Connect 등록이 아직 없습니다.
  • 서비스 계정에 GKE Connect 등록을 변경할 수 있는 충분한 권한이 있습니다.

Google Cloud 콘솔 -> Kubernetes Engine -> 클러스터에 클러스터의 기존 GKE Connect 멤버십이 없는지 확인합니다. 클러스터에 멤버십이 이미 있는 경우 다음 중 하나를 수행합니다.

  • 다른 클러스터 이름을 선택하세요.

  • Google Cloud 콘솔에서 기존 클러스터를 등록 취소하거나 다음을 실행합니다.

    gcloud container hub memberships unregister <CLUSTER_NAME> --gke-cluster=<LOCATION>/<CLUSTER_NAME>

참조: https://cloud.google.com/sdk/gcloud/reference/container/hub/memberships/unregister

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000026: Google 기본 사용자 인증 정보를 가져올 수 없음

Google 기본 사용자 인증 정보를 가져올 수 없습니다. 자세한 내용은 https://cloud.google.com/docs/authentication/production#automatically을 참고하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000027: Google Cloud 권한 거부됨

이는 Google Cloud API에 대한 요청이 거부되었음을 나타냅니다.

다음 중 하나를 실행하여 서비스 계정 키가 제공되었는지 확인합니다.

  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 사용자 인증 정보가 포함된 파일의 경로로 설정합니다.

  • 다음 명령어를 실행하여 기본 사용자 인증 정보를 사용하여 Google Cloud로 인증합니다.

    gcloud auth application-default login

자세한 내용은 https://cloud.google.com/docs/authentication#adc를 참고하세요.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

서비스 계정의 역할과 권한을 확인하고 다시 시도하세요. 만들고 구성해야 하는 Google Cloud 리소스에 관한 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa를 참고하세요.

E000028: 잘못된 서비스 계정 키

Google 기본 사용자 인증 정보에 사용된 서비스 계정 키가 잘못되었습니다.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000029: Google Cloud 권한이 부족함

권한이 부족하여 Google Cloud API와 통신할 수 없습니다. 원활한 커뮤니케이션을 위해서는 유효한 서비스 계정 키가 필요합니다.

다음 중 하나를 실행하여 서비스 계정 키가 제공되었는지 확인합니다.

  • GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 사용자 인증 정보가 포함된 파일의 경로로 설정합니다.

  • 다음 명령어를 실행하여 기본 사용자 인증 정보를 사용하여 Google Cloud로 인증합니다.

    gcloud auth application-default login

자세한 내용은 https://cloud.google.com/docs/authentication#adc를 참고하세요.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

서비스 계정의 역할과 권한을 확인하고 다시 시도하세요. 만들고 구성해야 하는 Google Cloud 리소스에 관한 자세한 내용은 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa를 참고하세요.

E000030: 컴퓨팅 서비스를 만들 수 없음

클러스터 구성의 spec.clusterOperations.location에 지정된 위치에 대해 검사를 실행하는 데 필요한 Google Cloud 프로젝트에서 영역 또는 위치에 관한 정보를 가져오는 컴퓨팅 서비스를 만들 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000031: 서비스 계정 만들기 확인 불가

서비스 계정 확인을 만들 수 없습니다.

cloudOperationsServiceAccountKeyPath 아래의 클러스터 구성 파일에 지정된 서비스 계정 키 파일은 서비스 계정 확인을 만드는 데 사용됩니다.

서비스 계정 파일이 존재하고 유효한지 확인합니다.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정을 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000032: 서비스 계정 확인 실패

이는 서비스 계정 확인을 실행하는 중에 오류가 발생했음을 나타냅니다.

이 검사는 cloudOperationsServiceAccountKeyPath 아래 클러스터의 구성 파일에 참조된 서비스 계정 키 파일에 대해 유효성 검사를 실행합니다.

다음을 확인하세요.

Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정 키를 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000033: 플래그를 설정할 수 없음

로그 디렉터리 또는 파일에 플래그를 설정할 수 없습니다.

bmctl 명령어는 명령어가 실행되는 동안 로그 디렉터리 또는 파일을 사용하여 로그를 저장합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000034: 디렉터리 생성 실패

디렉터리를 만들 수 없습니다.

이 문제는 일반적으로 디렉터리를 만들 권한이 부족하거나 디렉터리가 생성되는 경로가 존재하지 않기 때문에 발생합니다.

디렉터리를 만들 수 있는 권한이 있고 지정된 위치가 있는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000035: Container Registry 권한 검증 실패

Container Registry 권한 검증을 실행하는 중에 오류가 발생했습니다.

gcrServiceAccountKey 아래의 클러스터 구성 파일에 참조된 서비스 계정 키 파일은 유효성 검사를 실행하는 데 사용됩니다.

서비스 계정 키 파일이 있고 유효한지 확인합니다. Google Cloud 콘솔 -> IAM 및 관리자 -> 서비스 계정에서 서비스 계정 키를 확인합니다. 서비스 계정 키가 만료된 경우 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/how-to/update-secrets에 설명된 안내에 따라 업데이트합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

유효성 검사 실패를 무시하려면 명령어를 실행할 때 --ignore-validation-errors 플래그를 사용하세요.

E000036: 최소 커널 버전 필요

워크스테이션의 최소 커널 버전 검증에 실패했습니다. 워크스테이션이 최소 커널 버전 요구사항을 충족해야 합니다.

커널 버전의 숫자 부분이 4.15.0 이상이어야 합니다. 커널 버전을 확인하려면 다음 명령어를 실행합니다.

uname -r

/proc/version 파일에서도 커널 세부정보를 확인할 수 있습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000037: 서비스 계정 이름을 가져올 수 없음

워크로드 아이덴티티에 필요한 서비스 계정을 가져올 수 없습니다.

클러스터 구성 파일에 다음 중 하나를 제공하여 오류를 수정합니다.

  • spec.gkeConnect.projectID 필드를 Google Cloud 프로젝트 ID로 설정합니다.
  • metadata.annotations 아래의 baremetal.cluster.gke.io/gcr-service-account을 서비스 계정 이름으로 설정합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000038: 부트스트랩 클러스터를 만들 수 없음

부트스트랩 클러스터를 만들 수 없습니다. 부트스트랩 클러스터는 자체 관리형 (관리자, 하이브리드 또는 독립형) 클러스터를 만들거나 업그레이드하는 데 필요한 Kubernetes 컨트롤러를 호스팅하는 임시 클러스터입니다.

부트스트랩 클러스터와 관련된 문제를 해결하려면 https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/troubleshooting/create-upgrade를 참고하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000039: 부트스트랩 클러스터 인터넷 실패

다음 명령어로 부트스트랩 클러스터 인터넷 연결을 확인할 수 없습니다.

docker exec bmctl-control-plane curl https://oauth2.googleapis.com/$discovery/rest

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000040: kubeconfig 파일에서 REST 구성을 만들 수 없음

kubeconfig 파일에서 REST 구성을 만들 수 없습니다. Kubernetes API 서버와 통신하는 방법을 설정하려면 REST 구성이 필요합니다.

제공된 kubeconfig 파일이 존재하고 유효한지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000041: 부트스트랩 클러스터 종속 항목 설치 실패

필요한 모든 리소스를 부트스트랩 클러스터에 적용할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000042: 부트스트랩 클러스터 외부 매니페스트 설치 실패

--addon-manager-manifests-path 플래그를 통해 지정된 디렉터리에서 매니페스트를 설치할 수 없습니다.

제공된 매니페스트 디렉터리가 있고 유효한지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000043: 매니페스트 파일을 추출할 수 없음

매니페스트 파일을 추출할 수 없습니다. 매니페스트 파일은 bmctl 명령어가 호출되는 위치에 생성되는 .manifests 디렉터리에 추출되어야 합니다.

bmctl 명령어가 시스템에서 디렉터리와 파일을 만드는 데 필요한 권한이 있는지, .manifests 디렉터리가 성공적으로 생성되었는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000044: Kubernetes 클라이언트를 만들 수 없음

제공된 kubeconfig 파일을 사용하여 클러스터의 Kubernetes 클라이언트를 만들 수 없습니다.

kubeconfig 파일이 존재하고 유효한지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000045: 클러스터 매니페스트 프로필을 로드할 수 없음

로딩 프로세스는 프로필 구성의 항목을 KusBuild로 변환하고 클러스터 커스텀 리소스의 값으로 매개변수를 설정합니다. 프로필 위치는 매니페스트의 루트 디렉터리, 프로필 이름, 환경에 따라 결정됩니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000046: 워크로드 아이덴티티를 설정할 수 없음

프로젝트의 워크로드 아이덴티티를 설정할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000047: 디버그 옵션을 만들거나 업데이트할 수 없음

bmctl 명령어에 제공된 플래그와 클러스터 구성 파일의 상단 섹션을 기반으로 부트스트랩 클러스터에서 디버그 옵션 ConfigMap을 만들거나 업데이트할 수 없습니다.

이 ConfigMap은 디버깅 목적으로 필요하며 관련 구성 데이터를 포함합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000048: 사용량 서비스를 만들 수 없음

서비스 사용량을 만들 수 없습니다. 이 서비스는 필수 API가 사용 설정되었는지 확인하는 등의 작업에 필요한 Google Cloud 서비스 사용량 API에 액세스하는 데 필수적입니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000049: API 사용 설정 확인 실패

이는 API 사용 설정 확인을 실행하는 중에 오류가 발생했음을 나타냅니다. 이렇게 하면 프로젝트에서 필요한 모든 API가 사용 설정됩니다(https://cloud.google.com/anthos/clusters/docs/bare-metal/latest/installing/configure-sa 참고).

API 사용 설정 확인 실패를 우회하려면 --skip-api-check 플래그를 사용하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000050: 객체 작업을 수행할 수 없음

이는 Kubernetes 또는 맞춤 객체에서 Get, Patch, List, Update, Delete 또는 Apply 작업을 실행하는 중에 오류가 발생했음을 나타냅니다.

Kubernetes 클러스터에 액세스할 수 있고 API 서버가 응답하는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000051: 객체를 마샬링할 수 없음

객체를 YAML 형식으로 마샬링할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000052: 서비스 계정에서 보안 비밀을 생성할 수 없음

클러스터 구성 파일의 gkeRegisterServiceAccountKey 아래에 지정된 서비스 계정 키 경로에서 네임스페이스 gke-register에 저장할 보안 비밀 gkeRegisterServiceAccountKey을 생성할 수 없습니다.

지정된 보안 비밀 파일이 있는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000053: 클러스터 구성 파일을 읽을 수 없음

클러스터 구성 파일을 읽을 수 없습니다.

클러스터 구성 파일이 존재하고 bmctl 명령어에 액세스하는 데 필요한 권한이 있는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000054: 사전 비행 종속성 리소스를 적용할 수 없음

실행 전 검사 명령어 종속 항목을 적용할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000055: Google Cloud 사전 점검 실패

Google Cloud 프리플라이트 검사에 실패했습니다. 자세한 내용은 실행 전 검사 리소스를 확인하세요.

프리플라이트 검사 리소스를 확인합니다.

kubectl describe preflightcheck -A

Google Cloud 프리플라이트 검사 실패를 우회하려면 --bypass-gcp-preflight-errors 및 --force 플래그를 사용하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000056: 실행 전 검사 실패

프리플라이트 검사에 실패했습니다. 자세한 내용은 실행 전 검사 리소스를 확인하세요.

프리플라이트 검사 리소스를 확인합니다.

kubectl describe preflightcheck -A

프리플라이트 검사 실패를 우회하려면 --force 플래그를 사용하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000057: 실행 전 검사 상태를 확인할 수 없음

실행 전 검사 리소스의 상태를 확인할 수 없습니다.

자세한 내용은 프리플라이트 검사 리소스를 확인하세요.

kubectl describe preflightcheck -A

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000058: Kubeconfig 보안 비밀이 준비되지 않음

이는 kubeconfig 보안 비밀을 읽거나 준비될 때까지 기다리는 중에 오류가 발생했음을 나타냅니다.

보안 비밀 <CLUSTER_NAME>-kubeconfig이 부트스트랩 클러스터 내의 클러스터 네임스페이스에 있고 경로 .data이 비어 있지 않은지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000059: kubeconfig 파일을 쓸 수 없음

kubeconfig 파일을 bmctl-workspace/<CLUSTER_NAME>/<CLUSTER_NAME>-kubeconfig 경로에 쓸 수 없습니다.

bmctl 명령어에 kubeconfig 파일의 디렉터리에 쓸 수 있는 필요한 권한이 있는지 확인합니다.

bmctl reset 명령어를 실행한 후 클러스터를 다시 만들어 이 문제를 해결해 보세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000060: 클러스터가 준비되지 않음

이는 클러스터가 준비될 때까지 기다리는 동안 오류가 발생했음을 나타냅니다.

클러스터 상태를 확인하여 자세한 내용을 확인하세요.

kubectl describe cluster <CLUSTER_NAME> -A

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000061: NodePool이 준비되지 않음

이는 노드 풀이 준비될 때까지 기다리는 동안 오류가 발생했음을 나타냅니다.

노드 풀의 상태를 확인합니다.

kubectl describe nodepool -A

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000062: SecretForwarder가 준비되지 않음

SecretForwarder가 준비될 때까지 기다리는 동안 오류가 발생했음을 나타냅니다.

SecretForwarder의 상태를 확인합니다.

kubectl describe secretforwarder -A

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000063: 구조화되지 않은 객체를 구체적인 유형으로 변환할 수 없음

구조화되지 않은 객체를 구체적인 유형으로 변환할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000064: 클러스터 API 제공자 설치 실패

관리자 클러스터에서 클러스터 API 제공자의 설치를 확인할 수 없습니다.

문제를 해결하려면 부트스트랩 클러스터에 로그인하여 lifecycle-controllers-deployer 작업 및 lifecycle-controller-manager 포드 로그를 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000065: 피벗할 수 없음

부트스트랩 클러스터에서 실제 클러스터로 리소스를 피벗할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000066: 리소스를 적용할 수 없음

리소스를 적용하는 중에 오류가 발생했음을 나타냅니다. 이 리소스는 클러스터 구성 파일에 지정된 고객 리소스일 수 있습니다.

고객이 지정한 모든 리소스의 형식이 올바르고 유효한지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000067: 명령어를 만들 수 없음

bmctl 내부 명령어가 사용할 지정된 플래그로 자리표시자 명령어를 만들 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000068: GKE 버전을 가져올 수 없음

클러스터 구성 파일에서 spec.anthosBareMetalVersion로 지정된 클러스터 버전을 기반으로 GKE 버전을 가져올 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000069: 클러스터가 이미 타겟 버전임

이는 클러스터가 이미 타겟 버전에 있음을 나타냅니다. 클러스터 구성 파일의 spec.anthosBareMetalVersion에 지정된 버전이 현재 클러스터 버전보다 큰지 확인하고 다시 시도하세요.

E000070: 클러스터 및 NodePool이 이미 타겟 버전임

이는 클러스터와 노드 풀이 이미 타겟 버전에 있음을 나타냅니다. 클러스터 구성 파일의 spec.anthosBareMetalVersion에 지정된 버전이 현재 버전보다 큰지 확인한 후 다시 시도하세요.

E000071: CIDR의 IP 주소가 충분하지 않음

이는 부트스트랩 클러스터 포드 CIDR 범위에 노드를 수용할 IP 주소가 충분하지 않음을 나타냅니다.

노드에 충분한 IP 주소가 있는 --bootstrap-cluster-pod-cidr 플래그를 사용하여 CIDR 범위를 제공해야 합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000072: 미리보기 기능 업그레이드 정책 검증 실패

클러스터에 지정된 지원되는 사용 설정된 미리보기 기능이 업그레이드 요구사항을 충족하는지 확인할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000073: 부트스트랩을 GKE Connect 멤버십에 등록할 수 없음

부트스트랩 클러스터를 GKE 허브 멤버십에 등록할 수 없습니다.

Google Cloud 콘솔 -> Kubernetes Engine -> 프로젝트의 클러스터에 부트스트랩 클러스터 이름 (기본적으로 선택되거나 --bootstrap-cluster 플래그로 제공됨)에 대한 기존 GKE 연결 멤버십이 없는지 확인합니다.

클러스터 이름으로 멤버십이 이미 있는 경우 다음 중 하나를 수행합니다.

  • --bootstrap-cluster 플래그를 사용하여 다른 이름을 제공합니다.

  • Google Cloud 콘솔에서 기존 클러스터를 등록 취소하거나 다음을 실행합니다.

    gcloud container hub memberships unregister <CLUSTER_NAME>

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000074: 서비스 계정에서 보안 비밀을 만들 수 없음

클러스터 구성 파일에 지정된 서비스 계정 파일을 사용하여 보안 비밀을 만들 수 없습니다.

파일이 존재하고 액세스할 수 있는지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000075: GKE Hub URL을 가져올 수 없음

GKE 허브 엔드포인트 URL을 추출할 수 없습니다.GKE 허브 엔드포인트는 GKE 허브 API 요청에 사용되는 URL 엔드포인트입니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000076: 업그레이드가 완료되지 않음

업그레이드가 완료될 때까지 기다리는 중에 오류가 발생했습니다. 업그레이드가 완료된 것으로 간주되려면 클러스터와 노드 풀이 타겟 버전이어야 합니다.

노드 풀과 클러스터의 상태를 확인합니다.

kubectl describe nodepool -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>

kubectl describe cluster -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000077: 워크로드 아이덴티티 Stackdriver 보안 비밀을 만들 수 없음

워크로드 아이덴티티 Stackdriver 보안 비밀을 만들 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000078: 노드 풀 버전을 올릴 수 없음

NodePool 리소스 현재 버전을 타겟 버전으로 올릴 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000079: 클러스터 버전을 올릴 수 없음

클러스터 리소스 현재 버전을 타겟 버전으로 올릴 수 없습니다.

타겟 버전이 현재 버전보다 높고 유효한지 확인합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000080: kubeconfig 보안 비밀을 업데이트할 수 없음

클러스터의 kubeconfig 보안 비밀을 업데이트할 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000081: 보안 비밀 키 누락

이는 보안 비밀 리소스에 특정 키가 포함되어 있지 않음을 나타냅니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 오류를 검토하세요.

E000082: 업그레이드 결과를 인쇄할 수 없음

클러스터 업그레이드 결과를 출력할 수 없습니다.

업그레이드에 실패한 노드의 BaremetalMachine 리소스를 확인합니다.

kubectl describe baremetalmachines -n <NAMESPACE> --kubeconfig <KUBECONFIG_FILE>

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000083: GKEConnect 사양이 누락됨

클러스터 구성에 GKEConnect 사양이 지정되지 않았습니다.

클러스터 구성 파일에 spec.gkeConnect 필드가 제공되어 있는지 확인합니다.

E000084: 연결 에이전트 연결 확인을 만들 수 없음

새 Connect Agent 연결 확인을 만들 수 없습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 오류를 검토하세요.

E000085: Connect Agent 연결 확인 실패

Connect Agent 연결 확인을 실행하는 중에 오류가 발생했습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 오류를 검토하세요.

E000086: Group Version Kind를 사용하여 맞춤 리소스를 가져올 수 없음

이는 GroupVersionKind를 사용하여 커스텀 리소스를 가져오는 중에 오류가 발생했음을 나타냅니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000087: 비공개 레지스트리에서 비공개 레지스트리 구성을 생성할 수 없음

클러스터 구성 파일의 privateRegistries 아래에 지정된 클러스터 사용자 인증 정보 설정을 기반으로 레지스트리 구성을 생성할 수 없습니다.

클러스터 구성 파일의 privateRegistries에 제공된 구성이 유효한지 확인하고 다시 시도하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000088: 레지스트리 미러에서 비공개 레지스트리 구성을 생성할 수 없음

클러스터 구성 파일의 registryMirrors 아래에 지정된 클러스터 사용자 인증 정보 설정을 기반으로 레지스트리 구성을 생성할 수 없습니다.

클러스터 구성 파일의 registryMirrors에 제공된 구성이 유효한지 확인하고 다시 시도하세요.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000089: 노드 액세스를 업데이트할 수 없음

이는 노드 액세스를 업데이트하는 중에 오류가 발생했음을 나타냅니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000090: bmctl 업데이트에서 차이를 계산할 수 없음

이는 bmctl update 명령어 실행 중에 YAML 클러스터 구성 파일과 클러스터의 라이브 구성 간 차이를 계산하는 동안 오류가 발생했음을 나타냅니다.

해결 방법으로 bmctl get config을 실행하여 클러스터에서 라이브 구성을 가져오고 bmctl 외부에서 YAML 클러스터 구성 파일과 수동으로 차이를 확인할 수 있습니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000091: 콘솔 프롬프트에 잘못된 입력

콘솔 프롬프트에 잘못된 입력이 제공되었습니다.

yes 또는 no을 입력합니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E000092: 클러스터별 네임스페이스를 만들 수 없음

클러스터 생성의 첫 번째 단계 중 하나로 새 클러스터에 특정한 네임스페이스를 만듭니다. 이 네임스페이스에 저장된 새 클러스터의 거의 모든 리소스

이 오류는 새 네임스페이스를 만들거나 단순히 네임스페이스가 있는지 확인하여 이러한 클러스터별 네임스페이스가 있는지 확인하려는 시도가 실패했음을 나타냅니다.

특정 오류에 대한 자세한 내용은 명령어에서 반환된 래핑된 오류를 검토하세요.

E300000: 분리된 컨테이너가 감지됨

이는 노드 문제 감지기를 통해 노드에서 고아 컨테이너가 감지되었음을 나타냅니다.

고아 컨테이너는 더 이상 활성 상태로 실행되거나 작동하지 않지만 부분적으로 정리되거나 일관되지 않은 상태로 계속 유지되는 컨테이너 프로세스를 의미합니다.

전체 로그를 보려면 문제가 있는 노드에서 다음을 실행하세요.

journalctl -u node-problem-detector

오류 메시지의 고아 컨테이너 세부정보를 사용하여 컨테이너 ID를 가져옵니다.

다음 명령어를 사용하여 노드에서 고아 컨테이너를 삭제합니다.

crictl stop <container-id>

crictl rm <container-id>

위 명령어로 고아 컨테이너가 삭제되지 않으면 각 컨테이너의 프로세스를 중지해야 합니다. 다음 명령어를 사용하여 각 컨테이너의 프로세스 ID 또는 PID를 검색하고 중지할 수 있습니다.

crictl inspect <container-id> | grep pid

kill -9 <pid>

다음 단계

수정 조치 가이드를 따랐는데도 오류가 계속되면 기술 지원팀에 문의하세요.

클러스터 문제 해결에 대한 자세한 내용은 다음 리소스를 참고하세요.

Google Distributed Cloud

Google Distributed Cloud