az containerapp

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理 Azure Container Apps。

命令

名稱 Description 類型 狀態
az containerapp add-on

管理環境中可用的附加元件命令。

副檔名 預覽​​
az containerapp add-on kafka

用來管理 Container Apps 環境的kafka附加元件命令。

副檔名 預覽​​
az containerapp add-on kafka create

建立 kafka 附加元件之命令。

副檔名 預覽​​
az containerapp add-on kafka delete

刪除 kafka 附加元件的命令。

副檔名 預覽​​
az containerapp add-on list

列出環境中的所有附加元件。

副檔名 預覽​​
az containerapp add-on mariadb

用來管理 Container Apps 環境的 mariadb 附加元件命令。

副檔名 預覽​​
az containerapp add-on mariadb create

建立 mariadb 附加元件之命令。

副檔名 預覽​​
az containerapp add-on mariadb delete

刪除 mariadb 附加元件的命令。

副檔名 預覽​​
az containerapp add-on milvus

用來管理 Container Apps 環境的 milvus 附加元件命令。

副檔名 預覽​​
az containerapp add-on milvus create

建立 milvus 附加元件的命令。

副檔名 預覽​​
az containerapp add-on milvus delete

刪除 milvus 服務的命令。

副檔名 預覽​​
az containerapp add-on postgres

用來管理 Container Apps 環境的 postgres 附加元件命令。

副檔名 預覽​​
az containerapp add-on postgres create

建立 postgres 附加元件命令。

副檔名 預覽​​
az containerapp add-on postgres delete

刪除 postgres 附加元件的命令。

副檔名 預覽​​
az containerapp add-on qdrant

用來管理 Container Apps 環境的 qdrant 附加元件命令。

副檔名 預覽​​
az containerapp add-on qdrant create

建立 qdrant 附加元件的命令。

副檔名 預覽​​
az containerapp add-on qdrant delete

刪除 qdrant 附加元件的命令。

副檔名 預覽​​
az containerapp add-on redis

用來管理 Container Apps 環境的 redis 附加元件命令。

副檔名 預覽​​
az containerapp add-on redis create

建立 redis 附加元件命令。

副檔名 預覽​​
az containerapp add-on redis delete

刪除 redis 附加元件的命令。

副檔名 預覽​​
az containerapp add-on weaviate

用來管理 Container Apps 環境的 weaviate 附加元件命令。

副檔名 預覽​​
az containerapp add-on weaviate create

用來建立 weaviate 附加元件的命令。

副檔名 預覽​​
az containerapp add-on weaviate delete

刪除 weaviate 服務的命令。

副檔名 預覽​​
az containerapp auth

管理 containerapp 驗證和授權。

核心和擴充功能 GA
az containerapp auth apple

管理 Apple 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth apple show

顯示 Apple 識別提供者的驗證設定。

核心 GA
az containerapp auth apple update

更新Apple識別提供者的用戶端識別碼和客戶端密碼。

核心 GA
az containerapp auth facebook

管理 Facebook 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth facebook show

顯示Facebook識別提供者的驗證設定。

核心 GA
az containerapp auth facebook update

更新 Facebook 身分識別提供者的應用程式識別碼和應用程式密碼。

核心 GA
az containerapp auth github

管理 GitHub 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth github show

顯示 GitHub 識別提供者的驗證設定。

核心 GA
az containerapp auth github update

更新 GitHub 識別提供者的用戶端識別碼和客戶端密碼。

核心 GA
az containerapp auth google

管理Google識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth google show

顯示Google識別提供者的驗證設定。

核心 GA
az containerapp auth google update

更新Google身分識別提供者的用戶端標識碼和客戶端密碼。

核心 GA
az containerapp auth microsoft

管理 Microsoft 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth microsoft show

顯示 Azure Active Directory 識別提供者的驗證設定。

核心 GA
az containerapp auth microsoft update

更新 Azure Active Directory 識別提供者的用戶端識別碼和客戶端密碼。

核心 GA
az containerapp auth openid-connect

管理自訂 OpenID 連線 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth openid-connect add

設定新的自定義 OpenID 連線 識別提供者。

核心 GA
az containerapp auth openid-connect remove

拿掉現有的自定義 OpenID 連線 識別提供者。

核心 GA
az containerapp auth openid-connect show

顯示自訂 OpenID 連線 識別提供者的驗證設定。

核心 GA
az containerapp auth openid-connect update

更新現有自定義 OpenID 連線 識別提供者的用戶端識別碼和客戶端密碼設定名稱。

核心 GA
az containerapp auth show

顯示 containerapp 的驗證設定。

核心 GA
az containerapp auth show (containerapp 擴充功能)

顯示 containerapp 的驗證設定。

副檔名 GA
az containerapp auth twitter

管理 Twitter 識別提供者的 containerapp 驗證和授權。

核心 GA
az containerapp auth twitter show

顯示 Twitter 識別提供者的驗證設定。

核心 GA
az containerapp auth twitter update

更新 Twitter 身分識別提供者的取用者密鑰和取用者密碼。

核心 GA
az containerapp auth update

更新 containerapp 的驗證設定。

核心 GA
az containerapp auth update (containerapp 擴充功能)

更新 containerapp 的驗證設定。

副檔名 GA
az containerapp browse

盡可能在瀏覽器中開啟 containerapp。

核心 GA
az containerapp compose

從 Compose 規格建立 Azure Container Apps 的命令。

核心和擴充功能 GA
az containerapp compose create

從 Compose 規格,在新的或現有的容器應用程式環境中建立一或多個容器應用程式。

核心 GA
az containerapp compose create (containerapp 擴充功能)

從 Compose 規格,在新的或現有的容器應用程式環境中建立一或多個容器應用程式。

副檔名 GA
az containerapp connected-env

用來管理容器應用程式的命令 連線 環境,以搭配已啟用Arc的容器應用程式使用。

副檔名 預覽​​
az containerapp connected-env certificate

管理容器應用程式連線環境的憑證的命令。

副檔名 預覽​​
az containerapp connected-env certificate delete

從容器應用程式連線環境刪除憑證。

副檔名 預覽​​
az containerapp connected-env certificate list

列出已連線環境的憑證。

副檔名 預覽​​
az containerapp connected-env certificate upload

新增或更新憑證。

副檔名 預覽​​
az containerapp connected-env create

建立容器應用程式連線的環境。

副檔名 預覽​​
az containerapp connected-env dapr-component

管理容器應用程式連線環境的 Dapr 元件命令。

副檔名 預覽​​
az containerapp connected-env dapr-component list

列出已連線環境的 Dapr 元件。

副檔名 預覽​​
az containerapp connected-env dapr-component remove

從連線的環境移除 Dapr 元件。

副檔名 預覽​​
az containerapp connected-env dapr-component set

建立或更新 Dapr 元件。

副檔名 預覽​​
az containerapp connected-env dapr-component show

顯示 Dapr 元件的詳細數據。

副檔名 預覽​​
az containerapp connected-env delete

刪除容器應用程式已連線的環境。

副檔名 預覽​​
az containerapp connected-env list

依訂用帳戶或資源群組列出容器應用程式連線的環境。

副檔名 預覽​​
az containerapp connected-env show

顯示容器應用程式連線環境的詳細數據。

副檔名 預覽​​
az containerapp connected-env storage

用來管理容器應用程式連線環境的記憶體的命令。

副檔名 預覽​​
az containerapp connected-env storage list

列出已連線環境的記憶體。

副檔名 預覽​​
az containerapp connected-env storage remove

從連線的環境移除記憶體。

副檔名 預覽​​
az containerapp connected-env storage set

建立或更新記憶體。

副檔名 預覽​​
az containerapp connected-env storage show

顯示記憶體的詳細數據。

副檔名 預覽​​
az containerapp connection

管理 containerapp 連線的命令。

核心和擴充功能 GA
az containerapp connection create

建立 containerapp 與目標資源之間的連線。

核心和擴充功能 GA
az containerapp connection create app-insights

建立與 app-insights 的 containerapp 連線。

核心 GA
az containerapp connection create appconfig

建立與 appconfig 的 containerapp 連線。

核心 GA
az containerapp connection create confluent-cloud

建立 confluent-cloud 的 containerapp 連線。

核心 GA
az containerapp connection create cosmos-cassandra

建立 cosmos-cassandra 的 containerapp 連線。

核心 GA
az containerapp connection create cosmos-gremlin

建立 cosmos-gremlin 的 containerapp 連線。

核心 GA
az containerapp connection create cosmos-mongo

