VM 확장 프로그램 관리자 정책을 사용하여 운영 에이전트 설치

VM 확장 프로그램 관리자 정책을 사용하면 Compute Engine VM Fleet에 운영 에이전트를 설치할 수 있습니다. 확장 프로그램 정책은 Google Cloud 프로젝트 전체 또는 특정 영역 내에 전역적으로 운영 에이전트를 설치하고, 에이전트 버전을 업데이트된 상태로 유지하고, 에이전트에 커스텀 구성을 적용할 수 있습니다.

시작하기 전에

운영 에이전트를 관리하기 위해 VM 확장 프로그램 관리자 확장 프로그램 정책을 만들기 전에 다음을 수행합니다.

• VM 확장 프로그램 관리자에 대한 일반 정보 검토

• 지원되는 운영체제를 검토하여 운영 에이전트와 VM 확장 프로그램 관리자가 모두 운영체제에서 지원되는지 확인합니다.

• VM에 이미 설치된 모니터링 가능성 에이전트를 삭제합니다.

• 운영 에이전트 및 VM 확장 프로그램 관리자에서 사용하는 API를 사용 설정합니다.

• 운영 에이전트에서 사용하는 역할 부여

• VM 확장 프로그램 관리자를 사용하는 데 필요한 역할을 부여합니다.

• 명령줄 인터페이스를 사용하여 확장 프로그램 정책을 만들고 관리하려면 Google Cloud CLI를 설치합니다.

  Google Cloud 콘솔 또는 Google Cloud CLI, gcloud를 사용하여 영역 VM 확장 프로그램 정책을 만들고 관리할 수 있습니다. gcloud를 사용하여 전역 VM 확장 프로그램 정책을 만들고 관리합니다.

기존 모니터링 가능성 에이전트 삭제

운영 에이전트의 VM 확장 프로그램 관리자 정책을 만들기 전에 VM에 운영 에이전트 또는 기존 Monitoring 에이전트 및 Logging 에이전트의 인스턴스가 없는지 확인합니다. 같은 VM에서 운영 에이전트와 기존 에이전트가 실행되면 중복 로그가 수집되거나 측정항목 수집 시 충돌이 발생할 수 있습니다.

확장 프로그램 정책을 사용하여 다른 모니터링 가능성 에이전트가 이미 설치된 VM에 운영 에이전트를 설치하면 정책에서 에이전트를 설치하지만 충돌이 감지되어 에이전트가 실행되지 않습니다.

기존 에이전트를 삭제하는 방법은 에이전트가 설치된 방식에 따라 다릅니다.

• 다음을 포함하는 VM Manager OS 구성 정책에 의해 설치된 에이전트:

  • VM 생성 중에Google Cloud 콘솔을 사용하여 설치된 운영 에이전트
  • GA VM Manager OS 구성 정책에 의해 설치된 운영 에이전트
  • 베타 VM Manager OS 구성 정책에 의해 설치된 운영 에이전트 또는 기존 Monitoring 에이전트 또는 Logging 에이전트

  이러한 정책을 사용하여 VM을 식별하는 방법에 대한 자세한 내용은 운영 에이전트 OS 정책이 적용되는 VM 찾기를 참조하세요.

  에이전트 제거 및 OS 구성 정책 삭제에 대한 자세한 내용은 운영 에이전트 OS 정책이 적용되는 VM에서 운영 에이전트 제거를 참조하세요.

• 설치 스크립트를 사용하여 수동으로 설치된 에이전트 에이전트 제거에 대한 자세한 내용은 다음을 참조하세요.

  • 운영 에이전트: 에이전트를 제거합니다.
  • 기존 Monitoring 에이전트: 에이전트를 제거합니다.
  • 기존 Logging 에이전트: 에이전트를 제거합니다.

운영 에이전트를 사용하는 데 필요한 API 사용 설정

운영 에이전트를 사용하여 로그 및 측정항목을 작성하려면 Google Cloud 프로젝트에서 Cloud Logging API 및 Cloud Monitoring API를 사용 설정해야 합니다.

API 사용 설정에 필요한 역할

API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않으면 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할 부여 방법 알아보기

API 사용 설정

운영 에이전트를 사용하는 데 필요한 역할 부여

