在 Azure 容器應用程式 中設定應用程式的入口流量

本文顯示如何啟用容器應用程式的輸入功能。 輸入是全應用程式設定。 輸入設定的變更會同時套用至所有修訂,而且不會產生新的修訂。

輸入設定

您可以設定下列輸入範本屬性:

屬性 描述 值 必要
allowInsecure 允許不安全的流量流向您的容器應用程式。 設定為 true時,埠 80 的 HTTP 要求不會使用 HTTPS 自動重新導向至埠 443,因此允許不安全的連線。 false (預設值),true 會啟用不安全的連線 否
clientCertificateMode mTLS 驗證的用戶端憑證模式。 Ignore 表示伺服器在轉送時捨棄用戶端憑證。 Accept 表示伺服器會轉送用戶端憑證,但不需要用戶端憑證。 Require 表示伺服器需要用戶端憑證。 Required、Accept、Ignore (預設值) 否
customDomains 容器應用程式主機名稱的自訂網域繫結。 參閱自定義網域和憑證 (部分機器翻譯) 繫結的陣列 否
exposedPort (僅限 TCP 輸入) 接聽連接埠 TCP。 如果 external 為 true,則值在容器應用程式環境中必須唯一。 從 1 到 65535 的連接埠號碼。 (不可為 80 或 443) 否
external 允許從容器應用程式環境外部輸入您的應用程式。 true 或 false (預設值) 是的
ipSecurityRestrictions IP 輸入限制。 參閱設定 IP 輸入限制 (部分機器翻譯) 規則的陣列 否
stickySessions.affinity 啟用工作階段同質。 none (預設),sticky 否
targetPort 您的容器應用程式接聽傳入要求的連接埠。 將此值設定為您的容器應用程式所使用的連接埠號碼。 若要進行 HTTP 輸入,應用程式輸入端點一律會在連接埠 443 上公開。 是的
traffic 流量分割會在修訂之間分割進行加權。 規則的陣列 否
transport 傳輸通訊協定類型。 auto (預設)偵測 HTTP/1 或 HTTP/2, http 對於 HTTP/1,對於 HTTP/2, http2tcp 對於 TCP。 否

自動連接埠偵測

如果您的容器應用程式已啟用 HTTP 輸入,而且您未設定目標埠,Azure 容器應用程式會掃描容器上的所有接聽埠,以自動偵測目標埠。 如果只偵測到一個連接埠,則該連接埠會設定為容器應用程式的目標連接埠。 如果偵測到多個連接埠,容器應用程式不會自動設定目標連接埠,而且您需要手動設定目標連接埠。

  • 自動連接埠偵測僅適用於 HTTP 流量,不適用於 TCP 流量。
  • 如果您有 HTTP 健康探針在監聽連接埠 80 或 443,這項設定可能會干擾自動連接埠偵測。 預設的輸入組態會使用 TCP 健康情況探查。 如需詳細資訊,請參閱 健康情況探查。

啟用輸入

您可以使用 Azure CLI、ARM 範本或 Azure 入口網站來設定容器應用程式的輸入。

此 az containerapp ingress enable 命令會為您的容器應用啟用入口。 您必須指定目標連接埠,而且若您的傳輸類型為 tcp,便可選擇性地設定公開連接埠。

az containerapp ingress enable \
    --name <app-name> \
    --resource-group <resource-group> \
    --target-port <target-port> \
    --exposed-port <tcp-exposed-port> \
    --transport <transport> \
    --type <external>
    --allow-insecure

az containerapp ingress enable 輸入引數:

選項 屬性 描述 值 必要
--type external 允許從任何地方輸入您的應用程式,或限制其內部容器應用程式環境進行輸入。 external 或 internal 是的
--allow-insecure allowInsecure 允許 HTTP 連線到您的應用程式。 否
--target-port targetPort 容器接聽傳入要求的連接埠。 將此值設定為容器所使用的連接埠號碼。 應用程式輸入端點一律會在連接埠 443 上公開。 是的
--exposed-port exposedPort (僅限 TCP 輸入) 用於 TCP 輸入的連接埠。 若 external 為 true,此值在輸入為外部輸入時,其在容器應用程式環境中必須唯一。 從 1 到 65535 的連接埠號碼。 (不可為 80 或 443) 否
--transport 傳輸 傳輸通訊協定類型。 自動 (預設值) 會偵測 HTTP/1 或 HTTP/2、HTTP/1 的 http、HTTP/2 的 http2、用於 TCP 的 tcp。 否

附註

在內部環境中, --type external 不會讓你的應用程式暴露在公共網際網路上,因為該環境沒有公開端點。 它讓應用程式能透過環境內部的負載平衡器,從你的虛擬網路存取。 使用 --type internal 會限制該應用程式只能在同一環境中使用其他容器應用程式,而虛擬網路其他用戶端會收到 HTTP 404 回應。 欲了解更多資訊,請參閱「 入口可見性如何與環境類型互動」。

使用入口網站針對您的容器應用程式啟用輸入。

您可以在建立容器應用程式時啟用輸入,也可以為現有容器應用程式啟用輸入。

  • 若要在建立容器應用程式時設定輸入,請從容器應用程式建立精靈的「應用程式組態」索引標籤選取「輸入」。
  • 若要設定現有容器應用程式的輸入,請從容器應用程式資源頁面的「設定」功能表中選取「輸入」。

針對您的容器應用程式啟用輸入

