Azure Functions Flex Consumption でコンテナーを使用して OS レベルの依存関係を利用する

Important

この機能はプレビュー中です。 プレビュー段階の機能は変更される場合があります。

コンテナを通じたOSレベルの依存関係サポートを利用することで、実行環境でアプリケーションコードや言語パッケージ以上のものを必要とするFlex Consumption関数アプリを実行できます。 アプリケーションと、その必要な言語およびOS依存関係を含むLinuxコンテナイメージを提供します。 Azureは引き続きFunctionsホスト、トリガー統合、ルーティング、およびスケーリングを提供しています。

Overview

関数コード、サポートされている Functions の言語ワーカー 1 つ、言語およびアプリケーションの依存関係、そして実行時にアプリが必要とするシステムパッケージ、ネイティブライブラリ、実行ファイル、フォント、証明書、その他のファイルを含む Linux コンテナイメージを作成します。

Azure は Functions ホストを実行・パッチ適用し、画像外でルーティング、トリガー統合、スケーリングを管理します。 この分離により、ワーカー環境をカスタマイズしつつ、画像表面積を減らし、Functions ホストを自分でパッケージ化、保護、更新する必要がなくなります。

Flex Consumptionはワーカーオンリーコンテナモデルを採用しています。 あなたのイメージは任意のウェブコンテナではありません。 また、Functions ホスト、言語ワーカー、アプリケーション、依存関係をまとめて別のホスティングオプションとしてパッケージ化した完全な Function App イメージでもありません。

オペレーティング レベルの依存関係をワーカー専用コンテナイメージでパッケージ化する完全な例については、Azure Functions Flex Consumption .NET 隔離コンテナサンプルを参照してください。

オペレーティング レベルの依存関係をワーカー専用コンテナイメージでパッケージ化する完全な例については、Azure Functions Flex Consumption Python コンテナサンプルを参照してください。

オペレーティング レベルの依存関係をワーカー専用コンテナイメージでパッケージ化する完全な例については、Azure Functions Flex Consumption Go コンテナサンプルを参照してください。

オペレーティング レベルの依存関係をワーカー専用コンテナイメージでパッケージ化する完全な例については、「Azure Functions Flex Consumption Node.js コンテナサンプル」を参照してください。

Benefits

  • アプリケーション、言語ワーカー、言語依存関係、OS レベルの依存関係を 1 つのバージョン付きのイメージにパッケージ化します。
  • ワーカー、言語ランタイム、依存関係の更新を、イメージを再構築、テスト、再デプロイすることでいつ採用するかを選択します。
  • Functions ホスト、トリガー統合、ルーティング、スケーリングは、イメージの外部で Azure による管理とパッチ適用のままにします。
  • イメージ内に含め、保護し、管理しなければならないコンポーネントを、完全な Function App イメージと比べて減らしましょう。

この機能を使用する状況

次の場合は、Flex Consumption の OS レベルの依存関係にコンテナを使用します:

  • Flex Consumption アプリには、言語パッケージマネージャーだけでは取得できない依存関係が必要です。
  • Linuxイメージはビルド、スキャン、パッチ、テスト、公開が可能です。
  • 選択したベースイメージと言語ワーカーバージョンをイメージで保持できます。

コンテナホスティングの選択肢を比較する

制御したいランタイムの部分に合うホスティングモデルを選択してください。

能力 Flex Consumption コンテナイメージ Elastic Premium または Dedicated (App Service) のカスタムイメージ Functions on Azure Container Apps
イメージ コントラクト ワーカー専用 Function App の完全なイメージ Function App の完全なイメージ
Functions ホスト/ランタイム Azure がイメージの外部で提供、運用、パッチ適用 イメージに含まれる、通常は Functions のベース イメージ由来 あなたのイメージに含まれる
イメージには以下が含まれています アプリ、1言語ワーカー、言語/アプリケーションの依存関係、OSパッケージ Functions ホスト、ワーカー、アプリ、および依存関係 Functions ホスト、ワーカー、アプリ、および依存関係
スケーリング Functions 管理の Flex Consumption スケーリング Functions 管理の Premium スケーリングまたは App Service プランのスケーリング コンテナアプリのスケーリング
Billing Standard Flex Consumption の課金 Elastic Premium または App Service プランの請求 コンテナアプリの請求
最適 Flexサーバーレスプラットフォーム契約を維持しつつ、OSレベルの依存関係を追加 App Service インフラストラクチャ上の Functions コンテナ全体を制御する Container Apps の機能で完全な Functions コンテナーを実行する

完全な Function App イメージの詳細については、「Azure Functions における Linux コンテナのサポート」を参照してください。

アーキテクチャと責任の境界

イベントまたは HTTP リクエストはまず Azure 管理下の Functions プラットフォームに到達します。 Azure は Functions ホストとランタイムを実行し、トリガーを評価し、呼び出しをルーティングし、インスタンスの追加または削除のタイミングを判断します。 呼び出しが準備完了すると、プラットフォームはそれをイメージ内の関数言語ワーカーに送信します。 言語ワーカーが関数アプリを読み込み、アプリは画像にパッケージされた言語、アプリケーション、OSレベルの依存関係を利用できます。

イメージには Functions ホストは含まれず、また置き換えられず、トリガー ルーティングを実装せず、プラットフォームのスケーリングを制御しません。 アプリケーション、言語ワーカー、ベースイメージ、および依存関係はイメージ内で管理します。 Microsoftはイメージの外部にあるFunctionsプラットフォームコンポーネントを維持・更新します。

アクティブな関数言語ワーカーは、プレビューサポートテーブルに記載されているワーカーのいずれかでなければなりません。 プレビューでは、任意の顧客開発の言語ワーカーやカスタムハンドラーで置き換えることはサポートしていません。 イメージには、サポートされている関数によって呼び出される Rust コンポーネントなど、他のランタイムや実行ファイルをアプリケーション依存関係として含めることができます。 ワンワーカー制限はアクティブな関数言語ワーカーに適用され、アプリにパッケージされた補助ランタイムやツールには適用されません。

