zadania Microsoft.App 2022-11-01-preview

Artykuł
12/09/2024

Definicja zasobu Bicep

Typ zasobu zadań można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/jobs, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.App/jobs@2022-11-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    configuration: {
      manualTriggerConfig: {
        parallelism: int
        replicaCompletionCount: int
      }
      registries: [
        {
          identity: 'string'
          passwordSecretRef: 'string'
          server: 'string'
          username: 'string'
        }
      ]
      replicaRetryLimit: int
      replicaTimeout: int
      scheduleTriggerConfig: {
        cronExpression: 'string'
        parallelism: int
        replicaCompletionCount: int
      }
      secrets: [
        {
          identity: 'string'
          keyVaultUrl: 'string'
          name: 'string'
          value: 'string'
        }
      ]
      triggerType: 'string'
    }
    environmentId: 'string'
    template: {
      containers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          probes: [
            {
              failureThreshold: int
              httpGet: {
                host: 'string'
                httpHeaders: [
                  {
                    name: 'string'
                    value: 'string'
                  }
                ]
                path: 'string'
                port: int
                scheme: 'string'
              }
              initialDelaySeconds: int
              periodSeconds: int
              successThreshold: int
              tcpSocket: {
                host: 'string'
                port: int
              }
              terminationGracePeriodSeconds: int
              timeoutSeconds: int
              type: 'string'
            }
          ]
          resources: {
            cpu: int
            memory: 'string'
          }
          volumeMounts: [
            {
              mountPath: 'string'
              volumeName: 'string'
            }
          ]
        }
      ]
      initContainers: [
        {
          args: [
            'string'
          ]
          command: [
            'string'
          ]
          env: [
            {
              name: 'string'
              secretRef: 'string'
              value: 'string'
            }
          ]
          image: 'string'
          name: 'string'
          resources: {
            cpu: int
            memory: 'string'
          }
          volumeMounts: [
            {
              mountPath: 'string'
              volumeName: 'string'
            }
          ]
        }
      ]
      volumes: [
        {
          name: 'string'
          secrets: [
            {
              path: 'string'
              secretRef: 'string'
            }
          ]
          storageName: 'string'
          storageType: 'string'
        }
      ]
    }
    workloadProfileName: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Kontener

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
Sondy	Lista sond dla kontenera.	ContainerAppProbe[]
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

ContainerAppProbe

Nazwa	Opis	Wartość
failureThreshold	Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
httpGet	Wartość HTTPGet określa żądanie HTTP do wykonania.	ContainerAppProbeHttpGet
initialDelaySeconds	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	Int
periodSeconds	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
successThreshold	Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
tcpSocket	TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina)	Int
timeoutSeconds	Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
typ	Typ sondy.	"Liveness" "Gotowość" "Uruchamianie"

ContainerAppProbeHttpGet

Nazwa	Opis	Wartość
gospodarz	Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders.	struna
httpHeaders	Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki.	ContainerAppProbeHttpGetHttpHeadersItem[]
ścieżka	Ścieżka dostępu na serwerze HTTP.	struna
port	Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)
plan	Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.	"HTTP" "HTTPS"

ContainerAppProbeHttpGetHttpHeadersItem

Nazwa	Opis	Wartość
nazwa	Nazwa pola nagłówka	ciąg (wymagany)
wartość	Wartość pola nagłówka	ciąg (wymagany)

ContainerAppProbeTcpSocket

Nazwa	Opis	Wartość
gospodarz	Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika.	struna
port	Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)

ContainerResources

Nazwa	Opis	Wartość
procesor	Wymagany procesor CPU w rdzeniach, np. 0,5	Int
pamięć	Wymagana pamięć, np. "250 Mb"	struna

EnvironmentVar

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	struna
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	struna

InitContainer

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

Konfiguracja zadania

