前書き

本番環境ではAzure Blob Storageをオブジェクトストレージとして使用していますが、ローカル開発環境ではクラウド環境と切り離して開発したいと考え、Azure StorageのエミュレーターであるAzuriteを利用しました。
AzuriteをDockerComposeで構築する際に、Blobコンテナの作成までをCompose内で自動化しているケースがパッと見つかれなかったので本記事を作成しました。

対応方針

Azurite（Azure Storage Emulator） をDocker Composeで立ち上げて、Azure Blob Storageの代替として使う。
起動時に Azurite の初期設定として、あらかじめBlobコンテナを作成する。
Laravelのソースコードで、本番とローカルを環境変数だけで切り替えられるようにする。

実装

1. ライブラリのインストール

まず、Azure Blob Storage にアクセスするためのライブラリを Laravel プロジェクトに導入します。

composer require microsoft/azure-storage-blob

2. `.env` の設定

クラウドのAzure Blob Storageではなく、ローカルのAzuriteに接続するための設定例です。AZURE_BLOB_CONNECTION_STRINGのAccountKeyについて、Base64形式でないと後続の「az storage container create」がエラーになったため、ダミーのBase64形式としています。

AZURE_BLOB_CONNECTION_STRING="DefaultEndpointsProtocol=http;AccountName=localblobaccount;AccountKey=Eby8vdM02xNo72UNZ4lCUQ==;BlobEndpoint=http://azurite:10000/localblobaccount"
AZURE_BLOB_ENDPOINT=http://localhost:10000/localblobaccount/local-container/
AZURE_BLOB_CONTAINER_NAME=local-container

3. `docker-compose.yml` でAzuriteコンテナと初期設定のコンテナを追加

下記の例では azurite というサービスでAzuriteを起動し、azurite-init というサービスでBlobコンテナを作成するコマンドを実行しています。

version: '3.8'
services:
  # ...（他のサービス設定など）

  #*# Azurite (Azure Storage Emulator) #*#
  azurite:
    container_name: azurite_${APP_NAME}
    image: mcr.microsoft.com/azure-storage/azurite:latest
    ports:
      - "10000:10000"
    volumes:
      - azurite-store:/data
    environment:
      AZURITE_ACCOUNTS: localblobaccount:Eby8vdM02xNo72UNZ4lCUQ==
    restart: always

  # Azurite上にcontainerを作成
  azurite-init:
    container_name: azurite_init_${APP_NAME}
    image: mcr.microsoft.com/azure-cli
    depends_on:
      - azurite
    entrypoint:
      - "/bin/sh"
    command:
      - "-c"
      - |
        echo 'Waiting for azurite...'
        sleep 3
        az storage container create \
            --name local-container \
            --account-name localblobaccount \
            --account-key Eby8vdM02xNo72UNZ4lCUQ== \
            --blob-endpoint http://azurite:10000/localblobaccount \
            --public-access blob
        echo 'Done.'

volumes:
  azurite-store:

上記では、azurite-init コンテナで az storage container create ... コマンドを実行し、Azurite上に local-container というBlobコンテナを作成しています。--public-access blob を指定しているため、特定のパスを直接URLで開くことが可能になります。

4. Laravelコントローラでファイルアップロード処理

以下は例として、ローカルの neko.jpg をAzuriteにアップロードするコードです。createBlockBlob メソッドでBlobへアップロードしています。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use MicrosoftAzure\Storage\Blob\BlobRestProxy;
use MicrosoftAzure\Storage\Blob\Models\CreateBlockBlobOptions;
use Illuminate\Support\Str;

class BlobSampleController extends Controller
{
    public function uploadLocalImage()
    {
        // 環境変数から直接取得
        $connectionString = env('AZURE_BLOB_CONNECTION_STRING');
        $blobEndpoint     = env('AZURE_BLOB_ENDPOINT');
        $containerName    = env('AZURE_BLOB_CONTAINER_NAME');

        // Blobクライアントの生成
        $blobClient = BlobRestProxy::createBlobService($connectionString);

        // ローカルの画像ファイル（例：project_root/neko.jpg）を読み込み
        $localFilePath = base_path('neko.jpg');
        $content = fopen($localFilePath, 'r');

        // アップロード先パスとファイル名をランダム生成（例：XXX/image/YYY.jpg）
        $uploadPath = Str::random(10) . '/image/';
        $fileName   = Str::random(10) . '.jpg';

        // Blobの作成オプション（ここでは MIME タイプを設定）
        $options = new CreateBlockBlobOptions();
        $options->setContentType('image/jpeg');

        // アップロード実行
        $blobClient->createBlockBlob(
            $containerName,
            $uploadPath . $fileName,
            $content,
            $options
        );

        // 成功レスポンス（URL を含む）
        return response()->json([
            'message'  => 'アップロード成功',
            'blob_url' => $blobEndpoint . $uploadPath . $fileName,
        ]);
    }
}

実装後、Laravelプロジェクトを起動して uploadLocalImage() を呼び出すと、Azuriteに対して画像がアップロードされます。JSONレスポンスに含まれる blob_url にアクセスすると、実際にアップロードされた画像をブラウザから確認できます。

参考

どなたかの参考になれば嬉しいです！