プレビューでの言語サポート

プレビューでは以下の Functions 言語ワーカーをサポートしています。 サポートされているランタイム バージョン、ワーカー互換性情報、サンプル Dockerfile については、記事の上部で言語を選択して確認してください。

Functions の言語 ワーカーがどのように含まれるか
隔離された.NET アプリケーションのNuGet依存関係および公開出力を通じて含まれます
Python Python バージョン固有の Microsoft ワーカーアーティファクトとして追加されました
Node.js Microsoft によって公開された Node.js ワーカーアーティファクトとして追加されました
Go Go Worker SDKを通じて含まれ、アプリケーションバイナリにコンパイルされています

プレビュー中はFunctions の他の言語ワーカーはサポートされていません。

Prerequisites

開始する前に、次のものが必要です。

  • サポートされているプレビュー言語を使用するアプリケーション。
  • Docker互換イメージビルド環境。
  • 自分で管理できるLinuxまたは言語ベースのイメージ。
  • アプリケーションソースとその言語依存関係。
  • 必要なOSパッケージ、ネイティブライブラリ、フォント、ドライバー、またはツール。
  • コンテナレジストリへのアクセス。
  • イメージの構築、スキャン、プッシュ、および展開の許可。

プレビューはLinux amd64 イメージをサポートしています。

Flex Consumption コンテナモデルを理解する

あなたのイメージは次の役割を担います:

  • アプリケーションのペイロード。
  • サポートされている Functions 言語ワーカー 1 つ。
  • 言語およびアプリケーションの依存関係。
  • OSレベルの依存関係。
  • 選択したLinuxまたは言語ベースのイメージ。
  • イメージセキュリティ、脆弱性修復、および明示的なコンポーネントバージョン。

Azure は以下を担当します:

  • Functions ホスト
  • ルーティングとトリガー統合。
  • 関数で管理されるスケーリング。
  • イメージ外のプラットフォームコンポーネント。

Flex Consumption では、アプリケーションおよび組織の要件に最適な Linux または言語ベースのイメージを選択できます。 このイメージを基に、サポートされている Functions 言語ワーカー、アプリケーション、およびその依存関係をこのワーカー専用コンテナモデルに従って追加します。 Microsoft は、互換性のあるイメージ作成を支援するバージョン化されたワーカー アーティファクトやサンプル Docker ファイルを提供し、一方 Azure はイメージの外部にある Functions ホストを管理します。

ワーカースタートアップは言語ごとに異なります。 他の言語からエントリポイントをコピーする代わりに、 あなたの言語用のサンプル Dockerfile を使用してください。 プラットフォームはワーカーのRPC接続引数とアプリケーションディレクトリを提供します。 イメージは言語ワーカーまたはアプリケーションバイナリを直接起動します。Functions ホストをインストールまたは起動せず、プラットフォームのエンドポイント構成も含めません。

環境変数とスクリプトルート

Functions のホスト変数やワーカー接続環境変数は構成しません。 プラットフォームは、言語ワーカーが Azure 管理の Functions ホストと通信するために必要なワーカー ID 、接続、プロトコル、およびブートストラップの値を注入します。

Flex Consumption アプリがコンテナイメージを使用している場合は、アプリ設定 AzureWebJobsScriptRoot=/home/site/wwwroot設定してください。 画像は関数アプリケーションをそのパスに配置しなければなりません。 Azureは実行時にコンテナに設定を注入するため、Dockerfile でENV命令として宣言する必要はありません。 アプリケーションで必要とされる他のアプリ設定は引き続き使用できます。

コンテナイメージを使用するFlex Consumptionアプリには FUNCTIONS_WORKER_RUNTIME や FUNCTIONS_EXTENSION_VERSION を追加しないでください。 プラットフォームはこれらのランタイムの詳細をイメージの外側で管理します。

言語ワーカーを取得する

お使いの言語向けに文書化されている、サポートされているワーカー参照を使用してください。 Pythonおよび Node.js サンプルは、サポートされている最新のワーカーアーティファクトを指すMicrosoft管理型aka.ms参照を使用しています。 それらのデプロイツールは現在のアーティファクトの参照先を確定するかハッシュ化し、ワーカーの更新によってイメージのビルド入力が変更されるようにします。

公開されたSHA-256チェックサムを使用してダウンロードされたワーカーアーティファクトを確認します。 フローティングワーカー参照が更新された場合、更新されたワーカーを採用する前に、イメージを再構築、テスト、プッシュ、再デプロイします。 アプリケーション依存関係を通じて提供されるワーカーについては、アプリケーションプロジェクト内で依存関係のバージョンを指定します。

隔離された.NET

プレビューは .NET 10 および .NET 11 で .NET 隔離ワーカーモデルをサポートしています。 .NET 隔離アプリケーションは通常の NuGet 依存関係とビルド出力を通じて Functions ワーカーを含みます。 ワーカーはサポートされている各 .NET ランタイムバージョンごとに個別のアーティファクトとして公開されるわけではありません。 プロジェクト内の Microsoft.Azure.Functions.Worker および関連するパッケージバージョンを指定し、アプリケーションを /home/site/wwwroot に公開します。

プロジェクトSDKとして Azure.Functions.Sdk の最新バージョンを使用してください。 既存のプロジェクトについては、Azure.Functions.Sdk への移行に従ってください。

以下の最低パッケージバージョンを使用してください:

  • Microsoft.Azure.Functions.Worker バージョン 2.53.0-preview.1 以降。
  • Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCoreアプリが ASP.NET Core統合を使用している場合は、バージョン2.1.2-preview.1以降です。