建立 cosmos-mongo 的 containerapp 連線。

核心 GA
az containerapp connection create cosmos-sql

建立 cosmos-sql 的 containerapp 連線。

核心 GA
az containerapp connection create cosmos-table

建立 cosmos-table 的 containerapp 連線。

核心 GA
az containerapp connection create eventhub

建立 eventhub 的 containerapp 連線。

核心 GA
az containerapp connection create keyvault

建立keyvault的 containerapp 連線。

核心 GA
az containerapp connection create mysql

建立 mysql 的 containerapp 連線。

核心 已取代
az containerapp connection create mysql-flexible

建立與 mysql 彈性的 containerapp 連線。

核心 GA
az containerapp connection create mysql-flexible (serviceconnector-passwordless 擴充功能)

建立與 mysql 彈性的 containerapp 連線。

副檔名 GA
az containerapp connection create postgres

建立與 postgres 的 containerapp 連線。

核心 已取代
az containerapp connection create postgres (serviceconnector-passwordless 擴充功能)

建立與 postgres 的 containerapp 連線。

副檔名 GA
az containerapp connection create postgres-flexible

建立與 postgres 彈性的 containerapp 連線。

核心 GA
az containerapp connection create postgres-flexible (serviceconnector-passwordless 擴充功能)

建立與 postgres 彈性的 containerapp 連線。

副檔名 GA
az containerapp connection create redis

建立 redis 的 containerapp 連線。

核心 GA
az containerapp connection create redis-enterprise

建立與 redis-enterprise 的 containerapp 連線。

核心 GA
az containerapp connection create servicebus

建立與 servicebus 的 containerapp 連線。

核心 GA
az containerapp connection create signalr

建立與 signalr 的 containerapp 連線。

核心 GA
az containerapp connection create sql

建立與 sql 的 containerapp 連線。

核心 GA
az containerapp connection create sql (serviceconnector-passwordless 擴充功能)

建立與 sql 的 containerapp 連線。

副檔名 GA
az containerapp connection create storage-blob

建立與 storage-blob 的 containerapp 連線。

核心 GA
az containerapp connection create storage-file

建立 storage-file 的 containerapp 連線。

核心 GA
az containerapp connection create storage-queue

建立與記憶體佇列的 containerapp 連線。

核心 GA
az containerapp connection create storage-table

建立 storage-table 的 containerapp 連線。

核心 GA
az containerapp connection create webpubsub

建立與 webpubsub 的 containerapp 連線。

核心 GA
az containerapp connection delete

刪除 containerapp 連線。

核心 GA
az containerapp connection list

列出 containerapp 的連線。

核心 GA
az containerapp connection list-configuration

列出 containerapp 連線的來源組態。

核心 GA
az containerapp connection list-support-types

列出容器應用程式連線支援的用戶端類型和驗證類型。

核心 GA
az containerapp connection show

取得 containerapp 連線的詳細數據。

核心 GA
az containerapp connection update

更新 containerapp 連線。

核心 GA
az containerapp connection update app-insights

將 containerapp 更新為 app-insights 連線。

核心 GA
az containerapp connection update appconfig

將 containerapp 更新為 appconfig 連線。

核心 GA
az containerapp connection update confluent-cloud

將 containerapp 更新為 confluent-cloud 連線。

核心 GA
az containerapp connection update cosmos-cassandra

將 containerapp 更新為 cosmos-cassandra 連線。

核心 GA
az containerapp connection update cosmos-gremlin

將 containerapp 更新為 cosmos-gremlin 連線。

核心 GA
az containerapp connection update cosmos-mongo

將 containerapp 更新為 cosmos-mongo 連線。

核心 GA
az containerapp connection update cosmos-sql

將 containerapp 更新為 cosmos-sql 連線。

核心 GA
az containerapp connection update cosmos-table

將 containerapp 更新為 cosmos-table 連線。

核心 GA
az containerapp connection update eventhub

將 containerapp 更新為 eventhub 連線。

核心 GA
az containerapp connection update keyvault

將 containerapp 更新為keyvault連線。

核心 GA
az containerapp connection update mysql

將 containerapp 更新為 mysql 連線。

核心 已取代
az containerapp connection update mysql-flexible

將 containerapp 更新為 mysql 彈性連線。

核心 GA
az containerapp connection update postgres

將 containerapp 更新為 postgres 連線。

核心 已取代
az containerapp connection update postgres-flexible

將 containerapp 更新為 postgres 彈性連線。

核心 GA
az containerapp connection update redis

將 containerapp 更新為 redis 連線。

核心 GA
az containerapp connection update redis-enterprise

將 containerapp 更新為 redis-enterprise 連線。

核心 GA
az containerapp connection update servicebus

將 containerapp 更新為 servicebus 連線。

核心 GA
az containerapp connection update signalr

將 containerapp 更新為 signalr 連線。

核心 GA
az containerapp connection update sql

將 containerapp 更新為 sql 連線。

核心 GA
az containerapp connection update storage-blob

將 containerapp 更新為 storage-blob 連線。

核心 GA
az containerapp connection update storage-file

將 containerapp 更新為記憶體檔案連線。

核心 GA
az containerapp connection update storage-queue

將 containerapp 更新為記憶體佇列連線。

核心 GA
az containerapp connection update storage-table

將 containerapp 更新為記憶體數據表連線。

核心 GA
az containerapp connection update webpubsub

將 containerapp 更新為 webpubsub 連線。

核心 GA
az containerapp connection validate

驗證 containerapp 連線。

核心 GA
az containerapp connection wait

將 CLI 置於等候狀態,直到符合連線的條件為止。

核心 GA
az containerapp create

建立容器應用程式。

核心 GA
az containerapp create (containerapp 擴充功能)

建立容器應用程式。

副檔名 GA
az containerapp dapr

管理 Dapr 的命令。 若要管理 Dapr 元件,請參閱 az containerapp env dapr-component

核心 GA
az containerapp dapr disable

停用容器應用程式的 Dapr。 拿掉現有的值。

核心 GA
az containerapp dapr enable

為容器應用程式啟用 Dapr。 更新 現有的值。

核心 GA
az containerapp delete

刪除容器應用程式。

核心 GA
az containerapp delete (containerapp 擴充功能)

刪除容器應用程式。

副檔名 GA
az containerapp env

管理容器應用程式環境的命令。

核心和擴充功能 GA
az containerapp env certificate

用來管理容器應用程式環境的憑證的命令。

核心和擴充功能 GA
az containerapp env certificate create

建立受控憑證。

副檔名 預覽​​
az containerapp env certificate delete

從 Container Apps 環境刪除憑證。

核心 GA
az containerapp env certificate delete (containerapp 擴充功能)

從 Container Apps 環境刪除憑證。

副檔名 預覽​​
az containerapp env certificate list

列出環境的憑證。

核心 GA
az containerapp env certificate list (containerapp 擴充功能)

列出環境的憑證。

副檔名 預覽​​
az containerapp env certificate upload

新增或更新憑證。

核心 GA
az containerapp env certificate upload (containerapp 擴充功能)

新增或更新憑證。

副檔名 GA
az containerapp env create

建立容器應用程式環境。

核心 GA
az containerapp env create (containerapp 擴充功能)

建立容器應用程式環境。

副檔名 GA
az containerapp env dapr-component

管理 Container Apps 環境的 Dapr 元件命令。

核心和擴充功能 GA
az containerapp env dapr-component init

初始化環境的 Dapr 元件和開發服務。

副檔名 預覽​​
az containerapp env dapr-component list

列出環境的 Dapr 元件。

核心 GA
az containerapp env dapr-component remove

從環境中移除 Dapr 元件。

核心 GA
az containerapp env dapr-component resiliency

管理 dapr 元件的復原原則的命令。

副檔名 預覽​​
az containerapp env dapr-component resiliency create

建立 dapr 元件的復原原則。

副檔名 預覽​​
az containerapp env dapr-component resiliency delete

刪除 dapr 元件的復原原則。

副檔名 預覽​​
az containerapp env dapr-component resiliency list

列出 dapr 元件的復原原則。

副檔名 預覽​​
az containerapp env dapr-component resiliency show

顯示 dapr 元件的復原原則。

副檔名 預覽​​
az containerapp env dapr-component resiliency update

更新 dapr 元件的復原原則。

副檔名 預覽​​
az containerapp env dapr-component set

建立或更新 Dapr 元件。

核心 GA
az containerapp env dapr-component show

顯示 Dapr 元件的詳細數據。

