透過容器在 Azure Functions Flex Consumption 中使用作業系統層級相依性

Important

這項功能處於預覽狀態。 預覽功能可能會變更。

透過容器使用作業系統層級的相依性支援,您可以執行那些執行環境中需要更多內容的 Flex Consumption 函式應用程式。 您提供包含應用程式及其所需語言與作業系統相依關係的 Linux 容器映像檔。 Azure 持續提供 Functions 主機、觸發器整合、路由與擴展功能。

Overview

您建立一個 Linux 容器映像檔,其中包含函式程式碼、一個支援的 Functions 語言工作者、語言與應用程式相依關係,以及系統套件、原生函式庫、執行檔、字型、憑證或其他執行時應用程式所需的檔案。

Azure 會執行並修補 Functions 主機,並在映像之外管理路由、觸發整合與縮放。 這種分離方式讓您能自訂 worker 環境,同時減少映像檔攻擊面,免除自行封裝、保護及更新 Functions 主機的需求。

Flex Consumption 採用僅限工作者的容器模型。 你的容器映像不是任意的網頁容器。 它也不是完整的 Function App 映像檔,後者會將 Functions 主機、語言工作者、應用程式和相依項打包在一起,作為另一個寄存選項。

如需完整範例將作業系統層級相依性封裝為僅工作者容器映像,請參閱 Azure Functions Flex Consumption .NET 隔離容器範例。

欲以僅工作者容器映像封裝作業系統層級相依關係的完整範例,請參閱 Azure Functions Flex Consumption Python 容器範例。

欲以僅工作者容器映像格式封裝作業系統層級相依關係的完整範例,請參閱 Azure Functions Flex Consumption Go 容器範例。

欲以僅工作者容器映像封裝作業系統層級相依關係的完整範例,請參閱 Azure Functions Flex Consumption Node.js 容器範例。

Benefits

  • 將應用程式、語言工作者、語言相依性及作業系統層級相依性打包於單一版本化映像中。
  • 選擇何時採用工作程式、語言執行環境及相依性更新,透過重建、測試及重新部署映像檔。
  • 將 Functions 主機、觸發器整合、路由與調整規模管理保留在映像之外,並由 Azure 負責管理和修補。
  • 與完整的 Function App 映像相比,減少您必須包含、保護並維護在映像中的元件。

使用此功能的時機

在下列情況下,使用容器來處理 Flex Consumption 上作業系統層級的相依性:

  • 您的 Flex Consumption 應用程式需要依賴性,而這些依賴性無法單獨透過語言套件管理器取得。
  • 您可以建置、掃描、修補、測試並發佈 Linux 映像檔。
  • 您可以在影像中維護所選的基本影像以及語言工作者版本。

比較容器主機選項

選擇與您需要控制的執行時部分相符的託管模式。

Capability Flex Consumption 容器映像 彈性高級版或專用版(App Service)自訂映像檔 Functions on Azure 容器應用程式
映像合約 僅限員工 完整 Function App 映像 完整 Function App 映像
函數主機/執行環境 由 Azure 在映像檔之外提供、操作並修補 包含在您的映像中,通常來自函式基礎映像 包含在您的映像中
您的圖片包含 應用程式、單一語言工作程式、語言/應用程式相依性與作業系統套件 Functions 主機、背景工作角色、應用程式及相依性 Functions 主機、背景工作角色、應用程式及相依性
Scaling Functions 管理的彈性取用縮放 由 Functions 管理的 Premium 擴縮或 App Service 方案擴縮 容器應用程式調整規模
Billing 標準彈性消費計費 彈性高級或 App Service 方案計費 容器應用程式計費
最適用 在保留 Flex 無伺服器平台合約的同時,新增作業系統層級的相依性 控制 App Service 基礎架構上的完整 Functions 容器 以 Container Apps 功能執行完整的 Functions 容器