Important

サポートされている .NET バージョンを使用してください。 サポートされている .NET ランタイムイメージと、互換性のある Functions ワーカーおよびアプリケーションの依存関係を選択・管理する責任はあなたにあります。

アプリケーションおよび展開ファイルの完全な内容については、Azure Functions Flex Consumption .NET 隔離コンテナサンプルをご覧ください。

.NET 分離サンプル Dockerfile

以下のサンプル Dockerfile は、.NET 分離アプリケーションを公開し、パブリッシュ出力を .NET 10 ランタイムイメージにコピーします。

FROM mcr.microsoft.com/dotnet/sdk:10.0-noble AS build

WORKDIR /src
COPY NuGet.config FlexDotnetWorker.csproj ./
RUN dotnet restore FlexDotnetWorker.csproj --runtime linux-x64 -p:PublishReadyToRun=true

COPY *.cs host.json ./

RUN dotnet publish FlexDotnetWorker.csproj --configuration Release --runtime linux-x64 --self-contained false \
    --no-restore -p:PublishReadyToRun=true --output /publish \
    && rm -f /publish/worker.config.json /publish/functions.metadata

FROM mcr.microsoft.com/dotnet/aspnet:10.0-noble

WORKDIR /home/site/wwwroot
COPY --from=build /publish/ ./

USER $APP_UID
ENTRYPOINT ["dotnet", "FlexDotnetWorker.dll"]

この例は .NET 10 を対象としています。 サポートされている別の .NET バージョンを選択したら、両方の .NET ベースイメージタグを同時に更新し、アプリケーションおよび Functions ワーカーパッケージのバージョンを検証します。

Python

プレビューは Python 3.13 から Python 3.15 までをサポートします。 Python イメージには、アプリケーション、Python 依存関係、OS レベルの依存関係、およびサポートされている Python Functions ワーカーのアーティファクトが含まれます。 ワーカーアーティファクトはイメージ内の Python ランタイムバージョンと一致しなければなりません。

Important

サポートされている Python バージョンとそれに対応するワーカーアーティファクトを使用してください。 ある Python バージョンのワーカーアーティファクトと、別の Python ランタイムバージョンを組み合わせないでください。

まずは Azure Functions Flex Consumption Python コンテナサンプル内のサンプル Dockerfile から始めてください。

サンプルアプリケーションでは azure-functions==2.3.0を使用します。 Python Dockerfileは、Microsoft管理aka.ms参照から現在サポートされているPythonワーカーをダウンロードし、公開されたSHA-256チェックサムによってダウンロードされたアーティファクトを検証し、それをイメージに展開します。 そのエントリーポイントは、Pythonワーカーを直接起動します。

Python Dockerfile

以下の値は、各 Python バージョンでサポートされているベースイメージおよびフローティングワーカー参照を示します:

Python バージョン TestVM Worker リファレンス
3.13 python:3.13-slim-bookworm https://aka.ms/azurefunctions/releases/python/3.13/worker/latest/azure-functions-python-worker-py313-linux-x64.tar.gz
3.14 python:3.14-slim-bookworm https://aka.ms/azurefunctions/releases/python/3.14/worker/latest/azure-functions-python-worker-py314-linux-x64.tar.gz
3.15 python:3.15-slim-bookworm https://aka.ms/azurefunctions/releases/python/3.15/worker/latest/azure-functions-python-worker-py315-linux-x64.tar.gz

この例は Python 3.15 を対象としています。 前のテーブルのPython 3.15ワーカー参照を含むworker-release-url.txtという名前のファイルを作成します。 Python 3.13または3.14を選択したら、ベースイメージ、ワーカー参照、ワーカーアーカイブ名をまとめて更新してください。

FROM python:3.15-slim-bookworm AS build

COPY worker-release-url.txt /tmp/worker-release-url.txt

RUN python -c "from pathlib import Path; from urllib.request import urlretrieve; url = Path('/tmp/worker-release-url.txt').read_text(encoding='utf-8').strip(); latest = 'https://aka.ms/azurefunctions/releases/python/3.15/worker/latest/azure-functions-python-worker-py315-linux-x64.tar.gz'; archive = '/tmp/azure-functions-python-worker-py315-linux-x64.tar.gz'; urlretrieve(latest, archive); urlretrieve(latest + '.sha256', archive + '.sha256'); urlretrieve(url + '.sha256', archive + '.expected.sha256')" \
    && cd /tmp \
    && cmp azure-functions-python-worker-py315-linux-x64.tar.gz.sha256 azure-functions-python-worker-py315-linux-x64.tar.gz.expected.sha256 \
    && sha256sum --check --strict azure-functions-python-worker-py315-linux-x64.tar.gz.sha256 \
    && mkdir -p /opt/functions-worker \
    && tar -xzf azure-functions-python-worker-py315-linux-x64.tar.gz -C /opt/functions-worker \
    && rm azure-functions-python-worker-py315-linux-x64.tar.gz azure-functions-python-worker-py315-linux-x64.tar.gz.sha256 azure-functions-python-worker-py315-linux-x64.tar.gz.expected.sha256

COPY requirements.txt /tmp/requirements.txt
RUN --mount=type=secret,id=pip_config,target=/etc/pip.conf \
    python -m pip install --no-cache-dir --only-binary=:all: \
    --target /home/site/wwwroot/.python_packages/lib/site-packages \
    -r /tmp/requirements.txt

FROM python:3.15-slim-bookworm

RUN groupadd --gid 10001 app \
    && useradd --uid 10001 --gid 10001 --create-home --shell /usr/sbin/nologin app

WORKDIR /home/site/wwwroot
COPY --from=build /opt/functions-worker/ /opt/functions-worker/
COPY --from=build /tmp/worker-release-url.txt /opt/functions-worker-release-url.txt
COPY --from=build /home/site/wwwroot/.python_packages/ ./.python_packages/
COPY function_app.py host.json ./

