Konfigurowanie dostępu dla aplikacji w usłudze Azure Container Apps

Polecenie az containerapp ingress enable włącza ruch przychodzący dla aplikacji kontenera. Musisz określić port docelowy i opcjonalnie można ustawić uwidoczniony port, jeśli typ transportu to 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 argumenty wejściowe:

Włącz ruch przychodzący dla aplikacji kontenerowej za pomocą portalu.

Ruch przychodzący można włączyć podczas tworzenia aplikacji kontenera lub włączyć ruch przychodzący dla istniejącej aplikacji kontenera.

• Aby skonfigurować ruch przychodzący podczas tworzenia aplikacji kontenera, wybierz pozycję Ruch przychodzący na karcie Konfiguracja aplikacji w kreatorze tworzenia aplikacji kontenera.
• Aby skonfigurować ruch przychodzący dla istniejącej aplikacji kontenera, wybierz pozycję Ruch przychodzący z menu Ustawienia strony zasobu aplikacji kontenera.

Włączanie ruchu przychodzącego dla aplikacji kontenera

Możesz skonfigurować dostęp przychodzący podczas tworzenia aplikacji kontenerowej przy użyciu portalu Azure.

1. Ustaw Ingress na Włączono.

2. Skonfiguruj ustawienia wejścia dla aplikacji kontenerowej.

3. Wybierz opcję Ograniczone do środowiska usługi Container Apps w przypadku ruchu przychodzącego wewnętrznego lub Akceptowanie ruchu z dowolnego źródła w przypadku ruchu przychodzącego zewnętrznego.

   W środowisku wewnętrznym przyjmowanie ruchu z dowolnego miejsca nie wystawia Twojej aplikacji na dostęp do publicznego internetu. Dzięki temu aplikacja jest dostępna z Twojej wirtualnej sieci przez wewnętrzny load balancer środowiska. Więcej informacji znajdziesz w artykule Jak widoczność wejścia oddziałuje z typem środowiska.

4. Wybierz typ ruchu przychodzącego: HTTP lub TCP (ruch przychodzący TCP jest dostępny tylko w środowiskach skonfigurowanych z siecią wirtualną).

5. Jeśli wybrano opcję HTTP dla typu ruchu przychodzącego, wybierz opcję Transport: Auto, HTTP/1 lub HTTP/2.

6. Wybierz pozycję Niezabezpieczone połączenia , jeśli chcesz zezwolić na połączenia HTTP z aplikacją.

7. Wprowadź port docelowy dla aplikacji kontenera.

8. W przypadku wybrania opcji TCP dla opcji Transport wprowadź port uwidoczniony dla aplikacji kontenera. Udostępniony numer portu może mieć wartość od 1 do 65535. (nie może być 80 lub 443)

Strona Ustawień ruchu przychodzącego dla aplikacji kontenera umożliwia również konfigurowanie ograniczeń adresów IP. Aby uzyskać informacje na temat konfigurowania ograniczeń adresów IP, zobacz Ograniczenia adresów IP.

Włącz ruch przychodzący dla aplikacji kontenerowej, używając właściwości konfiguracji ingress. Ustaw właściwość external na true i ustaw właściwości transport i targetPort.

• external Ustaw właściwość na wartość true dla ruchu przychodzącego zewnętrznego lub false dla ruchu przychodzącego wewnętrznego.
• Ustaw transport na auto, aby wykrywać HTTP/1 lub HTTP/2, http dla HTTP/1, http2 dla HTTP/2 lub tcp dla TCP.
• Ustaw targetPort na numer portu, którego używa kontener. Punkt końcowy ruchu przychodzącego aplikacji jest zawsze uwidaczniony na porcie 443.
• Ustaw właściwość exposedPort, jeśli typ transportu to tcp, na port dla przychodzącego ruchu TCP. Wartość musi być unikalna w środowisku Container Apps, jeśli ruch przychodzący jest ustawiony jako zewnętrzny. Numer portu z 1 do 65535. (nie może być 80 lub 443)

{
  ...
  "configuration": {
    "ingress": {
        "external": true,
        "transport": "tcp",
        "targetPort": 80,
        "exposedPort": 8080,
    },
  }
}

Wyłącz Ingress

Wyłącz ruch wejściowy dla aplikacji kontenerowej przy użyciu polecenia az containerapp ingress.

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

Możesz wyłączyć ingress dla swojej aplikacji kontenera, używając portalu.

1. Wybierz pozycję Ingress z menu Settings na stronie aplikacji kontenera.
2. Odznacz ustawienie IngressWłączone.
3. Wybierz pozycję Zapisz.

Wyłącz ruch przychodzący dla aplikacji kontenerowej, całkowicie pomijając właściwość konfiguracji ingress w elemencie properties.configuration.

Dodatkowe porty TCP można dodać za pośrednictwem interfejsu linii poleceń, odwołując się do pliku YAML z konfiguracjami portów TCP.

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

Poniższy przykład przedstawia plik YAML, do którego można się odwołać w poprzednim poleceniu interfejsu wiersza polecenia. Konfiguracja dodatkowych portów TCP znajduje się w obszarze 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

1. Rozwiń sekcję Dodatkowe porty TCP w bloku Ingress.
2. Dodaj dodatkowe porty TCP, do których aplikacja akceptuje ruch w polu Port docelowy . Jeśli port uwidoczniony zostanie pusty, użyje tej samej wartości co port docelowy.
3. Zmień pole „Ruch przychodzący” w razie potrzeby. To pole umożliwia skonfigurowanie miejsca, w którym ruch przychodzący jest ograniczony do każdego portu.
4. Po skończeniu kliknij przycisk Zapisz.

Poniższy szablon usługi ARM zawiera przykład dodawania dodatkowych portów do aplikacji kontenera. Dodaj każdy dodatkowy port w sekcji additionalPortMappings w ingress dla configuration w properties aplikacji kontenera. W poniższym przykładzie pokazano, jak dodać dodatkowe porty:

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