Nazwa	Opis	Wartość
manualTriggerConfig	Ręczna konfiguracja wyzwalacza dla pojedynczego zadania wykonywania. Właściwość replicaCompletionCount i równoległość zostanie ustawiona na 1 domyślnie	JobConfigurationManualTriggerConfig
Rejestrów	Zbieranie poświadczeń prywatnego rejestru kontenerów używanych przez zadanie aplikacji kontenera	RegistryCredentials[]
replicaRetryLimit	Maksymalna liczba ponownych prób przed niepowodzeniem zadania.	Int
replicaTimeout	Maksymalna liczba sekund, przez które może działać replika.	int (wymagane)
scheduleTriggerConfig	Cron sformatowany harmonogram powtarzanych wyzwalaczy ("* * * * *") dla cronjobs. Uzupełnianie właściwości i równoległość będą domyślnie ustawione na 1	JobConfigurationScheduleTriggerConfig
Tajemnice	Zbieranie wpisów tajnych używanych przez zadanie usługi Container Apps	tajne[]
triggerType	Typ wyzwalacza zadania	"Zdarzenie" "Ręczne" "Harmonogram" (wymagany)

JobConfigurationManualTriggerConfig

Nazwa	Opis	Wartość
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

JobConfigurationScheduleTriggerConfig

Nazwa	Opis	Wartość
cronExpression	Cron sformatowany harmonogram powtarzania ("* * * * * *") zadania Cron.	ciąg (wymagany)
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

Właściwości zadań

Nazwa	Opis	Wartość
konfiguracja	Właściwości konfiguracji zadania usługi Container Apps.	JobConfiguration
environmentId	Identyfikator zasobu środowiska.	struna
szablon	Definicja zadania usługi Container Apps.	JobTemplate
workloadProfileName	Nazwa profilu obciążenia, który ma być przypięty do wykonania zadania aplikacji kontenera.	struna

ZadanieTemplate

Nazwa	Opis	Wartość
Pojemniki	Lista definicji kontenerów dla aplikacji kontenera.	Container[]
initContainers	Lista wyspecjalizowanych kontenerów uruchamianych przed kontenerami aplikacji.	InitContainer[]
Woluminów	Lista definicji woluminów dla aplikacji kontenera.	woluminu[]

ManagedServiceIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).	"Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (wymagane)
userAssignedIdentities	Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.	UserAssignedIdentities

Microsoft.App/jobs

Nazwa	Opis	Wartość
tożsamość	Tożsamości zarządzane wymagane przez zadanie aplikacji kontenera do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie.	ManagedServiceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
nazwa	Nazwa zasobu	ciąg (wymagany)
Właściwości	Właściwości specyficzne dla zasobu zadania usługi Container Apps.	JobProperties
Tagi	Tagi zasobów	Słownik nazw tagów i wartości. Zobacz tagi w szablonach

RegistryCredentials

Nazwa	Opis	Wartość
tożsamość	Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system"	struna
passwordSecretRef	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	struna
serwer	Serwer rejestru kontenerów	struna
nazwa użytkownika	Nazwa użytkownika usługi Container Registry	struna

Tajny

Nazwa	Opis	Wartość
tożsamość	Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania w usłudze Azure Key Vault lub system do używania tożsamości przypisanej przez system.	struna
keyVaultUrl	Adres URL usługi Azure Key Vault wskazujący wpis tajny przywołyny przez aplikację kontenera.	struna
nazwa	Nazwa wpisu tajnego.	struna
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

SecretVolumeItem

Nazwa	Opis	Wartość
ścieżka	Ścieżka do wpisu tajnego projektu. Jeśli nie podano żadnej ścieżki, ścieżka domyślna to nazwa wpisu tajnego wymienionego w secretRef.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość wpisu tajnego.	struna

TrackedResourceTags

Nazwa	Opis	Wartość

UserAssignedIdentities

Nazwa	Opis	Wartość

UserAssignedIdentity

Nazwa	Opis	Wartość

Głośność

Nazwa	Opis	Wartość
nazwa	Nazwa woluminu.	struna
Tajemnice	Lista wpisów tajnych do dodania w woluminie. Jeśli nie podano żadnych wpisów tajnych, wszystkie wpisy tajne w kolekcji zostaną dodane do woluminu.	SecretVolumeItem[]
storageName	Nazwa zasobu magazynu. Nie trzeba podawać wartości EmptyDir i Secret.	struna
storageType	Typ magazynu dla woluminu. Jeśli nie zostanie podana, użyj wartości EmptyDir.	"AzureFile" "EmptyDir" "Wpis tajny"

WoluminMount

Nazwa	Opis	Wartość
mountPath	Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać ':'.	struna
volumeName	Musi to być zgodne z nazwą woluminu.	struna

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł	Opis
zadania aplikacji	Moduł zasobów AVM dla zadania aplikacji