核心 GA
az containerapp env delete

刪除容器應用程式環境。

核心 GA
az containerapp env delete (containerapp 擴充功能)

刪除容器應用程式環境。

副檔名 GA
az containerapp env identity

管理環境受控識別的命令。

副檔名 預覽​​
az containerapp env identity assign

將受控識別指派給受控環境。

副檔名 預覽​​
az containerapp env identity remove

從受控環境移除受控識別。

副檔名 預覽​​
az containerapp env identity show

顯示受控環境的受控識別。

副檔名 預覽​​
az containerapp env java-component

管理環境中 Java 元件的命令。

副檔名 預覽​​
az containerapp env java-component list

列出環境中的所有 Java 元件。

副檔名 預覽​​
az containerapp env java-component spring-cloud-config

管理 Container Apps 環境的 Spring Cloud Config 命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-config create

建立 Spring Cloud Config 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-config delete

刪除 Spring Cloud Config 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-config show

顯示 Spring Cloud Config 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-config update

更新 Spring Cloud Config 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-eureka

用於管理 Container Apps 環境的 Spring Cloud Eureka 命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-eureka create

建立 Spring Cloud Eureka 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-eureka delete

刪除 Spring Cloud Eureka 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-eureka show

顯示 Spring Cloud Eureka 的命令。

副檔名 預覽​​
az containerapp env java-component spring-cloud-eureka update

更新 Spring Cloud Eureka 的命令。

副檔名 預覽​​
az containerapp env list

依訂用帳戶或資源群組列出容器應用程式環境。

核心 GA
az containerapp env list (containerapp 擴充功能)

依訂用帳戶或資源群組列出容器應用程式環境。

副檔名 GA
az containerapp env list-usages

列出特定受控環境的配額使用量。

副檔名 預覽​​
az containerapp env logs

顯示容器應用程式環境記錄。

核心 GA
az containerapp env logs show

實時顯示過去的環境記錄和/或列印記錄(使用 --follow 參數)。

核心 GA
az containerapp env show

顯示容器應用程式環境的詳細數據。

核心 GA
az containerapp env show (containerapp 擴充功能)

顯示容器應用程式環境的詳細數據。

副檔名 GA
az containerapp env storage

用來管理容器應用程式環境的記憶體的命令。

核心和擴充功能 GA
az containerapp env storage list

列出環境的記憶體。

核心 GA
az containerapp env storage list (containerapp 擴充功能)

列出環境的記憶體。

副檔名 GA
az containerapp env storage remove

從環境移除記憶體。

核心 GA
az containerapp env storage remove (containerapp 擴充功能)

從環境移除記憶體。

副檔名 GA
az containerapp env storage set

建立或更新記憶體。

核心 GA
az containerapp env storage set (containerapp 擴充功能)

建立或更新記憶體。

副檔名 GA
az containerapp env storage show

顯示記憶體的詳細數據。

核心 GA
az containerapp env storage show (containerapp 擴充功能)

顯示記憶體的詳細數據。

副檔名 GA
az containerapp env telemetry

用來管理容器應用程式環境的遙測設定的命令。

副檔名 預覽​​
az containerapp env telemetry app-insights

用來管理容器應用程式環境的App深入解析設定的命令。

副檔名 預覽​​
az containerapp env telemetry app-insights delete

刪除容器應用程式環境遙測應用程式深入解析設定。

副檔名 預覽​​
az containerapp env telemetry app-insights set

建立或更新容器應用程式環境遙測應用程式深入解析設定。

副檔名 預覽​​
az containerapp env telemetry app-insights show

顯示容器應用程式環境遙測應用程式深入解析設定。

副檔名 預覽​​
az containerapp env telemetry data-dog

管理容器應用程式環境數據狗設定的命令。

副檔名 預覽​​
az containerapp env telemetry data-dog delete

刪除容器應用程式環境遙測數據狗設定。

副檔名 預覽​​
az containerapp env telemetry data-dog set

建立或更新容器應用程式環境遙測數據狗設定。

副檔名 預覽​​
az containerapp env telemetry data-dog show

顯示容器應用程式環境遙測數據狗設定。

副檔名 預覽​​
az containerapp env telemetry otlp

用來管理容器應用程式環境的otlp設定的命令。

副檔名 預覽​​
az containerapp env telemetry otlp add

新增容器應用程式環境遙測 otlp 設定。

副檔名 預覽​​
az containerapp env telemetry otlp list

列出容器應用程式環境遙測otlp設定。

副檔名 預覽​​
az containerapp env telemetry otlp remove

拿掉容器應用程式環境遙測 otlp 設定。

副檔名 預覽​​
az containerapp env telemetry otlp show

顯示容器應用程式環境遙測 otlp 設定。

副檔名 預覽​​
az containerapp env telemetry otlp update

更新容器應用程式環境遙測 otlp 設定。

副檔名 預覽​​
az containerapp env update

更新容器應用程式環境。

核心 GA
az containerapp env update (containerapp 擴充功能)

更新容器應用程式環境。

副檔名 GA
az containerapp env workload-profile

管理 Container Apps 環境的工作負載配置檔。

核心和擴充功能 GA
az containerapp env workload-profile add

在 Container Apps 環境中建立工作負載配置檔。

核心 GA
az containerapp env workload-profile delete

從 Container Apps 環境刪除工作負載配置檔。

核心 GA
az containerapp env workload-profile list

從 Container Apps 環境列出工作負載配置檔。

核心 GA
az containerapp env workload-profile list-supported

列出區域中支援的工作負載配置檔。

核心 GA
az containerapp env workload-profile set

在 Container Apps 環境中建立或更新現有的工作負載配置檔。

副檔名 已取代
az containerapp env workload-profile show

顯示來自 Container Apps 環境的工作負載配置檔。

核心 GA
az containerapp env workload-profile update

更新 Container Apps 環境中的現有工作負載配置檔。

核心 GA
az containerapp exec

在容器應用程式複本內開啟類似SSH的互動式殼層。

核心 GA
az containerapp github-action

管理 GitHub Actions 的命令。

核心和擴充功能 GA
az containerapp github-action add

將 GitHub Actions 工作流程新增至存放庫,以部署容器應用程式。

核心 GA
az containerapp github-action add (containerapp 擴充功能)

將 GitHub Actions 工作流程新增至存放庫,以部署容器應用程式。

副檔名 GA
az containerapp github-action delete

從存放庫移除先前設定的 Container Apps GitHub Actions 工作流程。

核心 GA
az containerapp github-action show

在容器應用程式上顯示 GitHub Actions 設定。

核心 GA
az containerapp hostname

管理容器應用程式的主機名的命令。

核心和擴充功能 GA
az containerapp hostname add

將主機名新增至容器應用程式,而不需要系結。

核心 GA
az containerapp hostname bind

使用憑證新增或更新主機名和系結。

核心 GA
az containerapp hostname bind (containerapp 擴充功能)

使用憑證新增或更新主機名和系結。

副檔名 GA
az containerapp hostname delete

從容器應用程式刪除主機名。

核心 GA
az containerapp hostname list

列出容器應用程式的主機名。

核心 GA
az containerapp identity

管理受控識別的命令。

核心 GA
az containerapp identity assign

將受控識別指派給容器應用程式。

核心 GA
az containerapp identity remove

從容器應用程式移除受控識別。

核心 GA
az containerapp identity show

顯示容器應用程式的受控識別。

核心 GA
az containerapp ingress

用來管理輸入和流量分割的命令。

核心 GA
az containerapp ingress access-restriction

管理IP存取限制的命令。

核心 GA
az containerapp ingress access-restriction list

列出容器應用程式的IP存取限制。

核心 GA
az containerapp ingress access-restriction remove

從容器應用程式移除IP存取限制。

核心 GA
az containerapp ingress access-restriction set

設定容器應用程式的IP存取限制。

核心 GA
az containerapp ingress cors

管理容器應用程式的 CORS 原則命令。

核心 GA
az containerapp ingress cors disable

停用容器應用程式的 CORS 原則。

核心 GA
az containerapp ingress cors enable

啟用容器應用程式的 CORS 原則。

核心 GA
az containerapp ingress cors show

顯示容器應用程式的 CORS 原則。

核心 GA
az containerapp ingress cors update

更新容器應用程式的 CORS 原則。

核心 GA
az containerapp ingress disable

停用容器應用程式的輸入。

核心 GA
az containerapp ingress enable

啟用或更新容器應用程式的輸入。

核心 GA
az containerapp ingress show

