サービスの NFS ボリューム マウントを構成する

コンソール

1. Google Cloud コンソールで Cloud Run に移動します。

   Cloud Run に移動

2. [コンテナをデプロイ] をクリックし、[サービス] を選択して、新しいサービスを構成します。既存のサービスを構成する場合は、サービスをクリックし、[新しいリビジョンの編集とデプロイ] をクリックします。

3. 新しいサービスを構成する場合は、最初のサービス設定のページに入力してから、[コンテナ、ボリューム、ネットワーキング、セキュリティ] をクリックしてサービス構成ページを開きます。

4. [ボリューム] タブをクリックします。

   

   • [ボリューム] で、次の操作を行います。
     • [ボリュームを追加] をクリックします。
     • [ボリュームのタイプ] プルダウンで、ボリューム タイプとして [NFS] を選択します。
     • [ボリューム名] フィールドに、ボリュームに使用する名前を入力します。
     • [NFS サーバー] フィールドに、NFS ファイル共有のドメイン名または場所（IP_ADDRESS 形式）を入力します。
     • [パス] フィールドに、マウントする NFS サーバー ディレクトリのパスを入力します。
     • [完了] をクリックします。
   • [コンテナ] タブをクリックし、ボリュームをマウントするコンテナを開いて、コンテナを編集します。
   • [ボリュームのマウント] タブをクリックします。
   • [ボリュームをマウント] をクリックします。
   • メニューから NFS ボリュームを選択します。
   • ボリュームをマウントするパスを指定します。
   • [ボリュームをマウント] をクリックします。

5. [作成] または [デプロイ] をクリックします。

gcloud

• ボリュームを追加してマウントするには:

  gcloud run services update SERVICE \
  --add-volume=name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
  --add-volume-mount=volume=VOLUME_NAME,mount-path=MOUNT_PATH

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

  • SERVICE: 実際のサービスの名前。
  • VOLUME_NAME は、ボリュームに付ける名前に置き換えます。
  • IP_ADDRESS は、NFS ファイル共有の場所に置き換えます。
  • NFS_PATH は、NFS ファイル共有のパスに置き換えます（スラッシュで始まるパス、例: /example-directory）。
  • MOUNT_PATH は、ボリュームをマウントする相対パス（/mnt/my-volume など）に置き換えます。
  • VOLUME_NAME は、ボリュームに付ける名前に置き換えます。VOLUME_NAME 値は、ボリュームをボリューム マウントにマッピングするために使用されます。

• ボリュームを読み取り専用ボリュームとしてマウントするには:

  --add-volume=name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH,readonly=true

• 複数のコンテナを使用している場合は、まずボリュームを指定してから、各コンテナのボリューム マウントを指定します。

  gcloud run services update SERVICE \
  --add-volume=name VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
  --container CONTAINER_1 \
  --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH \
  --container CONTAINER_2 \
  --add-volume-mount volume= VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

1. 新しいサービスを作成する場合は、この手順をスキップします。既存のサービスを更新する場合は、その YAML 構成をダウンロードします。

   gcloud run services describe SERVICE --format export > service.yaml

2. 必要に応じて、MOUNT_PATH、VOLUME_NAME、IP_ADDRESS、NFS_PATH を更新します。複数のボリュームをマウントしている場合は、属性はその倍数になります。

   apiVersion: run.googleapis.com/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/execution-environment: gen2
       spec:
         containers:
         - image: IMAGE_URL
           volumeMounts:
           - name: VOLUME_NAME
             mountPath: MOUNT_PATH
         volumes:
         - name: VOLUME_NAME
           nfs:
             server: IP_ADDRESS
             path: NFS_PATH
             readOnly: IS_READ_ONLY

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

   • SERVICE は、Cloud Run サービスの名前に置き換えます。
   • MOUNT_PATH は、ボリュームをマウントする相対パス（/mnt/my-volume など）に置き換えます。
   • VOLUME_NAME は、ボリュームに付ける名前に置き換えます。VOLUME_NAME 値は、ボリュームをボリューム マウントにマッピングするために使用されます。
   • IP_ADDRESS は、NFS ファイル共有のアドレスに置き換えます。
   • NFS_PATH は、NFS ファイル共有のパスに置き換えます（スラッシュで始まるパス、例: /example-directory）。
   • ボリュームを読み取り専用にする場合は IS_READ_ONLY を True に置き換えます。書き込み可能にするには False に置き換えます。

3. 次のコマンドを使用して、サービスを作成または更新します。

   gcloud run services replace service.yaml

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE"
  location = "us-central1"

  template {
    execution_environment = "EXECUTION_ENVIRONMENT_GEN2"
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      volume_mounts {
        name       = "VOLUME_NAME"
        mount_path = "MOUNT_PATH"
      }
    }
    vpc_access {
      network_interfaces {
        network    = "default"
        subnetwork = "default"
      }
    }
    volumes {
      name = "VOLUME_NAME"
      nfs {
        server    = google_filestore_instance.default.networks[0].ip_addresses[0]
        path      = "NFS_PATH"
        read_only = IS_READ_ONLY
      }
    }
  }
}

resource "google_filestore_instance" "default" {
  name     = "cloudrun-service-ro"
  location = "us-central1-b"
  tier     = "BASIC_HDD"

  file_shares {
    capacity_gb = 1024
    name        = "share1"
  }

  networks {
    network = "default"
    modes   = ["MODE_IPV4"]
  }
}

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

• SERVICE は、Cloud Run サービスの名前に置き換えます。
• MOUNT_PATH は、ボリュームをマウントする相対パス（/mnt/nfs/filestore など）に置き換えます。
• VOLUME_NAME は、ボリュームに付ける名前に置き換えます。VOLUME_NAME 値は、ボリュームをボリューム マウントにマッピングするために使用されます。
• NFS_PATH は、NFS ファイル共有のパスに置き換えます（スラッシュで始まるパス、例: /share1）。
• ボリュームを読み取り専用にする場合は IS_READ_ONLY を True に置き換えます。書き込み可能にするには False に置き換えます。

Node.js

ファイル システム モジュールを使用して、ボリューム /mnt/my-volume に新しいファイルを作成するか、既存のファイルに追加します。

var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });

Python

ボリューム /mnt/my-volume に保存されているファイルに書き込みます。

f = open("/mnt/my-volume/sample-logfile.txt", "a")

Go

os パッケージを使用して、ボリューム /mnt/my-volume に新しいファイルを作成します。

f, err := os.Create("/mnt/my-volume/sample-logfile.txt")

Java

Java.io.File クラスを使用して、ボリューム /mnt/my-volume にログファイルを作成します。

import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");