Definicja zasobu szablonu usługi ARM

Typ zasobu zadań można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/jobs, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.App/jobs",
  "apiVersion": "2022-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "configuration": {
      "manualTriggerConfig": {
        "parallelism": "int",
        "replicaCompletionCount": "int"
      },
      "registries": [
        {
          "identity": "string",
          "passwordSecretRef": "string",
          "server": "string",
          "username": "string"
        }
      ],
      "replicaRetryLimit": "int",
      "replicaTimeout": "int",
      "scheduleTriggerConfig": {
        "cronExpression": "string",
        "parallelism": "int",
        "replicaCompletionCount": "int"
      },
      "secrets": [
        {
          "identity": "string",
          "keyVaultUrl": "string",
          "name": "string",
          "value": "string"
        }
      ],
      "triggerType": "string"
    },
    "environmentId": "string",
    "template": {
      "containers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "probes": [
            {
              "failureThreshold": "int",
              "httpGet": {
                "host": "string",
                "httpHeaders": [
                  {
                    "name": "string",
                    "value": "string"
                  }
                ],
                "path": "string",
                "port": "int",
                "scheme": "string"
              },
              "initialDelaySeconds": "int",
              "periodSeconds": "int",
              "successThreshold": "int",
              "tcpSocket": {
                "host": "string",
                "port": "int"
              },
              "terminationGracePeriodSeconds": "int",
              "timeoutSeconds": "int",
              "type": "string"
            }
          ],
          "resources": {
            "cpu": "int",
            "memory": "string"
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "volumeName": "string"
            }
          ]
        }
      ],
      "initContainers": [
        {
          "args": [ "string" ],
          "command": [ "string" ],
          "env": [
            {
              "name": "string",
              "secretRef": "string",
              "value": "string"
            }
          ],
          "image": "string",
          "name": "string",
          "resources": {
            "cpu": "int",
            "memory": "string"
          },
          "volumeMounts": [
            {
              "mountPath": "string",
              "volumeName": "string"
            }
          ]
        }
      ],
      "volumes": [
        {
          "name": "string",
          "secrets": [
            {
              "path": "string",
              "secretRef": "string"
            }
          ],
          "storageName": "string",
          "storageType": "string"
        }
      ]
    },
    "workloadProfileName": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Kontener

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
Sondy	Lista sond dla kontenera.	ContainerAppProbe[]
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

ContainerAppProbe

Nazwa	Opis	Wartość
failureThreshold	Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
httpGet	Wartość HTTPGet określa żądanie HTTP do wykonania.	ContainerAppProbeHttpGet
initialDelaySeconds	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	Int
periodSeconds	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
successThreshold	Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
tcpSocket	TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina)	Int
timeoutSeconds	Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
typ	Typ sondy.	"Liveness" "Gotowość" "Uruchamianie"

ContainerAppProbeHttpGet

Nazwa	Opis	Wartość
gospodarz	Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders.	struna
httpHeaders	Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki.	ContainerAppProbeHttpGetHttpHeadersItem[]
ścieżka	Ścieżka dostępu na serwerze HTTP.	struna
port	Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)
plan	Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.	"HTTP" "HTTPS"

ContainerAppProbeHttpGetHttpHeadersItem

Nazwa	Opis	Wartość
nazwa	Nazwa pola nagłówka	ciąg (wymagany)
wartość	Wartość pola nagłówka	ciąg (wymagany)

ContainerAppProbeTcpSocket

Nazwa	Opis	Wartość
gospodarz	Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika.	struna
port	Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)

ContainerResources

Nazwa	Opis	Wartość
procesor	Wymagany procesor CPU w rdzeniach, np. 0,5	Int
pamięć	Wymagana pamięć, np. "250 Mb"	struna

EnvironmentVar

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	struna
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	struna

InitContainer

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

Konfiguracja zadania

