VM Manager を設定する

Compute Engine では、VM Manager を使用して、仮想マシン（VM）で実行されているオペレーティングシステムを管理できます。

VM Manager は、個々の VM、プロジェクト、フォルダまたは組織内のすべてのプロジェクトに対して有効にできます。VM Manager を使用するために必要な VM の設定手順については、設定の概要をご覧ください。

VM Manager を設定すると、OS Config API で実行される API オペレーションの監査ログを表示できます。詳しくは、VM Manager の監査ログの表示をご覧ください。

始める前に

プロジェクトの OS Config の割り当てを確認します。
まだ設定していない場合は、認証を設定します。認証では、 Google Cloud サービスと API にアクセスするための ID が確認されます。ローカル開発環境からコードまたはサンプルを実行するには、次のいずれかのオプションを選択して Compute Engine に対する認証を行います。
Select the tab for how you plan to use the samples on this page:
Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Google Cloud CLI をインストールします。インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。
  gcloud init
  外部 ID プロバイダ（IdP）を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
  
  注: すでに gcloud CLI をインストールしている場合は、gcloud components update を実行して、最新バージョンがインストールされていることを確認してください。
2. Set a default region and zone.
REST

このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。

サポートされているオペレーティングシステム

VM Manager をサポートしているオペレーティングシステムのバージョンの完全なリストについては、オペレーティングシステムの詳細をご覧ください。特定のオペレーティングシステムで OS 構成エージェントを使用できない場合、このオペレーティングシステムを実行する VM で VM Manager を有効にすることはできません。

組織のポリシーを使用して VM Manager を有効にする

Require OS Config 組織ポリシーを使用することで、組織、フォルダ、プロジェクト内のすべての新しい VM で VM Manager を自動的に有効にできます。

Require OS Config ブール値制約が設定されている場合、次の条件が適用されます。

enable-osconfig=TRUE は、すべての新しいプロジェクトのプロジェクトメタデータに含まれています。
VM とプロジェクトが新規の場合でも既存の場合でも、インスタンスまたはプロジェクトのメタデータで enable-osconfig を FALSE に設定するリクエストは拒否されます。
この組織のポリシーでは、ポリシーを有効にする前に作成された VM またはプロジェクトの enable-osconfig メタデータ値が TRUE に変更されることはありません。これらの VM またはプロジェクトで VM Manager を有効にする場合は、メタデータを更新することをおすすめします。詳細については、メタデータ値を設定するをご覧ください。

OS Config 組織ポリシーが有効な場合でも、osconfig-disabled-features メタデータを使用して 1 つ以上の VM Manager 機能を無効にできます。

OS Config 組織ポリシーを有効にする

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

resourcemanager.organizationAdmin role。詳しくは、IAM を使用した組織のアクセス制御をご覧ください。
組織レベルでのポリシー管理の詳細については、組織のポリシーの管理者の追加をご覧ください。

OS Config ポリシーを有効にするには、Google Cloud コンソールまたは Google Cloud CLI を使用して、組織全体、フォルダ、または特定のプロジェクトに Require OS Config の制約を設定します。

コンソール

コンソールから OS Login の組織のポリシーを設定する手順は次のとおりです。

Google Cloud コンソールで、[組織のポリシー] ページに移動します。

[組織のポリシー] に移動
プロジェクト選択ツールから、組織のポリシーを編集するプロジェクト、フォルダ、または組織を選択します。
[組織のポリシー] ページに、利用可能な組織ポリシー制約のリストが表示されます。
制約のリストから [Require OS Config] 制約を選択します。表示される [ポリシーの詳細] ページに、制約の説明と、その制約の適用状況に関する情報が示されます。
このリソースの組織ポリシーを構成するには、[ポリシーを管理] をクリックします。
[ポリシーの編集] ページで、[親のポリシーをオーバーライドする] を選択します。
[ルールを追加] を選択します。
[適用] で、この組織ポリシーの適用を有効にするかどうかを選択します。
ポリシーを適用するには、[ポリシーを設定] をクリックします。

gcloud

OS Login の組織のポリシーを設定するには、gcloud beta resource-manager org-policies enable-enforce コマンドを使用します。

自分の組織 ID を確認します。
```
gcloud organizations list
```

組織で制約を設定します。organization-id を組織 ID に置き換えます。

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --organization=organization-id