顯示容器應用程式輸入的詳細數據。

核心 GA
az containerapp ingress sticky-sessions

設定容器應用程式的黏性會話親和性的命令。

核心 GA
az containerapp ingress sticky-sessions set

設定容器應用程式的黏性會話。

核心 GA
az containerapp ingress sticky-sessions show

顯示容器應用程式的 Affinity。

核心 GA
az containerapp ingress traffic

管理流量分割的命令。

核心 GA
az containerapp ingress traffic set

設定容器應用程式的流量分割。

核心 GA
az containerapp ingress traffic show

顯示容器應用程式的流量分割組態。

核心 GA
az containerapp ingress update

更新容器應用程式的輸入。

核心 GA
az containerapp job

管理容器應用程式作業的命令。

核心和擴充功能 GA
az containerapp job create

建立容器應用程式作業。

核心 GA
az containerapp job create (containerapp 擴充功能)

建立容器應用程式作業。

副檔名 GA
az containerapp job delete

刪除容器應用程式作業。

核心 GA
az containerapp job delete (containerapp 擴充功能)

刪除容器應用程式作業。

副檔名 GA
az containerapp job execution

用來檢視容器應用程式作業執行的命令。

核心 GA
az containerapp job execution list

取得容器應用程式作業的所有執行清單。

核心 GA
az containerapp job execution show

取得容器應用程式作業的執行。

核心 GA
az containerapp job identity

管理容器應用程式作業受控識別的命令。

核心 GA
az containerapp job identity assign

將受控識別指派給容器應用程式作業。

核心 GA
az containerapp job identity remove

從容器應用程式作業中移除受控識別。

核心 GA
az containerapp job identity show

顯示容器應用程式作業的受控識別。

核心 GA
az containerapp job list

依訂用帳戶或資源群組列出容器應用程式作業。

核心 GA
az containerapp job list (containerapp 擴充功能)

依訂用帳戶或資源群組列出容器應用程式作業。

副檔名 GA
az containerapp job secret

管理秘密的命令。

核心 GA
az containerapp job secret list

列出容器應用程式作業的秘密。

核心 GA
az containerapp job secret remove

從容器應用程式作業移除秘密。

核心 GA
az containerapp job secret set

建立/更新秘密。

核心 GA
az containerapp job secret show

顯示秘密的詳細數據。

核心 GA
az containerapp job show

顯示容器應用程式作業的詳細數據。

核心 GA
az containerapp job show (containerapp 擴充功能)

顯示容器應用程式作業的詳細數據。

副檔名 GA
az containerapp job start

啟動容器應用程式作業執行。

核心 GA
az containerapp job stop

停止容器應用程式作業執行。

核心 GA
az containerapp job update

更新容器應用程式作業。

核心 GA
az containerapp list

列出容器應用程式。

核心 GA
az containerapp list (containerapp 擴充功能)

列出容器應用程式。

副檔名 GA
az containerapp list-usages

列出特定區域中訂用帳戶層級配額的使用方式。

副檔名 預覽​​
az containerapp logs

顯示容器應用程式記錄。

核心 GA
az containerapp logs show

實時顯示過去的記錄和/或列印記錄(使用 --follow 參數)。 請注意,記錄只會取自一個修訂、複本和容器(針對非系統記錄)。

核心 GA
az containerapp patch

修補 Azure Container Apps。 修補僅適用於使用來源到雲端功能所建置的應用程式。 請參閱 https://aka.ms/aca-local-source-to-cloud

副檔名 預覽​​
az containerapp patch apply

列出並套用要修補的容器應用程式。 修補僅適用於使用來源到雲端功能所建置的應用程式。 請參閱 https://aka.ms/aca-local-source-to-cloud

副檔名 預覽​​
az containerapp patch interactive

列出並選取要以互動方式修補的容器應用程式。 修補僅適用於使用來源到雲端功能所建置的應用程式。 請參閱 https://aka.ms/aca-local-source-to-cloud

副檔名 預覽​​
az containerapp patch list

列出可修補的容器應用程式。 修補僅適用於使用來源到雲端功能所建置的應用程式。 請參閱 https://aka.ms/aca-local-source-to-cloud

副檔名 預覽​​
az containerapp registry

管理容器登錄資訊的命令。

核心 GA
az containerapp registry list

列出容器應用程式中設定的容器登錄。

核心 GA
az containerapp registry remove

拿掉容器登錄的詳細數據。

核心 GA
az containerapp registry set

新增或更新容器登錄的詳細數據。

核心 GA
az containerapp registry show

顯示容器登錄的詳細數據。

核心 GA
az containerapp replica

管理容器應用程式複本。

核心和擴充功能 GA
az containerapp replica count

容器應用程式的複本計數。

副檔名 預覽​​
az containerapp replica list

列出容器應用程式修訂的複本。

核心 GA
az containerapp replica list (containerapp 擴充功能)

列出容器應用程式修訂的複本。

副檔名 GA
az containerapp replica show

顯示容器應用程式複本。

核心 GA
az containerapp replica show (containerapp 擴充功能)

顯示容器應用程式複本。

副檔名 GA
az containerapp resiliency

管理容器應用程式的復原原則的命令。

副檔名 預覽​​
az containerapp resiliency create

建立容器應用程式的復原原則。

副檔名 預覽​​
az containerapp resiliency delete

刪除容器應用程式的復原原則。

副檔名 預覽​​
az containerapp resiliency list

列出容器應用程式的復原原則。

副檔名 預覽​​
az containerapp resiliency show

顯示容器應用程式的復原原則。

副檔名 預覽​​
az containerapp resiliency update

更新容器應用程式的復原原則。

副檔名 預覽​​
az containerapp revision

管理修訂的命令。

核心 GA
az containerapp revision activate

啟動修訂。

核心 GA
az containerapp revision copy

根據先前的修訂建立修訂。

核心 GA
az containerapp revision deactivate

停用修訂。

核心 GA
az containerapp revision label

管理指派給流量權數的修訂標籤。

核心 GA
az containerapp revision label add

將修訂標籤設定為具有相關聯流量權數的修訂。

核心 GA
az containerapp revision label remove

從具有相關聯流量權數的修訂中移除修訂標籤。

核心 GA
az containerapp revision label swap

在兩個修訂之間交換修訂標籤與相關聯的流量權數。

核心 GA
az containerapp revision list

列出容器應用程式的修訂。

核心 GA
az containerapp revision restart

重新啟動修訂。

核心 GA
az containerapp revision set-mode

設定容器應用程式的修訂模式。

核心 GA
az containerapp revision show

顯示修訂的詳細數據。

核心 GA
az containerapp secret

管理秘密的命令。

核心 GA
az containerapp secret list

列出容器應用程式的秘密。

核心 GA
az containerapp secret remove

從容器應用程式移除秘密。

核心 GA
az containerapp secret set

建立/更新秘密。

核心 GA
az containerapp secret show

顯示秘密的詳細數據。

核心 GA
az containerapp show

顯示容器應用程式的詳細數據。

核心 GA
az containerapp show (containerapp 擴充功能)

顯示容器應用程式的詳細數據。

副檔名 GA
az containerapp show-custom-domain-verification-id

顯示系結應用程式或環境自定義網域的驗證標識碼。

副檔名 預覽​​
az containerapp ssl

將憑證上傳至受控環境、將主機名新增至該環境中的應用程式,並將憑證系結至主機名。

核心 GA
az containerapp ssl upload

將憑證上傳至受控環境、將主機名新增至該環境中的應用程式,並將憑證系結至主機名。

核心 GA
az containerapp up

建立或更新容器應用程式以及任何相關聯的資源(ACR、資源群組、容器應用程式環境、GitHub Actions 等)。

核心 GA
az containerapp up (containerapp 擴充功能)

建立或更新容器應用程式以及任何相關聯的資源(ACR、資源群組、容器應用程式環境、GitHub Actions 等)。

副檔名 GA
az containerapp update

更新容器應用程式。 在多個修訂模式中,根據最新的修訂建立新的修訂。

核心 GA
az containerapp update (containerapp 擴充功能)

更新容器應用程式。 在多個修訂模式中,根據最新的修訂建立新的修訂。

副檔名 GA

az containerapp browse

盡可能在瀏覽器中開啟 containerapp。

az containerapp browse [--ids]
                       [--name]
                       [--resource-group]
                       [--subscription]

範例

在瀏覽器中開啟 containerapp

az containerapp browse -n my-containerapp -g MyResourceGroup

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp create