USER 10001:10001
ENTRYPOINT ["python", "/opt/functions-worker/worker.py"]

Azure サンプルは、イメージ コンテキストをステージングする前に、フローティング ワーカー参照をバージョン付きの GitHub リリース URL に固定します。 Dockerfileは、選択したリリースのチェックサムが aka.msを通じて現在公開されているチェックサムと一致することを求め、その後アーカイブを検証します。 参照が一致しない場合、ビルドは失敗します。

Dockerfileおよびアプリケーションファイルが入っているディレクトリから、イメージをビルドしてプッシュします。 この例では Azure Container Registry とシステム割り当て ID を使用します。

az acr login --name <ACR_NAME>

docker build --platform linux/amd64 --progress plain \
  -f Dockerfile \
  -t <ACR_NAME>.azurecr.io/<REPOSITORY>:python315 .

docker push <ACR_NAME>.azurecr.io/<REPOSITORY>:python315

az functionapp create -g <RESOURCE_GROUP> -n <APP_NAME> -s <STORAGE_ACCOUNT> \
  --flexconsumption-location <REGION> \
  --deployment-image <ACR_NAME>.azurecr.io/<REPOSITORY>:python315 \
  --deployment-image-auth-type SystemAssignedIdentity \
  --assign-identity [system] --role AcrPull --scope <ACR_RESOURCE_ID>

az functionapp deployment config show -g <RESOURCE_GROUP> -n <APP_NAME>

Go

プレビューはGo 1.27をサポートしています。 Goイメージには、アプリケーション、OSレベルの依存関係、およびアプリケーション バイナリにコンパイルされた、サポートされている Go Functions ワーカーと SDK が含まれています。 ワーカーはサポートされている各 Go バージョンごとに個別のアーティファクトとして公開されるわけではありません。

Important

サポートされている Go バージョンを使用してください。 サポートされた Go ツールチェーンと対応する Go Functions ワーカー SDK バージョンでアプリケーションをコンパイルする責任はあなたにあります。

まずは Azure Functions Flex Consumption Go コンテナサンプル内のサンプル Dockerfile から始めてください。

サンプルgo.modファイルはバージョンv1.0.2github.com/azure/azure-functions-golang-worker指定しています。 Go Dockerfileはマルチステージビルドを使用し、コンパイル済みアプリケーションバイナリを直接起動します。

Go Dockerfile

FROM golang:1.27-bookworm AS build
WORKDIR /src

COPY go.mod go.sum ./
RUN go mod download

COPY *.go ./
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
    go build -mod=readonly -trimpath -ldflags="-s -w" -o /out/app .

FROM ubuntu:24.04

WORKDIR /home/site/wwwroot
COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
COPY --from=build --chmod=0555 /out/app ./app
COPY host.json ./

USER 10001:10001
ENTRYPOINT ["/home/site/wwwroot/app"]

Dockerfileおよびアプリケーションファイルが入っているディレクトリから、イメージをビルドしてプッシュします。 この例では Azure Container Registry とシステム割り当て ID を使用します。

az acr login --name <ACR_NAME>

docker build --platform linux/amd64 --progress plain \
  -f go.Dockerfile \
  -t <ACR_NAME>.azurecr.io/<REPOSITORY>:go127 .

docker push <ACR_NAME>.azurecr.io/<REPOSITORY>:go127

az functionapp create -g <RESOURCE_GROUP> -n <APP_NAME> -s <STORAGE_ACCOUNT> \
  --flexconsumption-location <REGION> \
  --deployment-image <ACR_NAME>.azurecr.io/<REPOSITORY>:go127 \
  --deployment-image-auth-type SystemAssignedIdentity \
  --assign-identity [system] --role AcrPull --scope <ACR_RESOURCE_ID>

az functionapp deployment config show -g <RESOURCE_GROUP> -n <APP_NAME>

Node.js

プレビューは Node.js 24をサポートしています。 Node.js イメージにはアプリケーション、Node.js 依存関係、OSレベルの依存関係、およびサポートされている Node.js 関数ワーカーのアーティファクトが含まれます。 ワーカーはサポートされている各 Node.js ランタイムバージョンごとに個別のアーティファクトとして公開されません。

Important

サポートされている Node.js バージョンを使用してください。 サポート対象となる Node.js ベースイメージと互換性のある関数ワーカーおよびアプリケーションの依存関係を選択し、管理する責任があります。

まずは Azure Functions Flex Consumption Node.js コンテナサンプルにあるサンプル JavaScript または TypeScript Dockerfile から始めてください。

サンプルアプリケーションは4.17.0バージョン@azure/functionsを使用しています。 Node.js Dockerfile は、Microsoft管理されたaka.ms参照から現在サポートされている Node.js ワーカーをダウンロードし、それをイメージに展開します。 サンプルの展開ツールは、ダウンロードしたアーティファクトのSHA-256値を計算し、その値を画像コンテキストハッシュに含めて、検証のためにイメージビルドに渡します。 イメージのエントリーポイントは Node.js ワーカーを直接起動します。

Node.js Dockerfile

以下の Dockerfiles は、サンプルの JavaScript および TypeScript プロジェクトのレイアウトを使用しています。 アプリケーションのディレクトリ構造とビルド出力に合うように、COPY コマンドとビルド手順を更新します。 TypeScriptの場合、この例はアプリケーションをコンパイルし、生成されたJavaScriptを distからコピーします。 distディレクトリはサンプル慣行であり、Flex Consumption コンテナモデルの要件ではありません。 package.json の main フィールドが生成された JavaScript ファイルを識別していることを確認してください。

FROM node:24-bookworm-slim AS worker