また、--folder フラグまたは --project フラグ、フォルダ ID またはプロジェクト ID をそれぞれ使用して、フォルダやプロジェクトに対して OS Config 組織ポリシーを適用することもできます。

フォルダの場合は、次のコマンドを実行します。

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --folder=folder-id

プロジェクトの場合は、次のコマンドを実行します。

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --project=project-id

次のように置き換えます。

folder-id: 実際のフォルダ ID。
project-id: 実際のプロジェクト ID。

プロジェクトで VM Manager を有効にする

注意: VM Manager を使用してパッチジョブまたは OS ポリシーの割り当てを作成するには、ユーザーに必要な IAM 権限を付与する必要があります。これらの権限により、VM でコードを実行する権限が付与され、セキュリティリスクが生じる可能性があります。

このリスクを軽減するには、最小権限の原則に従い、必要なアクセス権のみを各ユーザーに付与することをおすすめします。 Google Cloud プロジェクトで VM Manager を使用する予定がない場合は、次の手順で VM Manager を無効にすることをおすすめします。

プロジェクトレベルのメタデータを設定して、パッチと OS ポリシーの機能を無効にします。

enable-osconfig メタデータを FALSE に設定して、VM Manager を無効にします。

OS Config エージェントを無効にします。

プロジェクトで VM Manager を有効にするには、次の 2 つの方法があります。

自動での有効化: Google Cloud プロジェクト全体に適用されます。 Google Cloud コンソールから自動での有効化を完了します。一部のステップは、手動で完了しなければならない場合があります。
手動での有効化: VM ごとまたは Google Cloud プロジェクト全体に対して適用できます。

手動

VM Manager を手動で設定するには、次の手順を行います。

Google Cloud プロジェクトで OS Config API を有効にします。
各 VM で、OS Config エージェントがインストールされているかどうかを確認します。エージェントがまだインストールされていない場合は、OS Config エージェントをインストールします。
プロジェクトまたは各 VM で、OS Config エージェントのインスタンスメタデータを設定します。このステップは、VM またはプロジェクトで OS Config エージェントをアクティブにするために必要です。
接続されたサービスアカウントが、すべての VM にあることを確認します。このサービスアカウントに IAM のロールを付与する必要はありません。VM Manager は、このサービスアカウントを使用して API サービスに対するリクエストに署名します。
VM がプライベート VPC ネットワーク内で実行されていて、公共のインターネットアクセスがない場合は、限定公開の Google アクセスを有効にします。
VM に HTTP プロキシを使用する場合は、HTTP プロキシを構成します。
省略可。プロジェクトまたは各 VM で、不要な機能を無効にします。

自動

Google Cloud コンソールの [VM Manager] ページのいずれかに初めてアクセスするときに、VM Manager を自動的に有効にすることを選択できます。

手順ガイドに従うと、自動での有効化を使用して以下を実行できます。

Google Cloud プロジェクトで VM Manager（OS Config API）を有効にする
エージェントがインストールされている Google Cloud プロジェクト内のすべての VM で OS Config エージェントを有効にする

自動での有効化。

OS Config Service API を有効にする

Google Cloud プロジェクトで OS Config API を有効にします。

コンソール

Google Cloud コンソールで、VM Manager（OS Config API）を有効にします。

OS Config API を有効にする

gcloud

API を有効にするには、次のコマンドを実行します。

gcloud services enable osconfig.googleapis.com

OS Config エージェントがインストールされているかどうかを確認する

OS Config エージェントは、ビルド日付が v20200114 以降の CentOS、Container-Optimized OS（COS）、Debian、Red Hat Enterprise Linux（RHEL）、Rocky Linux、SLES、Ubuntu、Windows Server の各イメージにデフォルトでインストールされています。OS Config エージェントがインストールされているオペレーティングシステムのバージョンについては、オペレーティングシステムの詳細をご覧ください。これらのエージェントは、エージェントメタデータを有効化し、サービス API を有効化するまで、アイドル状態で実行されます。

Linux

Linux VM にエージェントがインストールされているかどうかを確認するには、次のコマンドを実行します。

sudo systemctl status google-osconfig-agent

エージェントがインストールされ、実行されている場合、出力は次のようになります。

google-osconfig-agent.service - Google OSConfig Agent
Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset:
Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago
Main PID: 369 (google_osconfig)
 Tasks: 8 (limit: 4374)
Memory: 102.7M
CGroup: /system.slice/google-osconfig-agent.service
        └─369 /usr/bin/google_osconfig_agent