如需更多關於完整的 Function App 映像的資訊,請參閱 Azure Functions 中的 Linux 容器支援。

架構與責任邊界

事件或 HTTP 請求首先抵達由 Azure 管理的 Functions 平台。 Azure 執行 Functions 主機與執行環境,評估觸發器、路由呼叫,並決定何時新增或移除實例。 當呼叫準備好時,平台會將其傳送給您映像中的函數語言工作者。 語言工作工具會載入您的函式應用程式,您的應用程式可以使用圖像中打包的語言、應用程式及作業系統層級相依關係。

您的映像檔未包含或取代 Functions 主機,未實作觸發路由,也不控制平台擴縮。 您維護應用程式、語言工作者、基礎映像及相依關係,皆置於映像內。 Microsoft 維護並更新映像之外的 Functions 平台元件。

啟用的 Functions 語言工作者必須是預覽支援表中列出的工作者之一。 預覽版不支援以任意客戶開發的語言工作程式或自訂處理器取代它。 映像檔可以包含其他執行環境或執行檔,例如由受支援函式呼叫的 Rust 元件,作為應用程式相依性。 單一工作者限制適用於作用中的 Functions 語言背景工作程序,不適用於隨應用程式打包的輔助執行階段或工具。

預覽語言支援

預覽版支援以下 Functions 語言工作者。 請在文章頂端選擇您的語言,以取得支援的執行時版本、工作伺服器相容性資訊及範例 Dockerfile。

函式語言 背景工作處理序如何被納入
.NET 隔離 包含在應用程式的 NuGet 相依性和發佈輸出中
Python 新增為 Python 版本專屬的 Microsoft worker 成品
Node.js 新增為 Microsoft 已發佈的 Node.js worker 成品
Go 透過 Go Worker SDK 納入,並編譯到應用程式二進位檔中

預覽期間不支援其他函數語言工作者。

Prerequisites

在開始之前,您需要:

  • 使用支援預覽語言的應用程式。
  • 一個相容 Docker 的映像建置環境。
  • 一個你可以維護的 Linux 或語言基礎映像檔。
  • 應用程式原始碼及其語言相依性。
  • 所需的作業系統套件、原生函式庫、字型、驅動程式或工具。
  • 存取 容器登錄庫。
  • 建立、掃描、推送及部署映像檔的權限。

預覽版支援 Linux amd64 映像檔。

了解彈性消費容器模型

您的映像檔負責:

  • 應用程式承載資料。
  • 一個支援的 Functions 語言工作者。
  • 語言與應用程式的依賴性。
  • 作業系統層級的相依關係。
  • 您所選擇的 Linux 或語言基礎映像。
  • 影像安全性、漏洞修復,以及明確的元件版本。

Azure 負責:

  • Functions 主機本身。
  • 路由與觸發整合。
  • 由函式管理的擴展
  • 影像之外的平台元件。

Flex Consumption 讓您選擇最適合您應用程式與組織需求的 Linux 或語言基礎映像檔。 在此映像基礎上,新增支援的 Functions 語言工作者、您的應用程式及其依賴關係,並遵循此僅限工作者的容器模型。 Microsoft 提供版本化的工作器與範例 Dockerfile,協助您建立相容映像檔,而 Azure 則管理映像檔外的 Functions 主機。

Worker Startup 是針對特定語言的。 請使用 您語言的範例 Dockerfile ,而非從其他語言複製入口點。 該平台提供工作者 RPC 連線參數及應用程式目錄。 您的映像檔會直接啟動語言工作者或應用程式二進位;它不會安裝或啟動 Functions 主機,也不會包含平台端點設定。

環境變數與腳本根目錄

您不需要設定 Functions 主機或工作者連線環境變數。 平台會注入工作者身份、連線、協定及啟動權限,這些值是語言工作者與 Azure 管理的 Functions 主機通訊所需的。

