VM의 확장 프로그램 세부정보 및 상태 보기

읽기 전용 확장 프로그램 상태 list 및 get 메서드를 사용하여 각 머신에 연결하지 않고도 각 VM 인스턴스에 설치된 확장 프로그램의 런타임 상태를 확인합니다. 확장 프로그램 정책을 사용하면 한 VM에 서로 다른 정책에 의해 설치된 여러 확장 프로그램이 있을 수 있습니다. 확장 프로그램 상태 메서드를 사용하면 설치된 각 확장 프로그램의 최종 유효 구성 및 관리 정책을 확인하고 예기치 않은 확장 프로그램이 설치되거나 인스턴스에서 확장 프로그램이 실패할 때 문제를 해결할 수 있습니다.

확장 프로그램 세부정보 및 상태 정보

조직, 폴더 또는 프로젝트 수준에서 전역 또는 영역 확장 프로그램 정책을 만들어 VM에 VM 확장 프로그램을 설치합니다. 단일 정책으로 단일 VM에 여러 확장 프로그램을 설치할 수 있으며 리소스 계층 구조 전반의 여러 정책을 동일한 VM에 적용할 수 있습니다.

읽기 전용 확장 프로그램 상태 메서드를 사용하면 VM에 있는 모든 확장 프로그램의 상태를 나열하여 설치된 모든 확장 프로그램의 최종 유효 구성 및 런타임 상태를 확인할 수 있습니다. 반환된 정보에는 각 확장 프로그램의 활성 버전, 시행 상태, 상태, 관리 정책의 식별자가 표시됩니다.

VM 확장 프로그램 및 버전 보기

Google Cloud CLI 또는 Compute Engine API를 사용하여 설치된 VM 확장 프로그램에 대한 세부정보를 볼 수 있습니다. 이 문서에서는 gcloud를 사용하는 방법을 설명합니다. Compute Engine API를 사용하여 확장 프로그램 상태를 보는 방법에 대한 자세한 내용은 인스턴스에서 MV 확장 프로그램 상태 보기를 참조하세요.

확장 프로그램 세부정보를 보는 데 필요한 IAM 권한

프로젝트, 폴더 또는 조직 수준에서 설치된 확장 프로그램 및 해당 버전에 대한 정보를 보는 데 필요한 역할을 보려면 다음 수준 중 하나를 선택합니다.

프로젝트