エージェントがインストールされていない場合は、OS Config エージェントをインストールします。

Windows

Windows VM にエージェントがインストールされているかどうかを確認するには、次のコマンドを実行します。

PowerShell Get-Service google_osconfig_agent

エージェントがインストールされ、実行されている場合、出力は次のようになります。

Status   Name               DisplayName
------   ----               -----------
Running  google_osconfig... Google OSConfig Agent

エージェントがインストールされていない場合は、OS Config エージェントをインストールします。

OS Config エージェントをインストールする

これらの手順でエージェントをインストールする前に、エージェントが VM ですでに実行されているかどうかを確認します。

各 VM に OS Config エージェントをインストールします。次のいずれかの方法で OS Config エージェントをインストールできます。

ターミナルから手動でエージェントをインストールする。
VM で起動スクリプトを使用する。
Google Cloud Observability エージェントポリシーを使用して、複数の VM への OS Config のインストールを自動化する。
VM 作成時に Ops エージェントをインストールする。

手動でエージェントをインストールする

この方法を使用して、OS Config エージェントを既存の VM にインストールします。

エージェントのインストール手順は次のとおりです。

OS Config エージェントをインストールする VM に接続します。
OS Config エージェントをインストールします。
Windows Server
Windows サーバーに OS Config エージェントをインストールするには、次のコマンドを実行します。
```
googet -noconfirm install google-osconfig-agent
```
Ubuntu
Ubuntu VM に OS Config エージェントをインストールするには、次のコマンドを実行します。
1. Ubuntu リポジトリを設定します。
  - Ubuntu 20.04 以降のバージョンでは、次のコマンドを実行します。
    
    Ubuntu リポジトリを追加します。
    
    sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-focal-stable main' > \ /etc/apt/sources.list.d/google-compute-engine.list"
    
    Google Cloud 公開鍵をインポートします。
    
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \ sudo apt-key add -
  - Ubuntu 18.04 以降のバージョンでは、次のコマンドを実行します。
    
    Ubuntu リポジトリを追加します。
    
    sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-bionic-stable main' > \ /etc/apt/sources.list.d/google-compute-engine.list"
    
    Google Cloud 公開鍵をインポートします。
    
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \ sudo apt-key add -
  - Ubuntu 16.04 の場合は、次のコマンドを実行します。
    
    Ubuntu リポジトリを追加します。
    
    sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-xenial-stable main'> \ /etc/apt/sources.list.d/google-compute-engine.list"
    
    Google Cloud 公開鍵をインポートします。
    
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \ sudo apt-key add -
2. OS Config エージェントをインストールします。
  sudo apt update sudo apt -y install google-osconfig-agent
Debian
Debian VM に OS Config エージェントをインストールするには、次のコマンドを実行します。
```
sudo apt update
sudo apt -y install google-osconfig-agent
```
注: Google が提供するイメージから作成されていない VM インスタンスを使用している場合や、エラー「E: Unable to locate package google-osconfig-agent」が表示される場合は、 Google Cloudリポジトリと公開鍵を追加する必要があります

Google Cloud リポジトリと公開鍵の追加

Google が提供するイメージから作成されていない VM インスタンスを使用している場合や、「パッケージが見つかりません」というエラーメッセージが表示される場合は、次の手順で、 Google Cloudリポジトリを追加し、公開鍵をインポートします。

リポジトリを追加して鍵をインポートしたら、コマンドを実行して OS Config エージェントをインストールできます。
1. Debian Cloud リポジトリを設定します。
  Debian 13 以降
  
  公開リポジトリの /etc/apt/keyrings 鍵をインストールします。
  
  sudo curl https://packages.cloud.google.com/apt/doc/apt-key.gpg -o /etc/apt/keyrings/google-keyring.gpg
  
  Debian ディストリビューションの名前を特定します。次に、ソースリストファイル /etc/apt/sources.list.d/google-cloud.list を作成します。
  
  eval $(grep VERSION_CODENAME /etc/os-release) sudo tee /etc/apt/sources.list.d/google-cloud.list << EOM deb [signed-by=/etc/apt/keyrings/google-keyring.gpg] http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-stable main EOM
  
  Debian 12 以前
  
  公開リポジトリの GPG 鍵をインストールします。
  
  curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
  
  Debian ディストリビューションの名前を特定します。次に、ソースリストファイル /etc/apt/sources.list.d/google-cloud.list を作成します。
  
  eval $(grep VERSION_CODENAME /etc/os-release) sudo tee /etc/apt/sources.list.d/google-cloud.list << EOM deb http://packages.cloud.google.com/apt google-compute-engine-${VERSION_CODENAME}-stable main deb http://packages.cloud.google.com/apt google-cloud-packages-archive-keyring-${VERSION_CODENAME} main EOM