Nazwa	Opis	Wartość
manualTriggerConfig	Ręczna konfiguracja wyzwalacza dla pojedynczego zadania wykonywania. Właściwość replicaCompletionCount i równoległość zostanie ustawiona na 1 domyślnie	JobConfigurationManualTriggerConfig
Rejestrów	Zbieranie poświadczeń prywatnego rejestru kontenerów używanych przez zadanie aplikacji kontenera	RegistryCredentials[]
replicaRetryLimit	Maksymalna liczba ponownych prób przed niepowodzeniem zadania.	Int
replicaTimeout	Maksymalna liczba sekund, przez które może działać replika.	int (wymagane)
scheduleTriggerConfig	Cron sformatowany harmonogram powtarzanych wyzwalaczy ("* * * * *") dla cronjobs. Uzupełnianie właściwości i równoległość będą domyślnie ustawione na 1	JobConfigurationScheduleTriggerConfig
Tajemnice	Zbieranie wpisów tajnych używanych przez zadanie usługi Container Apps	tajne[]
triggerType	Typ wyzwalacza zadania	"Zdarzenie" "Ręczne" "Harmonogram" (wymagany)

JobConfigurationManualTriggerConfig

Nazwa	Opis	Wartość
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

JobConfigurationScheduleTriggerConfig

Nazwa	Opis	Wartość
cronExpression	Cron sformatowany harmonogram powtarzania ("* * * * * *") zadania Cron.	ciąg (wymagany)
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

Właściwości zadań

Nazwa	Opis	Wartość
konfiguracja	Właściwości konfiguracji zadania usługi Container Apps.	JobConfiguration
environmentId	Identyfikator zasobu środowiska.	struna
szablon	Definicja zadania usługi Container Apps.	JobTemplate
workloadProfileName	Nazwa profilu obciążenia, który ma być przypięty do wykonania zadania aplikacji kontenera.	struna

ZadanieTemplate

Nazwa	Opis	Wartość
Pojemniki	Lista definicji kontenerów dla aplikacji kontenera.	Container[]
initContainers	Lista wyspecjalizowanych kontenerów uruchamianych przed kontenerami aplikacji.	InitContainer[]
Woluminów	Lista definicji woluminów dla aplikacji kontenera.	woluminu[]

ManagedServiceIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).	"Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (wymagane)
userAssignedIdentities	Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.	UserAssignedIdentities

Microsoft.App/jobs

Nazwa	Opis	Wartość
apiVersion	Wersja interfejsu API	"2022-11-01-preview"
tożsamość	Tożsamości zarządzane wymagane przez zadanie aplikacji kontenera do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie.	ManagedServiceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
nazwa	Nazwa zasobu	ciąg (wymagany)
Właściwości	Właściwości specyficzne dla zasobu zadania usługi Container Apps.	JobProperties
Tagi	Tagi zasobów	Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ	Typ zasobu	"Microsoft.App/jobs"

RegistryCredentials

Nazwa	Opis	Wartość
tożsamość	Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system"	struna
passwordSecretRef	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	struna
serwer	Serwer rejestru kontenerów	struna
nazwa użytkownika	Nazwa użytkownika usługi Container Registry	struna

Tajny

Nazwa	Opis	Wartość
tożsamość	Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania w usłudze Azure Key Vault lub system do używania tożsamości przypisanej przez system.	struna
keyVaultUrl	Adres URL usługi Azure Key Vault wskazujący wpis tajny przywołyny przez aplikację kontenera.	struna
nazwa	Nazwa wpisu tajnego.	struna
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

SecretVolumeItem

Nazwa	Opis	Wartość
ścieżka	Ścieżka do wpisu tajnego projektu. Jeśli nie podano żadnej ścieżki, ścieżka domyślna to nazwa wpisu tajnego wymienionego w secretRef.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość wpisu tajnego.	struna

TrackedResourceTags

Nazwa	Opis	Wartość

UserAssignedIdentities

Nazwa	Opis	Wartość

UserAssignedIdentity

Nazwa	Opis	Wartość

Głośność

Nazwa	Opis	Wartość
nazwa	Nazwa woluminu.	struna
Tajemnice	Lista wpisów tajnych do dodania w woluminie. Jeśli nie podano żadnych wpisów tajnych, wszystkie wpisy tajne w kolekcji zostaną dodane do woluminu.	SecretVolumeItem[]
storageName	Nazwa zasobu magazynu. Nie trzeba podawać wartości EmptyDir i Secret.	struna
storageType	Typ magazynu dla woluminu. Jeśli nie zostanie podana, użyj wartości EmptyDir.	"AzureFile" "EmptyDir" "Wpis tajny"

WoluminMount

Nazwa	Opis	Wartość
mountPath	Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać ':'.	struna
volumeName	Musi to być zgodne z nazwą woluminu.	struna

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu zadań można wdrożyć przy użyciu operacji docelowych:

grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.App/jobs, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/jobs@2022-11-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      configuration = {
        manualTriggerConfig = {
          parallelism = int
          replicaCompletionCount = int
        }
        registries = [
          {
            identity = "string"
            passwordSecretRef = "string"
            server = "string"
            username = "string"
          }
        ]
        replicaRetryLimit = int
        replicaTimeout = int
        scheduleTriggerConfig = {
          cronExpression = "string"
          parallelism = int
          replicaCompletionCount = int
        }
        secrets = [
          {
            identity = "string"
            keyVaultUrl = "string"
            name = "string"
            value = "string"
          }
        ]
        triggerType = "string"
      }
      environmentId = "string"
      template = {
        containers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            probes = [
              {
                failureThreshold = int
                httpGet = {
                  host = "string"
                  httpHeaders = [
                    {
                      name = "string"
                      value = "string"
                    }
                  ]
                  path = "string"
                  port = int
                  scheme = "string"
                }
                initialDelaySeconds = int
                periodSeconds = int
                successThreshold = int
                tcpSocket = {
                  host = "string"
                  port = int
                }
                terminationGracePeriodSeconds = int
                timeoutSeconds = int
                type = "string"
              }
            ]
            resources = {
              cpu = int
              memory = "string"
            }
            volumeMounts = [
              {
                mountPath = "string"
                volumeName = "string"
              }
            ]
          }
        ]
        initContainers = [
          {
            args = [
              "string"
            ]
            command = [
              "string"
            ]
            env = [
              {
                name = "string"
                secretRef = "string"
                value = "string"
              }
            ]
            image = "string"
            name = "string"
            resources = {
              cpu = int
              memory = "string"
            }
            volumeMounts = [
              {
                mountPath = "string"
                volumeName = "string"
              }
            ]
          }
        ]
        volumes = [
          {
            name = "string"
            secrets = [
              {
                path = "string"
                secretRef = "string"
              }
            ]
            storageName = "string"
            storageType = "string"
          }
        ]
      }
      workloadProfileName = "string"
    }
  })
}

Wartości właściwości

Kontener

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
Sondy	Lista sond dla kontenera.	ContainerAppProbe[]
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

ContainerAppProbe

Nazwa	Opis	Wartość
failureThreshold	Minimalna liczba kolejnych niepowodzeń sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
httpGet	Wartość HTTPGet określa żądanie HTTP do wykonania.	ContainerAppProbeHttpGet
initialDelaySeconds	Liczba sekund po uruchomieniu kontenera przed zainicjowanym sondami aktualności. Wartość minimalna to 1. Wartość maksymalna to 60.	Int
periodSeconds	Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
successThreshold	Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po niepodaniu. Wartość domyślna to 1. Musi być 1 dla życia i uruchamiania. Wartość minimalna to 1. Wartość maksymalna to 10.	Int
tcpSocket	TcpSocket określa akcję obejmującą port TCP. Haki TCP nie są jeszcze obsługiwane.	ContainerAppProbeTcpSocket
terminationGracePeriodSeconds	Opcjonalny czas trwania w sekundach zasobnik musi zostać bezpiecznie zakończony po niepowodzeniu sondy. Okres prolongaty to czas trwania w sekundach po wysłaniu sygnału zakończenia procesów uruchomionych w zasobniku i czasie, w którym procesy są wymuszone zatrzymane za pomocą sygnału zabicia. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Jeśli ta wartość jest zerowa, zostanie użyte zakończenie zasobnikaGracePeriodSeconds. W przeciwnym razie ta wartość zastępuje wartość podaną przez specyfikację zasobnika. Wartość musi być nieujemna liczba całkowita. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału kill (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Wartość maksymalna to 3600 sekund (1 godzina)	Int
timeoutSeconds	Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Wartość maksymalna to 240.	Int
typ	Typ sondy.	"Liveness" "Gotowość" "Uruchamianie"

ContainerAppProbeHttpGet

Nazwa	Opis	Wartość
gospodarz	Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w zamiast tego httpHeaders.	struna
httpHeaders	Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki.	ContainerAppProbeHttpGetHttpHeadersItem[]
ścieżka	Ścieżka dostępu na serwerze HTTP.	struna
port	Nazwa lub numer portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)
plan	Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.	"HTTP" "HTTPS"