當您的 Flex Consumption 應用程式使用容器映像時,請設定應用程式設定 AzureWebJobsScriptRoot=/home/site/wwwroot。 您的映像必須將函式應用程式放置於該路徑下。 Azure 會在執行時將設定注入容器,因此你不需要在 Dockerfile 中宣告它作為ENV指令。 您可以繼續使用應用程式所需的其他應用程式設定。

請勿將 FUNCTIONS_WORKER_RUNTIME 或 FUNCTIONS_EXTENSION_VERSION 新增至使用容器映像的彈性消費應用程式。 平台會在您的映像之外管理這些執行階段細節。

取得語言工作者

請使用針對您語言所記載的支援 worker 參考。 Python 與 Node.js 範例使用 Microsoft 管理的 aka.ms 參考,指向最新支援的背景工作角色成品。 他們的部署工具會判定或雜湊目前的產物,讓工作程式更新時會改變映像建置輸入。

使用已發佈的 SHA-256 檢查碼驗證已下載的 worker 成品。 當浮動工作者參照推進時,請在採用更新後的工作者之前,先重建、測試、推送並重新部署映像檔。 對於透過應用程式相依性提供的工作程式,請在應用程式專案中指定相依性版本。

.NET 隔離

預覽版支援 .NET 10 與 .NET 11 上的 .NET 隔離工作者模型。 一個 .NET 隔離應用程式會透過其正常的 NuGet 依賴與建置輸出包含 Functions 背景工作程序。 工作程式不會作為每個支援的 .NET 執行階段版本的獨立成品發佈。 在專案中指定 Microsoft.Azure.Functions.Worker 及相關套件版本,並將應用程式發佈至 /home/site/wwwroot。

使用最新版本的 Azure.Functions.Sdk 作為專案 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 執行時映像檔,以及相容的函數工作者與應用程式相依關係。

如需完整的應用程式與部署檔案,請參閱 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 相依關係、作業系統層級相依性,以及支援的 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 版本 基礎映像 工作器參考
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。 建立一個名為 worker-release-url.txt 的檔案,其中包含前述表格中的 Python 3.15 worker reference。 當您選擇 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 及系統指派識別碼:

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 映像包含應用程式、作業系統層級的相依性,以及已編譯至應用程式二進位檔中的受支援 Go Functions worker 與 SDK。 工作者不會作為每個支援的 Go 版本的獨立產物發佈。

Important

請使用支援的 Go 版本。 你負責使用支援的 Go 工具鏈和相容的 Go Functions worker SDK 版本來編譯應用程式。

從 Azure Functions Flex Consumption Go 容器範例中的範例 Dockerfile 開始。

範例 go.mod 檔案指定 github.com/azure/azure-functions-golang-worker 版本 v1.0.2。 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 及系統指派識別碼:

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 相依關係、作業系統層級相依關係,以及支援的 Node.js 函數工作者成品。 該工作程式未作為每個支援的 Node.js 執行階段版本的獨立成品發佈。

Important

請使用支援的 Node.js 版本。 您負責選擇並維護支援的 Node.js 基底映像,以及相容的函式工作者與應用程式相依關係。

請從 Azure Functions Flex Consumption Node.js 容器範例中的範例 JavaScript 或 TypeScript Dockerfile 開始。

範例應用程式使用 @azure/functions 版本 4.17.0。 Node.js Dockerfile 會從 Microsoft 管理的aka.ms參考下載目前支援的 Node.js 工作程式,並將其解壓縮到映像檔中。 範例部署工具會計算下載的工件的 SHA-256 值,將該值納入影像上下文雜湊值,並傳給映像建置進行驗證。 映像入口點會直接啟動 Node.js 工作者。

Node.js Dockerfile

以下 Dockerfile 採用範例 JavaScript 與 TypeScript 專案的版面配置。 更新 COPY 指令與建置步驟,使其符合應用程式的目錄結構並符合建置輸出。 對於 TypeScript,範例會編譯應用程式,並從 dist 複製產生的 JavaScript。 目錄 dist 只是範例慣例,並非 Flex Consumption container model 的必備條件。 請確保 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 及系統指派識別碼:

(
  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 作為起點:

從 Go 範例 Dockerfile 開始。

範例 Dockerfile 會組裝一個容器映像檔;它不是 Microsoft 提供的基礎映像檔。

  1. 從貴組織信任的來源中選擇支援的 Linux 或語言基礎映像檔。
  2. 根據您的供應鏈政策,選擇明確的基礎映像版本標籤或不可變摘要。 避免使用浮動標籤,例如 latest。
  3. 安裝所需的作業系統套件並移除暫存的套件管理員資料。
  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 應用程式所使用的身分或認證能夠擷取該映像。

登錄檔支援

將映像檔發佈至您所選的容器登錄檔。

容器映像設定支援匿名存取、基本驗證、系統指派身份及使用者指派身份。 對公開映像使用匿名存取。 基本驗證會參考包含登錄憑證的應用程式設定名稱;不要直接將憑證值放入容器映像設定中。 系統指派與使用者指派的受控識別驗證適用於 Azure Container Registry。

在彈性消費中使用容器並不會帶來額外的網路限制。 現有的 Flex Consumption 網路需求仍然適用。 已設定的登錄庫必須可從應用程式的網路路徑存取,並可解析 DNS。

使用管理身份與 金鑰保存庫 參考

使用容器映像的 Flex Consumption 應用程式,會支援與程式碼封裝 Flex 應用程式相同的應用程式層級管理身份行為。 您可以為函數應用程式指派系統指派或使用者指派的身份,Azure 管理的 Functions 主機及支援的擴充功能即可正常使用該身份。 您的應用程式代碼也可以透過適當的 Azure 身份庫使用該指派的身份。

應用程式設定可以像其他 Flex Consumption 應用程式一樣使用 金鑰保存庫 參考。 您可以獨立設定用於解析 金鑰保存庫 參考的身份,與拉取容器映像所使用的驗證方式無關。 例如,您可以使用一個使用者指派的身份來進行登錄拉取,另一個身份用於應用程式存取 Azure 資源。

設定 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 也會拒絕省略完整 registry 主機名稱的 registry 縮寫。

對於僅標籤參照,平台會在建立工作者實例時解析該標籤。 如果標籤內容變更,但 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 使用應用程式由系統指派的身分。
UserAssignedIdentity userAssignedIdentityResourceId 請使用指定的使用者指派受控識別。
Basic usernameSettingName,passwordSettingName 參考包含登錄憑證的應用程式設定。 千萬不要把憑證值直接寫在程式碼中。

當您閱讀或更新資源時:

  1. 在讀取deployment.storage.type或runtime.version之前,請先不區分大小寫比較runtime.name。 使用登錄檔部署的應用程式會省略 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 別名 Purpose
--deployment-image None 限定映像參照。 該值會被傳送,且不加變更。
--deployment-image-auth-type --diat Anonymous、、 SystemAssignedIdentity、 UserAssignedIdentity或 Basic。
--deployment-image-identity --dii 使用者指派的身份資源 ID。
--deployment-image-username-setting --dius 包含容器登錄使用者名稱的應用程式設定名稱。
--deployment-image-password-setting --dips 包含登錄密碼的應用程式設定名稱。

建立帶有容器影像的函式應用程式

建立一個 Flex Consumption 函數應用程式,使用系統指派的身份從 Azure Container Registry 擷取映像檔:

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>

更新現有函式應用程式以使用容器映像

將符合資格的彈性消耗方案函式應用程式從 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 這樣的選項來設定登錄識別與角色指派。

執行階段選項不適用於使用 Registry 部署的應用程式。 show 指令會回傳登錄庫組態與驗證設定名稱,但不會回傳登錄庫認證資訊。

驗證部署與首次呼叫

部署完成後,驗證 Azure 中的容器映像與平台整合:

  1. 確認應用程式是否參考了目標的映像檔標籤或摘要。
  2. 確認平台能向登錄服務驗證身分並擷取映像檔。
  3. 確認工作程序已啟動並已準備好。
  4. 確認已發現預期的函式與觸發條件。
  5. 呼叫一個具代表性的函式。
  6. 確認所需的作業系統層級相依性已被使用。
  7. 檢視應用程式遙測資料中啟動與呼叫失敗的情況。

HTTP 與非 HTTP 觸發器

在預覽期間,使用容器映像的 Flex Consumption 函式應用程式,除了 Durable Functions 及 Azure 服務匯流排 擴充功能外,支援與程式碼套件 Flex Consumption 相同的 HTTP 與非 HTTP 觸發條件。

更新並回滾映像檔

使用不可變摘要以實現可預測的部署與回滾。 如果你使用標籤,請為每個圖片版本指派一個新標籤,而不是覆寫已使用的標籤。

若要更新應用程式程式碼、Functions 背景工作角色、語言執行階段、基礎作業系統、作業系統套件或應用程式相依性:

  1. 更新影像來源中的明確元件版本。
  2. 重建映像檔。
  3. 執行原始碼層級測試以及映像建置與安全性檢查。
  4. 推送新影像並錄製摘要或為其指派新標籤。
  5. 更新 Flex Consumption 功能應用程式以參考新映像。
  6. 驗證啟動、觸發偵測及代表性呼叫。

Microsoft 不會悄悄修補你已經建立好的映像檔。 監控基礎映像檔及相依項目的上游來源,並在需要更新時重建。

平台推出、排空與回滾行為

當您更新函式應用程式以參考不同的影像摘要或標籤時,更新會開始傳播並觸發以下動作:

  • 新的工作者實例會使用更新後的映像檔。
  • 平台會在更新後的映像檔中識別觸發程序,並更新應用程式已註冊的觸發程序。
  • 現有實例停止接受新調用,並開始排空,且不會等待更新映像開始或完成觸發器發現。
  • 平台允許 HTTP 請求及已在執行中的非 HTTP 函式執行完成,直到平台終止寬限期結束為止。

這些動作是同時發生的。 觸發器發現不必在現有實例開始排空之前完成。

Important

映像更新沒有部署前的健康閘門或自動回滾。 如果更新後的映像檔無法被拉取、無法啟動或無法完成觸發程序探索,先前的執行個體仍會持續排空。 HTTP 與非 HTTP 觸發器在您設定有效映像之前都可能失敗。

如果你更新函式應用程式的影像參照時停止,平台會移除所有現有實例並記錄新的參照。 啟動應用程式時,平台會使用更新後的映像並識別其觸發程序。

避免更新現有的可變標籤

將新影像置於同一個可變標籤下不會啟動部署,因為函式應用程式中設定的影像參考沒有變更。 現有實例仍會使用先前的影像。 在後續擴展過程中建立的實例可以將標籤解析到新影像,導致不同影像版本同時執行。

重新啟動函式應用程式會排空現有實例,以便新建立的實例能解析更新後的標籤。 然而,重新啟動並不會重新執行觸發程序探索。 如果更新後的影像新增或變更函數或觸發器,請更新函式應用程式以參考新的摘要或標籤。

為了讓部署行為更可預測,請在每次發行時將函式應用程式更新為參考新的不可變摘要。

回滾映像

平台不會自動回滾失敗的影像更新。 保留每張先前驗證過的影像摘要。

若要回滾,請更新函式應用程式以參考先前的工作摘要或標籤。 此更新啟動觸發器發現,並從還原映像中配置新的工作實例。

記錄與遙測

使用 container image 的 Flex Consumption 應用程式的 Application Insights 行為與日誌建議,與標準 Flex Consumption 及其他 Azure Functions 主機選項相同。

對於應用程式日誌與追蹤,請使用 OpenTelemetry 為您的函數應用程式進行儀器化,並將遙測資料直接傳送至 Application Insights。 建議直接進行儀器化,而非依賴 Functions 主機來轉發應用程式遙測,尤其是在應用程式規模擴大時。 如需設定指引,請參閱〈使用 OpenTelemetry 搭配 Azure Functions〉。

關於應用程式日誌與追蹤,請使用 OpenTelemetry 為您的 Go 函數應用程式進行檢測。 Go 工作型中介軟體透過 OpenTelemetry Protocol(OTLP)設定匯出遙測資料。 將遙測資料傳送至 OpenTelemetry Collector 或其他遙測管線,再轉發至 Azure 監視器。 僅有 Application Insights 的 連接字串 不足以完成 Go 工作者的遙測。 如需設定指引,請參閱〈使用 OpenTelemetry 搭配 Azure Functions〉。

這個由 Azure 管理的平台持續將工作者啟動錯誤及功能索引錯誤轉交給 Application Insights。 利用這些錯誤來調查在函式呼叫到達應用程式程式碼之前發生的失敗。

Azure 入口網站中的 Azure 監視器 指標體驗在預覽版中不被支援。 使用 Application Insights 日誌與追蹤來監控並排除應用程式問題。

監控與故障排除

依生命週期順序排解部署問題:

  1. 設定: 確認應用程式參考了預期的映像與驗證設定。
  2. 登錄存取權限: 確認已設定的身分或認證能存取映像檔。
  3. 網路與 DNS: 確認平台能解析並連線到登錄服務。
  4. 映像檔解析與拉取: 確認標籤或摘要存在且使用支援的格式。
  5. 啟動: 確認工作程序已啟動並建立語言專屬平台連線。
  6. 工作程序就緒狀態: 確認應用程式已準備好。
  7. 觸發程序探索與擴縮: 確認已發現預期函式與觸發程序。
  8. 叫用: 確認工作者已收到叫用並能使用封裝的依賴。
  9. 更新或回滾: 確認應用程式指向的是預期的影像版本。

在聯絡支援之前,請收集影像參考、部署時間、背景工作角色版本、基礎映像、區域、觸發類型及相關關聯識別碼。 不要包含 registry 憑證。

安全性、修補與維護職責

Area 客戶責任 Microsoft 的責任
基礎 Linux 或語言映像檔 選擇明確版本,掃描、修補、重建並驗證 發佈平台相容性需求
映像中的 Functions 語言背景工作程式 指定一個支援的版本,正確地將其納入,重建、測試並更新後重新部署 發佈支援的工作者產物、發佈資訊及範例
作業系統與應用程式相依關係 選取、設定、授權、掃描、修補與驗證 發佈平台限制條件
應用程式程式碼 建置、測試、掃描、修補及部署 操作由 Azure 管理的平台元件,這些元件會呼叫工作者
影像來源與登錄庫 套用供應鏈控管並限制存取 支援文件化的登錄檔驗證與映像擷取路徑
函數主機、路由、觸發器與延展 透過支援的介面設定應用程式 操作並修補由 Azure 管理的平台

依照貴組織的政策,使用最小權限容器登錄存取、不可變的映像版本、漏洞掃描、軟體物料清單做法,以及受信任的成品來源。

預覽限制

  • 不支援 Durable Functions。
  • 不支援 Azure 服務匯流排 擴充功能。
  • 不提供可用區域支援。
  • 映像檔必須針對 Linux amd64。
  • 預覽語言支援僅限於.NET isolated、Python、Node.js和 Go。
  • 預覽版目前尚未提供支援的開發者體驗,以在本地執行或測試容器映像。
  • Azure 入口網站中的 Azure 監視器 指標體驗不被支援。 使用日誌與 Application Insights 來監控。

下一步