RHEL / CentOS / Rocky
RHEL 7/8、CentOS 7/8 VM、または Rocky Linux 8/9 に OS Config エージェントをインストールするには、次のコマンドを実行します。
```
sudo yum -y install google-osconfig-agent
```
SLES / openSUSE
SLES または openSUSE VM に OS Config エージェントをインストールするには、次のコマンドを実行します。
1. SLES リポジトリを設定します。
  - SLES 12 の場合は、次のコマンドを実行します。
    
    sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM [google-compute-engine] name=Google Compute Engine baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles12-stable enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM"
  - SLES 15 と OpenSUSE 15 の場合は、次のコマンドを実行します。
    
    sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM [google-compute-engine] name=Google Compute Engine baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles15-stable enabled=1 gpgcheck=1 repo_gpgcheck=0 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM"
2. Google Cloudの GPG 鍵をインポートします。
  sudo rpm --import https://packages.cloud.google.com/yum/doc/yum-key.gpg \ --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
3. OS Config エージェントをインストールします。
  sudo zypper -n --gpg-auto-import-keys install --from google-compute-engine google-osconfig-agent

起動スクリプトを使用してエージェントをインストールする

手動のインストールコマンドを使用して、VM の作成中に OS Config エージェントをインストールする起動スクリプトを作成できます。

ご使用のオペレーティングシステム用の手動インストールコマンドをコピーします。
VM 作成メソッドに起動スクリプトを追加します。

たとえば、gcloud compute instances create コマンドを使用して新しい Debian 10 VM を作成する場合、コマンドは次のようになります。
```
gcloud compute instances create VM_NAME \
   --image-family=debian-10 --image-project=debian-cloud \
   --metadata startup-script='#! /bin/bash
   apt update
   apt -y install google-osconfig-agent'
```
VM_NAME は実際の VM 名に置き換えます。
起動スクリプトが完了したことを確認します。起動スクリプトが完了したかどうかを確認するには、ログまたはシリアルコンソールを確認します。

メタデータ値を設定する

インスタンスメタデータは、各 VM に対して設定するか、プロジェクトメタデータに設定してプロジェクト内のすべての VM に適用します。

Google Cloud プロジェクトまたは VM で、enable-osconfig メタデータ値を TRUE に設定します。enable-osconfig メタデータ値を TRUE に設定すると、次の機能が有効になります。

パッチ
OS ポリシー
OS Inventory Management
- 以前のバージョンの OS Inventory Management では、enable-guest-attributes メタデータ値を TRUE に設定する必要もあります。両方のメタデータ値が設定されていない場合は、ダッシュボードに VM の no data が表示されます。この設定は新しいバージョンでは必要ありません。2 つの OS Inventory Management バージョンについては、OS Inventory Management のバージョンをご覧ください。

コンソール

次のいずれかのオプションを使用して、 Google Cloud プロジェクトまたは VM にメタデータ値を適用できます。

オプション 1: プロジェクト全体のメタデータに enable-osconfig を設定して、プロジェクト内のすべての VM に適用する。
1. Google Cloud コンソールで、[メタデータ] ページに移動します。
  
  [メタデータ] に移動
2. [編集] をクリックします。
3. 次のメタデータエントリを追加します。
  
  キー: enable-osconfig
  値: TRUE
  
  以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
  - キー: enable-osconfig
    値: TRUE
  - キー: enable-guest-attributes
    値: TRUE
4. [保存] をクリックして変更を適用します。
オプション 2: インスタンスの作成時に VM メタデータで enable-osconfig を設定する。
1. Google Cloud コンソールで [インスタンスの作成] ページに移動します。
  
  [インスタンスの作成] に移動
2. VM の詳細を指定します。
3. [詳細オプション] セクションを開き、次の操作を行います。
  1. [管理] セクションを開きます。
  2. [メタデータ] セクションで [項目を追加] をクリックし、次のメタデータエントリを追加します。
    
    キー: enable-osconfig
    値: TRUE
    
    以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
    - キー: enable-osconfig
      値: TRUE
    - 鍵: enable-guest-attributes
      値: TRUE