프로젝트 수준에서 영역 또는 전역 VM 확장 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute VM 확장 정책 뷰어(roles/compute.vmExtensionPolicyViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 프로젝트 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

프로젝트 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보려면 다음 권한이 필요합니다.

  • 인스턴스의 특정 VM 확장 프로그램 설명: compute.vmExtensions.get
  • 인스턴스의 모든 VM 확장 프로그램 나열: compute.vmExtensions.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

폴더

폴더 수준 확장 프로그램 정책은 프리뷰로 제공됩니다.

폴더 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 폴더에 대한 폴더 수준 Compute VM 확장 프로그램 정책 뷰어(roles/compute.folderVmExtensionPolicyViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 폴더 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

폴더 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보려면 다음 권한이 필요합니다.

  • 인스턴스의 특정 VM 확장 프로그램 설명: compute.folderVmExtensions.get
  • 인스턴스의 모든 VM 확장 프로그램 나열: compute.folderVmExtensions.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

조직

조직 수준 확장 프로그램 정책은 프리뷰에서 사용할 수 있습니다.

조직 수준에서 영역 또는 전역 VM 확장 정책을 보는 데 필요한 권한을 얻으려면 관리자에게 조직에 대한 조직 수준 Compute VM 확장 정책 뷰어(roles/compute.orgVmExtensionPolicyViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 조직 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

조직 수준에서 영역 또는 전역 VM 확장 프로그램 정책을 보려면 다음 권한이 필요합니다.

  • 인스턴스의 특정 VM 확장 프로그램 설명: compute.orgVmExtensions.get
  • 인스턴스의 모든 VM 확장 프로그램 나열: compute.orgVmExtensions.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

Compute Engine의 IAM 역할 및 권한에 대한 자세한 내용은 Compute Engine 역할 및 권한을 참조하세요.

VM 확장 프로그램 및 버전 나열

프로젝트, 폴더 또는 조직에서 영역 간에 또는 전역적으로 VM 확장 프로그램 관리자가 관리하는 VM 확장 프로그램 및 버전을 나열하려면 다음 옵션 중 하나를 선택합니다.

영역

gcloud preview compute zone-vm-extension-policies extensions list 명령어를 사용하여 프로젝트, 폴더 또는 조직 내 영역의 VM 확장 프로그램을 나열합니다.

프로젝트 수준

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

명령어에서 다음 변수를 바꿉니다.

  • PROJECT_ID: 프로젝트 식별자
  • ZONE: 대상 영역(예: us-central1-f)
폴더 및 조직 수준

폴더 또는 조직 수준에서 이전 작업을 수행하려면 다음 변경사항 중 하나를 사용하여 동일한 명령어를 사용합니다.

  • 폴더 수준 정보의 경우 --project=PROJECT_ID 옵션을 --folder=folders/FOLDER_ID로 바꿉니다. 여기서 FOLDER_ID는 폴더의 숫자 ID입니다.
  • 조직 수준 정보의 경우 --project=PROJECT_ID 옵션을 --organization=organizations/ORGANIZATION_ID로 바꿉니다. 여기서 ORGANIZATION_ID는 조직의 숫자 ID입니다.

전역

gcloud preview compute global-vm-extension-policies extensions list 명령어를 사용하여 프로젝트, 폴더 또는 조직 내 모든 영역의 VM 확장 프로그램을 나열합니다.

프로젝트 수준

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

명령어에서 다음 변수를 바꿉니다.

  • PROJECT_ID: 프로젝트 식별자
폴더 및 조직 수준

폴더 또는 조직 수준에서 이전 작업을 수행하려면 다음 변경사항 중 하나를 사용하여 동일한 명령어를 사용합니다.

  • 폴더 수준 정보의 경우 --project=PROJECT_ID 옵션을 --folder=folders/FOLDER_ID로 바꿉니다. 여기서 FOLDER_ID는 폴더의 숫자 ID입니다.
  • 조직 수준 정보의 경우 --project=PROJECT_ID 옵션을 --organization=organizations/ORGANIZATION_ID로 바꿉니다. 여기서 ORGANIZATION_ID는 조직의 숫자 ID입니다.

특정 VM 확장 프로그램에 대한 정보 보기

프로젝트, 폴더 또는 조직에서 단일 영역 또는 전역적으로 특정 VM 확장 프로그램의 세부정보를 보려면 다음 옵션 중 하나를 선택합니다.

영역

gcloud preview compute zone-vm-extension-policies extensions describe 명령어를 사용하여 프로젝트, 폴더 또는 조직 내 영역에 있는 특정 VM 확장 프로그램의 세부정보를 확인합니다.

프로젝트 수준

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

명령어에서 다음 변수를 바꿉니다.

  • EXTENSION_NAME: VM 확장 프로그램 관리자 지원되는 확장 프로그램 중 하나입니다(예: ops-agent).
  • PROJECT_ID: 프로젝트 식별자
  • ZONE: 대상 영역(예: us-central1-f)
폴더 및 조직 수준

폴더 또는 조직 수준에서 이전 작업을 수행하려면 다음 변경사항 중 하나를 사용하여 동일한 명령어를 사용합니다.

  • 폴더 수준 정보의 경우 --project=PROJECT_ID 옵션을 --folder=folders/FOLDER_ID로 바꿉니다. 여기서 FOLDER_ID는 폴더의 숫자 ID입니다.
  • 조직 수준 정보의 경우 --project=PROJECT_ID 옵션을 --organization=organizations/ORGANIZATION_ID로 바꿉니다. 여기서 ORGANIZATION_ID는 조직의 숫자 ID입니다.

전역

gcloud preview compute global-vm-extension-policies extensions describe 명령어를 사용하여 프로젝트, 폴더 또는 조직 내 모든 영역에서 특정 VM 확장 프로그램의 세부정보를 확인합니다.

프로젝트 수준

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

명령어에서 다음 변수를 바꿉니다.

폴더 및 조직 수준

폴더 또는 조직 수준에서 이전 작업을 수행하려면 다음 변경사항 중 하나를 사용하여 동일한 명령어를 사용합니다.

  • 폴더 수준 정보의 경우 --project=PROJECT_ID 옵션을 --folder=folders/FOLDER_ID로 바꿉니다. 여기서 FOLDER_ID는 폴더의 숫자 ID입니다.
  • 조직 수준 정보의 경우 --project=PROJECT_ID 옵션을 --organization=organizations/ORGANIZATION_ID로 바꿉니다. 여기서 ORGANIZATION_ID는 조직의 숫자 ID입니다.

인스턴스에서 VM 확장 프로그램 상태 보기

확장 프로그램 정책은 단일 VM에 여러 확장 프로그램을 설치할 수 있습니다. 유효한 구성, 런타임 상태, 기타 정보를 포함하여 각 확장 프로그램의 상태를 확인하려면 특정 VM에서 확장 프로그램의 상태를 검사하면 됩니다.

확장 프로그램 상태 메서드는 VM 확장 프로그램 관리자 정책에 의해 설치되고 관리되는 운영 에이전트 인스턴스에 대한 정보만 반환합니다. 일부 VM에서 다른 방법으로 설치된 에이전트를 실행하는 경우 해당 에이전트에 대해 보고할 확장 프로그램 정보가 없습니다.

Google Cloud CLI 또는 Compute Engine API를 사용하여 VM에 설치된 확장 프로그램의 상태를 볼 수 있습니다. 이 문서에서는 gcloud를 사용하는 방법을 설명합니다. Compute Engine API를 사용하여 확장 프로그램 상태를 보는 방법에 대한 자세한 내용은 인스턴스에서 MV 확장 프로그램 상태 보기를 참조하세요.

확장 프로그램 상태를 보는 데 필요한 IAM 권한

인스턴스에서 VM 확장 프로그램 상태를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 뷰어(roles/compute.viewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 인스턴스에서 VM 확장 프로그램 상태를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

인스턴스에서 VM 확장 프로그램 상태를 보려면 다음 권한이 필요합니다.

  • 인스턴스의 모든 VM 확장 프로그램 상태를 나열합니다. compute.instances.listVmExtensionStates
  • 인스턴스에서 특정 VM 확장 프로그램의 상태 가져오기: compute.instances.getVmExtensionState

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

VM 인스턴스에 설치된 확장 프로그램 나열

gcloud를 사용하여 인스턴스에 설치된 모든 VM 확장 프로그램을 나열하고 현재 상태를 보려면 gcloud beta compute instances list-vm-extension-states 명령어를 실행합니다.

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

명령어에서 다음 변수를 바꿉니다.

  • INSTANCE_NAME: VM 인스턴스 이름입니다.
  • PROJECT_ID: 프로젝트 식별자
  • ZONE: 인스턴스가 있는 영역입니다(예: us-central1-f).

이 명령어는 설치된 각 확장 프로그램의 이름, 시행 상태, 정상 상태를 반환합니다. 확장 프로그램 상태를 볼 때 반환되는 값에 대한 자세한 내용은 VM 확장 프로그램 상태 필드 해석을 참조하세요.

Compute Engine API 사용에 대한 정보를 포함하여 VM의 확장 프로그램 상태에 대한 정보를 보는 방법에 대한 자세한 내용은 인스턴스에서 MV 확장 프로그램 상태 보기를 참조하세요.

인스턴스에서 특정 VM 확장 프로그램의 상태 보기

gcloud를 사용하여 VM에 설치된 특정 VM 확장 프로그램의 상태 정보를 가져오려면 gcloud beta compute instances get-vm-extension-state 명령어를 실행합니다.

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

명령어에서 다음 변수를 바꿉니다.

  • INSTANCE_NAME: VM 인스턴스 이름입니다.
  • PROJECT_ID: 프로젝트 식별자
  • ZONE: 인스턴스가 있는 영역입니다(예: us-central1-f).
  • EXTENSION_NAME: VM 확장 프로그램 관리자 지원되는 확장 프로그램 중 하나입니다(예: ops-agent).

이 명령어는 확장 프로그램의 이름, 활성 버전, 상태 정보, 시행 정보, 관리 정책 ID를 반환합니다. 확장 프로그램 상태를 볼 때 반환되는 값에 대한 자세한 내용은 VM 확장 프로그램 상태 필드 해석을 참조하세요.

Compute Engine API 사용에 대한 정보를 포함하여 VM의 확장 프로그램 상태에 대한 정보를 보는 방법에 대한 자세한 내용은 인스턴스에서 MV 확장 프로그램 상태 보기를 참조하세요.

다음 단계