ARG FUNCTIONS_NODE_WORKER_SHA256

ADD --checksum=sha256:${FUNCTIONS_NODE_WORKER_SHA256} \
    https://aka.ms/azurefunctions/releases/node/worker/latest/worker.tar.gz \
    /tmp/worker.tar.gz

RUN mkdir -p /opt/functions-worker \
    && tar -xzf /tmp/worker.tar.gz -C /opt/functions-worker \
    && rm /tmp/worker.tar.gz

FROM node:24-bookworm-slim AS dependencies
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --omit=dev --ignore-scripts --no-audit --no-fund

FROM node:24-bookworm-slim
WORKDIR /home/site/wwwroot
COPY --from=worker /opt/functions-worker/ /opt/functions-worker/
COPY --from=dependencies /app/node_modules/ ./node_modules/
COPY package.json host.json ./
COPY src/ ./src/

USER node
ENTRYPOINT ["node", "/opt/functions-worker/dist/src/nodejsWorker.js"]

Dockerfileおよびアプリケーションファイルが入っているディレクトリから、イメージをビルドしてプッシュします。 この例では Azure Container Registry とシステム割り当て ID を使用します。

(
  set -e

  az acr login --name <ACR_NAME>

  WORKER_URL=https://aka.ms/azurefunctions/releases/node/worker/latest/worker.tar.gz
  WORKER_FILE=azure-functions-nodejs-worker.tar.gz
  WORKER_DIR=$(mktemp -d)

  trap 'rm -f -- "$WORKER_DIR/$WORKER_FILE" "$WORKER_DIR/$WORKER_FILE.sha256"; rmdir -- "$WORKER_DIR"' EXIT

  curl --fail --location "$WORKER_URL" \
    --output "$WORKER_DIR/$WORKER_FILE"
  curl --fail --location "${WORKER_URL}.sha256" \
    --output "$WORKER_DIR/$WORKER_FILE.sha256"

  (
    cd "$WORKER_DIR"
    sha256sum --check --strict "$WORKER_FILE.sha256"
  )

  FUNCTIONS_NODE_WORKER_SHA256=$(
    sha256sum "$WORKER_DIR/$WORKER_FILE" | cut -d ' ' -f 1
  )

  docker build --platform linux/amd64 --progress plain \
    -f node24.Dockerfile \
    --build-arg FUNCTIONS_NODE_WORKER_SHA256="$FUNCTIONS_NODE_WORKER_SHA256" \
    -t <ACR_NAME>.azurecr.io/<REPOSITORY>:node24 .

  docker push <ACR_NAME>.azurecr.io/<REPOSITORY>:node24

  az functionapp create -g <RESOURCE_GROUP> -n <APP_NAME> -s <STORAGE_ACCOUNT> \
    --flexconsumption-location <REGION> \
    --deployment-image <ACR_NAME>.azurecr.io/<REPOSITORY>:node24 \
    --deployment-image-auth-type SystemAssignedIdentity \
    --assign-identity [system] --role AcrPull --scope <ACR_RESOURCE_ID>

  az functionapp deployment config show -g <RESOURCE_GROUP> -n <APP_NAME>
)

イメージをビルドする

サポートされている言語のサンプル Dockerfile を出発点として使用してください:

.NET 分離サンプル Docker ファイルからスタートします。

まずはPythonサンプルのDockerfileから始めましょう。

Go サンプルの Dockerfile から始めてください。

Node.js サンプルのDockerfileから始めてください。

サンプルの Dockerfile はコンテナイメージを組み立てます。これは Microsoft が提供するベースイメージではありません。

  1. 組織が信頼するソースからサポートされているLinuxまたは言語ベースのイメージを選択してください。
  2. サプライチェーンポリシーに従って、明示的なベースイメージバージョンタグまたは不可変ダイジェストを選択します。 latestのような浮動タグは避けてください。
  3. 必要なOSパッケージをインストールし、一時的なパッケージマネージャーデータを削除します。
  4. 言語およびアプリケーションの依存関係を復元またはインストールします。
  5. アプリケーションペイロードとサポートされている Functions 言語ワーカーを追加します。
  6. 言語固有のエントリポイントを、ご使用の言語用のサンプル Dockerfile に従って設定します。 プラットフォームのエンドポイント設定をイメージに組み込まないでください。
  7. 画像を作成してスキャンします。
  8. イメージが Linux amd64 をターゲットにしていること、および必要なファイルと実行権限が存在することを確認してください。
  9. バージョンタグまたはダイジェストを割り当てます。 両方の参照形式がサポートされていますが、決定論的なデプロイとロールバックにはダイジェストが推奨されます。

プレビュー版では、ローカルでコンテナイメージを実行またはテストするためのサポートされた開発者体験は提供されていません。

ローカルでの開発とテスト

関数コードは通常通りに開発してください。 言語のテストツールを使い、 func start を実行してソースアプリケーションをローカルで検証してください。

ソースレベルの検証が完了した後、公開されたイメージコントラクトと 、お使いの言語用のサンプル Dockerfile を使ってコンテナイメージを構築してください。 ビルドが成功したことを確認し、イメージアーキテクチャ、ファイル、および権限を検査できます。 プレビュー版では、ローカルでコンテナイメージを実行またはテストするためのサポートされた開発者体験は提供されていません。

イメージをプッシュし、Azure CLI を使用して Flex Consumption 関数アプリを構成し、Azure 上でコンテナ化されたワークロードを検証します。

イメージをレジストリにプッシュする

ソースレベルのテストおよびイメージビルドおよびセキュリティチェックを完了した後:

  1. 選択したレジストリとリポジトリにイメージにタグを付けてください。
  2. レジストリにログインします。
  3. 不変の画像バージョンをプッシュしてください。
  4. 結果として得られたタグとダイジェストを記録します。
  5. Flex Consumption アプリで使用されている ID または認証情報が画像を取得できることを確認してください。

