Container Apps - Update
Aktualizowanie właściwości aplikacji kontenera
Poprawia aplikację kontenera przy użyciu poprawki scalanej JSON
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/containerApps/{containerAppName}?api-version=2024-03-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
container
|
path | True |
string |
Nazwa aplikacji kontenera. |
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
extendedLocation |
Typ złożony lokalizacji rozszerzonej. |
||
identity |
tożsamości zarządzane dla aplikacji kontenera umożliwiające interakcję z innymi usługami platformy Azure bez konieczności obsługi wpisów tajnych ani poświadczeń w kodzie. |
||
managedBy |
string |
W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie w trybie pełnym nie usunie zasobu, jeśli zostanie on usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób. |
|
properties.configuration |
Nieobsługiwane właściwości konfiguracji aplikacji kontenera. |
||
properties.environmentId |
string |
Identyfikator zasobu środowiska. |
|
properties.managedEnvironmentId |
string |
Przestarzałe. Identyfikator zasobu środowiska aplikacji kontenera. |
|
properties.template |
Definicja aplikacji kontenera w wersji. |
||
properties.workloadProfileName |
string |
Nazwa profilu obciążenia do przypięcia na potrzeby wykonywania aplikacji kontenera. |
|
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Ok |
|
202 Accepted |
Operacja stosowania poprawek jest w toku. Nagłówki Location: string |
|
Other Status Codes |
Typowa odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
Patch Container App
Przykładowe żądanie
PATCH https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0?api-version=2024-03-01
{
"location": "East US",
"tags": {
"tag1": "value1",
"tag2": "value2"
},
"properties": {
"configuration": {
"ingress": {
"external": true,
"targetPort": 3000,
"customDomains": [
{
"name": "www.my-name.com",
"bindingType": "SniEnabled",
"certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
},
{
"name": "www.my-other-name.com",
"bindingType": "SniEnabled",
"certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
}
],
"traffic": [
{
"weight": 100,
"revisionName": "testcontainerapp0-ab1234",
"label": "production"
}
],
"ipSecurityRestrictions": [
{
"name": "Allow work IP A subnet",
"description": "Allowing all IP's within the subnet below to access containerapp",
"ipAddressRange": "192.168.1.1/32",
"action": "Allow"
},
{
"name": "Allow work IP B subnet",
"description": "Allowing all IP's within the subnet below to access containerapp",
"ipAddressRange": "192.168.1.1/8",
"action": "Allow"
}
],
"stickySessions": {
"affinity": "sticky"
}
},
"dapr": {
"enabled": true,
"appPort": 3000,
"appProtocol": "http",
"httpReadBufferSize": 30,
"httpMaxRequestSize": 10,
"logLevel": "debug",
"enableApiLogging": true
},
"maxInactiveRevisions": 10,
"service": {
"type": "redis"
}
},
"template": {
"containers": [
{
"image": "repo/testcontainerapp0:v1",
"name": "testcontainerapp0",
"probes": [
{
"type": "Liveness",
"httpGet": {
"path": "/health",
"port": 8080,
"httpHeaders": [
{
"name": "Custom-Header",
"value": "Awesome"
}
]
},
"initialDelaySeconds": 3,
"periodSeconds": 3
}
]
}
],
"initContainers": [
{
"image": "repo/testcontainerapp0:v4",
"name": "testinitcontainerApp0",
"resources": {
"cpu": 0.5,
"memory": "1Gi"
}
}
],
"scale": {
"minReplicas": 1,
"maxReplicas": 5,
"rules": [
{
"name": "httpscalingrule",
"custom": {
"type": "http",
"metadata": {
"concurrentRequests": "50"
}
}
}
]
},
"serviceBinds": [
{
"serviceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/service",
"name": "service"
}
]
}
}
}
Przykładowa odpowiedź
{
"id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/containerApps/testcontainerapp0",
"name": "testcontainerapp0",
"type": "Microsoft.App/containerApps",
"location": "East US",
"properties": {
"provisioningState": "Succeeded",
"managedEnvironmentId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube",
"workloadProfileName": "My-GP-01",
"latestRevisionFqdn": "testcontainerapp0-pjxhsye.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"latestReadyRevisionName": "testcontainerapp0-pjxhsye",
"configuration": {
"ingress": {
"fqdn": "testcontainerapp0.demokube-t24clv0g.eastus.containerApps.k4apps.io",
"external": true,
"targetPort": 3000,
"transport": "auto",
"customDomains": [
{
"name": "www.my-name.com",
"bindingType": "SniEnabled",
"certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-name-dot-com"
},
{
"name": "www.my--other-name.com",
"bindingType": "SniEnabled",
"certificateId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/rg/providers/Microsoft.App/managedEnvironments/demokube/certificates/my-certificate-for-my-other-name-dot-com"
}
],
"traffic": [
{
"weight": 80,
"revisionName": "testcontainerapp0-ab1234"
},
{
"weight": 20,
"revisionName": "testcontainerapp0-ab4321",
"label": "staging"
}
],
"ipSecurityRestrictions": [
{
"name": "Allow work IP A subnet",
"description": "Allowing all IP's within the subnet below to access containerapp",
"ipAddressRange": "192.168.1.1/32",
"action": "Allow"
},
{
"name": "Allow work IP B subnet",
"description": "Allowing all IP's within the subnet below to access containerapp",
"ipAddressRange": "192.168.1.1/8",
"action": "Allow"
}
]
},
"dapr": {
"enabled": true,
"appPort": 3000,
"appProtocol": "http",
"httpReadBufferSize": 30,
"httpMaxRequestSize": 10,
"logLevel": "debug",
"enableApiLogging": true
},
"maxInactiveRevisions": 10
},
"template": {
"containers": [
{
"image": "repo/testcontainerapp0:v4",
"name": "testcontainerapp0",
"resources": {
"cpu": 0.5,
"memory": "1Gi"
}
}
],
"initContainers": [
{
"image": "repo/testcontainerapp0:v4",
"name": "testinitcontainerApp0",
"resources": {
"cpu": 0.5,
"memory": "1Gi"
}
}
],
"scale": {
"minReplicas": 1,
"maxReplicas": 5,
"rules": [
{
"name": "httpscalingrule",
"http": {
"metadata": {
"concurrentRequests": "50"
}
}
}
]
}
},
"eventStreamEndpoint": "testEndpoint"
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.App/locations/eastus/containerappOperationResults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2024-03-01
Definicje
Nazwa | Opis |
---|---|
action |
Zezwalaj na reguły zezwalania lub odmawiania określania dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów |
Active |
Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna. |
affinity |
Koligacja sesji sticky |
app |
Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http |
binding |
Custom Domain typ powiązania. |
Configuration |
Nieobsługiwane właściwości konfiguracji aplikacji kontenera definiujące ustawienia modyfikowalne aplikacji kontenera |
Container |
Definicja kontenera aplikacji kontenera |
Container |
Aplikacja kontenera. |
Container |
Sonda opisuje kontrolę kondycji, która ma być wykonywana względem kontenera w celu określenia, czy jest ona aktywna, czy gotowa do odbierania ruchu. |
Container |
Stan aprowizacji aplikacji kontenera. |
Container |
Wymagania dotyczące zasobów kontenera aplikacji kontenera. |
Cors |
Zasady współużytkowania zasobów między źródłami |
created |
Typ tożsamości, która utworzyła zasób. |
Custom |
Custom Domain aplikacji kontenera |
Custom |
Niestandardowa reguła skalowania kontenera aplikacji kontenera. |
Dapr |
Konfiguracja języka Dapr aplikacji kontenera. |
Default |
App Service odpowiedź na błąd. |
Details |
Szczegóły lub błąd |
Environment |
Zmienna środowiskowa kontenera aplikacji kontenera. |
Error |
Model błędu. |
Extended |
Typ złożony lokalizacji rozszerzonej. |
Extended |
Typ lokalizacji rozszerzonej. |
Http |
HttpGet określa żądanie http do wykonania. |
Http |
Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP umożliwia powtarzające się nagłówki. |
Http |
Reguła skalowania HTTP kontenera aplikacji kontenera. |
Ingress |
Konfiguracja ruchu przychodzącego aplikacji kontenera. |
Ingress |
Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta. |
Ingress |
Mapowania portów ruchu przychodzącego aplikacji kontenera |
Ingress |
Protokół transportu ruchu przychodzącego |
Init |
Definicja kontenera init aplikacji kontenera |
Ip |
Reguła ograniczania przychodzącego adresu IP. |
log |
Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje. |
Managed |
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika) |
Managed |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
Queue |
Reguła skalowania oparta na kolejce na podstawie kontenera aplikacji kontenera platformy Azure. |
Registry |
Rejestr prywatny aplikacji kontenera |
Scale |
Konfiguracje skalowania aplikacji kontenera. |
Scale |
Reguła skalowania kontenera aplikacji kontenera. |
Scale |
Wpisy tajne uwierzytelniania dla reguły skalowania |
Scheme |
Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP. |
Secret |
Definicja wpisu tajnego. |
Secret |
Wpis tajny do dodania do woluminu. |
Service |
Aplikacja kontenera, która ma być usługą dewelopera |
Service |
Konfiguracja powiązania aplikacji ContainerApp z usługą Dev ContainerApp Service |
Sticky |
Sesje sticky dla trybu pojedynczej poprawki |
Storage |
Typ magazynu woluminu. Jeśli nie podano, użyj wartości EmptyDir. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
Tcp |
Reguła skalowania tcp kontenera aplikacji kontenera. |
Tcp |
TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane. |
Template |
Definicja aplikacji kontenera w wersji. Definiuje żądany stan niezmiennej poprawki. Wszelkie zmiany w tej sekcji spowodują utworzenie nowej poprawki |
Traffic |
Waga ruchu przypisana do poprawki |
Type |
Typ sondy. |
User |
Właściwości tożsamości przypisanej przez użytkownika |
Volume |
Definicje woluminów dla aplikacji kontenera. |
Volume |
Instalacja woluminu dla aplikacji kontenera. |
action
Zezwalaj na reguły zezwalania lub odmawiania określania dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów
Nazwa | Typ | Opis |
---|---|---|
Allow |
string |
|
Deny |
string |
ActiveRevisionsMode
Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna.
Nazwa | Typ | Opis |
---|---|---|
Multiple |
string |
|
Single |
string |
affinity
Koligacja sesji sticky
Nazwa | Typ | Opis |
---|---|---|
none |
string |
|
sticky |
string |
appProtocol
Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http
Nazwa | Typ | Opis |
---|---|---|
grpc |
string |
|
http |
string |
bindingType
Custom Domain typ powiązania.
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
SniEnabled |
string |
Configuration
Nieobsługiwane właściwości konfiguracji aplikacji kontenera definiujące ustawienia modyfikowalne aplikacji kontenera
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
activeRevisionsMode | Single |
Tryb ActiveRevisionsMode określa sposób obsługi aktywnych poprawek dla aplikacji kontenera: wiele: wiele wersji może być aktywnych.Pojedynczy: tylko jedna poprawka może być aktywna jednocześnie. Wagi poprawek nie mogą być używane w tym trybie. Jeśli nie podano żadnej wartości, jest to wartość domyślna. |
|
dapr |
Konfiguracja języka Dapr dla aplikacji kontenera. |
||
ingress |
Konfiguracje ruchu przychodzącego. |
||
maxInactiveRevisions |
integer |
Opcjonalny. Maksymalna liczba nieaktywnych poprawek, które może mieć aplikacja kontenera. |
|
registries |
Kolekcja prywatnych poświadczeń rejestru kontenerów dla kontenerów używanych przez aplikację kontenerów |
||
secrets |
Secret[] |
Zbieranie wpisów tajnych używanych przez aplikację kontenera |
|
service |
Aplikacja kontenera, która ma być deweloperem App Service kontenera |
Container
Definicja kontenera aplikacji kontenera
Nazwa | Typ | Opis |
---|---|---|
args |
string[] |
Argumenty polecenia uruchamiania kontenera. |
command |
string[] |
Polecenie uruchamiania kontenera. |
env |
Zmienne środowiskowe kontenera. |
|
image |
string |
Tag obrazu kontenera. |
name |
string |
Niestandardowa nazwa kontenera. |
probes |
Lista sond dla kontenera. |
|
resources |
Wymagania dotyczące zasobów kontenera. |
|
volumeMounts |
Instalacja woluminu kontenera. |
ContainerApp
Aplikacja kontenera.
Nazwa | Typ | Opis |
---|---|---|
extendedLocation |
Typ złożony lokalizacji rozszerzonej. |
|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
tożsamości zarządzane dla aplikacji kontenera umożliwiające interakcję z innymi usługami platformy Azure bez konieczności obsługi wpisów tajnych ani poświadczeń w kodzie. |
|
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
managedBy |
string |
W pełni kwalifikowany identyfikator zasobu, który zarządza tym zasobem. Wskazuje, czy ten zasób jest zarządzany przez inny zasób platformy Azure. Jeśli jest to obecne, wdrożenie w trybie pełnym nie usunie zasobu, jeśli zostanie on usunięty z szablonu, ponieważ jest on zarządzany przez inny zasób. |
name |
string |
Nazwa zasobu |
properties.configuration |
Nieobsługiwane właściwości konfiguracji aplikacji kontenera. |
|
properties.customDomainVerificationId |
string |
Identyfikator używany do weryfikowania własności nazwy domeny |
properties.environmentId |
string |
Identyfikator zasobu środowiska. |
properties.eventStreamEndpoint |
string |
Punkt końcowy strumienia zdarzeń aplikacji kontenera. |
properties.latestReadyRevisionName |
string |
Nazwa najnowszej gotowej wersji aplikacji kontenera. |
properties.latestRevisionFqdn |
string |
W pełni kwalifikowana nazwa domeny najnowszej wersji aplikacji kontenera. |
properties.latestRevisionName |
string |
Nazwa najnowszej wersji aplikacji kontenera. |
properties.managedEnvironmentId |
string |
Przestarzałe. Identyfikator zasobu środowiska aplikacji kontenera. |
properties.outboundIpAddresses |
string[] |
Wychodzące adresy IP dla aplikacji kontenera. |
properties.provisioningState |
Stan aprowizacji aplikacji kontenera. |
|
properties.template |
Definicja aplikacji kontenera w wersji. |
|
properties.workloadProfileName |
string |
Nazwa profilu obciążenia do przypięcia na potrzeby wykonywania aplikacji kontenera. |
systemData |
Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
ContainerAppProbe
Sonda opisuje kontrolę kondycji, która ma być wykonywana względem kontenera w celu określenia, czy jest ona aktywna, czy gotowa do odbierania ruchu.
Nazwa | Typ | Opis |
---|---|---|
failureThreshold |
integer |
Minimalna liczba kolejnych niepowodzeń dla sondy, które mają zostać uznane za zakończone niepowodzeniem po pomyślnym zakończeniu. Wartość domyślna to 3. Wartość minimalna to 1. Maksymalna wartość to 10. |
httpGet |
HttpGet określa żądanie http do wykonania. |
|
initialDelaySeconds |
integer |
Liczba sekund po uruchomieniu kontenera przed zainicjowanymi sondami aktualności. Wartość minimalna to 1. Maksymalna wartość to 60. |
periodSeconds |
integer |
Jak często (w sekundach) wykonać sondę. Wartość domyślna to 10 sekund. Wartość minimalna to 1. Maksymalna wartość to 240. |
successThreshold |
integer |
Minimalna liczba kolejnych sukcesów dla sondy, która ma zostać uznana za pomyślną po nieudanej awarii. Wartość domyślna to 1. Musi być 1 dla utrzymania i uruchamiania. Wartość minimalna to 1. Maksymalna wartość to 10. |
tcpSocket |
TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane. |
|
terminationGracePeriodSeconds |
integer |
Opcjonalny czas trwania w sekundach zasobnika musi zakończyć się bezproblemowo po awarii 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 zabijania. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania 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ć nie ujemną liczbą całkowitą. Wartość zero wskazuje, że zatrzymaj się natychmiast za pośrednictwem sygnału zabijania (brak możliwości zamknięcia). Jest to pole alfa i wymaga włączenia bramki funkcji ProbeTerminationGracePeriod. Maksymalna wartość to 3600 sekund (1 godzina) |
timeoutSeconds |
integer |
Liczba sekund, po których sonda upłynął limit czasu. Wartość domyślna to 1 sekunda. Wartość minimalna to 1. Maksymalna wartość to 240. |
type |
Typ sondy. |
ContainerAppProvisioningState
Stan aprowizacji aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
Canceled |
string |
|
Deleting |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
ContainerResources
Wymagania dotyczące zasobów kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
cpu |
number |
Wymagany procesor CPU w rdzeniach, np. 0,5 |
ephemeralStorage |
string |
Efemeryczny magazyn, np. "1Gi" |
memory |
string |
Wymagana pamięć, np. "250 Mb" |
CorsPolicy
Zasady współużytkowania zasobów między źródłami
Nazwa | Typ | Opis |
---|---|---|
allowCredentials |
boolean |
Określa, czy zasób zezwala na poświadczenia |
allowedHeaders |
string[] |
Określa zawartość nagłówka access-control-allow-headers |
allowedMethods |
string[] |
Określa zawartość nagłówka access-control-allow-methods |
allowedOrigins |
string[] |
Określa zawartość nagłówka access-control-allow-origins |
exposeHeaders |
string[] |
Określa zawartość nagłówka access-control-expose-headers |
maxAge |
integer |
Określa zawartość nagłówka access-control-max-age |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CustomDomain
Custom Domain aplikacji kontenera
Nazwa | Typ | Opis |
---|---|---|
bindingType |
Custom Domain typ powiązania. |
|
certificateId |
string |
Identyfikator zasobu certyfikatu, który ma być powiązany z tą nazwą hosta. Musi istnieć w środowisku zarządzanym. |
name |
string |
Nazwa hosta. |
CustomScaleRule
Niestandardowa reguła skalowania kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
auth |
Wpisy tajne uwierzytelniania dla reguły skalowania niestandardowego. |
|
metadata |
object |
Właściwości metadanych opisujące niestandardową regułę skalowania. |
type |
string |
Typ niestandardowej reguły skalowania, np. azure-servicebus, redis itp. |
Dapr
Konfiguracja języka Dapr aplikacji kontenera.
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
appId |
string |
Identyfikator aplikacji języka Dapr |
|
appPort |
integer |
Informuje dapr, na którym porcie nasłuchuje aplikacja |
|
appProtocol | http |
Informuje dapr, którego protokołu używa aplikacja. Prawidłowe opcje to http i grpc. Wartość domyślna to http |
|
enableApiLogging |
boolean |
Włącza rejestrowanie interfejsu API dla przyczepki Dapr |
|
enabled |
boolean |
False |
Wartość logiczna wskazująca, czy samochód boczny Dapr jest włączony |
httpMaxRequestSize |
integer |
Zwiększenie maksymalnego rozmiaru treści żądania http i grpc server parametru w MB do obsługi przekazywania dużych plików. Wartość domyślna to 4 MB. |
|
httpReadBufferSize |
integer |
Maksymalny rozmiar buforu odczytu nagłówka HTTP w bazie wiedzy dapr do obsługi podczas wysyłania nagłówków z wieloma kb. Wartość domyślna to 65 KB. |
|
logLevel |
Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje. |
DefaultErrorResponse
App Service odpowiedź na błąd.
Nazwa | Typ | Opis |
---|---|---|
error |
Model błędu. |
Details
Szczegóły lub błąd
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Ustandaryzowany ciąg w celu programowego identyfikowania błędu. |
message |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
target |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
EnvironmentVar
Zmienna środowiskowa kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa zmiennej środowiskowej. |
secretRef |
string |
Nazwa wpisu tajnego aplikacji kontenera, z którego ma być pobierana wartość zmiennej środowiskowej. |
value |
string |
Wartość zmiennej środowiskowej bez wpisu tajnego. |
Error
Model błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Ustandaryzowany ciąg w celu programowego identyfikowania błędu. |
details |
Details[] |
Szczegóły lub błąd |
innererror |
string |
Więcej informacji na temat debugowania błędu. |
message |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
target |
string |
Szczegółowy opis błędu i informacje o debugowaniu. |
ExtendedLocation
Typ złożony lokalizacji rozszerzonej.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa lokalizacji rozszerzonej. |
type |
Typ lokalizacji rozszerzonej. |
ExtendedLocationTypes
Typ lokalizacji rozszerzonej.
Nazwa | Typ | Opis |
---|---|---|
CustomLocation |
string |
HttpGet
HttpGet określa żądanie http do wykonania.
Nazwa | Typ | Opis |
---|---|---|
host |
string |
Nazwa hosta, z którymi ma nawiązać połączenie, domyślnie jest to adres IP zasobnika. Prawdopodobnie chcesz ustawić wartość "Host" w elementach httpHeaders. |
httpHeaders |
Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP zezwala na powtarzające się nagłówki. |
|
path |
string |
Ścieżka dostępu do serwera HTTP. |
port |
integer |
Nazwa lub numer portu do uzyskania dostępu do kontenera. Liczba musi należeć do zakresu od 1 do 65535. Nazwa musi być IANA_SVC_NAME. |
scheme |
Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP. |
HttpHeaders
Nagłówki niestandardowe do ustawienia w żądaniu. Protokół HTTP umożliwia powtarzające się nagłówki.
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa pola nagłówka |
value |
string |
Wartość pola nagłówka |
HttpScaleRule
Reguła skalowania HTTP kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
auth |
Wpisy tajne uwierzytelniania dla reguły skalowania niestandardowego. |
|
metadata |
object |
Właściwości metadanych opisujące regułę skalowania http. |
Ingress
Konfiguracja ruchu przychodzącego aplikacji kontenera.
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
additionalPortMappings |
Ustawienia umożliwiające uwidocznienie dodatkowych portów w aplikacji kontenera |
||
allowInsecure |
boolean |
False |
Wartość logiczna wskazująca, czy połączenia HTTP z są dozwolone. W przypadku ustawienia wartości false połączeń HTTP są automatycznie przekierowywane do połączeń HTTPS |
clientCertificateMode |
Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta. |
||
corsPolicy |
Zasady CORS dla aplikacji kontenera |
||
customDomains |
niestandardowe powiązania domeny dla nazw hostów usługi Container Apps. |
||
exposedPort |
integer |
Uwidoczniony port w kontenerach dla ruchu TCP z ruchu przychodzącego |
|
external |
boolean |
False |
Wartość logiczna wskazująca, czy aplikacja uwidacznia zewnętrzny punkt końcowy HTTP |
fqdn |
string |
Nazwa hosta. |
|
ipSecurityRestrictions |
Reguły ograniczania przychodzącego adresu IP. |
||
stickySessions |
Sesje sticky dla trybu pojedynczej poprawki |
||
targetPort |
integer |
Docelowy port w kontenerach dla ruchu przychodzącego |
|
traffic |
Wagi ruchu dla wersji aplikacji |
||
transport | auto |
Protokół transportu ruchu przychodzącego |
IngressClientCertificateMode
Tryb certyfikatu klienta na potrzeby uwierzytelniania mTLS. Ignoruj wskazuje, że serwer odrzuca certyfikat klienta podczas przekazywania dalej. Pozycja Accept wskazuje, że serwer przekazuje certyfikat klienta, ale nie wymaga certyfikatu klienta. Pozycja Wymagaj wskazuje, że serwer wymaga certyfikatu klienta.
Nazwa | Typ | Opis |
---|---|---|
accept |
string |
|
ignore |
string |
|
require |
string |
IngressPortMapping
Mapowania portów ruchu przychodzącego aplikacji kontenera
Nazwa | Typ | Opis |
---|---|---|
exposedPort |
integer |
Określa uwidoczniony port dla portu docelowego. Jeśli nie zostanie określony, domyślnie jest to port docelowy |
external |
boolean |
Określa, czy port aplikacji jest dostępny poza środowiskiem |
targetPort |
integer |
Określa nasłuchuje kontenera użytkownika portu |
IngressTransportMethod
Protokół transportu ruchu przychodzącego
Nazwa | Typ | Opis |
---|---|---|
auto |
string |
|
http |
string |
|
http2 |
string |
|
tcp |
string |
InitContainer
Definicja kontenera init aplikacji kontenera
Nazwa | Typ | Opis |
---|---|---|
args |
string[] |
Argumenty polecenia uruchamiania kontenera. |
command |
string[] |
Polecenie uruchamiania kontenera. |
env |
Zmienne środowiskowe kontenera. |
|
image |
string |
Tag obrazu kontenera. |
name |
string |
Niestandardowa nazwa kontenera. |
resources |
Wymagania dotyczące zasobów kontenera. |
|
volumeMounts |
Instalacja woluminu kontenera. |
IpSecurityRestrictionRule
Reguła ograniczania przychodzącego adresu IP.
Nazwa | Typ | Opis |
---|---|---|
action |
Zezwalaj na reguły zezwalania lub odmowy w celu określenia dla przychodzącego adresu IP. Uwaga: Reguły mogą składać się tylko ze wszystkich dozwolonych lub WSZYSTKICH odmów |
|
description |
string |
Opisz regułę ograniczeń adresów IP, która jest wysyłana do kontenera-app. Jest to pole opcjonalne. |
ipAddressRange |
string |
Notacja CIDR zgodna z przychodzącym adresem IP |
name |
string |
Nazwa reguły ograniczeń adresów IP. |
logLevel
Ustawia poziom dziennika dla przyczepki Dapr. Dozwolone wartości to debugowanie, informacje, ostrzeganie, błąd. Wartość domyślna to informacje.
Nazwa | Typ | Opis |
---|---|---|
debug |
string |
|
error |
string |
|
info |
string |
|
warn |
string |
ManagedServiceIdentity
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub przypisane przez użytkownika)
Nazwa | Typ | Opis |
---|---|---|
principalId |
string |
Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
tenantId |
string |
Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system. |
type |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
ManagedServiceIdentityType
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
QueueScaleRule
Reguła skalowania oparta na kolejce na podstawie kontenera aplikacji kontenera platformy Azure.
Nazwa | Typ | Opis |
---|---|---|
auth |
Wpisy tajne uwierzytelniania dla reguły skalowania kolejek. |
|
queueLength |
integer |
Długość kolejki. |
queueName |
string |
Nazwa kolejki. |
RegistryCredentials
Rejestr prywatny aplikacji kontenera
Nazwa | Typ | Opis |
---|---|---|
identity |
string |
Tożsamość zarządzana używana do uwierzytelniania za pomocą Azure Container Registry. W przypadku tożsamości przypisanych przez użytkownika użyj pełnego identyfikatora zasobu tożsamości przypisanej przez użytkownika. W przypadku tożsamości przypisanych przez system użyj polecenia "system" |
passwordSecretRef |
string |
Nazwa wpisu tajnego zawierającego hasło logowania rejestru |
server |
string |
Serwer usługi Container Registry |
username |
string |
Nazwa użytkownika usługi Container Registry |
Scale
Konfiguracje skalowania aplikacji kontenera.
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
maxReplicas |
integer |
10 |
Opcjonalny. Maksymalna liczba replik kontenerów. Wartość domyślna to 10, jeśli nie jest ustawiona. |
minReplicas |
integer |
Opcjonalny. Minimalna liczba replik kontenerów. |
|
rules |
Reguły skalowania. |
ScaleRule
Reguła skalowania kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
azureQueue |
Skalowanie oparte na kolejce platformy Azure. |
|
custom |
Niestandardowa reguła skalowania. |
|
http |
Skalowanie na podstawie żądań HTTP. |
|
name |
string |
Nazwa reguły skalowania |
tcp |
Skalowanie oparte na żądaniach TCP. |
ScaleRuleAuth
Wpisy tajne uwierzytelniania dla reguły skalowania
Nazwa | Typ | Opis |
---|---|---|
secretRef |
string |
Nazwa wpisu tajnego, z którego mają być pobierane parametry uwierzytelniania. |
triggerParameter |
string |
Parametr wyzwalacza, który używa wpisu tajnego |
Scheme
Schemat używany do nawiązywania połączenia z hostem. Wartość domyślna to HTTP.
Nazwa | Typ | Opis |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
Secret
Definicja wpisu tajnego.
Nazwa | Typ | Opis |
---|---|---|
identity |
string |
Identyfikator zasobu tożsamości zarządzanej do uwierzytelniania za pomocą usługi Azure Key Vault lub system do używania tożsamości przypisanej przez system. |
keyVaultUrl |
string |
Adres URL usługi Azure Key Vault wskazujący wpis tajny przywołyny przez aplikację kontenera. |
name |
string |
Nazwa wpisu tajnego. |
value |
string |
Wartość wpisu tajnego. |
SecretVolumeItem
Wpis tajny do dodania do woluminu.
Nazwa | Typ | Opis |
---|---|---|
path |
string |
Ścieżka do wpisu tajnego projektu. Jeśli nie podano żadnej ścieżki, ścieżka jest domyślnie określana jako nazwa wpisu tajnego wymienionego w elemecie secretRef. |
secretRef |
string |
Nazwa wpisu tajnego aplikacji kontenera, z którego ma być pobierana wartość wpisu tajnego. |
Service
Aplikacja kontenera, która ma być usługą dewelopera
Nazwa | Typ | Opis |
---|---|---|
type |
string |
Typ usługi Dev ContainerApp |
ServiceBind
Konfiguracja powiązania aplikacji ContainerApp z usługą Dev ContainerApp Service
Nazwa | Typ | Opis |
---|---|---|
name |
string |
Nazwa powiązania usługi |
serviceId |
string |
Identyfikator zasobu usługi docelowej |
StickySessions
Sesje sticky dla trybu pojedynczej poprawki
Nazwa | Typ | Opis |
---|---|---|
affinity |
Koligacja sesji sticky |
StorageType
Typ magazynu woluminu. Jeśli nie podano, użyj wartości EmptyDir.
Nazwa | Typ | Opis |
---|---|---|
AzureFile |
string |
|
EmptyDir |
string |
|
Secret |
string |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobów (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
TcpScaleRule
Reguła skalowania tcp kontenera aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
auth |
Wpisy tajne uwierzytelniania dla reguły skalowania tcp. |
|
metadata |
object |
Właściwości metadanych opisujące regułę skalowania tcp. |
TcpSocket
TcpSocket określa akcję obejmującą port TCP. Punkty zaczepienia TCP nie są jeszcze obsługiwane.
Nazwa | Typ | Opis |
---|---|---|
host |
string |
Opcjonalnie: nazwa hosta do nawiązania połączenia domyślnie z adresem IP zasobnika. |
port |
integer |
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. |
Template
Definicja aplikacji kontenera w wersji. Definiuje żądany stan niezmiennej poprawki. Wszelkie zmiany w tej sekcji spowodują utworzenie nowej poprawki
Nazwa | Typ | Opis |
---|---|---|
containers |
Lista definicji kontenerów dla aplikacji kontenera. |
|
initContainers |
Lista wyspecjalizowanych kontenerów uruchamianych przed kontenerami aplikacji. |
|
revisionSuffix |
string |
Sufiks przyjazny dla użytkownika, który jest dołączany do nazwy poprawki |
scale |
Właściwości skalowania dla aplikacji kontenera. |
|
serviceBinds |
Lista usług app services kontenera powiązanych z aplikacją |
|
terminationGracePeriodSeconds |
integer |
Opcjonalny czas trwania w sekundach, przez który wystąpienie aplikacji kontenera musi zostać bezpiecznie zakończone. Wartość musi być nieujemną liczbą całkowitą. Wartość zero wskazuje zatrzymać się natychmiast za pośrednictwem sygnału zabicia (brak możliwości zamknięcia). Jeśli ta wartość jest zerowa, zostanie użyty domyślny okres prolongaty. Ustaw tę wartość dłużej niż oczekiwany czas oczyszczania dla procesu. Wartość domyślna to 30 sekund. |
volumes |
Volume[] |
Lista definicji woluminów dla aplikacji kontenera. |
TrafficWeight
Waga ruchu przypisana do poprawki
Nazwa | Typ | Domyślna wartość | Opis |
---|---|---|---|
label |
string |
Kojarzy etykietę ruchu z poprawką |
|
latestRevision |
boolean |
False |
Wskazuje, że waga ruchu należy do najnowszej stabilnej wersji |
revisionName |
string |
Nazwa poprawki |
|
weight |
integer |
Waga ruchu przypisana do poprawki |
Type
Typ sondy.
Nazwa | Typ | Opis |
---|---|---|
Liveness |
string |
|
Readiness |
string |
|
Startup |
string |
UserAssignedIdentity
Właściwości tożsamości przypisanej przez użytkownika
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta przypisanej tożsamości. |
principalId |
string |
Identyfikator podmiotu zabezpieczeń przypisanej tożsamości. |
Volume
Definicje woluminów dla aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
mountOptions |
string |
Opcje instalacji używane podczas instalowania pliku AzureFile. Musi być ciągiem rozdzielanym przecinkami. |
name |
string |
Nazwa woluminu. |
secrets |
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. |
|
storageName |
string |
Nazwa zasobu magazynu. Nie trzeba podawać wartości EmptyDir i Secret. |
storageType |
Typ magazynu dla woluminu. Jeśli nie zostanie podana, użyj wartości EmptyDir. |
VolumeMount
Instalacja woluminu dla aplikacji kontenera.
Nazwa | Typ | Opis |
---|---|---|
mountPath |
string |
Ścieżka w kontenerze, w którym należy zamontować wolumin. Nie może zawierać elementu ":". |
subPath |
string |
Ścieżka w woluminie, z którego należy zamontować wolumin kontenera. Wartość domyślna to "" (katalog główny woluminu). |
volumeName |
string |
Musi to być zgodne z nazwą woluminu. |