4. VM を作成するには、[作成] をクリックします。
オプション 3: 既存の VM のメタデータに enable-osconfig を設定する。
1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。
  
  [VM インスタンス] に移動
2. メタデータ値を設定する VM の名前をクリックします。
3. [インスタンスの詳細] ページで、[編集] をクリックして設定を編集します。
4. [カスタムメタデータ] の下に、次のメタデータエントリを追加します。
  
  キー: enable-osconfig
  値: TRUE
  
  以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
  - キー: enable-osconfig
    値: TRUE
  - キー: enable-guest-attributes
    値: TRUE
5. [保存] をクリックして、VM に変更を適用します。

gcloud

--metadata=enable-osconfig=TRUE フラグを指定して、project-info add-metadata か instances add-metadata コマンドを使用します。

次のいずれかの方法で、プロジェクトまたは VM にメタデータ値を適用できます。

オプション 1: プロジェクト全体のメタデータに enable-osconfig を設定して、プロジェクト内のすべてのインスタンスに適用する。
```
gcloud compute project-info add-metadata \
  --project PROJECT_ID \
  --metadata=enable-osconfig=TRUE
```
以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
```
gcloud compute project-info add-metadata \
  --project PROJECT_ID \
  --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
```
PROJECT_ID は、実際のプロジェクト ID に置き換えます。
オプション 2: 既存のインスタンスのメタデータに enable-osconfig を設定する。
```
gcloud compute instances add-metadata VM_NAME \
  --metadata=enable-osconfig=TRUE
```
以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
```
gcloud compute instances add-metadata VM_NAME \
  --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
```
VM_NAME は実際の VM 名に置き換えます。
オプション 3: インスタンスの作成時にインスタンスメタデータで enable-osconfig を設定する。
```
gcloud compute instances create VM_NAME \
  --metadata=enable-osconfig=TRUE
```
以前のバージョンの OS Inventory Management では、enable-osconfig と enable-guest-attributes の両方を設定します。
```
gcloud compute instances create VM_NAME \
  --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
```
VM_NAME は実際の VM 名に置き換えます。

REST

メタデータ値は、 Google Cloud プロジェクトレベルまたはインスタンスレベルで設定できます。

プロジェクト全体のメタデータの設定手順については、プロジェクト全体のカスタムメタデータの設定をご覧ください。
インスタンスメタデータの設定手順については、インスタンスメタデータの設定をご覧ください。

メタデータプロパティの一部として、次の Key-Value ペアが必要です。

キー: enable-osconfig
値: TRUE

以前のバージョンの OS Inventory Management では、次の Key-Value ペアも追加します。

キー: enable-guest-attributes
値: TRUE

HTTP プロキシを構成する

VM で HTTP プロキシを使用する場合は、次のコマンドを実行して http_proxy 環境変数と https_proxy 環境変数を設定します。また、OS Config エージェントがローカルメタデータサーバーにアクセスできるように、no_proxy 環境変数を構成して、メタデータサーバー（169.254.169.254）を除外することも必要です。

Linux

systemd を使用する Linux ディストリビューションでは、root ユーザーとして、プロキシ環境変数を google-osconfig-agent.service ユニットに追加します。

mkdir -p /etc/systemd/system/google-osconfig-agent.service.d
cat >/etc/systemd/system/google-osconfig-agent.service.d/override.conf <<EOF
[Service]
Environment="http_proxy=http://PROXY_IP:PROXY_PORT" \
  "https_proxy=http://PROXY_IP:PROXY_PORT" \
  "no_proxy=169.254.169.254,metadata,metadata.google.internal"
EOF

PROXY_IP と PROXY_PORT をプロキシサーバーの IP アドレスとポート番号に置き換えます。

OS Config エージェントサービスを再起動します。

systemctl daemon-reload
systemctl restart google-osconfig-agent

変数が正しく設定されていることを確認するには、実行中のエージェントの環境変数を確認します。

tr '\0' '\n' < /proc/$(systemctl show -p MainPID --value google-osconfig-agent)/environ

Windows

管理者のコマンドプロンプトから次のコマンドを実行します。

  setx http_proxy http://PROXY_IP:PROXY_PORT /m
  setx https_proxy http://PROXY_IP:PROXY_PORT /m
  setx no_proxy 169.254.169.254,metadata,metadata.google.internal /m