レジストリのサポート

選択したコンテナレジストリにイメージを公開します。

コンテナイメージの設定は匿名アクセス、基本認証、システム割り当てID、ユーザー割り当てIDをサポートします。 公開画像には匿名アクセスを活用してください。 基本認証は、レジストリ認証情報を含むアプリ設定名を参照します。認証情報の値をコンテナイメージ設定に直接入力しないでください。 システム割り当ておよびユーザー割り当てのマネージドID認証は、Azure Container Registryに適用されます。

Flex Consumption でコンテナを使用することは、追加のネットワーク制限を生じさせません。 既存のフレックス消費ネットワーク要件が適用されます。 設定されたレジストリは、アプリのネットワークパスからアクセス可能かつDNSで解決可能なものでなければなりません。

マネージドIDおよびKey Vault参照を使用する

コンテナイメージを使用する Flex Consumption アプリは、コードパッケージ Flex アプリと同じアプリレベルのマネージドアイデンティティ動作をサポートします。 関数アプリにシステム割り当てまたはユーザー割り当てのIDを割り当てることができ、Azure管理のFunctionsホストおよびサポートされている拡張機能は通常そのIDを使用できます。 アプリケーションコードは、適切な Azure ID ライブラリを通じて割り当てられた ID を使用することもできます。

アプリ設定は、他の Flex Consumption アプリと同様に Key Vault 参照を使用できます。 コンテナイメージを取得する際に使用した認証方法とは独立して、Key Vault 参照を解決する際に使用するアイデンティティを設定します。 たとえば、レジストリからのプルには 1 つのユーザー割り当て ID を、Azure のリソースへのアプリケーション アクセスには別の ID を使用できます。

Flex Consumption 関数アプリがコンテナ イメージを使用するように構成する

レジストリ展開で新しいFlex Consumption関数アプリを作成するか、対象となる既存アプリを BlobContainer 展開から Registry 展開に変更できます。

Microsoft.Web/sitesリソースは展開ストレージタイプを使用して展開モデルを特定します:

  • コードパッケージアプリは properties.functionAppConfig.deployment.storage.type を BlobContainerに設定しています。
  • コンテナイメージのデプロイでは、properties.functionAppConfig.deployment.storage.type が Registry に設定されます。

レジストリ展開の場合:

  • deployment.storage.valueを完全修飾イメージ参照に設定します。 値を正確に保持してください。
  • deployment.storage.authentication をサポートされている認証形式に設定します。
  • functionAppConfig.runtimeを省略します。

画像参照を選択してください

properties.functionAppConfig.deployment.storage.valueプロパティには、完全修飾レジストリホスト名と明示的なタグ、ダイジェスト、またはその両方を含める必要があります:

  • ダイジェスト(推奨):myregistry.example.com/app/worker@sha256:<digest>
  • タグ:myregistry.example.com/app/worker:v1
  • タグとダイジェスト:myregistry.example.com/app/worker:v1@sha256:<digest>

画像参照にタグとダイジェストの両方が含まれている場合、プラットフォームはダイジェストで識別された画像を引き出します。 タグは説明的なものです。

明示的なタグやダイジェストのない画像参照はサポートされていません。 latestタグを使用するには、明示的に「myregistry.example.com/app/worker:latest」と指定してください。 APIはまた、完全修飾レジストリホスト名を省略したレジストリ略記も拒否します。

タグのみ参照の場合、プラットフォームはワーカーインスタンスを作成するたびにタグを解決します。 タグの内容が変更されても deployment.storage.valueが変更されていない場合、異なる画像バージョンが同時に実行されることがあります。 詳細については、「 既存の可変タグの更新を避ける」を参照してください。

リソースを構成する

以下のBicep断片はproperties形状を示しています:

properties: {
  functionAppConfig: {
    deployment: {
      storage: {
        type: 'Registry'
        value: '<qualified-image-reference>'
        authentication: {
          type: 'SystemAssignedIdentity'
        }
      }
    }
  }
}

更新時には、既存の scaleAndConcurrency 値と siteUpdateStrategy 値を変更する予定がない限り保持してください。

以下のいずれかの認証シェイプを使用してください:

認証の種類 追加フィールド Usage
Anonymous None 匿名アクセスを許可するレジストリから取り出してください。
SystemAssignedIdentity None アプリにシステム割り当てられた ID を使用してください。
UserAssignedIdentity userAssignedIdentityResourceId 指定されたユーザー割り当てマネージド ID を使用します。
Basic usernameSettingName、passwordSettingName レジストリ認証情報を含むアプリ設定を参照します。 認証情報をインラインに設定しないでください。

リソースを読み取るまたは更新するとき:

  1. runtime.nameまたはruntime.versionを読む前に、deployment.storage.typeを大文字と小文字を区別せずに比較します。 レジストリ展開を使用するアプリは runtimeを省略します。
  2. scaleAndConcurrency、siteUpdateStrategy、認証設定名、および認識されないfunctionAppConfigフィールドは、変更する予定がない限り保持してください。
  3. 画像参照は提供された通りに正確に保持してください。

Azure CLI

プレビューリリースには Azure CLI のサポートが含まれています。 Azure CLI を使用して、コンテナイメージ付きの Flex Consumption 関数アプリを作成するか、対象となる既存アプリを更新します。

画像オプションは以下のコマンドに適用されます:

  • az functionapp create
  • az functionapp deployment config set
  • az functionapp deployment config show
  • az functionapp show
Argument Alias Purpose
--deployment-image None 完全修飾イメージ参照。 値は変更せずに送信されます。
--deployment-image-auth-type --diat Anonymous、 SystemAssignedIdentity、 UserAssignedIdentity、または Basic。
--deployment-image-identity --dii ユーザー割り当てのIDリソースID。
--deployment-image-username-setting --dius レジストリのユーザー名を含むアプリ設定名。
--deployment-image-password-setting --dips レジストリパスワードを含むアプリ設定名。