운영 에이전트를 사용하여 로그 및 측정항목을 작성하는 데 필요한 권한을 얻으려면 관리자에게 서비스 계정에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• 로그 작성: Logging 로그 작성자 (roles/logging.logWriter)
• 측정항목을 작성하려면 모니터링 측정항목 작성자 (roles/monitoring.metricWriter) 역할이 필요합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

역할 및 운영 에이전트에 대한 자세한 내용은 운영 에이전트 승인을 참조하세요.

VM 확장 프로그램 관리자에서 사용하는 API 사용 설정

VM 확장 프로그램 관리자는 Compute Engine API를 사용합니다. Google Cloud 프로젝트에서 이 API가 아직 사용 설정되지 않았으면 사용 설정합니다.

Compute Engine API 사용 설정

VM 확장 프로그램 관리자를 사용하는 데 필요한 역할 부여

VM 확장 정책을 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

• 확장 프로그램 정책을 만들려면 VM 확장 프로그램 정책 관리자 (roles/compute.vmExtensionPolicyAdmin) 역할이 필요합니다.

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 VM 확장 정책을 만드는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

VM 확장 프로그램 정책을 만들려면 다음 권한이 필요합니다.

• 확장 프로그램 정책을 만들려면 다음 권한이 필요합니다. compute.vmExtensionPolicies.create

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

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

Google Cloud CLI 설치

Google Cloud 콘솔 또는 Google Cloud CLI, gcloud를 사용하여 VM 확장 프로그램 정책을 만들고 관리할 수 있습니다. gcloud를 사용하려면 먼저 Google Cloud CLI를 설치해야 합니다.

설치한 구성요소를 보려면 다음 명령어를 실행합니다.

gcloud components list

최신 버전이 있는지 확인하려면 다음 명령어를 실행합니다.

gcloud components update

정책 충돌 및 우선순위

VM 확장 프로그램 관리자는 각 새 정책에 우선순위를 연결하며, 숫자가 작을수록 우선순위가 높습니다. 기본 우선순위는 1000입니다. VM은 운영 에이전트와 같은 확장 프로그램에 대해 여러 정책이 적용될 수 있지만 운영 에이전트 확장 프로그램에 대한 정책은 하나만 VM에 적용됩니다.

VM 확장 프로그램 관리자는 우선순위를 사용하여 VM에 적용된 정책 간의 충돌을 해결합니다. 해결 프로세스에 대한 자세한 내용은 정책 우선순위 및 충돌 해결을 참조하세요.

전역 정책의 정책 출시 계획

VM 확장 프로그램 관리자 전역 정책은 출시 계획을 사용하여 정책이 대상 VM에 배포되는 방식을 결정합니다. 출시 계획에는 두 가지 유형이 있습니다.

• 사전 정의된 출시 계획. 사전 정의된 출시 계획은 두 가지가 있으며, gcloud CLI 명령어의 --rollout-predefined-plan 옵션과 함께 사용되는 값으로 선택됩니다.

  • 느린 출시: 일정 기간 동안 여러 영역에 운영 에이전트를 점진적으로 배포합니다. 이 출시 계획을 권장합니다.

    --rollout-predefined-plan=slow_rollout 옵션을 사용하여 이 출시 계획을 지정합니다.

  • 빠른 출시: 모든 영역 및 리전의 모든 타겟팅된 VM에 운영 에이전트를 즉시 배포합니다.

    --rollout-predefined-plan=fast_rollout 옵션을 사용하여 이 출시 계획을 지정합니다.

• gcloud CLI 명령어에 --rollout-custom-plan 옵션을 사용하여 지정된 커스텀 출시 계획

  Google Cloud 프로젝트의 출시 계획 집합에 추가하여 커스텀 출시 계획을 만듭니다. 자세한 내용은 Compute Engine API 메서드 rolloutPlans.insert를 참조하세요.

출시 계획에 대한 자세한 내용은 전역 정책 출시 계획을 참조하세요.

운영 에이전트를 설치하는 VM 확장 프로그램 정책 만들기

VM 확장 프로그램 관리자를 사용하면 VM에 설치할 확장 프로그램을 선언하는 정책을 만들 수 있습니다. 운영 에이전트는 사용 가능한 확장 프로그램 중 하나입니다. 정책을 정의하면 운영 에이전트를 포함하여 지원되는 확장 프로그램이 VM 라벨과 같이 지정한 기준과 일치하는 모든 VM에 설치되고 유지관리되도록 할 수 있습니다.

