Skip to main content
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

既存の Cloud Volumes ONTAP デプロイメントを Infrastructure Manager に変換

共同作成者 netapp-manini

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 バケットに保存します。これらのバケットには追加費用が発生する可能性がありますが、バケットやそのコンテンツを編集または削除しないでください:

  • gs://netapp-cvo-infrastructure-manager-<project id>:新規Cloud Volumes ONTAP環境の導入に使用されるONTAPバージョンおよびSVM Terraformテンプレート用。このバケット内の `dm-to-im-convert`バケットには、Cloud Volumes ONTAP Terraformファイルが含まれています。

  • <gcp project number>-<region>-blueprint-config:Google Cloud Terraform アーティファクトを保存します。

開始する前に
  • 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 パッケージミラー

ツールを実行するための環境を準備する

ツールを実行する前に、これらの手順を実行してください。

手順
  1. ロールを作成し、サービス アカウントに関連付けます:

    1. 以下の権限を持つ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
    2. Consoleエージェントのプロジェクトで、YAMLファイルに定義された権限を持つカスタムロールをGoogle Cloudで作成します。クロスプロジェクト設定では、Cloud Volumes ONTAPリソースが存在するプロジェクトでもこのロールを作成します。
      `gcloud iam roles create dmtoim_convert_tool_role --project=PROJECT_ID \
      --file=YAML_FILE_PATH`詳細については、 "カスタムロールの作成と管理"を参照してください。

    3. VM の作成に使用するサービス アカウントにカスタム ロールを関連付けます。

    4. `roles/iam.serviceAccountUser`ロールをこのサービス アカウントに追加します。 "サービス アカウントの概要"を参照してください。

    5. プロジェクトでIAMサービスアカウント認証情報APIを有効にします:

      gcloud services enable iamcredentials.googleapis.com --project=PROJECT_ID
    6. 作成したサービスアカウントが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
  2. 次の構成で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):書き込みのみ(デフォルト)

  3. SSH を使用して新しく作成した VM に接続します: gcloud compute ssh dmtoim-convert-executor-vm --zone <region where VM is deployed>

  4. NSS クレデンシャルを使用して "NetAppサポート サイト"から変換ツールをダウンロードします: wget <download link from NetApp Support site>

  5. ダウンロードしたファイルを展開します: unzip <downloaded file name>

Ubuntu
  1. 次の前提条件パッケージをダウンロードしてインストールします:

    • 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 docker

      Google Cloud CLI `gcloud`は VM にプリインストールされています。

SUSE Linux Enterprise Server
  1. Python をセットアップします: sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2

  2. パッケージをインストールするために pip3 をインストールします: python3.11 -m ensurepip --upgrade

  3. 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
  4. Google Cloud SDK(gcloud)をインストールする

    curl https://sdk.cloud.google.com | bash
    exec -l $SHELL

変換ツールを実行する

以下の手順に従って、UbuntuとSUSE Linux Enterprise Serverの両方で変換ツールを実行してください。

手順
  1. 現在のユーザーをDockerグループに追加すると、ツールは `sudo`特権なしでDockerを使用できるようになります。

    sudo usermod -aG docker $USER
    newgrp docker
  2. 変換ツールをインストールします:

    cd <folder where you extracted the tool>
     ./install.sh

    これにより、ツールは隔離された環境にインストールされ dmconvert-venv、必要なソフトウェアパッケージがすべてインストールされていることを確認します。

  3. ツールがインストールされている環境を入力します: source dmconvert-venv/bin/activate

  4. `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 にロールバックできます:

手順
  1. 同じツールを実行するために作成した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
  2. ロールバックが完了するまでお待ちください。