Azure Developer CLI (azd)支援將程式碼和容器部署至 Azure Functions。 在 azure.yaml 中,兩種模式都使用專用的 function 主機:
- Code deployment 會把你建置的函式程式碼打包成壓縮檔,然後上傳到 Function App。
- 容器部署會建置或解析容器映像,必要時將其發佈到 Azure Container Registry(ACR),並更新函式應用程式以執行映像。
Azure Functions 和 Azure App 服務 都使用Microsoft.Web/sites資源提供者,且它們的容器部署流程共享一些內部機制。 不過,他們不是同一個 azd 主機。 Functions 使用 host: function,具有 Functions 專屬的封裝與遠端建置行為,且不使用 App Service 部署槽的工作流程。
選擇部署模式
azd 從服務配置中選擇部署模式:
| 配置 | 部署模式 |
|---|---|
具有受支援的非 Docker language 且沒有 docker.path 的來源project |
程式碼部署 |
language: docker |
容器部署 |
docker.path帶有源語言的值 |
容器部署 |
預先建置項目 image |
容器部署 |
已佈建的 Function App 必須使用與服務設定相同的模式。 如果函式應用程式 Function App 設定為容器,但 azure.yaml 選擇了程式碼部署,或相反,azd deploy 則會在上傳前停止並回報不相符。
部署功能程式碼
配置一個基於程式碼的函式服務,使用原始專案、支援的語言,以及 host: function:
services:
api:
project: ./src/api
language: ts
host: function
在 azd deployazd 期間,建置專案、套用 .funcignore 排除、建立壓縮檔,並透過 Azure Functions 部署 API 上傳套件。
你的 Bicep 或 Terraform 必須配置一個以程式碼為基礎的函式應用程式,並將 azd-service-name 設為服務名稱的標籤,除非你是在 azure.yaml 中使用 resourceName 來識別該資源。 透過基礎設施即程式碼配置主機計畫、執行環境、儲存、身份、網路及應用程式設定。
配置遠端建置以部署程式碼
頂層服務 remoteBuild 屬性僅適用於 Flex Consumption 計畫中以程式碼為基礎的函式應用程式。 它控制 Azure Functions 是否使用 Oryx 來建立上傳的套件:
services:
api:
project: ./src/api
language: python
host: function
remoteBuild: true
在 Flex Consumption 上省略 remoteBuild 時,azd 會根據語言和套件內容選擇預設值:
| 語言 | 預設行為 |
|---|---|
| JavaScript 或 TypeScript | 當 .funcignore 排除 node_modules或沒有 .funcignore 檔案存在時,會使用遠端建置。 否則,就使用本機建置的套件。 |
| Python | 使用遠端建置。 |
| Go | 本地建置。 Go Function Apps 不支援遠端建置。 |
| 其他支援語言 | 使用本機建置的套件。 |
對於 JavaScript 和 TypeScript,明確設定的 remoteBuild 值在該檔案存在時必須與 .funcignore 一致。 當 node_modules 排除 remoteBuild: true 時,設定 .funcignore。 當 .funcignore 在套裝中包含 node_modules 時,設定 remoteBuild: false
不要為非彈性方案設定頂層 remoteBuild 屬性。 要在其他支援的方案上啟用 Oryx 建置,請在你的基礎架構中將 ENABLE_ORYX_BUILD=true 和 SCM_DO_BUILD_DURING_DEPLOYMENT=true 設定為 Function App 設定。
部署容器化函式
對於帶有 Dockerfile 的原始碼專案,請設定 language: docker,或保留原始碼語言並指定 docker.path。
以下範例使用帶有 Docker 檔案的 TypeScript 專案:
services:
api:
project: ./src/api
language: ts
host: function
docker:
path: ./Dockerfile
你也可以部署一個預先建置的映像檔,而不需要本地專案:
services:
api:
host: function
image: myregistry.azurecr.io/functions/api:1.0
對於預建映像檔,可以省略 language 或設為 docker。 不要將 project 與 image 合併。
在容器部署期間, azd
- 本地或遠端建置映像檔,或解析已設定好的預先建置的映像檔。
- 當需要發佈時,會將映像發佈到專案中已設定的 ACR 實例。
- 更新函式應用程式的
linuxFxVersion為DOCKER|<image>。 - 部署到主要 Function App 網站。
頂層服務 remoteBuild 屬性不適用於容器。 要使用 ACR 任務建立容器映像檔,請使用 docker.remoteBuild:
services:
api:
project: ./src/api
language: docker
host: function
docker:
path: ./Dockerfile
remoteBuild: true
佈建可供容器使用的 Function App
azd deploy 更新圖片參考,但不會將基於程式碼的函式應用程式轉換成基於容器的函式應用程式。 您的基礎架構必須在部署前先佈建相容的站台。
| 需求 | 詳細資訊 |
|---|---|
| Linux Function App | 在 Azure Functions Premium 或 Dedicated (App Service) 計劃中配置一個 Linux Function 應用程式。 Flex Consumption 不支援自訂容器。 此 host: function 工作流程的目標是 Microsoft.Web/sites,而不是裝載於 Azure 容器應用程式 上的 Azure Functions。 |
| 容器站點配置 | 將網站類型設為包含 functionapp、 linux、 container。 用一個linuxFxVersion值初始化DOCKER\|<image>。 佔位影像就足夠了,因為 azd deploy 會取代它。 |
| 容器註冊表 | 對於原始碼建置,可以配置一個 ACR 實例,並透過 AZURE_CONTAINER_REGISTRY_ENDPOINT 基礎結構輸出公開其登入伺服器,或為該服務設定 docker.registry。 完整限定的預建 image 版本可直接使用,無需另行發佈登錄。 |
| 登錄檔存取 | 授予發佈該映像的身分在需要發佈時將映像推送至目標登錄的權限。 另外,設定 Function App 來拉取已部署的映像檔。 對於私有 ACR 映像,請授與 Function App 的受控識別提取權限,並設定網站使用受控識別認證。 對於另一個私有登錄檔,請在你的基礎設施中設定適當的拉取憑證。 |
| 功能設定 | 設定必要的設定,例如 FUNCTIONS_EXTENSION_VERSION、FUNCTIONS_WORKER_RUNTIME 和 AzureWebJobsStorage,可透過 Bicep 或 Terraform。 |
| 資源探索 | 套用值與 azure.yaml 中的服務名稱相符的 azd-service-name 標籤,或明確設定 resourceName。 |
服務層級function設定不支援env主機。 改在你的基礎設施中定義 Function App 的設定。
了解部署位置
azd 總是將 function 服務部署到主要的功能應用網站。 它不會發現、提示或部署到 Function App 的部署位置。 像是 App Service 部署位置設定 AZD_DEPLOY_{SERVICE}_SLOT_NAME 不會影響 Function App 部署。
如果你需要以部署位置為基礎的函式發佈流程,請在 host: function 內建工作流程之外管理部署位置與部署。
比較函式與 App Service 主機
函式與 App Service 共享 Microsoft.Web/sites 資源類型,但選擇與工作負載相符的主機:
| Behavior |
function 主機 |
appservice 主機 |
|---|---|---|
| [工作負載] | Event-driven Azure Functions | 網頁應用程式與 API |
| 程式碼部署 | 使用 Azure Functions zip 部署流程 | 使用 App Service 部署流程 |
| 容器部署 | 在驗證網站為容器式後,更新 Function App 映像檔 | 在驗證網站已準備好容器後,更新網頁應用程式映像檔 |
| 遠端程式碼編譯 | 支援彈性取用函式應用程式的服務等級 remoteBuild 選項 |
沒有使用 Functions remoteBuild 選項 |
| 部署位置 | 一律部署到主要網站 | 支援 azd App Service 部署位置工作流程 |
服務層級 env |
不支援;請改用基礎架構中的 Function App 設定 | 設定基礎結構中的應用程式設定 |