운영 에이전트의 확장 프로그램 정책을 사용하여 다음과 같은 작업을 수행할 수 있습니다.

• Fleet 전체 설치: 다음에 운영 에이전트를 설치합니다.

  • Google Cloud 프로젝트의 하나 이상의 영역에 있는 모든 VM
  • 전역의 모든 VM ( Google Cloud 프로젝트)
  • 라벨로 식별되는 영역의 VM 하위 집합입니다.
  • 라벨로 식별되는 Google Cloud 프로젝트의 영역 간 VM 하위 집합입니다.

• 버전 제어:

  • 운영 에이전트를 최신 버전으로 업데이트합니다.
  • 운영 에이전트 버전을 특정 출시 버전에 고정합니다.

• 구성 관리: 정책으로 관리되는 모든 VM의 운영 에이전트에 커스텀 구성을 적용합니다.

다음 섹션에서는 특정 기준에 따라 운영 에이전트를 설치하는 정책의 예시를 제공합니다.

VM 확장 프로그램 관리자는 확장 프로그램 정책에 따라 운영 에이전트가 설치된 경우 운영 에이전트 버전 2.58.0 이상을 지원합니다. VM 확장 프로그램 관리자는 이전 버전의 운영 에이전트, 다른 수단을 사용하여 설치된 운영 에이전트 인스턴스, 기존 Monitoring 에이전트 또는 Logging 에이전트를 관리할 수 없습니다.

모든 VM에 최신 운영 에이전트 설치

영역 또는 전역의 모든 VM에 최신 버전의 운영 에이전트를 설치하고 새 버전이 출시될 때 운영 에이전트를 업데이트하는 정책을 만들려면 다음을 수행합니다.

콘솔

영역 정책을 만들려면 Google Cloud 콘솔을 사용하면 됩니다.

1. Google Cloud 콘솔에서 확장 프로그램 정책 페이지로 이동합니다.

   확장 프로그램 정책으로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.

2. + 만들기를 클릭합니다.
3. 이름 필드에 정책 이름을 입력합니다.
4. 선택사항: 설명 필드에 정책에 대한 설명을 입력합니다.
5. 우선순위 필드에서 정책 간 충돌을 해결하기 위한 우선순위 번호를 지정합니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1,000입니다.
6. 영역 목록에서 이 정책을 적용할 영역을 선택합니다.
7. 확장 프로그램 관리 섹션에서 확장 프로그램 추가를 클릭하고 다음을 수행합니다.
   1. 확장 프로그램 목록에서 Google Cloud's Extension for Ops Agent를 선택합니다.
   2. 버전 필드는 비워둡니다.
8. 만들기를 클릭합니다.

gcloud

영역 또는 전역 정책을 만들려면 gcloud CLI를 사용하면 됩니다.

영역

다음 gcloud compute zone-vm-extension-policies create 명령어를 사용하여 정책을 만듭니다.

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• ZONE: 대상 영역(예: us-central1-f)

gcloud compute zone-vm-extension-policies create 명령어는 --version 옵션을 사용합니다. --version 옵션을 생략하면 정책에서 최신 버전을 설치하고 새 버전이 출시되면 운영 에이전트를 업데이트합니다.

전역

다음 gcloud compute global-vm-extension-policies create 명령어를 사용하여 정책을 만듭니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자

gcloud compute global-vm-extension-policies create 명령어는 --version 옵션을 사용합니다. --version 옵션을 생략하면 정책에서 최신 버전을 설치하고 새 버전이 출시되면 운영 에이전트를 업데이트합니다.

모든 VM에서 운영 에이전트를 특정 버전에 고정

영역 또는 전역의 모든 VM에 특정 버전의 운영 에이전트를 설치하는 정책을 만들려면 다음을 수행합니다.

콘솔

영역 정책을 만들려면 Google Cloud 콘솔을 사용하면 됩니다.

1. Google Cloud 콘솔에서 확장 프로그램 정책 페이지로 이동합니다.

   확장 프로그램 정책으로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.

