既存の Cloud Volumes ONTAP デプロイメントを Infrastructure Manager に変換
2026年2月9日より、Google Cloudでの新しいCloud Volumes ONTAPデプロイメントには、Google Cloud Infrastructure Managerを使用できます。Googleは、Google Cloud Deployment Managerを廃止し、代わりにInfrastructure Managerを導入します。既存のCloud Volumes ONTAPデプロイメントをDeployment ManagerからInfrastructure Managerに変換するには、変換ツールを手動で実行してください。この1回限りのプロセスにより、システムが自動的にInfrastructure Managerに切り替わります。
変換ツールはNetApp Support Siteで入手でき、以下のアーティファクトを作成します:
-
Terraformアーティファクトは、 `conversion_output/deployment_name`に保存されます。
-
変換の概要は、 `conversion_output/batch_summary_<deployment_name>_<timestamp>.json`に保存されます。
-
デバッグログは、 `<gcp project number>-<region>-blueprint-config/<cvo name>`ディレクトリに保存されます。トラブルシューティングにはこれらのログが必要です。 `<gcp project number>-<region>-blueprint-config`バケットには Terraform ログが保存されます。
-
Cloud Volumes ONTAPプロジェクトは、Cloud Volumes ONTAPリソースを作成するGoogle Cloudプロジェクトです。ConsoleエージェントとCloud Volumes ONTAPシステムは、同じGoogle Cloudプロジェクトに配置することも、異なるGoogle Cloudプロジェクトに配置することもできます(クロスプロジェクト構成)。クロスプロジェクト構成では、Consoleエージェントのサービスアカウントに必要な権限があれば、プロジェクトAなどの1つのプロジェクトにConsoleエージェントをデプロイし、プロジェクトBなどの別のプロジェクトにCloud Volumes ONTAPシステムをデプロイできます。
|
|
Infrastructure Manager を使用する Cloud Volumes ONTAP システムは、データとレコードを Google Cloud Storage バケットに保存します。これらのバケットには追加費用が発生する可能性がありますが、バケットやそのコンテンツを編集または削除しないでください:
|
-
Cloud Volumes ONTAPシステムが9.16.1以降であることを確認してください。
-
Google Cloud ConsoleからCloud Volumes ONTAPリソースやそのプロパティが手動で編集されていないことを確認します。
-
Google Cloud API(Google Cloud Quotas APIを含む)が有効になっていることを確認してください。 "Google Cloud API を有効にする"を参照してください。
-
NetApp Consoleエージェントのサービスアカウントに、必要なすべての権限があることを確認します。 "コンソール エージェントの Google Cloud 権限"を参照してください。
-
ConsoleエージェントとCloud Volumes ONTAPが異なるプロジェクトにある場合は、ConsoleエージェントのサービスアカウントがCloud Volumes ONTAPプロジェクトで必要なすべての権限を持っていることを確認してください。Consoleエージェントのサービスアカウントに他のプロジェクトへのアクセス権限を付与する方法については、 "エージェントで使用するGoogle Cloudサービスアカウントを作成します"を参照してください。
-
変換を開始する前に、Cloud Volumes ONTAPシステムのルートディスクとブートディスクのスナップショットを取得することをお勧めします。
プライベートモードまたはプロテクトモードの展開の場合、以下の追加要件を満たしていることを確認してください:
-
最新バージョンのConsoleエージェントがインストールされていることを確認してください。NetApp Support Siteから製品インストーラをダウンロードし、エージェントがInfrastructure Manager APIを使用できるように、ホストにエージェントを手動でインストールします。
-
ツールをプライベートモードで実行している場合は、他のAPIに加えてCloud Build APIも有効にしていることを確認してください。 "Google Cloud API を有効にする"を参照してください。
-
プライベートモードまたは保護された環境でのデプロイメントの場合、ネットワーク構成が完了し、ワーカープールが作成されていることを確認してください。"プライベートモードまたは保護された環境でのインフラストラクチャマネージャの構成" を参照してください。
-
-
変換ツールは次のドメインを使用します。ネットワークのポート 443 で有効にします:
ドメイン ポート プロトコル 送受信方向 目的 cloudresourcemanager.googleapis.com
443
TCP
EGRESS(イーグレス)
プロジェクトの検証
deploymentmanager.googleapis.com
443
TCP
EGRESS(イーグレス)
デプロイメントの検出
config.googleapis.com
443
TCP
EGRESS(イーグレス)
インフラストラクチャ マネージャ API
storage.googleapis.com
443
TCP
EGRESS(イーグレス)
GCS バケット操作
iam.googleapis.com
443
TCP
EGRESS(イーグレス)
サービスアカウントの検証
compute.googleapis.com
443
TCP
EGRESS(イーグレス)
Google Cloud と Terraform のインポートとプランで使用される Compute API 呼び出し
cloudbuild.googleapis.com
443
TCP
EGRESS(イーグレス)
ビルド操作はプライベートモードでのみ必要です
openidconnect.googleapis.com
443
TCP
EGRESS(イーグレス)
認証
oauth2.googleapis.com
443
TCP
EGRESS(イーグレス)
OAuth2 トークン交換
registry.terraform.io
443
TCP
EGRESS(イーグレス)
Terraform プロバイダー レジストリ
releases.hashicorp.com
443
TCP
EGRESS(イーグレス)
Terraform バイナリのダウンロード
apt.releases.hashicorp.com
443
TCP
EGRESS(イーグレス)
HashiCorp APT リポジトリ
us-central1-docker.pkg.dev
443
TCP
EGRESS(イーグレス)
GCP Artifact Registry
metadata.google.internal
80
HTTP
内部
VM メタデータと認証トークン
pypi.org
443
TCP
EGRESS(イーグレス)
Python パッケージインデックス
files.pythonhosted.org
443
TCP
EGRESS(イーグレス)
Python パッケージのダウンロード
checkpoint-api.hashicorp.com
443
TCP
EGRESS(イーグレス)
Terraformのバージョンチェック
download.docker.com
443
TCP
EGRESS(イーグレス)
Docker APTリポジトリ
security.ubuntu.com
80/443
TCP
EGRESS(イーグレス)
Ubuntuのセキュリティアップデート
*.gce.archive.ubuntu.com
80
TCP
EGRESS(イーグレス)
Ubuntu パッケージミラー
ツールを実行するための環境を準備する
ツールを実行する前に、これらの手順を実行してください。
-
ロールを作成し、サービス アカウントに関連付けます:
-
以下の権限を持つYAMLファイルを作成してください。
title: NetApp Dm TO IM Convert Solution description: Permissions for the service account associated with the VM where the tool will run. stage: GA includedPermissions: - compute.addresses.get - compute.disks.get - compute.forwardingRules.get - compute.healthChecks.get - compute.instanceGroups.get - compute.instances.get - compute.regionBackendServices.get - config.deployments.create - config.deployments.get - config.deployments.getLock - config.deployments.lock - config.deployments.unlock - config.deployments.update - config.deployments.delete - config.deployments.updateState - config.operations.get - deploymentmanager.deployments.get - deploymentmanager.deployments.list - deploymentmanager.manifests.get - iam.serviceAccounts.get - storage.buckets.create - storage.buckets.get - storage.objects.create - storage.objects.delete - storage.objects.get - storage.objects.listプライベートモードまたは保護されたデプロイメントに追加の権限を含める
ツールをプライベートモードまたは保護された環境で実行している場合は、YAMLファイルに `cloudbuild.workerpools.get`権限も追加してください。
プロジェクト間展開のための追加権限を含める(1つのプロジェクトにConsoleエージェント、別のプロジェクトにCloud Volumes ONTAP)
クロスプロジェクト展開では、Consoleエージェントのプロジェクト用に前のYAMLファイルを作成します。Cloud Volumes ONTAPリソースが存在するプロジェクト用に、次の権限を持つ2番目のYAMLファイルを作成する必要があります:
title: NetApp Dm TO IM Convert Solution for Cross Project description: Permissions for the service account associated with the VM where the tool will run for the project where CVO resources resides. stage: GA includedPermissions: - compute.addresses.get - compute.disks.get - compute.forwardingRules.get - compute.healthChecks.get - compute.instanceGroups.get - compute.instances.get - compute.regionBackendServices.get - deploymentmanager.deployments.get - deploymentmanager.deployments.list - deploymentmanager.manifests.get - resourcemanager.projects.get -
Consoleエージェントのプロジェクトで、YAMLファイルに定義された権限を持つカスタムロールをGoogle Cloudで作成します。クロスプロジェクト設定では、Cloud Volumes ONTAPリソースが存在するプロジェクトでもこのロールを作成します。
`gcloud iam roles create dmtoim_convert_tool_role --project=PROJECT_ID \
--file=YAML_FILE_PATH`詳細については、 "カスタムロールの作成と管理"を参照してください。 -
VM の作成に使用するサービス アカウントにカスタム ロールを関連付けます。
-
`roles/iam.serviceAccountUser`ロールをこのサービス アカウントに追加します。 "サービス アカウントの概要"を参照してください。
-
プロジェクトでIAMサービスアカウント認証情報APIを有効にします:
gcloud services enable iamcredentials.googleapis.com --project=PROJECT_ID -
作成したサービスアカウントがConsoleエージェントサービスアカウントの権限を借用できるようにします。そのためには、作成したサービスアカウントに `Service Account Token Creator`ロールを付与します。
gcloud iam service-accounts add-iam-policy-binding \ CONSOLE_AGENT_SA@PROJECT_ID.iam.gserviceaccount.com \ -- member="serviceAccount:CONVERT_VM_SA@PROJECT_ID.iam.gserviceaccount.com" \ -- role="roles/iam.serviceAccountTokenCreator" \ -- project=PROJECT_ID
-
-
次の構成でVMを作成します。このVM上でツールを実行します。
-
マシンタイプ:Google Compute Engine マシンタイプ e2-medium
-
OS:要件に応じて、次のいずれかのイメージを選択します。
-
Ubuntu 26.04 LTS Minimal (ubuntu-2604-resolute-amd64)
-
SUSE Linux Enterprise Server 15 SP7 x86_64
-
-
ネットワーク:HTTPおよびHTTPSを許可するファイアウォール
-
ディスクサイズ:20GB
-
セキュリティ:サービス アカウント:作成したサービス アカウント
-
セキュリティ:アクセス スコープ - 各 API のアクセス セット:
-
クラウドプラットフォーム:有効
-
Compute Engine:読み取り専用
-
ストレージ:読み取り専用(デフォルト)
-
Google Cloud Logging(旧 Stackdriver Logging)API:書き込み専用(デフォルト)
-
Stackdriver Monitoring(現在は Google Cloud Operations の一部)API:書き込み専用(デフォルト)
-
サービス管理:読み取り専用(デフォルト)
-
サービス制御:有効(デフォルト)
-
Google Cloud Trace(旧Stackdriver Trace):書き込みのみ(デフォルト)
-
-
-
SSH を使用して新しく作成した VM に接続します:
gcloud compute ssh dmtoim-convert-executor-vm --zone <region where VM is deployed> -
NSS クレデンシャルを使用して "NetAppサポート サイト"から変換ツールをダウンロードします:
wget <download link from NetApp Support site> -
ダウンロードしたファイルを展開します:
unzip <downloaded file name>
-
次の前提条件パッケージをダウンロードしてインストールします:
-
Docker:28.2.2 build 28.2.2-0ubuntu1 以降
-
Terraform:1.14.1 以降
-
Python:3.13.7、python3-pip、python3 venv
sudo apt-get update sudo apt-get install python3-pip python3-venv -y wget -O - https://apt.releases.hashicorp.com/gpg | sudo gpg --dearmor -o /usr/share/keyrings/hashicorp-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/hashicorp-archive-keyring.gpg] https://apt.releases.hashicorp.com noble main" | sudo tee /etc/apt/sources.list.d/hashicorp.list sudo apt update && sudo apt install terraform sudo apt-get install -y docker.io sudo systemctl start dockerGoogle Cloud CLI `gcloud`は VM にプリインストールされています。
-
-
Python をセットアップします:
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2 -
パッケージをインストールするために pip3 をインストールします:
python3.11 -m ensurepip --upgrade -
Terraform をインストールします:
wget https://releases.hashicorp.com/terraform/1.7.4/terraform_1.7.4_linux_amd64.zip unzip terraform_1.7.4_linux_amd64.zip sudo mv terraform /usr/local/bin/ rm terraform_1.7.4_linux_amd64.zip -
Google Cloud SDK(gcloud)をインストールする
curl https://sdk.cloud.google.com | bash exec -l $SHELL
変換ツールを実行する
以下の手順に従って、UbuntuとSUSE Linux Enterprise Serverの両方で変換ツールを実行してください。
-
現在のユーザーをDockerグループに追加すると、ツールは `sudo`特権なしでDockerを使用できるようになります。
sudo usermod -aG docker $USER newgrp docker -
変換ツールをインストールします:
cd <folder where you extracted the tool> ./install.shこれにより、ツールは隔離された環境にインストールされ
dmconvert-venv、必要なソフトウェアパッケージがすべてインストールされていることを確認します。 -
ツールがインストールされている環境を入力します:
source dmconvert-venv/bin/activate -
`non-sudo`ユーザーとして変換ツールを実行します。Consoleエージェントが使用するのと同じサービスアカウントを使用し、そのサービスアカウントにすべての "Google Cloud Infrastructure Manager に必要な権限"があることを確認してください。
dmconvert \ --cvo-project-id=<the Google Cloud project ID for the Cloud Volumes ONTAP deployment> \ --cvo-name=<Cloud Volumes ONTAP system name> \ --service-account=<the service account attached to the Console agent>ツールをクロスプロジェクト展開で実行する(1つのプロジェクトにConsoleエージェント、別のプロジェクトにCloud Volumes ONTAP)
Cloud Volumes ONTAPシステムが、Consoleエージェントが配置されているプロジェクトとは別のプロジェクトにある場合は、 `--console-agent-project-id`パラメータを指定します。
dmconvert \ --cvo-project-id=<the Google Cloud project ID for the Cloud Volumes ONTAP deployment> \ --console-agent-project-id=<the Google Cloud project ID for the Console agent> \ --cvo-name=<Cloud Volumes ONTAP system name> \ --service-account=<the service account attached to the Console agent> \プライベートモードまたは保護モードの環境でツールを実行します
プライベートモードまたは保護モードの環境でツールを実行するには、 `--worker-pool`パラメータを指定します。ワーカープールの構成については、"プライベートモードまたは保護された環境でのインフラストラクチャマネージャの構成"を参照してください。
dmconvert \ --cvo-project-id=<the Google Cloud project ID for the Cloud Volumes ONTAP deployment> \ --cvo-name=<Cloud Volumes ONTAP system name> \ --service-account=<the service account attached to the Console agent> \ --worker-pool=<worker pool name>
このツールは、すべてのCloud Volumes ONTAPシステムとSVMの詳細のリストを表示します。処理が完了すると、変換されたすべてのシステムのステータスを確認できます。変換された各システムは、Google Cloud ConsoleのInfrastructure Managerの下に_<system-name-imdeploy>_形式で表示されます。この形式は、NetApp ConsoleがInfrastructure Manager APIを使用してそのCloud Volumes ONTAPシステムを管理するようになったことを示しています。
|
|
変換後、Google Cloud ConsoleのDeployment Managerのデプロイメントオブジェクトを削除しないでください。このデプロイメントオブジェクトには、変換後のシステムをロールバックする際に必要となる可能性のある情報が含まれています。 |
変換をロールバックする必要がある場合は、同じ VM を使用する必要があります。すべてのシステムを変換し、Deployment Manager にロールバックする必要がない場合は、VM を削除できます。
変換をロールバックする
変換を続行したくない場合は、次の手順に従って Deployment Manager にロールバックできます:
-
同じツールを実行するために作成したVMで、次のコマンドを実行します:
dmconvert \ --cvo-project-id=<the Google Cloud project ID for the Cloud Volumes ONTAP deployment> \ --cvo-name=<Cloud Volumes ONTAP system name> \ --service-account=<the service account attached to the Console agent> \ --rollbackクロスプロジェクト展開の場合は、 `--console-agent-project-id`パラメータを指定します:
dmconvert \ --cvo-project-id=<the Google Cloud project ID for the Cloud Volumes ONTAP deployment> \ --console-agent-project-id=<the Google Cloud project ID for the Console agent> \ --cvo-name=<Cloud Volumes ONTAP system name> \ --service-account=<the service account attached to the Console agent> \ --rollback -
ロールバックが完了するまでお待ちください。