PROXY_IP と PROXY_PORT をプロキシサーバーの IP アドレスと IP ポート番号に置き換えます。

OS Config エージェントからの接続の問題を回避するため、no_proxy 環境変数を追加して、*.googleapis.com を除外することをおすすめします。特定の VM のみを OS Config エージェントに接続する場合は、VM が存在するゾーンに接頭辞を追加して、[zone-name]-osconfig.googleapis.com の形式で設定します。例: us-central1-f-osconfig.googleapis.com

不要な機能を無効にする

不要な機能については、次のメタデータ値 osconfig-disabled-features=FEATURE1,FEATURE2 を設定して無効にできます。

FEATURE1,FEATURE2 を次のいずれかの値に置き換えます。

OS Inventory Management: osinventory
パッチと OS ポリシー: tasks
OS ゲストポリシー（ベータ版）: guestpolicies

メタデータ値を無効にするには、次のいずれかの方法を使用します。

コンソール

次のいずれかのオプションを使用して、 Google Cloud プロジェクトまたは VM のメタデータ値を無効にできます。

オプション 1: プロジェクト全体のメタデータの機能を無効にして、プロジェクト内のすべてのインスタンスに適用する。
1. Google Cloud コンソールで、[メタデータ] ページに移動します。
  
  [メタデータ] に移動
2. [編集] をクリックします。
3. 次のメタデータエントリを追加します。
  
  キー: osconfig-disabled-features
  値: FEATURE1,FEATURE2
  
  例:
  キー: osconfig-disabled-features
  値: osinventory,guestpolicies
4. [保存] をクリックして変更を適用します。
オプション 2: 既存の VM のメタデータで機能を無効にする。
1. Google Cloud コンソールで、[VM インスタンス] ページに移動します。
  
  [VM インスタンス] に移動
2. メタデータ値を設定する VM の名前をクリックします。
3. [インスタンスの詳細] ページで、[編集] をクリックして VM 設定を編集します。
4. [カスタムメタデータ] の下に、次のメタデータエントリを追加します。
  
  キー: osconfig-disabled-features
  値: FEATURE1,FEATURE2
  
  例:
  キー: osconfig-disabled-features
  値: osinventory
5. [保存] をクリックして、VM に変更を適用します。

gcloud

project-info add-metadata または instances add-metadata gcloud コマンドを使用して、--metadata=osconfig-disabled-features フラグを指定します。

複数の機能を無効にする場合は、フラグの形式を --metadata=osconfig-disabled-features=FEATURE1,FEATURE2 にする必要があります。例 2 をご覧ください。

例

例 1 Google Cloud CLI を使用して Google Cloud プロジェクトレベルでパッチを無効にするには、次のコマンドを実行します。

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=tasks

例 2 Google Cloud CLI を使用して、プロジェクトレベルで OS ポリシーと OS Inventory Management を無効にするには、次のコマンドを実行します。

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=osinventory,guestpolicies

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

REST

メタデータ値は、 Google Cloud プロジェクトレベルまたはインスタンスレベルで設定できます。

プロジェクト全体のメタデータの設定手順については、プロジェクト全体のカスタムメタデータの設定をご覧ください。
インスタンスメタデータの設定手順については、インスタンスメタデータの設定をご覧ください。

メタデータプロパティの一部として、次の Key-Value ペアが必要です。

キー: osconfig-disabled-features
値: 次のフラグのいずれかまたは組み合わせを指定できます。
- osinventory
- tasks
- guestpolicies

アクティブな OS Config エージェントの要件

OS Config エージェントがアクティブで課金対象とみなされるには、次の要件をすべて満たしている必要があります。

VM Manager が設定されている。
VM が RUNNING 状態で、OS Config エージェントが OS Config サービスと通信を行っている。

VM が停止、一時停止、ネットワークから切断されている場合、その VM のエージェントはアクティブなエージェントとしてカウントされません。

設定を確認する

設定手順を完了したら、設定を確認できます。

プロジェクトの VM Manager 機能の設定を表示する

プロジェクトですべての VM Manager 機能が有効になっているかどうかを確認するには、次の操作を行います。

gcloud

次のように gcloud compute os-config project-feature-settings describe コマンドを使用します。

gcloud compute os-config project-feature-settings describe \
    --project PROJECT_ID