2. + 만들기를 클릭합니다.
3. 이름 필드에 정책 이름을 입력합니다.
4. 선택사항: 설명 필드에 정책에 대한 설명을 입력합니다.
5. 우선순위 필드에서 정책 간 충돌을 해결하기 위한 우선순위 번호를 지정합니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1,000입니다.
6. 영역 목록에서 이 정책을 적용할 영역을 선택합니다.
7. 확장 프로그램 관리 섹션에서 확장 프로그램 추가를 클릭하고 다음을 수행합니다.
   1. 확장 프로그램 목록에서 Google Cloud's Extension for Ops Agent를 선택합니다.
   2. 버전 목록에서 설치할 버전을 선택합니다. 버전 2.58.0 이상을 사용합니다.
8. 만들기를 클릭합니다.

gcloud

영역 또는 전역 정책을 만들려면 gcloud CLI를 사용하면 됩니다.

영역

다음 gcloud compute zone-vm-extension-policies create 명령어를 사용하여 정책을 만듭니다.

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• ZONE: 대상 영역(예: us-central1-f)
• VERSION: 설치할 운영 에이전트 버전입니다. 버전 2.58.0 이상을 사용합니다.

  --version 옵션을 생략하면 정책에서 최신 버전을 설치하고 새 버전이 출시될 때 운영 에이전트를 업데이트합니다. 이는 최신 버전을 설치하는 예시에 나와 있습니다.

전역

다음 gcloud compute global-vm-extension-policies create 명령어를 사용하여 정책을 만듭니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• VERSION: 설치할 운영 에이전트 버전입니다. 버전 2.58.0 이상을 사용합니다.

  --version 옵션을 생략하면 정책에서 최신 버전을 설치하고 새 버전이 출시될 때 운영 에이전트를 업데이트합니다. 이는 최신 버전을 설치하는 예시에 나와 있습니다.

운영 에이전트 버전 목록은 GitHub의 운영 에이전트 출시 페이지를 참조하세요.

특정 라벨이 있는 VM에 운영 에이전트 설치

특정 라벨이 있는 영역 또는 전역의 VM에 최신 버전의 운영 에이전트를 설치하는 정책을 만들려면 다음을 수행합니다.

콘솔

영역 정책을 만들려면 Google Cloud 콘솔을 사용하면 됩니다.

1. Google Cloud 콘솔에서 확장 프로그램 정책 페이지로 이동합니다.

   확장 프로그램 정책으로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.

2. + 만들기를 클릭합니다.
3. 이름 필드에 정책 이름을 입력합니다.
4. 선택사항: 설명 필드에 정책에 대한 설명을 입력합니다.
5. 우선순위 필드에서 정책 간 충돌을 해결하기 위한 우선순위 번호를 지정합니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1,000입니다.
6. 영역 목록에서 이 정책을 적용할 영역을 선택합니다.
7. 확장 프로그램 관리 섹션에서 확장 프로그램 추가를 클릭하고 다음을 수행합니다.
   1. 확장 프로그램 목록에서 Google Cloud's Extension for Ops Agent를 선택합니다.
   2. 버전 필드는 비워둡니다.
8. 대상 VM 인스턴스 섹션에서 정책의 VM을 선택합니다. 특정 라벨이 있는 VM을 선택하려면 라벨 추가를 클릭하고 키-값 쌍을 추가합니다.
9. 만들기를 클릭합니다.

gcloud

영역 또는 전역 정책을 만들려면 gcloud CLI를 사용하면 됩니다.

영역

gcloud compute zone-vm-extension-policies create 명령어에 --inclusion-labels 옵션을 사용하여 쉼표로 구분된 키-값 쌍 목록을 지정합니다.

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• ZONE: 대상 영역(예: us-central1-f)
• KEY1=VALUE1,KEY2=VALUE2: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM에 선택기에 지정된 모든 라벨이 포함되어야 합니다 (논리적 AND). --inclusion_labels 옵션을 여러 번 지정하면 정책은 선택기 중 하나에서 모든 라벨과 일치하는 VM을 타겟팅합니다 (논리적 OR). 이 옵션을 생략하면 정책은 지정된 영역의 모든 VM을 타겟팅합니다.

전역