コンテナイメージを持つ関数アプリを作成する

システム割り当ての ID を使用して Azure Container Registry からイメージを取得する Flex Consumption 関数アプリを作成します:

az functionapp create -g <RESOURCE_GROUP> -n <APP_NAME> -s <STORAGE_ACCOUNT> \
  --flexconsumption-location <REGION> \
  --deployment-image <REGISTRY>/<REPOSITORY>@sha256:<DIGEST> \
  --deployment-image-auth-type SystemAssignedIdentity \
  --assign-identity [system] --role AcrPull --scope <ACR_RESOURCE_ID>

既存の関数アプリをコンテナ イメージを使用するように更新する

対象となる Flex Consumption 関数アプリを、ユーザー割り当て ID を使用して BlobContainer から Registry に切り替える:

az functionapp deployment config set -g <RESOURCE_GROUP> -n <APP_NAME> \
  --deployment-image <REGISTRY>/<REPOSITORY>:<TAG> \
  --deployment-image-auth-type UserAssignedIdentity \
  --deployment-image-identity <IDENTITY_RESOURCE_ID>

認証情報のアプリ設定を参照して、レジストリ展開を使用している既存のアプリを基本認証に変更する:

az functionapp deployment config set -g <RESOURCE_GROUP> -n <APP_NAME> \
  --deployment-image-auth-type Basic \
  --deployment-image-username-setting REGISTRY_USERNAME \
  --deployment-image-password-setting REGISTRY_PASSWORD

CLI は、サービス検証のために画像参照を変更せずに送信します。 基本認証は、資格情報の値ではなく設定名を受け付けます。 --assign-identity、--role、--scopeなどのオプションを使用して、レジストリのアイデンティティとロール割り当てを個別に構成できます。

ランタイムオプションはレジストリ展開を使用するアプリには適用されません。 show コマンドはレジストリの構成設定名と認証設定名を返しますが、レジストリ認証情報は返しません。

展開と初回呼び出しの確認

展開後、Azure でコンテナイメージとプラットフォーム統合を検証します:

  1. アプリが意図するイメージ タグまたはダイジェストを参照していることを確認してください。
  2. プラットフォームがレジストリに対して認証を行い、イメージを取得できることを確認してください。
  3. ワーカープロセスが開始され、準備完了であることを確認しましょう。
  4. 期待される関数とトリガーが検出されていることを確認してください。
  5. 代表的な関数を呼び出します。
  6. 必要なOSレベルの依存関係が使用されていることを確認してください。
  7. アプリケーションのテレメトリで起動および呼び出しの失敗を確認しましょう。

HTTP トリガーと非 HTTP トリガー

プレビュー中、コンテナイメージを使用する Flex Consumption 関数アプリは、コードパッケージの Flex Consumption アプリと同じ HTTP トリガーおよび非 HTTP トリガーをサポートしますが、Durable Functions と Azure Service Bus 拡張機能は例外です。

イメージを更新してロールバックする

予測可能なデプロイとロールバックのために、不変ダイジェストを使用してください。 タグを使う場合は、すでに使用中のタグを上書きするのではなく、各画像バージョンに新しいタグを割り当ててください。

アプリケーション コード、Functions ワーカー、言語ランタイム、ベース OS、OS パッケージ、またはアプリケーションの依存関係を更新するには:

  1. 画像ソース内の明示的なコンポーネントバージョンを更新します。
  2. イメージを作り直す。
  3. ソースレベルのテストやイメージビルドおよびセキュリティチェックを実行します。
  4. 新しい画像をプッシュし、そのダイジェストを記録するか、新しいタグを割り当てます。
  5. Flex Consumption 関数アプリを更新して新しい画像を参照します。
  6. 起動、トリガー検出、および代表的な呼び出しを確認します。

Microsoftは、すでに作成したイメージを静かにパッチ適用することはありません。 ベースイメージと依存関係のアップストリームソースを監視し、更新が必要な場合は再構築してください。

プラットフォームのロールアウト、ドレイン、ロールバックの挙動

関数アプリを更新して別のイメージ ダイジェストまたはタグを参照するようにすると、更新の反映が開始され、次のアクションがトリガーされます。

  • 新しいワーカーインスタンスは更新された画像を使用します。
  • プラットフォームは更新された画像でトリガーを特定し、アプリに登録されたトリガーを更新します。
  • 既存のインスタンスは新しいインボーケーションの受け入れを停止し、更新されたイメージの開始やトリガー検出の完了を待たずにドレインを開始します。
  • プラットフォームでは、すでに実行中の HTTP リクエストおよび非 HTTP 関数の実行を、プラットフォーム終了の猶予期間まで終了させることを許可しています。

これらの処理は並行して実行されます。 トリガーの検出は、既存インスタンスのドレインが始まる前に完了する必要はありません。

Important

イメージ更新には事前のヘルスゲートや自動ロールバックはありません。 更新されたイメージを取得できず、起動に失敗し、またはトリガー検出を完了できない場合でも、以前のインスタンスは依然としてドレインを継続します。 HTTP トリガーと非 HTTP トリガーは、有効なイメージを構成するまで失敗することがあります。

画像参照を更新した際に関数アプリが停止した場合、プラットフォームは既存のインスタンスを削除し、新しい参照を記録します。 アプリを起動すると、プラットフォームは更新されたイメージを使用し、そのトリガーを識別します。

既存の可変タグを更新しない

新しい画像を同じ可変タグの下にプッシュしても、関数アプリで設定された画像参照が変更されていないため、ロールアウトは開始されません。 既存のインスタンスは前のイメージを引き続き使用します。 後のスケールアウトで作成されたインスタンスは、タグを新しいイメージに解析し、異なる画像バージョンが同時に実行されることがあります。

