CloudRunにGCSをマウントしてローカルファイルシステムとして扱う方法

2025.09.30 XIMIX 北脇

はじめに

Cloud Runは、コンテナ化されたアプリケーションをサーバーレスで実行できる強力なプラットフォームです。しかし、アプリケーションがローカルファイルシステムとして永続的なデータにアクセスする必要がある場合、一時的なファイルシステムしかもたないコンテナ環境では課題が生じます。

この記事では、Cloud Runの機能を利用してCloud Storage (GCS) バケットをボリュームマウントし、コンテナ内からあたかもローカルディレクトリのようにGCSのデータにアクセスする方法について、設定方法を解説します。

参考URL：https://cloud.google.com/run/docs/configuring/services/cloud-storage-volume-mounts?hl=ja

従来のファイルシステムを扱う方法と課題

従来Cloud Runで大きなファイルを扱う場合システムは一時的なものです。永続化ストレージとしては設計されておらず、コンテナが停止したりスケールアウトしたりするとデータは失われます。
永続的なデータではないにせよ、一時的にファイルを利用する場合、Cloud Runではコンテナインスタンスに割り当てられたメモリ（/tmpなどにマップされる）を使用する必要がありました。

また、ファイルをメモリ内の一時領域に保存して利用する場合、特にサイズの大きなファイルを処理する際にファイルのサイズがそのままコンテナインスタンスのメモリ容量を圧迫します。特に大容量のファイルを扱う場合、Cloud Runに必要なメモリ容量が大量に必要となり、結果としてより高価なインスタンスタイプを選択する必要になります。

実施手順

それでは具体的な実施手順について記載します。まずはマウントするGCSのバケットを用意しましょう。設定で特に注意する点はありません。
今回は「cloudrun-example-test」というバケットを作成しました。

次にサンプルプログラムを作成します。

サンプルプログラム

Cloud Run上で動かすサンプルプログラムは下記になります。
サンプルプログラムはnodeで作成しています。

import express from 'express';
import fs from 'fs';

const app = express();

app.get('/', (req, res) => {
    fs.appendFileSync('/mnt/gcs-test/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });

    const name = process.env.NAME || 'World';
    res.send(`Hello ${name}!`);
});

const port = parseInt(process.env.PORT) || 8080;
app.listen(port, () => {
    console.log(`helloworld: listening on port ${port}`);
});

Cloud Runを利用する場合、サンプルプログラムのようなローカルファイルシステムへの保存はできませんでしたが、Cloud RunにマウントすることでGCSに保存が可能になりました。

次に、Cloud Runへのデプロイコマンドを記述します。

gcloud run deploy --source .  \
--add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
--add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

赤字部分がGCSのマウントに必要な部分になります。
各パラメータは下記になります。

MOUNT_PATH: ボリュームをマウントする相対パス（/mnt/my-volume など）
VOLUME_NAME: ボリュームに付ける名前
VOLUME_NAME 値は、ボリュームをボリュームマウントにマッピングするために使用
BUCKET_NAME: Cloud Storage バケットの名前

事前にGCS上にバケットは作成してください。また、MOUNT_PATHとプログラムのパスは同じにしてください。
では実際にデプロイしてみましょう。
作成したバケットとサンプルプログラムの例をもとにデプロイコマンドに値を入れてみると下記のようになります。

gcloud run deploy --source . \
--add-volume name=gcs-test,type=cloud-storage,bucket=cloudrun-example-test \
--add-volume-mount volume=gcs-test,mount-path=/mnt/gcs-test

デプロイ後下記のように表示されます。