gcloud compute global-vm-extension-policies create 명령어에 --inclusion-labels 옵션을 사용하여 쉼표로 구분된 키-값 쌍 목록을 지정합니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• KEY1=VALUE1,KEY2=VALUE2: 선택기의 포함 라벨을 정의하는 쉼표로 구분된 키-값 쌍 목록입니다. VM에 선택기에 지정된 모든 라벨이 포함되어야 합니다 (논리적 AND). --inclusion_labels 옵션을 여러 번 지정하면 정책은 선택기 중 하나에서 모든 라벨과 일치하는 VM을 타겟팅합니다 (논리적 OR). 이 옵션을 생략하면 정책은 지정된 영역의 모든 VM을 타겟팅합니다.

모든 VM에 커스텀 구성으로 운영 에이전트 설치

영역 또는 전역의 모든 VM에 최신 버전의 운영 에이전트를 설치하고 운영 에이전트에 대한 커스텀 구성을 제공하는 정책을 만들려면 다음을 수행합니다.

콘솔

영역 정책을 만들려면 Google Cloud 콘솔을 사용하면 됩니다.

1. Google Cloud 콘솔에서 확장 프로그램 정책 페이지로 이동합니다.

   확장 프로그램 정책으로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.

2. + 만들기를 클릭합니다.
3. 이름 필드에 정책 이름을 입력합니다.
4. 선택사항: 설명 필드에 정책에 대한 설명을 입력합니다.
5. 우선순위 필드에서 정책 간 충돌을 해결하기 위한 우선순위 번호를 지정합니다. 숫자가 낮을수록 우선순위가 높습니다. 기본값은 1,000입니다.
6. 영역 목록에서 이 정책을 적용할 영역을 선택합니다.
7. 확장 프로그램 관리 섹션에서 확장 프로그램 추가를 클릭하고 다음을 수행합니다.
   1. 확장 프로그램 목록에서 Google Cloud's Extension for Ops Agent를 선택합니다.
   2. 버전 필드는 비워둡니다.
   3. 구성 파일 콘텐츠 필드에 운영 에이전트의 YAML 구성 문자열을 입력합니다.
8. 만들기를 클릭합니다.

gcloud

영역 또는 전역 정책을 만들려면 gcloud CLI를 사용하면 됩니다.

영역

gcloud compute zone-vm-extension-policies create 명령어에 --config-from-file 옵션을 사용하여 구성 파일을 지정합니다.

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• ZONE: 대상 영역(예: us-central1-f)
• OPS_AGENT_CONFIG_PATH: 운영 에이전트의 YAML 구성 문자열이 포함된 파일의 경로입니다. 이 파일은 gcloud 명령어를 실행하는 환경에 있어야 합니다.

  운영 에이전트의 구성 YAML은 길 수 있습니다. 구성을 파일에 넣고 파일을 gcloud CLI에 전달하면 명령줄에 올바른 형식의 YAML을 입력하는 것보다 오류가 발생할 가능성이 훨씬 적습니다. 정책을 만든 후 이 파일을 변경해도 정책이 업데이트되지 않습니다. 정책을 업데이트하려면 gcloud compute zone-vm-extension-policies update 명령어를 사용합니다.

전역

gcloud compute global-vm-extension-policies create 명령어에 --config-from-file 옵션을 사용하여 구성 파일을 지정합니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• OPS_AGENT_CONFIG_PATH: 운영 에이전트의 YAML 구성 문자열이 포함된 파일의 경로입니다. 이 파일은 gcloud 명령어를 실행하는 환경에 있어야 합니다.

  운영 에이전트의 구성 YAML은 길 수 있습니다. 구성을 파일에 넣고 파일을 gcloud CLI에 전달하면 명령줄에 올바른 형식의 YAML을 입력하는 것보다 오류가 발생할 가능성이 훨씬 적습니다. 정책을 만든 후 이 파일을 변경해도 정책이 업데이트되지 않습니다. 정책을 업데이트하려면 gcloud compute global-vm-extension-policies update 명령어를 사용합니다.

확장 프로그램 정책을 만들거나 업데이트할 때 운영 에이전트에 커스텀 구성을 제공하면 정책에서 커스텀 구성으로 운영 에이전트를 배포합니다. 에이전트를 수동으로 다시 시작할 필요가 없습니다.

구성은 확장 프로그램 정책과 함께 저장되므로 구성에 비밀번호와 같은 민감한 정보를 포함하지 마세요. 구성은 확장 프로그램 정책과 함께 저장되므로 구성 파일을 수정해도 에이전트 구성이 변경되지 않습니다. 적절한 gcloud 명령어를 사용하여 정책과 함께 저장된 구성을 업데이트해야 합니다.