建立容器應用程式。

az containerapp create --name
                       --resource-group
                       [--allow-insecure {false, true}]
                       [--args]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--dal]
                       [--dapr-app-id]
                       [--dapr-app-port]
                       [--dapr-app-protocol {grpc, http}]
                       [--dapr-http-max-request-size]
                       [--dapr-http-read-buffer-size]
                       [--dapr-log-level {debug, error, info, warn}]
                       [--enable-dapr {false, true}]
                       [--env-vars]
                       [--environment]
                       [--exposed-port]
                       [--image]
                       [--ingress {external, internal}]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--no-wait]
                       [--registry-identity]
                       [--registry-password]
                       [--registry-server]
                       [--registry-username]
                       [--revision-suffix]
                       [--revisions-mode {multiple, single}]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--secrets]
                       [--system-assigned]
                       [--tags]
                       [--target-port]
                       [--termination-grace-period]
                       [--transport {auto, http, http2, tcp}]
                       [--user-assigned]
                       [--workload-profile-name]
                       [--yaml]

範例

建立容器應用程式並擷取其完整功能變數名稱。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v1.0 --environment MyContainerappEnv \
    --ingress external --target-port 80 \
    --registry-server myregistry.azurecr.io --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --query properties.configuration.ingress.fqdn

建立具有資源需求和複本計數限制的容器應用程式。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image nginx --environment MyContainerappEnv \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

建立具有秘密和環境變數的容器應用程式。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret

使用 YAML 組態建立容器應用程式。 範例 YAML 組態 - https://aka.ms/azure-container-apps-yaml

az containerapp create -n my-containerapp -g MyResourceGroup \
    --environment MyContainerappEnv \
    --yaml "path/to/yaml/file.yml"

使用 HTTP 調整規則建立容器應用程式

az containerapp create -n myapp -g mygroup --environment myenv --image nginx \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自訂調整規則建立容器應用程式

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-queue-processor --environment MyContainerappEnv \
    --min-replicas 4 --max-replicas 8 \
    --scale-rule-name queue-based-autoscaling \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name"

建立具有秘密的容器應用程式,並將其掛接在磁碟區中。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --secret-volume-mount "mnt/secrets"

必要參數

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--allow-insecure

允許輸入流量不安全的連線。

接受的值: false, true
預設值: False
--args

容器啟動命令自變數的清單。 以空格分隔的值,例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值,例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU,從0.25 - 2.0,例如0.5。

--dal --dapr-enable-api-logging

啟用 Dapr 側車的 API 記錄。

預設值: False
--dapr-app-id

Dapr 應用程式識別碼。

--dapr-app-port

Dapr 埠會使用 來與應用程式通訊。

--dapr-app-protocol

Dapr 用來與應用程式通訊的通訊協定。

接受的值: grpc, http
--dapr-http-max-request-size --dhmrs

以 MB 增加要求本文 HTTP 和 grpc 伺服器參數的大小上限,以處理大型檔案上傳。

--dapr-http-read-buffer-size --dhrbs

傳送多 KB 標頭標頭時,要處理之 HTTP 標頭讀取緩衝區的大小上限。

--dapr-log-level

設定 Dapr 側車的記錄層級。

接受的值: debug, error, info, warn
--enable-dapr

布爾值,指出 Dapr 側車是否已啟用。

接受的值: false, true
預設值: False
--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref:' 作為參考秘密的前置詞值。

--environment

容器應用程式環境的名稱或資源識別碼。

--exposed-port

其他公開的埠。 僅支援 tcp 傳輸通訊協定。 如果應用程式輸入為外部,則每個環境必須是唯一的。

--image -i

容器映射,例如 publisher/image-name:tag。

--ingress

輸入類型。

接受的值: external, internal
--max-replicas

複本數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾,例如 1.0Gi。

--min-replicas

複本數目下限。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--registry-identity

使用登錄伺服器進行驗證的受控識別,而不是使用者名稱/密碼。 分別針對使用者定義和系統定義的身分識別使用資源標識碼或「系統」。 登錄必須是 ACR。 可能的話,系統會自動為身分識別建立「acrpull」角色 assignemnt。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名,例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--revision-suffix

附加至修訂名稱的使用者易記後綴。

--revisions-mode

容器應用程式的使用中修訂模式。

接受的值: multiple, single
預設值: single
--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

相應放大之前的並行要求數目上限。僅支援 HTTP 和 tcp 調整規則。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。 默認值:HTTP。 如需詳細資訊,請造訪 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

掛接所有秘密的路徑,例如 mnt/secrets。

--secrets -s

容器應用程式的秘密清單。 以 『key=value』 格式分隔的空間值。

--system-assigned

布爾值,指出是否指派系統指派的身分識別。

預設值: False
--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--target-port

用於輸入流量的應用程式埠。

--termination-grace-period --tgp

復本在強制終止之前,會先正常關閉複本的持續時間,以秒為單位。 (預設值:30)。

--transport

用於輸入流量的傳輸通訊協定。

接受的值: auto, http, http2, tcp
預設值: auto
--user-assigned

要指派的空間分隔使用者身分識別。

--workload-profile-name -w

要執行應用程式的工作負載配置檔名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例,請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp create (containerapp 擴充功能)

建立容器應用程式。

az containerapp create --name
                       --resource-group
                       [--allow-insecure {false, true}]
                       [--args]
                       [--artifact]
                       [--bind]
                       [--branch]
                       [--build-env-vars]
                       [--command]
                       [--container-name]
                       [--context-path]
                       [--cpu]
                       [--customized-keys]
                       [--dal]
                       [--dapr-app-id]
                       [--dapr-app-port]
                       [--dapr-app-protocol {grpc, http}]
                       [--dapr-http-max-request-size]
                       [--dapr-http-read-buffer-size]
                       [--dapr-log-level {debug, error, info, warn}]
                       [--enable-dapr {false, true}]
                       [--env-vars]
                       [--environment]
                       [--environment-type {connected, managed}]
                       [--exposed-port]
                       [--image]
                       [--ingress {external, internal}]
                       [--max-inactive-revisions]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--no-wait]
                       [--registry-identity]
                       [--registry-password]
                       [--registry-server]
                       [--registry-username]
                       [--repo]
                       [--revision-suffix]
                       [--revisions-mode {multiple, single}]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--secrets]
                       [--service-principal-client-id]
                       [--service-principal-client-secret]
                       [--service-principal-tenant-id]
                       [--source]
                       [--system-assigned]
                       [--tags]
                       [--target-port]
                       [--termination-grace-period]
                       [--token]
                       [--transport {auto, http, http2, tcp}]
                       [--user-assigned]
                       [--workload-profile-name]
                       [--yaml]

範例

建立容器應用程式並擷取其完整功能變數名稱。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v1.0 --environment MyContainerappEnv \
    --ingress external --target-port 80 \
    --registry-server myregistry.azurecr.io --registry-username myregistry --registry-password $REGISTRY_PASSWORD \
    --query properties.configuration.ingress.fqdn

建立具有資源需求和複本計數限制的容器應用程式。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image nginx --environment MyContainerappEnv \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

建立具有秘密和環境變數的容器應用程式。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --env-vars GREETING="Hello, world" SECRETENV=secretref:anothersecret

使用 YAML 組態建立容器應用程式。 範例 YAML 組態 - https://aka.ms/azure-container-apps-yaml

az containerapp create -n my-containerapp -g MyResourceGroup \
    --environment MyContainerappEnv \
    --yaml "path/to/yaml/file.yml"

使用 HTTP 調整規則建立容器應用程式

az containerapp create -n myapp -g mygroup --environment myenv --image nginx \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自訂調整規則建立容器應用程式

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-queue-processor --environment MyContainerappEnv \
    --min-replicas 4 --max-replicas 8 \
    --scale-rule-name queue-based-autoscaling \
    --scale-rule-type azure-queue \
    --scale-rule-metadata "accountName=mystorageaccountname" \
                          "cloud=AzurePublicCloud" \
                          "queueLength": "5" "queueName": "foo" \
    --scale-rule-auth "connection=my-connection-string-secret-name"

建立具有秘密的容器應用程式,並將其掛接在磁碟區中。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappEnv \
    --secrets mysecret=secretvalue1 anothersecret="secret value 2" \
    --secret-volume-mount "mnt/secrets"

建立裝載於 連線 環境的容器應用程式。

az containerapp create -n my-containerapp -g MyResourceGroup \
    --image my-app:v1.0 --environment MyContainerappConnectedEnv \
    --environment-type connected