您可以使用 Azure 入口網站,在建立容器應用程式時設定輸入。

  1. 將「輸入」設定為「已啟用」。

  2. 設定容器應用程式的輸入。

  3. 針對內部輸入選取「限制為容器應用程式環境」,或「接受來自任何位置的流量」進行外部輸入。

    在內部環境中, 接受來自任何地方的流量 並不會讓你的應用程式暴露在公共網路上。 它讓應用程式能透過環境內部的負載平衡器,從你的虛擬網路存取。 欲了解更多資訊,請參閱「 入口可見性如何與環境類型互動」。

  4. 選取 輸入類型: HTTP 或 TCP (TCP 輸入僅適用於使用虛擬網路設定的環境)。

  5. 如果已針對「輸入類型」選取 HTTP,請選取「傳輸」:自動、HTTP/1 或 HTTP/2。

  6. 如果您想要允許應用程式的 HTTP 連線,請選取「不安全的連線」。

  7. 輸入容器應用程式的「目標連接埠」。

  8. 如果您針對 [傳輸] 選項選取了 [TCP],請輸入容器應用程式的公開連接埠。 公開連接埠號碼可為 1 至 65535。 (不可為 80 或 443)

容器應用程式的「輸入」設定頁面也可讓您設定 IP 限制。 如需設定 IP 限制的資訊,請參閱 IP 限制 (部分機器翻譯)。

使用 ingress 設定屬性,針對容器應用程式啟用輸入。 將 external 屬性設定為 true,並設定 transport 和 targetPort 屬性。

  • 將external屬性設定為true表示外部流入,或設定為false表示內部流入。
  • 將 transport 設為 auto 以偵測 HTTP/1 或 HTTP/2、HTTP/1 的 http、HTTP/2 的 http2、用於 TCP 的 tcp。
  • 將 targetPort 設為容器使用的連接埠號碼。 應用程式輸入端點一律會在連接埠 443 上公開。
  • 如果傳輸類型是 TCP 輸入連接埠的 exposedPort,請設定 tcp 屬性。 若輸入為外部輸入時,則該值在容器應用程式環境中必須唯一。 從 1 到 65535 的連接埠號碼。 (不可為 80 或 443)
{
  ...
  "configuration": {
    "ingress": {
        "external": true,
        "transport": "tcp",
        "targetPort": 80,
        "exposedPort": 8080,
    },
  }
}

停用輸入

使用 az containerapp ingress 命令停用容器應用程式的輸入。

az containerapp ingress disable \
    --name <app-name> \
    --resource-group <resource-group> \

您可以透過使用入口網站來針對容器應用程式停用輸入。

  1. 從容器應用程式頁面的「設定」功能表中,選取「輸入」。
  2. 取消選取「輸入」「已啟用」設定。
  3. 選取 [儲存]。

停用容器應用程式輸入的螢幕擷取畫面。

從 ingress 完全省略 properties.configuration 設定屬性,針對容器應用程式停用輸入。

使用其他 TCP 連接埠

您可以從應用程式公開額外的 TCP 連接埠。 如需詳細資訊,請參閱 輸入概念一文。

附註

若要使用此功能,您需要容器應用程式 CLI 延伸模組。 執行 az extension add -n containerapp 來安裝最新版本的容器應用程式 CLI 延伸模組。

您可以透過 CLI 參照具有 TCP 連接埠組態的 YAML 檔案來新增額外的 TCP 連接埠。

az containerapp create \
    --name <app-name> \
    --resource-group <resource-group> \
    --yaml <your-yaml-file>

下列範例顯示您可以在上述 CLI 命令中參考的 YAML 檔案。 額外TCP埠的配置位於additionalPortMappings。

location: northcentralus
name: multiport-example
properties:
  configuration:
    activeRevisionsMode: Single
    ingress:
      additionalPortMappings:
      - exposedPort: 21025
        external: false
        targetPort: 1025
      allowInsecure: false
      external: true
      targetPort: 1080
      traffic:
      - latestRevision: true
        weight: 100
      transport: http
  managedEnvironmentId: <env id>
  template:
    containers:
    - image: maildev/maildev
      name: maildev
      resources:
        cpu: 0.25
        memory: 0.5Gi
    scale:
      maxReplicas: 1
      minReplicas: 1
  workloadProfileName: Consumption
type: Microsoft.App/containerApps

透過入口網站為容器應用程式輸入新增額外 TCP 連接埠的螢幕擷取畫面。

  1. 展開 [輸入] 刀鋒視窗中的 [其他 TCP 連接埠] 區段。
  2. 在 [目標連接埠] 欄位中新增應用程式接受流量的額外 TCP 連接埠。 如果您將 [公開連接埠] 保留空白,則會使用與 [目標連接埠] 相同的值。
  3. 視需要變更 [輸入流量] 欄位。 此欄位配置每個埠的輸入流量限制在何處。
  4. 完成時,按一下 [儲存]。

下列 ARM 範本提供範例,說明如何將額外的連接埠新增至容器應用程式。 在容器應用程式的 additionalPortMappings 內,在 ingress 的 configuration 區段內的 properties 下新增每個額外的連接埠。 下列範例顯示如何新增額外的連接埠:

{
  ...
  "properties": {
    ...
    "configuration": {
      "ingress": {
        ...
        "additionalPortMappings": [
          {
            "external": false
            "targetPort": 80
            "exposedPort": 12000
          }
        ]
      }
    }
  ...
}

後續步驟