この記事の目的

Azure Function のアプリで FFmpeg を使えるようにする

背景

個人開発しているアプリが音声ファイルを扱うもので、ライブラリが FFmpeg を必要としていた。
Azure Functions Core Tools でのローカル開発時には exe インストールするだけで済んだが、Azure Functions にデプロイするにあたって当然 function にも FFmpeg を仕込まないといけない。そのためどうやって使えるようにするか試行錯誤した。

当初 Docker コンテナーイメージを作成して Azure Functions にデプロイしていたものの (後述)、アプリを改修するたびのビルド&デプロイにものすごく時間がかかり、辟易していた。
後に GitHub Actions での CI/CD の手軽さを知ってしまったので、脱 Docker する方法を模索した。

解決方法

Azure ストレージのファイル共有に FFmpeg のバイナリファイルを配置する
Function Appにストレージのファイル共有をマウントする
Function のコードで FFmpeg の PATH を通す

シンプル。

実は依存関係とサードパーティ製ライブラリを Azure Functions に取り込む | Microsoft Learn で紹介されている。（全く気付かなかった）

実装

以下の説明では Python v2 モデルを使用しています。

Azure ストレージのファイル共有に FFmpeg のバイナリファイルを配置する

FFmpeg 公式 > [Download] > Linux Static Builds > [32-bit and 64-bit for kernel 3.2.0 and above] からバイナリファイルをダウンロード
- ffmpeg-git-amd64-static.tar.xz については動作確認済み
任意の Azure ストレージにファイル共有を作成しておく
- ストレージアカウントは Premium Files でなく Standard v2 のものでOK
ダウンロードした tar.xz を解凍し、中のファイルをファイル共有に配置する

ここでは fs01 というファイル共有に ffmpeg ディレクトリを作成し、その中に配置している

（ffmpeg ディレクトリ）

バイナリファイルは ffmpeg と ffprobe の両方を配置する必要があります。

Function App にストレージのファイル共有をマウントする

Azure CLI でマウントを実行（Windows での例）

Azure PowerShell にも同様のコマンドは用意されている（New-AzWebAppAzureStoragePath）

$resourceGroup = "リソースグループ名"
$functionApp = "Function App 名"
$shareId = "任意の文字列 (複数のファイル共有をマウントした時に一意であればOK)"
$share = "ファイル共有名"
$mountPath = "任意のマウントパス"
$AZURE_STORAGE_ACCOUNT = "ストレージアカウント名"
$AZURE_STORAGE_KEY = "ストレージアカウントキー"

az webapp config storage-account add `
--resource-group $resourceGroup `
--name $functionApp `
--custom-id $shareId `
--storage-type AzureFiles `
--share-name $share `
--mount-path $mountPath `
--account-name $AZURE_STORAGE_ACCOUNT `
--access-key $AZURE_STORAGE_KEY

実行結果は az webapp config storage-account list で確認できる

マウントしたファイル共有は Function App のコンテナーから確認できる（= /st01fs01）

ffmpeg ディレクトリ下に ffmpeg, ffprobe を確認できる

ファイル共有は Kudu サービス（アプリとは別コンテナー）からも確認できる

＊ Azure ポータルでの設定について

上記のマウント操作は Azure ポータルからも設定できる場合もあるが、必ずできるわけではなく、確認した範囲では何かしらの条件があるっぽい

App Service Plan ✅
Consumption ✅
Flex Consumption ✖
後述のようにコンテナー化したもの ✖

Function のコードで FFmpeg の PATH を通す

ドキュメントではマウントパスを直接参照する方法は紹介されているものの、やりたいのは PATH を通すこと（= ライブラリに FFmpeg を使わせたい）

マウントパスを Azure Functions の環境変数として設定

PATH にマウントパスを追記する（プログラム内でのみ PATH を通させる）

function_app.py

FFMPEG_PATH = os.getenv("ffmpeg_path")

# 本番環境の Azure Functions でのみ実行
# プログラム内でのみ環境変数を上書きして PATH を通す
if PY_ENV == "production":
    os.environ["PATH"] = os.environ["PATH"] + os.pathsep + FFMPEG_PATH
else:
    pass

これで各ライブラリが FFmpeg を使えるようになる。

補足（Docker での実装パターン）

上記一切のマウント作業をせずとも、Docker コンテナーイメージでも実行環境を作れる。
ビルド時に apt-get install -y ffmpeg させるだけ。
ただし先述の通りビルド&デプロイにものすごい時間がかかる場合がある。
当然コンテナーなので動作の確実性は高い。安定性を重視するならこちらでも全然アリ。

Dockerfile

FROM mcr.microsoft.com/azure-functions/python:4-python3.12-appservice

ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

RUN apt-get update && \
    apt-get install -y ffmpeg && \
    rm -rf /var/lib/apt/lists/*

COPY requirements.txt /

RUN python -m pip install --upgrade pip && \
    python -m pip install -r /requirements.txt

COPY . /home/site/wwwroot

上記の Dockerfile は func init --docker-only で生成できるもので、コンテナーイメージだけ SSH 対応版に変更しています。
使用できるイメージは Microsoft 公式リポジトリで確認できます。

参考リンク

Microsoft Learn 公式ドキュメント

FFmpeg 公式

FFmpeg

（FFmpeg を使っている個人開発アプリ）

LyriXer
- 楽曲中の歌詞を自動抽出するアプリ
AIsolator
- 楽曲のパートを分離するアプリ
Musigen (β)
- 画像から音楽を自動生成するアプリ