関数アプリの再起動は既存のインスタンスを消費し、新しく作成したインスタンスが更新されたタグを解決します。 ただし、再起動してもトリガー検出は再実行されません。 更新された画像が関数やトリガーを追加または変更した場合は、関数アプリを更新して新しいダイジェストまたはタグを参照してください。

予測可能なロールアウト動作のために、各リリースごとに新しい不変ダイジェストを参照するように関数アプリを更新してください。

画像をロールバックする

プラットフォームは失敗した画像更新を自動的にロールバックするわけではありません。 以前に検証済みの各画像のダイジェストを保持します。

ロールバックするには、関数アプリを更新して、以前に正常に動作していたダイジェストまたはタグを参照するようにします。 この更新はトリガー検出を開始し、復元イメージから新しいワーカーインスタンスをプロビジョニングします。

ログとテレメトリ

コンテナイメージを使用する Flex Consumption アプリの Application Insights の挙動およびログの推奨は、標準の Flex Consumption やその他の Azure Functions ホスティング オプションと同じです。

アプリケーションログやトレースについては、関数アプリをOpenTelemetryで計測し、テレメトリを直接Application Insightsに送信してください。 アプリケーション テレメトリの転送を Functions ホストに依存するのではなく、直接インストルメンテーションを使用することをお勧めします。特にアプリの規模が拡大する場合はそうです。 構成のガイダンスについては、「Azure Functions で OpenTelemetry を使用する」を参照してください。

アプリケーションログやトレースについては、Go関数アプリをOpenTelemetryで計測してください。 Go ワーカー ミドルウェアは、OpenTelemetry Protocol (OTLP) の設定を使用してテレメトリをエクスポートします。 テレメトリを OpenTelemetry Collector または別のテレメトリパイプラインに送り、Azure Monitor に転送します。 Application Insights の 接続文字列 だけでは Go ワーカーのテレメトリには不十分です。 構成のガイダンスについては、「Azure Functions で OpenTelemetry を使用する」を参照してください。

Azure 管理プラットフォームは、ワーカーの起動および関数インデックスのエラーを引き続き Application Insights に転送しています。 これらのエラーを使用して、関数呼び出しがアプリケーションコードに到達する前に発生する失敗を調査します。

Azure ポータルの Azure Monitor メトリクスエクスペリエンスはプレビューではサポートされていません。 Application Insights のログとトレースを使用してアプリを監視し、トラブルシューティングします。

監視とトラブルシューティング

ライフサイクル順に展開をトラブルシューティングする:

  1. 設定: アプリが意図したイメージおよび認証設定を参照していることを確認してください。
  2. レジストリアクセス: 設定されたIDまたは認証情報が画像にアクセスできることを確認してください。
  3. ネットワークとDNS: プラットフォームがレジストリを名前解決でき、到達できることを確認してください。
  4. イメージの解決とプル: タグまたはダイジェストが存在し、サポートされている形式を使用していることを確認してください。
  5. 起動: ワーカープロセスが開始し、言語固有のプラットフォーム接続が確立されていることを確認します。
  6. ワーカーの準備状況: アプリケーションが準備完了であることを確認しましょう。
  7. トリガーの検出とスケーリング: 期待される関数とトリガーが検出され、スケーリングされていることを確認します。
  8. 呼び出し: ワーカーが呼び出しを受け取り、パッケージされた依存関係を使用できることを確認してください。
  9. 更新またはロールバック: アプリが意図したイメージのバージョンを参照していることを確認してください。

サポートに連絡する前に、画像参照、展開時刻、ワーカーバージョン、ベースイメージ、地域、トリガータイプ、関連する相関識別子を集めてください。 レジストリの認証情報は含めないでください。

セキュリティ、パッチ適用、および保守の責任

Area お客様の責任 Microsoft の責任
ベースLinuxまたは言語イメージ 明示的なバージョンを選択し、スキャン、修正、再構築、検証 パブリッシュプラットフォームの互換性要件
画像内の関数言語ワーカー サポートされているバージョンを指定し、正しく含め、更新プログラムを再構築、テスト、再展開する サポートされているワーカーのアーティファクト、リリース情報、サンプルを公開する
OSおよびアプリケーションの依存関係 選択し、設定し、ライセンスを付与し、スキャンし、パッチを適用し、検証する プラットフォーム制約を公開
アプリケーション コード ビルド、テスト、スキャン、パッチ適用、展開 ワーカーを呼び出す Azure 管理プラットフォーム コンポーネントを操作する
画像の出所とレジストリ サプライチェーンの統制を適用し、アクセスを制限する ドキュメント化されたレジストリ認証および画像取得パスをサポートします。
ホスト機能、ルーティング、トリガー、スケーリング サポートされているインターフェイスを通じてアプリを構成する Azure 管理プラットフォームの運用とパッチ適用

組織のポリシーに従い、最小権限レジストリアクセス、不変のイメージバージョン、脆弱性スキャン、ソフトウェアの部品表対応、信頼済みアーティファクトソースを使用してください。

プレビューの制限事項

  • Durable Functionsはサポートされていません。
  • Azure Service Bus 拡張機能はサポートされていません。
  • 可用性ゾーンのサポートは利用できません。
  • イメージは Linux amd64 をターゲットにしなければなりません。
  • プレビュー言語のサポートは、.NET isolated、Python、Node.js、Go に限定されています。
  • プレビュー版では、ローカルでコンテナイメージを実行またはテストするためのサポートされた開発者体験は提供されていません。
  • Azure ポータルにおける Azure Monitor のメトリクス体験はサポートされていません。 監視にはログとアプリケーションインサイトを使用します。

次のステップ