在提供的 GitHub 存放庫中,從新的 GitHub Actions 工作流程建立容器應用程式

az containerapp create -n my-containerapp -g MyResourceGroup \
--environment MyContainerappEnv --registry-server MyRegistryServer \
--registry-user MyRegistryUser --registry-pass MyRegistryPass \
--repo https://github.com/myAccount/myRepo

從提供的應用程式來源建立容器應用程式

az containerapp create -n my-containerapp -g MyResourceGroup \
--environment MyContainerappEnv --registry-server MyRegistryServer \
--registry-user MyRegistryUser --registry-pass MyRegistryPass \
--source .

必要參數

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--allow-insecure

允許輸入流量不安全的連線。

接受的值: false, true
預設值: False
--args

容器啟動命令自變數的清單。 以空格分隔的值,例如 “-c” “mycommand”。 空字串可清除現有的值。

--artifact
預覽

用來建置容器映像之應用程式成品的本機路徑。 請參閱這裡支援的成品: https://aka.ms/SourceToCloudSupportedArtifacts

--bind
預覽

要連線至此應用程式的服務、系結或 Java 元件的空間分隔清單。 例如SVC_NAME1[:BIND_NAME1] SVC_NAME2[:BIND_NAME2]...

--branch -b
預覽

提供的 GitHub 存放庫中的分支。 如果未指定,則假設為 GitHub 存放庫的預設分支。

--build-env-vars
預覽

組建的環境變數清單。 以 『key=value』 格式分隔的空間值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值,例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--context-path
預覽

要執行 Docker 組建之存放庫中的路徑。 默認為 “./”。 Dockerfile 假設名為 “Dockerfile”,且在此目錄中。

--cpu

核心中所需的CPU,從0.25 - 2.0,例如0.5。

--customized-keys
預覽

用來變更預設組態名稱的自定義金鑰。 索引鍵是原始名稱,值為自定義名稱。

--dal --dapr-enable-api-logging

啟用 Dapr 側車的 API 記錄。

預設值: False
--dapr-app-id

Dapr 應用程式識別碼。

--dapr-app-port

Dapr 埠會使用 來與應用程式通訊。

--dapr-app-protocol

Dapr 用來與應用程式通訊的通訊協定。

接受的值: grpc, http
--dapr-http-max-request-size --dhmrs

以 MB 增加要求本文 HTTP 和 grpc 伺服器參數的大小上限,以處理大型檔案上傳。

--dapr-http-read-buffer-size --dhrbs

傳送多 KB 標頭標頭時,要處理之 HTTP 標頭讀取緩衝區的大小上限。

--dapr-log-level

設定 Dapr 側車的記錄層級。

接受的值: debug, error, info, warn
--enable-dapr

布爾值,指出 Dapr 側車是否已啟用。

接受的值: false, true
預設值: False
--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref:' 作為參考秘密的前置詞值。

--environment

容器應用程式環境的名稱或資源識別碼。

--environment-type
預覽

環境類型。

接受的值: connected, managed
預設值: managed
--exposed-port

其他公開的埠。 僅支援 tcp 傳輸通訊協定。 如果應用程式輸入為外部,則每個環境必須是唯一的。

--image -i

容器映射,例如 publisher/image-name:tag。

--ingress

輸入類型。

接受的值: external, internal
--max-inactive-revisions
預覽

容器應用程式可以擁有的最大非使用中修訂。

--max-replicas

複本數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾,例如 1.0Gi。

--min-replicas

複本數目下限。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--registry-identity

使用登錄伺服器進行驗證的受控識別,而不是使用者名稱/密碼。 分別針對使用者定義和系統定義的身分識別使用資源標識碼或「系統」。 登錄必須是 ACR。 可能的話,系統會自動為身分識別建立「acrpull」角色 assignemnt。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名,例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--repo
預覽

透過 GitHub Actions 建立應用程式,格式為: https://github.com// 或 /。

--revision-suffix

附加至修訂名稱的使用者易記後綴。

--revisions-mode

容器應用程式的使用中修訂模式。

接受的值: multiple, single
預設值: single
--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

相應放大之前的並行要求數目上限。僅支援 HTTP 和 tcp 調整規則。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。 默認值:HTTP。 如需詳細資訊,請造訪 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

掛接所有秘密的路徑,例如 mnt/secrets。

--secrets -s

容器應用程式的秘密清單。 以 『key=value』 格式分隔的空間值。

--service-principal-client-id --sp-cid
預覽

服務主體用戶端識別碼。 由 GitHub Actions 用來向 Azure 進行驗證。

--service-principal-client-secret --sp-sec
預覽

服務主體客戶端密碼。 由 GitHub Actions 用來向 Azure 進行驗證。

--service-principal-tenant-id --sp-tid
預覽

服務主體租用戶標識碼。 由 GitHub Actions 用來向 Azure 進行驗證。

--source
預覽

包含用來建置容器映像之應用程式來源和 Dockerfile 的本機目錄路徑。 預覽:如果沒有 Dockerfile 存在,就會使用 buildpack 產生容器映像。 如果 Docker 未執行或建置套件無法使用,Oryx 將用來產生映像。 請參閱這裡支援的 Oryx 運行時間: https://aka.ms/SourceToCloudSupportedVersions

--system-assigned

布爾值,指出是否指派系統指派的身分識別。

預設值: False
--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--target-port

用於輸入流量的應用程式埠。

--termination-grace-period --tgp

復本在強制終止之前,會先正常關閉複本的持續時間,以秒為單位。 (預設值:30)。

--token
預覽

具有指定存放庫寫入許可權的個人存取令牌。 如需詳細資訊: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果在快取中未提供或找不到 ,且使用 --repo,則會開啟瀏覽器頁面以向 Github 進行驗證。

--transport

用於輸入流量的傳輸通訊協定。

接受的值: auto, http, http2, tcp
預設值: auto
--user-assigned

要指派的空間分隔使用者身分識別。

--workload-profile-name -w

要執行應用程式的工作負載配置檔名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例,請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp delete

刪除容器應用程式。

az containerapp delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--subscription]
                       [--yes]

範例

刪除容器應用程式。

az containerapp delete -g MyResourceGroup -n MyContainerapp

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp delete (containerapp 擴充功能)

刪除容器應用程式。

az containerapp delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--subscription]
                       [--yes]

範例

刪除容器應用程式。

az containerapp delete -g MyResourceGroup -n MyContainerapp

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp exec

在容器應用程式複本內開啟類似SSH的互動式殼層。

az containerapp exec --name
                     --resource-group
                     [--command]
                     [--container]
                     [--replica]
                     [--revision]

範例

exec 進入容器應用程式

az containerapp exec -n my-containerapp -g MyResourceGroup

exec 到特定的容器應用程式復本和修訂

az containerapp exec -n my-containerapp -g MyResourceGroup --replica MyReplica --revision MyRevision

在 containerapp 中開啟 bash 殼層

az containerapp exec -n my-containerapp -g MyResourceGroup --command bash

必要參數

--name -n

Containerapp 的名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--command

啟動命令 (bash、zsh、sh 等)。

預設值: sh
--container

要透過 SSH 連線的容器名稱。

--replica

要透過 SSH 連線的複本名稱。 使用 'az containerapp replica list' 列出複本。 如果應用程式沒有流量,復本可能不存在。

--revision

要 ssh 登入的容器應用程式修訂名稱。 預設為最新的修訂。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp list

列出容器應用程式。

az containerapp list [--environment]
                     [--resource-group]

範例

列出目前訂用帳戶中的容器應用程式。

az containerapp list

依資源群組列出容器應用程式。

az containerapp list -g MyResourceGroup

選擇性參數

--environment

容器應用程式環境的名稱或資源識別碼。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp list (containerapp 擴充功能)

列出容器應用程式。

az containerapp list [--environment]
                     [--environment-type {connected, managed}]
                     [--resource-group]

範例

列出目前訂用帳戶中的容器應用程式。

az containerapp list

依資源群組列出容器應用程式。

az containerapp list -g MyResourceGroup

依環境類型列出容器應用程式。

az containerapp list --environment-type connected

選擇性參數

--environment

容器應用程式環境的名稱或資源識別碼。

--environment-type
預覽

環境類型。

接受的值: connected, managed
預設值: all
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp list-usages

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出特定區域中訂用帳戶層級配額的使用方式。

az containerapp list-usages --location

範例

列出特定區域中配額的使用方式。

az containerapp list-usages -l eastus