• 영역 정책의 경우 gcloud compute zone-vm-extension-policies update 명령어를 사용합니다.
• 전역 정책의 경우 gcloud compute global-vm-extension-policies update 명령어를 사용합니다.

운영 에이전트에 커스텀 구성을 제공하면 VM 확장 프로그램 관리자가 대상 VM의 사용자 지정 구성 파일에 운영 에이전트가 사용하는 위치에 구성을 복사합니다.

• Linux: /etc/google-cloud-ops-agent/config.yaml
• Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

VM에 config.yaml 파일이 있으면 확장 프로그램 정책이 이를 덮어씁니다.

Google Cloud 콘솔 및 gcloud CLI를 사용하여 VM 확장 프로그램 정책을 만드는 방법에 대한 일반적인 내용은 확장 프로그램 정책을 사용하여 VM 확장 프로그램 설치를 참조하세요 .

우선순위가 높은 빠른 출시 계획으로 운영 에이전트 설치 (전역만 해당)

기본값보다 높은 우선순위와 빠른 출시 계획을 사용하여 최신 버전의 운영 에이전트를 설치하는 전역 정책을 만들려면 다음 gcloud compute global-vm-extension-policies create 명령어를 사용합니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자

Google Cloud 프로젝트의 영역 하위 집합에 운영 에이전트 설치 (전역만 해당)

Google Cloud 프로젝트의 영역 하위 집합에만 적용되는 전역 정책을 만들려면 정책을 적용할 영역을 지정하는 커스텀 출시 계획을 사용해야 합니다. 커스텀 출시 계획을 만드는 방법에 대한 자세한 내용은 출시 계획 정보를 참조하세요. 영역 집합을 지정하려면 출시 계획을 만들 때 locationSelector.includedLocations 필드를 사용합니다.

커스텀 출시 계획을 사용하는 확장 프로그램 정책을 만들려면 다음 gcloud compute global-vm-extension-policies create 명령어를 사용합니다.

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

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

• POLICY_NAME: VM 확장 프로그램 정책의 이름입니다.
• PROJECT_ID: 프로젝트 식별자
• CUSTOM_PLAN_NAME: 커스텀 출시 계획과 연결된 이름입니다.

운영 에이전트 설치 확인

이 섹션에서는 다음 작업을 수행하는 방법을 설명합니다.

• 운영 에이전트 설치 상태 또는 버전 확인
• 운영 에이전트가 원격 분석을 수집하는지 확인

운영 에이전트 설치 상태 또는 버전 확인

운영 에이전트의 상태 또는 버전을 확인하려면 다음Google Cloud 콘솔 페이지 중 하나를 사용합니다.

Compute Engine

1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

   VM 인스턴스로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Compute Engine인 결과를 선택합니다.

2. 목록에서 VM을 선택합니다.
3. 모니터링 가능성 탭을 클릭합니다.

Cloud Monitoring

1. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.

   VM 인스턴스로 이동

   검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.

2. 목록 뷰를 선택합니다.

운영 에이전트가 VM에 설치되고 로그 및 측정항목을 수집하면 에이전트 상태가 운영 에이전트 라벨 옆에 녹색 체크표시로 표시됩니다.

설치된 에이전트 버전을 확인하려면 Compute Engine 또는 Monitoring 대시보드에서 운영 에이전트 라벨 위로 마우스를 가져갑니다.

운영 에이전트가 원격 분석을 수집하는지 확인

운영 에이전트가 성공적으로 설치되고 올바르게 실행 중이면 측정항목을 Cloud Monitoring으로 전송하고 로그를 Cloud Logging으로 전송합니다.

• 측정항목 수집 확인에 대한 자세한 내용은 에이전트가 실행 중이지만 데이터가 수집되지 않음을 참조하세요.
• 로그 수집 확인에 대한 자세한 내용은 성공적인 로그 수집 확인을 참조하세요.

다음 단계

• 확장 프로그램 정책을 업데이트하여 설치를 수정합니다.
• 확장 프로그램 정책 문제 해결
• VM 확장 프로그램 관리자에 대해 자세히 알아보세요.
• 운영 에이전트 구성에 대한 자세한 정보를 확인합니다.