ContainerAppProbeHttpGetHttpHeadersItem

Nazwa	Opis	Wartość
nazwa	Nazwa pola nagłówka	ciąg (wymagany)
wartość	Wartość pola nagłówka	ciąg (wymagany)

ContainerAppProbeTcpSocket

Nazwa	Opis	Wartość
gospodarz	Opcjonalnie: Nazwa hosta do nawiązania połączenia z, domyślnie jest to adres IP zasobnika.	struna
port	Numer lub nazwa portu w celu uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME.	int (wymagane)

ContainerResources

Nazwa	Opis	Wartość
procesor	Wymagany procesor CPU w rdzeniach, np. 0,5	Int
pamięć	Wymagana pamięć, np. "250 Mb"	struna

EnvironmentVar

Nazwa	Opis	Wartość
nazwa	Nazwa zmiennej środowiskowej.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość zmiennej środowiskowej.	struna
wartość	Wartość zmiennej środowiskowej bez wpisu tajnego.	struna

InitContainer

Nazwa	Opis	Wartość
args	Argumenty poleceń uruchamiania kontenera.	string[]
polecenie	Polecenie uruchamiania kontenera.	string[]
Env	Zmienne środowiskowe kontenera.	EnvironmentVar[]
obraz	Tag obrazu kontenera.	struna
nazwa	Niestandardowa nazwa kontenera.	struna
zasoby	Wymagania dotyczące zasobów kontenera.	ContainerResources
volumeMounts	Instalacja woluminu kontenera.	volumeMount[]

Konfiguracja zadania

Nazwa	Opis	Wartość
manualTriggerConfig	Ręczna konfiguracja wyzwalacza dla pojedynczego zadania wykonywania. Właściwość replicaCompletionCount i równoległość zostanie ustawiona na 1 domyślnie	JobConfigurationManualTriggerConfig
Rejestrów	Zbieranie poświadczeń prywatnego rejestru kontenerów używanych przez zadanie aplikacji kontenera	RegistryCredentials[]
replicaRetryLimit	Maksymalna liczba ponownych prób przed niepowodzeniem zadania.	Int
replicaTimeout	Maksymalna liczba sekund, przez które może działać replika.	int (wymagane)
scheduleTriggerConfig	Cron sformatowany harmonogram powtarzanych wyzwalaczy ("* * * * *") dla cronjobs. Uzupełnianie właściwości i równoległość będą domyślnie ustawione na 1	JobConfigurationScheduleTriggerConfig
Tajemnice	Zbieranie wpisów tajnych używanych przez zadanie usługi Container Apps	tajne[]
triggerType	Typ wyzwalacza zadania	"Zdarzenie" "Ręczne" "Harmonogram" (wymagany)

JobConfigurationManualTriggerConfig

Nazwa	Opis	Wartość
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

JobConfigurationScheduleTriggerConfig

Nazwa	Opis	Wartość
cronExpression	Cron sformatowany harmonogram powtarzania ("* * * * * *") zadania Cron.	ciąg (wymagany)
Równoległości prostych	Liczba równoległych replik zadania, które można uruchomić w danym momencie.	Int
replicaCompletionCount	Minimalna liczba zakończonych pomyślnie ukończenia repliki przed ogólnym ukończeniem zadania.	Int

Właściwości zadań

Nazwa	Opis	Wartość
konfiguracja	Właściwości konfiguracji zadania usługi Container Apps.	JobConfiguration
environmentId	Identyfikator zasobu środowiska.	struna
szablon	Definicja zadania usługi Container Apps.	JobTemplate
workloadProfileName	Nazwa profilu obciążenia, który ma być przypięty do wykonania zadania aplikacji kontenera.	struna

ZadanieTemplate

Nazwa	Opis	Wartość
Pojemniki	Lista definicji kontenerów dla aplikacji kontenera.	Container[]
initContainers	Lista wyspecjalizowanych kontenerów uruchamianych przed kontenerami aplikacji.	InitContainer[]
Woluminów	Lista definicji woluminów dla aplikacji kontenera.	woluminu[]

ManagedServiceIdentity

Nazwa	Opis	Wartość
typ	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).	"Brak" "SystemAssigned" "SystemAssigned,UserAssigned" "UserAssigned" (wymagane)
userAssignedIdentities	Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.	UserAssignedIdentities