必要參數

--location -l

位置。​​ 來自的值: az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp show

顯示容器應用程式的詳細數據。

az containerapp show [--ids]
                     [--name]
                     [--resource-group]
                     [--show-secrets]
                     [--subscription]

範例

顯示容器應用程式的詳細數據。

az containerapp show -n my-containerapp -g MyResourceGroup

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--show-secrets

顯示 Containerapp 秘密。

預設值: False
--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp show (containerapp 擴充功能)

顯示容器應用程式的詳細數據。

az containerapp show [--ids]
                     [--name]
                     [--resource-group]
                     [--show-secrets]
                     [--subscription]

範例

顯示容器應用程式的詳細數據。

az containerapp show -n my-containerapp -g MyResourceGroup

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--show-secrets

顯示 Containerapp 秘密。

預設值: False
--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp show-custom-domain-verification-id

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

顯示系結應用程式或環境自定義網域的驗證標識碼。

az containerapp show-custom-domain-verification-id

範例

取得驗證標識碼,其必須新增為應用程式自定義網域的 TXT 記錄,以驗證網域擁有權

az containerapp show-custom-domain-verification-id

取得驗證標識碼,其必須新增為自定義環境 DNS 後綴的 TXT 記錄,以驗證網域擁有權

az containerapp show-custom-domain-verification-id
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp up

建立或更新容器應用程式以及任何相關聯的資源(ACR、資源群組、容器應用程式環境、GitHub Actions 等)。

az containerapp up --name
                   [--branch]
                   [--browse]
                   [--context-path]
                   [--env-vars]
                   [--environment]
                   [--image]
                   [--ingress {external, internal}]
                   [--location]
                   [--logs-workspace-id]
                   [--logs-workspace-key]
                   [--registry-password]
                   [--registry-server]
                   [--registry-username]
                   [--repo]
                   [--resource-group]
                   [--service-principal-client-id]
                   [--service-principal-client-secret]
                   [--service-principal-tenant-id]
                   [--source]
                   [--target-port]
                   [--token]
                   [--workload-profile-name]

範例

在 GitHub 存放庫中從 dockerfile 建立容器應用程式(設定 github 動作)

az containerapp up -n my-containerapp --repo https://github.com/myAccount/myRepo

從本機目錄中的 dockerfile 建立容器應用程式(如果找不到 dockerfile 則自動產生容器)

az containerapp up -n my-containerapp --source .

從登錄中的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag

從登錄中啟用輸入和指定環境的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --ingress external --target-port 80 --environment MyEnv

必要參數

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

選擇性參數

--branch -b

Github 存放庫的分支。 如果未指定,則假設為 Github 存放庫的預設分支。

--browse

盡可能在建立和部署之後,在網頁瀏覽器中開啟應用程式。

預設值: False
--context-path

用來執行 Docker 組建之存放庫中的路徑。 默認為 “./”。 Dockerfile 假設名為 “Dockerfile”,且在此目錄中。

--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref:' 作為參考秘密的前置詞值。

--environment

容器應用程式環境的名稱或資源識別碼。

--image -i

容器映射,例如 publisher/image-name:tag。

--ingress

輸入類型。

接受的值: external, internal
--location -l

位置。​​ 來自的值: az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名,例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--repo

透過 Github Actions 建立應用程式。 格式為: https://github.com// 或 /。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service-principal-client-id --sp-cid

服務主體用戶端識別碼。 由 Github Actions 用來向 Azure 進行驗證。

--service-principal-client-secret --sp-sec

服務主體客戶端密碼。 由 Github Actions 用來向 Azure 進行驗證。

--service-principal-tenant-id --sp-tid

服務主體租用戶標識碼。 由 Github Actions 用來向 Azure 進行驗證。

--source

包含用來建置容器映像之應用程式來源和 Dockerfile 的本機目錄路徑。 預覽:如果沒有 Dockerfile 存在,就會使用 buildpack 產生容器映像。 如果 Docker 未執行或建置套件無法使用,Oryx 將用來產生映像。 請參閱這裡支援的 Oryx 運行時間: https://github.com/microsoft/Oryx/blob/main/doc/supportedRuntimeVersions.md

--target-port

用於輸入流量的應用程式埠。

--token

具有指定存放庫寫入許可權的個人存取令牌。 如需詳細資訊: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果在快取中未提供或找不到 ,且使用 --repo,則會開啟瀏覽器頁面以向 Github 進行驗證。

--workload-profile-name -w

工作負載配置檔的易記名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp up (containerapp 擴充功能)

建立或更新容器應用程式以及任何相關聯的資源(ACR、資源群組、容器應用程式環境、GitHub Actions 等)。

az containerapp up --name
                   [--artifact]
                   [--branch]
                   [--browse]
                   [--build-env-vars]
                   [--connected-cluster-id]
                   [--context-path]
                   [--custom-location]
                   [--env-vars]
                   [--environment]
                   [--image]
                   [--ingress {external, internal}]
                   [--location]
                   [--logs-workspace-id]
                   [--logs-workspace-key]
                   [--registry-password]
                   [--registry-server]
                   [--registry-username]
                   [--repo]
                   [--resource-group]
                   [--service-principal-client-id]
                   [--service-principal-client-secret]
                   [--service-principal-tenant-id]
                   [--source]
                   [--target-port]
                   [--token]
                   [--workload-profile-name]

範例

在 GitHub 存放庫中從 dockerfile 建立容器應用程式(設定 github 動作)

az containerapp up -n my-containerapp --repo https://github.com/myAccount/myRepo

從本機目錄中的 dockerfile 建立容器應用程式(如果找不到 dockerfile 則自動產生容器)

az containerapp up -n my-containerapp --source .

從登錄中的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag

從登錄中啟用輸入和指定環境的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --ingress external --target-port 80 --environment MyEnv

從 連線 叢集上登錄中的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --connected-cluster-id MyConnectedClusterResourceId

在連線的環境中,從登錄中的映像建立容器應用程式

az containerapp up -n my-containerapp --image myregistry.azurecr.io/myImage:myTag --environment MyConnectedEnvironmentId

必要參數

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

選擇性參數

--artifact
預覽

用來建置容器映像之應用程式成品的本機路徑。 請參閱這裡支援的成品: https://aka.ms/SourceToCloudSupportedArtifacts

--branch -b

Github 存放庫的分支。 如果未指定,則假設為 Github 存放庫的預設分支。

--browse

盡可能在建立和部署之後,在網頁瀏覽器中開啟應用程式。

預設值: False
--build-env-vars
預覽

組建的環境變數清單。 以 『key=value』 格式分隔的空間值。

--connected-cluster-id
預覽

已連線叢集的資源標識碼。 使用 'az connectedk8s list' 列出。

--context-path

用來執行 Docker 組建之存放庫中的路徑。 默認為 “./”。 Dockerfile 假設名為 “Dockerfile”,且在此目錄中。

--custom-location
預覽

自訂位置的資源識別碼。 使用 'az customlocation list' 列出。

--env-vars

容器的環境變數清單。 以 『key=value』 格式分隔的空間值。 空字串可清除現有的值。 使用 'secretref:' 作為參考秘密的前置詞值。

--environment

容器應用程式受控環境或已連線環境的名稱或資源標識符。

--image -i

容器映射,例如 publisher/image-name:tag。

--ingress

輸入類型。

接受的值: external, internal
--location -l

位置。​​ 來自的值: az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--logs-workspace-id

要傳送診斷記錄的Log Analytics工作區工作區標識碼。 您可以使用 “az monitor log-analytics workspace create” 來建立一個。 可能會套用額外的計費。

--logs-workspace-key

用來設定Log Analytics工作區的Log Analytics工作區密鑰。 您可以使用 “az monitor log-analytics workspace get-shared-keys” 來擷取密鑰。

--registry-password

登入容器登錄的密碼。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--registry-server

容器登錄伺服器主機名,例如 myregistry.azurecr.io。

--registry-username

要登入容器登錄的用戶名稱。

--repo

透過 Github Actions 建立應用程式。 格式為: https://github.com// 或 /。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--service-principal-client-id --sp-cid

服務主體用戶端識別碼。 由 Github Actions 用來向 Azure 進行驗證。

--service-principal-client-secret --sp-sec

服務主體客戶端密碼。 由 Github Actions 用來向 Azure 進行驗證。

--service-principal-tenant-id --sp-tid

服務主體租用戶標識碼。 由 Github Actions 用來向 Azure 進行驗證。

--source

