Definição de recursos do bíceps
O tipo de recurso containerApps pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Para criar um recurso Microsoft.App/containerApps, adicione o seguinte Bíceps ao seu modelo.
resource symbolicname 'Microsoft.App/containerApps@2022-03-01' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
configuration: {
activeRevisionsMode: 'string'
dapr: {
appId: 'string'
appPort: int
appProtocol: 'string'
enabled: bool
}
ingress: {
allowInsecure: bool
customDomains: [
{
bindingType: 'string'
certificateId: 'string'
name: 'string'
}
]
external: bool
targetPort: int
traffic: [
{
label: 'string'
latestRevision: bool
revisionName: 'string'
weight: int
}
]
transport: 'string'
}
registries: [
{
identity: 'string'
passwordSecretRef: 'string'
server: 'string'
username: 'string'
}
]
secrets: [
{
name: 'string'
value: 'string'
}
]
}
managedEnvironmentId: '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'
}
]
}
]
revisionSuffix: 'string'
scale: {
maxReplicas: int
minReplicas: int
rules: [
{
azureQueue: {
auth: [
{
secretRef: 'string'
triggerParameter: 'string'
}
]
queueLength: int
queueName: 'string'
}
custom: {
auth: [
{
secretRef: 'string'
triggerParameter: 'string'
}
]
metadata: {
{customized property}: 'string'
}
type: 'string'
}
http: {
auth: [
{
secretRef: 'string'
triggerParameter: 'string'
}
]
metadata: {
{customized property}: 'string'
}
}
name: 'string'
}
]
}
volumes: [
{
name: 'string'
storageName: 'string'
storageType: 'string'
}
]
}
}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Microsoft.App/containerApps
| Nome |
Descrição |
Valor |
| identidade |
identidades gerenciadas para o Aplicativo de Contêiner interagir com outros serviços do Azure sem manter segredos ou credenciais no código. |
ManagedServiceIdentity |
| localização |
A geolocalização onde o recurso vive |
string (obrigatório) |
| nome |
O nome do recurso |
string (obrigatório) |
| propriedades |
Propriedades específicas do recurso ContainerApp |
ContainerAppProperties |
| etiquetas |
Tags de recursos |
Dicionário de nomes e valores de tags. Consulte Tags em modelos |
Configuração
| Nome |
Descrição |
Valor |
| activeRevisionsMode |
ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo Container:
<
><item de lista>Múltiplo: várias revisões podem estar ativas.</item><>Único: Apenas uma revisão pode estar ativa de cada vez. Os pesos de revisão não podem ser usados neste modo. Se nenhum valor for fornecido, este é o padrão.</item></lista> |
'Múltiplo'
'Solteiro' |
| DAPR |
Configuração de Dapr para o aplicativo de contêiner. |
Dapr |
| ingresso |
Configurações de ingresso. |
Entrada |
| registos |
Coleta de credenciais de registro de contêiner privado para contêineres usados pelo aplicativo Contêiner |
RegistryCredentials[] |
| segredos |
Coleção de segredos usados por um aplicativo Container |
Secreto [] |
Contentor
| Nome |
Descrição |
Valor |
| Args |
Argumentos do comando Container start. |
string[] |
| comando |
Comando Container start. |
string[] |
| env |
Variáveis de ambiente de contêiner. |
AmbienteVar[] |
| imagem |
Tag de imagem de contêiner. |
corda |
| nome |
Nome do contêiner personalizado. |
corda |
| sondas |
Lista de sondas para o recipiente. |
ContainerAppProbe [] |
| Recursos |
Requisitos de recursos de contêiner. |
ContainerResources |
| volumeMontagens |
Montagens de volume de recipiente. |
VolumeMount[] |
ContainerAppProbe
| Nome |
Descrição |
Valor |
| failureThreshold |
Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. |
Int |
| httpObter |
HTTPGet especifica a solicitação http a ser executada. |
ContainerAppProbeHttpGet |
| initialDelaySeconds |
Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. |
Int |
| segundosPeríodo |
Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. |
Int |
| successThreshold |
Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. |
Int |
| tcpSocket |
TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. |
ContainerAppProbeTcpSocket |
| terminaçãoGracePeriodSeconds |
Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) |
Int |
| timeoutSegundos |
Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 1 segundo. O valor mínimo é 1. O valor máximo é 240. |
Int |
| tipo |
O tipo de sonda. |
'Vivacidade'
'Prontidão'
'Startup' |
ContainerAppProbeHttpGet
| Nome |
Descrição |
Valor |
| anfitrião |
Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. |
corda |
| Cabeçalhos HTTP |
Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. |
ContainerAppProbeHttpGetHttpHeadersItem [] |
| caminho |
Caminho de acesso no servidor HTTP. |
corda |
| porto |
Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
| Esquema |
Esquema a ser usado para se conectar ao host. O padrão é HTTP. |
'HTTP'
'HTTPS' |
| Nome |
Descrição |
Valor |
| nome |
O nome do campo de cabeçalho |
string (obrigatório) |
| valor |
O valor do campo de cabeçalho |
string (obrigatório) |
ContainerAppProbeTcpSocket
| Nome |
Descrição |
Valor |
| anfitrião |
Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. |
corda |
| porto |
Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
ContainerAppProperties
| Nome |
Descrição |
Valor |
| configuração |
Propriedades de configuração do aplicativo de contêiner sem versão. |
Configuração |
| managedEnvironmentId |
ID do recurso do ambiente do aplicativo de contêiner. |
corda |
| modelo |
Definição de aplicativo com versão do aplicativo de contêiner. |
Modelo |
ContainerResources
| Nome |
Descrição |
Valor |
| CPU |
CPU necessária em núcleos, por exemplo, 0,5 |
Int |
| memória |
Memória necessária, por exemplo, "250Mb" |
corda |
Domínio Personalizado
| Nome |
Descrição |
Valor |
| bindingType |
Tipo de vinculação de domínio personalizado. |
'Desativado'
'SniEnabled' |
| certificateId |
ID do recurso do certificado a ser vinculado a esse nome de host. |
corda |
| nome |
Nome do host. |
string (obrigatório) |
CustomScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala personalizada. |
CustomScaleRuleMetadata |
| tipo |
Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc. |
corda |
Dapr
| Nome |
Descrição |
Valor |
| ID do aplicativo |
Identificador do aplicativo Dapr |
corda |
| appPort |
Informa ao Dapr em qual porta seu aplicativo está escutando |
Int |
| appProtocolo |
Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http |
'GRPC'
«http» |
| habilitado |
Boolean indicando se o carro lateral Dapr está ativado |
Bool |
Variável de Ambiente
| Nome |
Descrição |
Valor |
| nome |
Nome da variável de ambiente. |
corda |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. |
corda |
| valor |
Valor da variável de ambiente não secreto. |
corda |
HttpScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala http. |
HttpScaleRuleMetadata |
Entrada
| Nome |
Descrição |
Valor |
| permitirInsecure |
Bool indicando se conexões HTTP para é permitido. Se definido como false conexões HTTP são automaticamente redirecionados para conexões HTTPS |
Bool |
| domínios personalizados |
associações de domínio personalizadas para nomes de host de Aplicativos de Contêiner. |
CustomDomain [] |
| externo |
Bool indicando se o aplicativo expõe um ponto de extremidade http externo |
Bool |
| Porto-alvo |
Porta de destino em contêineres para tráfego de entrada |
Int |
| Trânsito |
Pesos de tráfego para revisões de aplicativos |
TrafficWeight [] |
| Transportes |
Protocolo de transporte de entrada |
'Auto'
«http»
«http2» |
ManagedServiceIdentity
| Nome |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório) |
| identidades atribuídas pelo utilizador |
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. |
UserAssignedIdentities |
QueueScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala de fila. |
ScaleRuleAuth[] |
| comprimento da fila |
Comprimento da fila. |
Int |
| Nome da Fila |
Nome da fila. |
corda |
RegistryCredentials
| Nome |
Descrição |
Valor |
| identidade |
Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' |
corda |
| senhaSecretRef |
O nome do segredo que contém a senha de login do registro |
corda |
| servidor |
Servidor de Registro de Contêiner |
corda |
| nome de utilizador |
Nome de usuário do Registro de contêiner |
corda |
Escala
| Nome |
Descrição |
Valor |
| maxRéplicas |
Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. |
Int |
| minRéplicas |
Opcional. Número mínimo de réplicas de contêiner. |
Int |
| regras |
Regras de dimensionamento. |
ScaleRule [] |
Regra de Escala
| Nome |
Descrição |
Valor |
| azureQueue |
Escalonamento baseado em fila do Azure. |
QueueScaleRule |
| Personalizado |
Regra de escala personalizada. |
CustomScaleRule |
| Disponível em: |
Dimensionamento baseado em solicitações HTTP. |
HttpScaleRule |
| nome |
Nome da regra de escala |
corda |
ScaleRuleAuth
| Nome |
Descrição |
Valor |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair os parâmetros de autenticação. |
corda |
| triggerParâmetro |
Parâmetro Trigger que usa o segredo |
corda |
Segredo
| Nome |
Descrição |
Valor |
| nome |
Nome secreto. |
corda |
| valor |
Valor Secreto. |
cadeia de caracteres
Restrições:
Valor sensível. Passe como um parâmetro seguro. |
Modelo
| Nome |
Descrição |
Valor |
| contentores |
Lista de definições de contêiner para o aplicativo de contêiner. |
Contentor[] |
| revisionSuffix |
Sufixo amigável que é anexado ao nome da revisão |
corda |
| escala |
Propriedades de dimensionamento para o aplicativo de contêiner. |
Escala |
| Volumes |
Lista de definições de volume para o aplicativo de contêiner. |
Volume[] |
TrafficWeight
| Nome |
Descrição |
Valor |
| etiqueta |
Associa um rótulo de tráfego a uma revisão |
corda |
| mais recenteRevisão |
Indica que o peso do tráfego pertence a uma última revisão estável |
Bool |
| revisionName |
Nome de uma revisão |
corda |
| peso |
Peso de tráfego atribuído a uma revisão |
Int |
UserAssignedIdentities
IdentidadeAtribuídaPeloUtilizador
Volume
| Nome |
Descrição |
Valor |
| nome |
Nome do volume. |
corda |
| nome_do_armazenamento |
Nome do recurso de armazenamento. Não há necessidade de fornecer para EmptyDir. |
corda |
| tipo de armazenamento |
Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir. |
'AzureFile'
'EmptyDir' |
Montagem em volume
| Nome |
Descrição |
Valor |
| mountPath [en] |
Caminho dentro do recipiente no qual o volume deve ser montado. Não deve conter «:». |
corda |
| nome_do_volume |
Isso deve corresponder ao Nome de um Volume. |
corda |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
Exemplos de início rápido do Azure
Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.
Definição de recurso de modelo ARM
O tipo de recurso containerApps pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Para criar um recurso Microsoft.App/containerApps, adicione o JSON a seguir ao seu modelo.
{
"type": "Microsoft.App/containerApps",
"apiVersion": "2022-03-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"configuration": {
"activeRevisionsMode": "string",
"dapr": {
"appId": "string",
"appPort": "int",
"appProtocol": "string",
"enabled": "bool"
},
"ingress": {
"allowInsecure": "bool",
"customDomains": [
{
"bindingType": "string",
"certificateId": "string",
"name": "string"
}
],
"external": "bool",
"targetPort": "int",
"traffic": [
{
"label": "string",
"latestRevision": "bool",
"revisionName": "string",
"weight": "int"
}
],
"transport": "string"
},
"registries": [
{
"identity": "string",
"passwordSecretRef": "string",
"server": "string",
"username": "string"
}
],
"secrets": [
{
"name": "string",
"value": "string"
}
]
},
"managedEnvironmentId": "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"
}
]
}
],
"revisionSuffix": "string",
"scale": {
"maxReplicas": "int",
"minReplicas": "int",
"rules": [
{
"azureQueue": {
"auth": [
{
"secretRef": "string",
"triggerParameter": "string"
}
],
"queueLength": "int",
"queueName": "string"
},
"custom": {
"auth": [
{
"secretRef": "string",
"triggerParameter": "string"
}
],
"metadata": {
"{customized property}": "string"
},
"type": "string"
},
"http": {
"auth": [
{
"secretRef": "string",
"triggerParameter": "string"
}
],
"metadata": {
"{customized property}": "string"
}
},
"name": "string"
}
]
},
"volumes": [
{
"name": "string",
"storageName": "string",
"storageType": "string"
}
]
}
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Microsoft.App/containerApps
| Nome |
Descrição |
Valor |
| Versão da API |
A versão api |
'2022-03-01' |
| identidade |
identidades gerenciadas para o Aplicativo de Contêiner interagir com outros serviços do Azure sem manter segredos ou credenciais no código. |
ManagedServiceIdentity |
| localização |
A geolocalização onde o recurso vive |
string (obrigatório) |
| nome |
O nome do recurso |
string (obrigatório) |
| propriedades |
Propriedades específicas do recurso ContainerApp |
ContainerAppProperties |
| etiquetas |
Tags de recursos |
Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| tipo |
O tipo de recurso |
'Microsoft.App/containerApps' |
Configuração
| Nome |
Descrição |
Valor |
| activeRevisionsMode |
ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo Container:
<
><item de lista>Múltiplo: várias revisões podem estar ativas.</item><>Único: Apenas uma revisão pode estar ativa de cada vez. Os pesos de revisão não podem ser usados neste modo. Se nenhum valor for fornecido, este é o padrão.</item></lista> |
'Múltiplo'
'Solteiro' |
| DAPR |
Configuração de Dapr para o aplicativo de contêiner. |
Dapr |
| ingresso |
Configurações de ingresso. |
Entrada |
| registos |
Coleta de credenciais de registro de contêiner privado para contêineres usados pelo aplicativo Contêiner |
RegistryCredentials[] |
| segredos |
Coleção de segredos usados por um aplicativo Container |
Secreto [] |
Contentor
| Nome |
Descrição |
Valor |
| Args |
Argumentos do comando Container start. |
string[] |
| comando |
Comando Container start. |
string[] |
| env |
Variáveis de ambiente de contêiner. |
AmbienteVar[] |
| imagem |
Tag de imagem de contêiner. |
corda |
| nome |
Nome do contêiner personalizado. |
corda |
| sondas |
Lista de sondas para o recipiente. |
ContainerAppProbe [] |
| Recursos |
Requisitos de recursos de contêiner. |
ContainerResources |
| volumeMontagens |
Montagens de volume de recipiente. |
VolumeMount[] |
ContainerAppProbe
| Nome |
Descrição |
Valor |
| failureThreshold |
Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. |
Int |
| httpObter |
HTTPGet especifica a solicitação http a ser executada. |
ContainerAppProbeHttpGet |
| initialDelaySeconds |
Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. |
Int |
| segundosPeríodo |
Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. |
Int |
| successThreshold |
Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. |
Int |
| tcpSocket |
TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. |
ContainerAppProbeTcpSocket |
| terminaçãoGracePeriodSeconds |
Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) |
Int |
| timeoutSegundos |
Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 1 segundo. O valor mínimo é 1. O valor máximo é 240. |
Int |
| tipo |
O tipo de sonda. |
'Vivacidade'
'Prontidão'
'Startup' |
ContainerAppProbeHttpGet
| Nome |
Descrição |
Valor |
| anfitrião |
Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. |
corda |
| Cabeçalhos HTTP |
Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. |
ContainerAppProbeHttpGetHttpHeadersItem [] |
| caminho |
Caminho de acesso no servidor HTTP. |
corda |
| porto |
Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
| Esquema |
Esquema a ser usado para se conectar ao host. O padrão é HTTP. |
'HTTP'
'HTTPS' |
| Nome |
Descrição |
Valor |
| nome |
O nome do campo de cabeçalho |
string (obrigatório) |
| valor |
O valor do campo de cabeçalho |
string (obrigatório) |
ContainerAppProbeTcpSocket
| Nome |
Descrição |
Valor |
| anfitrião |
Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. |
corda |
| porto |
Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
ContainerAppProperties
| Nome |
Descrição |
Valor |
| configuração |
Propriedades de configuração do aplicativo de contêiner sem versão. |
Configuração |
| managedEnvironmentId |
ID do recurso do ambiente do aplicativo de contêiner. |
corda |
| modelo |
Definição de aplicativo com versão do aplicativo de contêiner. |
Modelo |
ContainerResources
| Nome |
Descrição |
Valor |
| CPU |
CPU necessária em núcleos, por exemplo, 0,5 |
Int |
| memória |
Memória necessária, por exemplo, "250Mb" |
corda |
Domínio Personalizado
| Nome |
Descrição |
Valor |
| bindingType |
Tipo de vinculação de domínio personalizado. |
'Desativado'
'SniEnabled' |
| certificateId |
ID do recurso do certificado a ser vinculado a esse nome de host. |
corda |
| nome |
Nome do host. |
string (obrigatório) |
CustomScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala personalizada. |
CustomScaleRuleMetadata |
| tipo |
Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc. |
corda |
Dapr
| Nome |
Descrição |
Valor |
| ID do aplicativo |
Identificador do aplicativo Dapr |
corda |
| appPort |
Informa ao Dapr em qual porta seu aplicativo está escutando |
Int |
| appProtocolo |
Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http |
'GRPC'
«http» |
| habilitado |
Boolean indicando se o carro lateral Dapr está ativado |
Bool |
Variável de Ambiente
| Nome |
Descrição |
Valor |
| nome |
Nome da variável de ambiente. |
corda |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. |
corda |
| valor |
Valor da variável de ambiente não secreto. |
corda |
HttpScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala http. |
HttpScaleRuleMetadata |
Entrada
| Nome |
Descrição |
Valor |
| permitirInsecure |
Bool indicando se conexões HTTP para é permitido. Se definido como false conexões HTTP são automaticamente redirecionados para conexões HTTPS |
Bool |
| domínios personalizados |
associações de domínio personalizadas para nomes de host de Aplicativos de Contêiner. |
CustomDomain [] |
| externo |
Bool indicando se o aplicativo expõe um ponto de extremidade http externo |
Bool |
| Porto-alvo |
Porta de destino em contêineres para tráfego de entrada |
Int |
| Trânsito |
Pesos de tráfego para revisões de aplicativos |
TrafficWeight [] |
| Transportes |
Protocolo de transporte de entrada |
'Auto'
«http»
«http2» |
ManagedServiceIdentity
| Nome |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório) |
| identidades atribuídas pelo utilizador |
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. |
UserAssignedIdentities |
QueueScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala de fila. |
ScaleRuleAuth[] |
| comprimento da fila |
Comprimento da fila. |
Int |
| Nome da Fila |
Nome da fila. |
corda |
RegistryCredentials
| Nome |
Descrição |
Valor |
| identidade |
Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' |
corda |
| senhaSecretRef |
O nome do segredo que contém a senha de login do registro |
corda |
| servidor |
Servidor de Registro de Contêiner |
corda |
| nome de utilizador |
Nome de usuário do Registro de contêiner |
corda |
Escala
| Nome |
Descrição |
Valor |
| maxRéplicas |
Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. |
Int |
| minRéplicas |
Opcional. Número mínimo de réplicas de contêiner. |
Int |
| regras |
Regras de dimensionamento. |
ScaleRule [] |
Regra de Escala
| Nome |
Descrição |
Valor |
| azureQueue |
Escalonamento baseado em fila do Azure. |
QueueScaleRule |
| Personalizado |
Regra de escala personalizada. |
CustomScaleRule |
| Disponível em: |
Dimensionamento baseado em solicitações HTTP. |
HttpScaleRule |
| nome |
Nome da regra de escala |
corda |
ScaleRuleAuth
| Nome |
Descrição |
Valor |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair os parâmetros de autenticação. |
corda |
| triggerParâmetro |
Parâmetro Trigger que usa o segredo |
corda |
Segredo
| Nome |
Descrição |
Valor |
| nome |
Nome secreto. |
corda |
| valor |
Valor Secreto. |
cadeia de caracteres
Restrições:
Valor sensível. Passe como um parâmetro seguro. |
Modelo
| Nome |
Descrição |
Valor |
| contentores |
Lista de definições de contêiner para o aplicativo de contêiner. |
Contentor[] |
| revisionSuffix |
Sufixo amigável que é anexado ao nome da revisão |
corda |
| escala |
Propriedades de dimensionamento para o aplicativo de contêiner. |
Escala |
| Volumes |
Lista de definições de volume para o aplicativo de contêiner. |
Volume[] |
TrafficWeight
| Nome |
Descrição |
Valor |
| etiqueta |
Associa um rótulo de tráfego a uma revisão |
corda |
| mais recenteRevisão |
Indica que o peso do tráfego pertence a uma última revisão estável |
Bool |
| revisionName |
Nome de uma revisão |
corda |
| peso |
Peso de tráfego atribuído a uma revisão |
Int |
UserAssignedIdentities
IdentidadeAtribuídaPeloUtilizador
Volume
| Nome |
Descrição |
Valor |
| nome |
Nome do volume. |
corda |
| nome_do_armazenamento |
Nome do recurso de armazenamento. Não há necessidade de fornecer para EmptyDir. |
corda |
| tipo de armazenamento |
Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir. |
'AzureFile'
'EmptyDir' |
Montagem em volume
| Nome |
Descrição |
Valor |
| mountPath [en] |
Caminho dentro do recipiente no qual o volume deve ser montado. Não deve conter «:». |
corda |
| nome_do_volume |
Isso deve corresponder ao Nome de um Volume. |
corda |
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
O tipo de recurso containerApps pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Para criar um recurso Microsoft.App/containerApps, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.App/containerApps@2022-03-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
configuration = {
activeRevisionsMode = "string"
dapr = {
appId = "string"
appPort = int
appProtocol = "string"
enabled = bool
}
ingress = {
allowInsecure = bool
customDomains = [
{
bindingType = "string"
certificateId = "string"
name = "string"
}
]
external = bool
targetPort = int
traffic = [
{
label = "string"
latestRevision = bool
revisionName = "string"
weight = int
}
]
transport = "string"
}
registries = [
{
identity = "string"
passwordSecretRef = "string"
server = "string"
username = "string"
}
]
secrets = [
{
name = "string"
value = "string"
}
]
}
managedEnvironmentId = "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"
}
]
}
]
revisionSuffix = "string"
scale = {
maxReplicas = int
minReplicas = int
rules = [
{
azureQueue = {
auth = [
{
secretRef = "string"
triggerParameter = "string"
}
]
queueLength = int
queueName = "string"
}
custom = {
auth = [
{
secretRef = "string"
triggerParameter = "string"
}
]
metadata = {
{customized property} = "string"
}
type = "string"
}
http = {
auth = [
{
secretRef = "string"
triggerParameter = "string"
}
]
metadata = {
{customized property} = "string"
}
}
name = "string"
}
]
}
volumes = [
{
name = "string"
storageName = "string"
storageType = "string"
}
]
}
}
}
}
Valores de propriedade
Microsoft.App/containerApps
| Nome |
Descrição |
Valor |
| identidade |
identidades gerenciadas para o Aplicativo de Contêiner interagir com outros serviços do Azure sem manter segredos ou credenciais no código. |
ManagedServiceIdentity |
| localização |
A geolocalização onde o recurso vive |
string (obrigatório) |
| nome |
O nome do recurso |
string (obrigatório) |
| propriedades |
Propriedades específicas do recurso ContainerApp |
ContainerAppProperties |
| etiquetas |
Tags de recursos |
Dicionário de nomes e valores de tags. |
| tipo |
O tipo de recurso |
"Microsoft.App/containerApps@2022-03-01" |
Configuração
| Nome |
Descrição |
Valor |
| activeRevisionsMode |
ActiveRevisionsMode controla como as revisões ativas são tratadas para o aplicativo Container:
<
><item de lista>Múltiplo: várias revisões podem estar ativas.</item><>Único: Apenas uma revisão pode estar ativa de cada vez. Os pesos de revisão não podem ser usados neste modo. Se nenhum valor for fornecido, este é o padrão.</item></lista> |
'Múltiplo'
'Solteiro' |
| DAPR |
Configuração de Dapr para o aplicativo de contêiner. |
Dapr |
| ingresso |
Configurações de ingresso. |
Entrada |
| registos |
Coleta de credenciais de registro de contêiner privado para contêineres usados pelo aplicativo Contêiner |
RegistryCredentials[] |
| segredos |
Coleção de segredos usados por um aplicativo Container |
Secreto [] |
Contentor
| Nome |
Descrição |
Valor |
| Args |
Argumentos do comando Container start. |
string[] |
| comando |
Comando Container start. |
string[] |
| env |
Variáveis de ambiente de contêiner. |
AmbienteVar[] |
| imagem |
Tag de imagem de contêiner. |
corda |
| nome |
Nome do contêiner personalizado. |
corda |
| sondas |
Lista de sondas para o recipiente. |
ContainerAppProbe [] |
| Recursos |
Requisitos de recursos de contêiner. |
ContainerResources |
| volumeMontagens |
Montagens de volume de recipiente. |
VolumeMount[] |
ContainerAppProbe
| Nome |
Descrição |
Valor |
| failureThreshold |
Mínimo de falhas consecutivas para que a sonda seja considerada falha após ter sido bem-sucedida. O padrão é 3. O valor mínimo é 1. O valor máximo é 10. |
Int |
| httpObter |
HTTPGet especifica a solicitação http a ser executada. |
ContainerAppProbeHttpGet |
| initialDelaySeconds |
Número de segundos após o início do recipiente antes que as sondas de vivacidade sejam iniciadas. O valor mínimo é 1. O valor máximo é 60. |
Int |
| segundosPeríodo |
Com que frequência (em segundos) realizar a sonda. O padrão é de 10 segundos. O valor mínimo é 1. O valor máximo é 240. |
Int |
| successThreshold |
Mínimo de sucessos consecutivos para que a sonda seja considerada bem-sucedida após ter falhado. O padrão é 1. Deve ser 1 para liveness e startup. O valor mínimo é 1. O valor máximo é 10. |
Int |
| tcpSocket |
TCPSocket especifica uma ação envolvendo uma porta TCP. Ganchos TCP ainda não suportados. |
ContainerAppProbeTcpSocket |
| terminaçãoGracePeriodSeconds |
Duração opcional: em segundos, o pod precisa terminar normalmente em caso de falha da sonda. O período de carência é a duração em segundos após os processos em execução no pod receberem um sinal de terminação e o tempo em que os processos são interrompidos à força com um sinal de morte. Defina esse valor por mais tempo do que o tempo de limpeza esperado para o seu processo. Se esse valor for nulo, a terminationGracePeriodSeconds do pod será usada. Caso contrário, esse valor substituirá o valor fornecido pela especificação do pod. O valor deve ser inteiro não negativo. O valor zero indica parar imediatamente através do sinal de morte (sem oportunidade de encerrar). Este é um campo alfa e requer a ativação da porta de recurso ProbeTerminationGracePeriod. O valor máximo é de 3600 segundos (1 hora) |
Int |
| timeoutSegundos |
Número de segundos após os quais a sonda atinge o tempo limite. O padrão é de 1 segundo. O valor mínimo é 1. O valor máximo é 240. |
Int |
| tipo |
O tipo de sonda. |
'Vivacidade'
'Prontidão'
'Startup' |
ContainerAppProbeHttpGet
| Nome |
Descrição |
Valor |
| anfitrião |
Nome do host ao qual se conectar, o padrão é o IP do pod. Você provavelmente deseja definir "Host" em httpHeaders em vez disso. |
corda |
| Cabeçalhos HTTP |
Cabeçalhos personalizados para definir na solicitação. HTTP permite cabeçalhos repetidos. |
ContainerAppProbeHttpGetHttpHeadersItem [] |
| caminho |
Caminho de acesso no servidor HTTP. |
corda |
| porto |
Nome ou número da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
| Esquema |
Esquema a ser usado para se conectar ao host. O padrão é HTTP. |
'HTTP'
'HTTPS' |
| Nome |
Descrição |
Valor |
| nome |
O nome do campo de cabeçalho |
string (obrigatório) |
| valor |
O valor do campo de cabeçalho |
string (obrigatório) |
ContainerAppProbeTcpSocket
| Nome |
Descrição |
Valor |
| anfitrião |
Opcional: Nome do host ao qual se conectar, o padrão é o IP do pod. |
corda |
| porto |
Número ou nome da porta a ser acessada no contêiner. O número deve estar no intervalo de 1 a 65535. O nome deve ser um IANA_SVC_NAME. |
int (obrigatório) |
ContainerAppProperties
| Nome |
Descrição |
Valor |
| configuração |
Propriedades de configuração do aplicativo de contêiner sem versão. |
Configuração |
| managedEnvironmentId |
ID do recurso do ambiente do aplicativo de contêiner. |
corda |
| modelo |
Definição de aplicativo com versão do aplicativo de contêiner. |
Modelo |
ContainerResources
| Nome |
Descrição |
Valor |
| CPU |
CPU necessária em núcleos, por exemplo, 0,5 |
Int |
| memória |
Memória necessária, por exemplo, "250Mb" |
corda |
Domínio Personalizado
| Nome |
Descrição |
Valor |
| bindingType |
Tipo de vinculação de domínio personalizado. |
'Desativado'
'SniEnabled' |
| certificateId |
ID do recurso do certificado a ser vinculado a esse nome de host. |
corda |
| nome |
Nome do host. |
string (obrigatório) |
CustomScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala personalizada. |
CustomScaleRuleMetadata |
| tipo |
Tipo de regra de escala personalizada
Por exemplo: Azure-ServiceBus, Redis etc. |
corda |
Dapr
| Nome |
Descrição |
Valor |
| ID do aplicativo |
Identificador do aplicativo Dapr |
corda |
| appPort |
Informa ao Dapr em qual porta seu aplicativo está escutando |
Int |
| appProtocolo |
Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http e grpc. O padrão é http |
'GRPC'
«http» |
| habilitado |
Boolean indicando se o carro lateral Dapr está ativado |
Bool |
Variável de Ambiente
| Nome |
Descrição |
Valor |
| nome |
Nome da variável de ambiente. |
corda |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair o valor da variável de ambiente. |
corda |
| valor |
Valor da variável de ambiente não secreto. |
corda |
HttpScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala personalizada. |
ScaleRuleAuth[] |
| metadados |
Propriedades de metadados para descrever a regra de escala http. |
HttpScaleRuleMetadata |
Entrada
| Nome |
Descrição |
Valor |
| permitirInsecure |
Bool indicando se conexões HTTP para é permitido. Se definido como false conexões HTTP são automaticamente redirecionados para conexões HTTPS |
Bool |
| domínios personalizados |
associações de domínio personalizadas para nomes de host de Aplicativos de Contêiner. |
CustomDomain [] |
| externo |
Bool indicando se o aplicativo expõe um ponto de extremidade http externo |
Bool |
| Porto-alvo |
Porta de destino em contêineres para tráfego de entrada |
Int |
| Trânsito |
Pesos de tráfego para revisões de aplicativos |
TrafficWeight [] |
| Transportes |
Protocolo de transporte de entrada |
'Auto'
«http»
«http2» |
ManagedServiceIdentity
| Nome |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
'Nenhuma'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obrigatório) |
| identidades atribuídas pelo utilizador |
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores do dicionário podem ser objetos vazios ({}) em solicitações. |
UserAssignedIdentities |
QueueScaleRule
| Nome |
Descrição |
Valor |
| autenticação |
Segredos de autenticação para a regra de escala de fila. |
ScaleRuleAuth[] |
| comprimento da fila |
Comprimento da fila. |
Int |
| Nome da Fila |
Nome da fila. |
corda |
RegistryCredentials
| Nome |
Descrição |
Valor |
| identidade |
Uma Identidade Gerenciada a ser usada para autenticar com o Registro de Contêiner do Azure. Para identidades atribuídas pelo usuário, use o ID de recurso de identidade atribuído pelo usuário completo. Para identidades atribuídas ao sistema, use 'system' |
corda |
| senhaSecretRef |
O nome do segredo que contém a senha de login do registro |
corda |
| servidor |
Servidor de Registro de Contêiner |
corda |
| nome de utilizador |
Nome de usuário do Registro de contêiner |
corda |
Escala
| Nome |
Descrição |
Valor |
| maxRéplicas |
Opcional. Número máximo de réplicas de contêiner. O padrão é 10 se não estiver definido. |
Int |
| minRéplicas |
Opcional. Número mínimo de réplicas de contêiner. |
Int |
| regras |
Regras de dimensionamento. |
ScaleRule [] |
Regra de Escala
| Nome |
Descrição |
Valor |
| azureQueue |
Escalonamento baseado em fila do Azure. |
QueueScaleRule |
| Personalizado |
Regra de escala personalizada. |
CustomScaleRule |
| Disponível em: |
Dimensionamento baseado em solicitações HTTP. |
HttpScaleRule |
| nome |
Nome da regra de escala |
corda |
ScaleRuleAuth
| Nome |
Descrição |
Valor |
| secretRef |
Nome do segredo do aplicativo de contêiner do qual extrair os parâmetros de autenticação. |
corda |
| triggerParâmetro |
Parâmetro Trigger que usa o segredo |
corda |
Segredo
| Nome |
Descrição |
Valor |
| nome |
Nome secreto. |
corda |
| valor |
Valor Secreto. |
cadeia de caracteres
Restrições:
Valor sensível. Passe como um parâmetro seguro. |
Modelo
| Nome |
Descrição |
Valor |
| contentores |
Lista de definições de contêiner para o aplicativo de contêiner. |
Contentor[] |
| revisionSuffix |
Sufixo amigável que é anexado ao nome da revisão |
corda |
| escala |
Propriedades de dimensionamento para o aplicativo de contêiner. |
Escala |
| Volumes |
Lista de definições de volume para o aplicativo de contêiner. |
Volume[] |
TrafficWeight
| Nome |
Descrição |
Valor |
| etiqueta |
Associa um rótulo de tráfego a uma revisão |
corda |
| mais recenteRevisão |
Indica que o peso do tráfego pertence a uma última revisão estável |
Bool |
| revisionName |
Nome de uma revisão |
corda |
| peso |
Peso de tráfego atribuído a uma revisão |
Int |
UserAssignedIdentities
IdentidadeAtribuídaPeloUtilizador
Volume
| Nome |
Descrição |
Valor |
| nome |
Nome do volume. |
corda |
| nome_do_armazenamento |
Nome do recurso de armazenamento. Não há necessidade de fornecer para EmptyDir. |
corda |
| tipo de armazenamento |
Tipo de armazenamento para o volume. Se não for fornecido, use EmptyDir. |
'AzureFile'
'EmptyDir' |
Montagem em volume
| Nome |
Descrição |
Valor |
| mountPath [en] |
Caminho dentro do recipiente no qual o volume deve ser montado. Não deve conter «:». |
corda |
| nome_do_volume |
Isso deve corresponder ao Nome de um Volume. |
corda |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