Microsoft.App/jobs

Nazwa	Opis	Wartość
tożsamość	Tożsamości zarządzane wymagane przez zadanie aplikacji kontenera do interakcji z innymi usługami platformy Azure, aby nie przechowywać żadnych wpisów tajnych ani poświadczeń w kodzie.	ManagedServiceIdentity
lokalizacja	Lokalizacja geograficzna, w której znajduje się zasób	ciąg (wymagany)
nazwa	Nazwa zasobu	ciąg (wymagany)
Właściwości	Właściwości specyficzne dla zasobu zadania usługi Container Apps.	JobProperties
Tagi	Tagi zasobów	Słownik nazw tagów i wartości.
typ	Typ zasobu	"Microsoft.App/jobs@2022-11-01-preview"

RegistryCredentials

Nazwa	Opis	Wartość
tożsamość	Tożsamość zarządzana używana do uwierzytelniania w usłudze Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu przypisanego przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system"	struna
passwordSecretRef	Nazwa wpisu tajnego zawierającego hasło logowania do rejestru	struna
serwer	Serwer rejestru kontenerów	struna
nazwa użytkownika	Nazwa użytkownika usługi Container Registry	struna

Tajny

Nazwa	Opis	Wartość
tożsamość	Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania w usłudze Azure Key Vault lub system do używania tożsamości przypisanej przez system.	struna
keyVaultUrl	Adres URL usługi Azure Key Vault wskazujący wpis tajny przywołyny przez aplikację kontenera.	struna
nazwa	Nazwa wpisu tajnego.	struna
wartość	Wartość wpisu tajnego.	struna Ograniczenia: Wartość wrażliwa. Przekaż jako bezpieczny parametr.

SecretVolumeItem

Nazwa	Opis	Wartość
ścieżka	Ścieżka do wpisu tajnego projektu. Jeśli nie podano żadnej ścieżki, ścieżka domyślna to nazwa wpisu tajnego wymienionego w secretRef.	struna
secretRef	Nazwa wpisu tajnego aplikacji kontenera, z którego ma być ściągana wartość wpisu tajnego.	struna

TrackedResourceTags

Nazwa	Opis	Wartość

UserAssignedIdentities

Nazwa	Opis	Wartość

UserAssignedIdentity

Nazwa	Opis	Wartość

Głośność

Nazwa	Opis	Wartość
nazwa	Nazwa woluminu.	struna
Tajemnice	Lista wpisów tajnych do dodania w woluminie. Jeśli nie podano żadnych wpisów tajnych, wszystkie wpisy tajne w kolekcji zostaną dodane do woluminu.	SecretVolumeItem[]
storageName	Nazwa zasobu magazynu. Nie trzeba podawać wartości EmptyDir i Secret.	struna
storageType	Typ magazynu dla woluminu. Jeśli nie zostanie podana, użyj wartości EmptyDir.	"AzureFile" "EmptyDir" "Wpis tajny"

WoluminMount

Nazwa	Opis	Wartość
mountPath	Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać ':'.	struna
volumeName	Musi to być zgodne z nazwą woluminu.	struna

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł	Opis
zadania aplikacji	Moduł zasobów AVM dla zadania aplikacji

Udostępnij za pośrednictwem

zadania Microsoft.App 2022-11-01-preview

Definicja zasobu Bicep

Format zasobu

Wartości właściwości

Kontener

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

Konfiguracja zadania

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

Właściwości zadań

ZadanieTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Tajny

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Głośność

WoluminMount

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Definicja zasobu szablonu usługi ARM

Format zasobu

Wartości właściwości

Kontener

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

Konfiguracja zadania

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

Właściwości zadań

ZadanieTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Tajny

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

Głośność

WoluminMount

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Format zasobu

Wartości właściwości

Kontener

ContainerAppProbe

ContainerAppProbeHttpGet

ContainerAppProbeHttpGetHttpHeadersItem

ContainerAppProbeTcpSocket

ContainerResources

EnvironmentVar

InitContainer

Konfiguracja zadania

JobConfigurationManualTriggerConfig

JobConfigurationScheduleTriggerConfig

Właściwości zadań

ZadanieTemplate

ManagedServiceIdentity

Microsoft.App/jobs

RegistryCredentials

Tajny

SecretVolumeItem

TrackedResourceTags

UserAssignedIdentities