包含用來建置容器映像之應用程式來源和 Dockerfile 的本機目錄路徑。 預覽:如果沒有 Dockerfile 存在,就會使用 buildpack 產生容器映像。 如果 Docker 未執行或建置套件無法使用,Oryx 將用來產生映像。 請參閱這裡支援的 Oryx 運行時間: https://github.com/microsoft/Oryx/blob/main/doc/supportedRuntimeVersions.md

--target-port

用於輸入流量的應用程式埠。

--token

具有指定存放庫寫入許可權的個人存取令牌。 如需詳細資訊: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line。 如果在快取中未提供或找不到 ,且使用 --repo,則會開啟瀏覽器頁面以向 Github 進行驗證。

--workload-profile-name -w

工作負載配置檔的易記名稱。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp update

更新容器應用程式。 在多個修訂模式中,根據最新的修訂建立新的修訂。

az containerapp update [--args]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--ids]
                       [--image]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--name]
                       [--no-wait]
                       [--remove-all-env-vars]
                       [--remove-env-vars]
                       [--replace-env-vars]
                       [--resource-group]
                       [--revision-suffix]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--set-env-vars]
                       [--subscription]
                       [--tags]
                       [--termination-grace-period]
                       [--workload-profile-name]
                       [--yaml]

範例

更新容器應用程式的容器映像。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v2.0

更新容器應用程式的資源需求和調整限制。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用 HTTP 調整規則更新容器應用程式

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自訂調整規則更新容器應用程式

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-custom-rule \
    --scale-rule-type my-custom-type \
    --scale-rule-metadata key=value key2=value2 \
    --scale-rule-auth triggerparam=secretref triggerparam=secretref

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值,例如 “-c” “mycommand”。 空字串可清除現有的值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值,例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU,從0.25 - 2.0,例如0.5。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--image -i

容器映射,例如 publisher/image-name:tag。

--max-replicas

複本數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾,例如 1.0Gi。

--min-replicas

複本數目下限。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--remove-all-env-vars

從 container 移除所有環境變數。。

預設值: False
--remove-env-vars

從容器中移除環境變數。 以空格分隔的環境變數名稱。

--replace-env-vars

取代容器中的環境變數。 拿掉其他現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--revision-suffix

附加至修訂名稱的使用者易記後綴。

--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

相應放大之前的並行要求數目上限。僅支援 HTTP 和 tcp 調整規則。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。 默認值:HTTP。 如需詳細資訊,請造訪 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

掛接所有秘密的路徑,例如 mnt/secrets。

--set-env-vars

在容器中新增或更新環境變數。 不會修改現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--termination-grace-period --tgp

復本在強制終止之前,會先正常關閉複本的持續時間,以秒為單位。 (預設值:30)。

--workload-profile-name -w

工作負載配置檔的易記名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例,請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az containerapp update (containerapp 擴充功能)

更新容器應用程式。 在多個修訂模式中,根據最新的修訂建立新的修訂。

az containerapp update [--args]
                       [--artifact]
                       [--bind]
                       [--build-env-vars]
                       [--command]
                       [--container-name]
                       [--cpu]
                       [--customized-keys]
                       [--ids]
                       [--image]
                       [--max-inactive-revisions]
                       [--max-replicas]
                       [--memory]
                       [--min-replicas]
                       [--name]
                       [--no-wait]
                       [--remove-all-env-vars]
                       [--remove-env-vars]
                       [--replace-env-vars]
                       [--resource-group]
                       [--revision-suffix]
                       [--scale-rule-auth]
                       [--scale-rule-http-concurrency]
                       [--scale-rule-metadata]
                       [--scale-rule-name]
                       [--scale-rule-type]
                       [--secret-volume-mount]
                       [--set-env-vars]
                       [--source]
                       [--subscription]
                       [--tags]
                       [--termination-grace-period]
                       [--unbind]
                       [--workload-profile-name]
                       [--yaml]

範例

更新容器應用程式的容器映像。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --image myregistry.azurecr.io/my-app:v2.0

更新容器應用程式的資源需求和調整限制。

az containerapp update -n my-containerapp -g MyResourceGroup \
    --cpu 0.5 --memory 1.0Gi \
    --min-replicas 4 --max-replicas 8

使用 HTTP 調整規則更新容器應用程式

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-http-rule \
    --scale-rule-http-concurrency 50

使用自訂調整規則更新容器應用程式

az containerapp update -n myapp -g mygroup \
    --scale-rule-name my-custom-rule \
    --scale-rule-type my-custom-type \
    --scale-rule-metadata key=value key2=value2 \
    --scale-rule-auth triggerparam=secretref triggerparam=secretref

從提供的應用程式來源更新容器應用程式

az containerapp update -n my-containerapp -g MyResourceGroup --source .

選擇性參數

--args

容器啟動命令自變數的清單。 以空格分隔的值,例如 “-c” “mycommand”。 空字串可清除現有的值。

--artifact
預覽

用來建置容器映像之應用程式成品的本機路徑。 請參閱這裡支援的成品: https://aka.ms/SourceToCloudSupportedArtifacts

--bind
預覽

要連線至此應用程式的服務、系結或 Java 元件的空間分隔清單。 例如SVC_NAME1[:BIND_NAME1] SVC_NAME2[:BIND_NAME2]...

--build-env-vars
預覽

組建的環境變數清單。 以 『key=value』 格式分隔的空間值。

--command

在啟動期間執行之容器上支援的命令清單。 以空格分隔的值,例如 “/bin/queue” “mycommand”。 空字串可清除現有的值。

--container-name

容器的名稱。

--cpu

核心中所需的CPU,從0.25 - 2.0,例如0.5。

--customized-keys
預覽

用來變更預設組態名稱的自定義金鑰。 索引鍵是原始名稱,值為自定義名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。

--image -i

容器映射,例如 publisher/image-name:tag。

--max-inactive-revisions
預覽

容器應用程式可以擁有的最大非使用中修訂。

--max-replicas

複本數目上限。

--memory

0.5 - 4.0 的所需記憶體以 “Gi” 結尾,例如 1.0Gi。

--min-replicas

複本數目下限。

--name -n

Containerapp 的名稱。 名稱必須包含小寫英數位元或 '-'、以字母開頭、以英數位元結尾、不能有 '--' 且必須小於 32 個字元。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--remove-all-env-vars

從 container 移除所有環境變數。。

預設值: False
--remove-env-vars

從容器中移除環境變數。 以空格分隔的環境變數名稱。

--replace-env-vars

取代容器中的環境變數。 拿掉其他現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--revision-suffix

附加至修訂名稱的使用者易記後綴。

--scale-rule-auth --sra

調整規則驗證參數。 驗證參數的格式必須是 “= = ...”。

--scale-rule-http-concurrency --scale-rule-tcp-concurrency --srhc --srtc

相應放大之前的並行要求數目上限。僅支援 HTTP 和 tcp 調整規則。

--scale-rule-metadata --srm

調整規則元數據。 元數據的格式必須是 “= = ...”。

--scale-rule-name --srn

縮放規則的名稱。

--scale-rule-type --srt

縮放規則的類型。 默認值:HTTP。 如需詳細資訊,請造訪 https://learn.microsoft.com/azure/container-apps/scale-app#scale-triggers

--secret-volume-mount

掛接所有秘密的路徑,例如 mnt/secrets。

--set-env-vars

在容器中新增或更新環境變數。 不會修改現有的環境變數。 以 『key=value』 格式分隔的空間值。 如果儲存為秘密,值必須以 'secretref:' 開頭,後面接著秘密名稱。

--source
預覽

包含用來建置容器映像之應用程式來源和 Dockerfile 的本機目錄路徑。 預覽:如果沒有 Dockerfile 存在,就會使用 buildpack 產生容器映像。 如果 Docker 未執行或建置套件無法使用,Oryx 將用來產生映像。 請參閱這裡支援的 Oryx 運行時間: https://aka.ms/SourceToCloudSupportedVersions

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--termination-grace-period --tgp

復本在強制終止之前,會先正常關閉複本的持續時間,以秒為單位。 (預設值:30)。

--unbind
預覽

要從此應用程式移除的服務、系結或 Java 元件的空間分隔清單。 例如BIND_NAME1...

--workload-profile-name -w

工作負載配置檔的易記名稱。

--yaml

具有容器應用程式組態的 .yaml 檔案路徑。 將會忽略所有其他參數。 如需範例,請參閱 https://docs.microsoft.com/azure/container-apps/azure-resource-manager-api-spec#examples

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。