コマンドの出力は、次のようになります。

name: projects/my-project/locations/global/projectFeatureSettings
patchAndConfigFeatureSet: OSCONFIG_C

値 OSCONFIG_C は完全な VM Manager 機能セットを表し、OSCONFIG_B は制限付きの機能セットを表します。

REST

Google Cloud プロジェクトで VM Manager の機能を表示するには、projects.locations.global.getProjectFeatureSettings メソッドに対する GET リクエストを作成します。

   GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

成功すると、このメソッドは次の例に示すように、プロジェクトの機能設定を返します

{
 "name": "projects/my-project/locations/global/projectFeatureSettings",
 "patchAndConfigFeatureSet": "OSCONFIG_C"
}

値 OSCONFIG_C は完全な VM Manager 機能セットを表し、OSCONFIG_B は制限付きの機能セットを表します。

VM Manager の全機能を有効にする

プロジェクトで VM Manager が有効になっていない場合、VM の作成時に Ops エージェントをインストールすると、VM Manager は制限付きモードで有効になります。このモードでは、VM の数に制限なく、VM Manager の一部の機能を無料で利用できます。たとえば、[OS ポリシー] ページで VM の OS ポリシーの割り当てを表示できますが、OS ポリシーの割り当ての作成や編集はできません。

Ops エージェントがインストールされているこれらの VM に対して、VM Manager のすべての機能を有効にするには、次の操作を行います。

コンソール

Google Cloud コンソールで、[OS ポリシー] ページに移動します。

[OS ポリシー] に移動

[VM Manager の全機能を有効にしましょう] をクリックして、すべての VM Manager 機能を有効にします。

注: プロジェクト内のすべての VM に対して VM Manager を有効にする場合は、プロジェクト全体のメタデータ enable-osconfig の値を true に設定します。詳細については、メタデータ値を設定するをご覧ください。

gcloud

Google Cloud プロジェクトですべての VM Manager 機能を有効にするには、gcloud compute os-config project-feature-settings update コマンドを使用します。

gcloud compute os-config project-feature-settings update \
    --project PROJECT_ID \
    --patch-and-config-feature-set=full

REST

Google Cloud プロジェクトレベルですべての VM Manager 機能を有効にするには、projprojects.locations.global.updateProjectFeatureSettings メソッドに PATCH リクエストを送信します。

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings
   {
     "name": "projects/PROJECT_ID/locations/global/projectFeatureSettings",
     "patchAndConfigFeatureSet": "OSCONFIG_C"
   }

PROJECT_ID は、実際のプロジェクト ID に置き換えます。値 OSCONFIG_C は、完全な VM Manager 機能セットを表します。

OS Config エージェントを無効にする

OS Config エージェントを無効にしても、VM の動作には影響しません。オペレーティングシステムの他のサービスを停止するのと同じ方法で、エージェントを無効にできます。

Linux

systemctl を使用してエージェントを無効にするには、次のコマンドを実行します。

sudo systemctl stop google-osconfig-agent
sudo systemctl disable google-osconfig-agent

Windows

powershell を使用してエージェントを無効にするには、次のコマンドを実行します。

PowerShell Stop-Service google_osconfig_agent [-StartupType disabled]

VM Manager を設定する

始める前に

Console

gcloud

REST

サポートされているオペレーティング システム

組織のポリシーを使用して VM Manager を有効にする

OS Config 組織ポリシーを有効にする

このタスクに必要な権限

コンソール

gcloud

プロジェクトで VM Manager を有効にする

手動

自動

OS Config Service API を有効にする

コンソール

gcloud

OS Config エージェントがインストールされているかどうかを確認する

Linux

Windows

OS Config エージェントをインストールする

手動でエージェントをインストールする

Windows Server

Ubuntu

Debian

Debian 13 以降

Debian 12 以前

RHEL / CentOS / Rocky

SLES / openSUSE

起動スクリプトを使用してエージェントをインストールする

メタデータ値を設定する

コンソール

gcloud

REST

HTTP プロキシを構成する

Linux

Windows

不要な機能を無効にする

コンソール

gcloud

REST

アクティブな OS Config エージェントの要件

設定を確認する

プロジェクトの VM Manager 機能の設定を表示する

gcloud

REST

VM Manager の全機能を有効にする

コンソール

gcloud

REST

OS Config エージェントを無効にする

Linux

Windows

次のステップ

サポートされているオペレーティングシステム