Condividi tramite

Microsoft.App contenitoreApp 2022-03-01

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa containerApps può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/containerApps, aggiungere il bicep seguente al modello.

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'
  }
}

Valori delle proprietà

Configurazione

Nome Descrizione Valore
activeRevisionsMode ActiveRevisionsMode controlla la modalità di gestione delle revisioni attive per l'app Contenitore:
<elenco><elemento>multiple: più revisioni possono essere attive.</item><elemento>Singolo: è possibile attivarne una sola alla volta. I pesi delle revisioni non possono essere utilizzati in questa modalità. Se non viene specificato alcun valore, si tratta dell'impostazione predefinita.</item></list>		 'Multiple'
'Single'
dapr Configurazione dapr per l'app contenitore. dapr
Ingresso Configurazioni di ingresso. in ingresso
Registri Raccolta di credenziali del registro contenitori privato per i contenitori usati dall'app Contenitore RegistryCredentials[]
segreti Raccolta di segreti usati da un'app contenitore segreto[]

Contenitore

Nome Descrizione Valore
argomenti Argomenti del comando di avvio del contenitore. string[]
comando Comando start del contenitore. string[]
Env Variabili di ambiente del contenitore. EnvironmentVar[]
immagine Tag immagine contenitore. corda
nome Nome del contenitore personalizzato. corda
Sonde Elenco di probe per il contenitore. ContainerAppProbe[]
risorse Requisiti delle risorse del contenitore. ContainerResources
volumeMounts Montaggi del volume del contenitore. VolumeMount []

ContainerAppProbe

Nome Descrizione Valore
failureThreshold Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10. Int
httpGet HTTPGet specifica la richiesta HTTP da eseguire. ContainerAppProbeHttpGet
initialDelaySeconds Numero di secondi dopo l'avvio del contenitore prima dell'avvio dei probe di attività. Il valore minimo è 1. Il valore massimo è 60. Int
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240. Int
successThreshold Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Il valore predefinito è 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10. Int
tcpSocket TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati. ContainerAppProbeTcpSocket
terminationGracePeriodSeconds La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora) Int
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240. Int
digitare Tipo di probe. 'Liveness'
'Idoneità'
'Startup'

ContainerAppProbeHttpGet

Nome Descrizione Valore
ospite Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders. corda
httpHeaders Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute. ContainerAppProbeHttpGetHttpGetHttpHeadersItem[]
sentiero Percorso di accesso nel server HTTP. corda
porto Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)
schema Schema da usare per la connessione all'host. Il valore predefinito è HTTP. 'HTTP'
'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nome Descrizione Valore
nome Nome del campo dell'intestazione stringa (obbligatorio)
valore Valore del campo dell'intestazione stringa (obbligatorio)

ContainerAppProbeTcpSocket

Nome Descrizione Valore
ospite Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. corda
porto Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)

ContainerAppProperties

Nome Descrizione Valore
configurazione Proprietà di configurazione dell'app contenitore non con controllo delle versioni. configurazione
managedEnvironmentId ID risorsa dell'ambiente dell'app contenitore. corda
sagoma Definizione dell'applicazione con controllo delle versioni dell'app contenitore. modello

ContainerResources

Nome Descrizione Valore
CPU CPU necessaria nei core, ad esempio 0,5 Int
memoria Memoria necessaria, ad esempio "250 Mb" corda

CustomDomain

Nome Descrizione Valore
bindingType Tipo di associazione di dominio personalizzato. 'Disabilitato'
'SniEnabled'
certificateId ID risorsa del certificato da associare a questo nome host. corda
nome Nome host. stringa (obbligatorio)

CustomScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. CustomScaleRuleMetadata
digitare Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.		 corda

CustomScaleRuleMetadata

Nome Descrizione Valore

Dapr

Nome Descrizione Valore
appId Identificatore dell'applicazione Dapr corda
appPort Indica a Dapr quale porta l'applicazione è in ascolto Int
appProtocol Indica a Dapr quale protocollo usa l'applicazione. Le opzioni valide sono http e grpc. Il valore predefinito è http 'grpc'
'http'
Abilitato Valore booleano che indica se l'auto lato Dapr è abilitata Bool

EnvironmentVar

Nome Descrizione Valore
nome Nome della variabile di ambiente. corda
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente. corda
valore Valore della variabile di ambiente non segreto. corda

HttpScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità HTTP. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Nome Descrizione Valore

Ingresso

Nome Descrizione Valore
allowInsecure Bool che indica se sono consentite le connessioni HTTP a. Se impostato su false connessioni HTTP vengono reindirizzate automaticamente alle connessioni HTTPS Bool
customDomains associazioni di dominio personalizzate per i nomi host di App contenitore. CustomDomain []
esterno Bool che indica se l'app espone un endpoint HTTP esterno Bool
targetPort Porta di destinazione nei contenitori per il traffico proveniente dall'ingresso Int
traffico Pesi del traffico per le revisioni dell'app TrafficWeight[]
trasporto Protocollo di trasporto in ingresso 'auto'
'http'
'http2'

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.App/containerApps

Nome Descrizione Valore
identità identità gestite per l'app contenitore per interagire con altri servizi di Azure senza mantenere segreti o credenziali nel codice. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà specifiche della risorsa ContainerApp ContainerAppProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

QueueScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. Int
queueName Nome coda. corda

RegistryCredentials

Nome Descrizione Valore
identità Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system' corda
passwordSecretRef Nome del segreto che contiene la password di accesso del Registro di sistema corda
server Server registro contenitori corda
nome utente Nome utente registro contenitori corda

Scala

Nome Descrizione Valore
maxReplicas Opzionale. Numero massimo di repliche di contenitori. Il valore predefinito è 10 se non è impostato. Int
minReplicas Opzionale. Numero minimo di repliche di contenitori. Int
norme Regole di ridimensionamento. ScaleRule []

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
costume Regola di scalabilità personalizzata. CustomScaleRule
http Ridimensionamento basato sulle richieste HTTP. HttpScaleRule
nome Nome regola di scalabilità corda

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull dei parametri di autenticazione. corda
triggerParameter Parametro trigger che usa il segreto corda

Segreto

Nome Descrizione Valore
nome Nome segreto. corda
valore Valore segreto. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.

Sagoma

Nome Descrizione Valore
contenitori Elenco di definizioni di contenitori per l'app contenitore. contenitore []
revisionSuffix Suffisso descrittivo aggiunto al nome della revisione corda
scala Proprietà di ridimensionamento per l'app contenitore. Ridimensionare
Volumi Elenco delle definizioni di volume per l'app contenitore. volume []

TrackedResourceTags

Nome Descrizione Valore

TrafficWeight

Nome Descrizione Valore
etichetta Associa un'etichetta di traffico a una revisione corda
latestRevision Indica che il peso del traffico appartiene a una revisione stabile più recente Bool
revisionName Nome di una revisione corda
peso Peso del traffico assegnato a una revisione Int

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

Volume

Nome Descrizione Valore
nome Nome del volume. corda
storageName Nome della risorsa di archiviazione. Non è necessario specificare emptyDir. corda
storageType Tipo di archiviazione per il volume. Se non specificato, usare EmptyDir. 'AzureFile'
'EmptyDir'

VolumeMount

Nome Descrizione Valore
mountPath Percorso all'interno del contenitore in cui deve essere montato il volume. Non deve contenere ':'. corda
volumeName Deve corrispondere al nome di un volume. corda

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
Crea un'app contenitore e un ambiente con registro Creare un ambiente dell'app contenitore con un'app contenitore di base da un Registro Azure Container. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un'app contenitore con una regola di ridimensionamento HTTP definita Creare un ambiente dell'app contenitore con un'app contenitore di base che viene ridimensionata in base al traffico HTTP.
Crea un'app contenitore all'interno di un ambiente dell'app contenitore Creare un ambiente dell'app contenitore con un'app contenitore di base. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un'app di microservizi Dapr usando app contenitore Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore Creare un'app pub-sub servicebus dapr usando App contenitore.
crea un'app contenitore con un ambiente dell'app contenitore Creare un ambiente di due app contenitore con un'app contenitore di base. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un ambiente dell'app contenitore esterno con una rete virtuale Crea un ambiente dell'app contenitore esterno con una rete virtuale.
Crea un ambiente dell'app contenitore interno con una rete virtuale Crea un ambiente dell'app contenitore interno con una rete virtuale.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa containerApps può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/containerApps, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

Configurazione

Nome Descrizione Valore
activeRevisionsMode ActiveRevisionsMode controlla la modalità di gestione delle revisioni attive per l'app Contenitore:
<elenco><elemento>multiple: più revisioni possono essere attive.</item><elemento>Singolo: è possibile attivarne una sola alla volta. I pesi delle revisioni non possono essere utilizzati in questa modalità. Se non viene specificato alcun valore, si tratta dell'impostazione predefinita.</item></list>		 'Multiple'
'Single'
dapr Configurazione dapr per l'app contenitore. dapr
Ingresso Configurazioni di ingresso. in ingresso
Registri Raccolta di credenziali del registro contenitori privato per i contenitori usati dall'app Contenitore RegistryCredentials[]
segreti Raccolta di segreti usati da un'app contenitore segreto[]

Contenitore

Nome Descrizione Valore
argomenti Argomenti del comando di avvio del contenitore. string[]
comando Comando start del contenitore. string[]
Env Variabili di ambiente del contenitore. EnvironmentVar[]
immagine Tag immagine contenitore. corda
nome Nome del contenitore personalizzato. corda
Sonde Elenco di probe per il contenitore. ContainerAppProbe[]
risorse Requisiti delle risorse del contenitore. ContainerResources
volumeMounts Montaggi del volume del contenitore. VolumeMount []

ContainerAppProbe

Nome Descrizione Valore
failureThreshold Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10. Int
httpGet HTTPGet specifica la richiesta HTTP da eseguire. ContainerAppProbeHttpGet
initialDelaySeconds Numero di secondi dopo l'avvio del contenitore prima dell'avvio dei probe di attività. Il valore minimo è 1. Il valore massimo è 60. Int
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240. Int
successThreshold Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Il valore predefinito è 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10. Int
tcpSocket TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati. ContainerAppProbeTcpSocket
terminationGracePeriodSeconds La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora) Int
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240. Int
digitare Tipo di probe. 'Liveness'
'Idoneità'
'Startup'

ContainerAppProbeHttpGet

Nome Descrizione Valore
ospite Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders. corda
httpHeaders Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute. ContainerAppProbeHttpGetHttpGetHttpHeadersItem[]
sentiero Percorso di accesso nel server HTTP. corda
porto Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)
schema Schema da usare per la connessione all'host. Il valore predefinito è HTTP. 'HTTP'
'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nome Descrizione Valore
nome Nome del campo dell'intestazione stringa (obbligatorio)
valore Valore del campo dell'intestazione stringa (obbligatorio)

ContainerAppProbeTcpSocket

Nome Descrizione Valore
ospite Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. corda
porto Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)

ContainerAppProperties

Nome Descrizione Valore
configurazione Proprietà di configurazione dell'app contenitore non con controllo delle versioni. configurazione
managedEnvironmentId ID risorsa dell'ambiente dell'app contenitore. corda
sagoma Definizione dell'applicazione con controllo delle versioni dell'app contenitore. modello

ContainerResources

Nome Descrizione Valore
CPU CPU necessaria nei core, ad esempio 0,5 Int
memoria Memoria necessaria, ad esempio "250 Mb" corda

CustomDomain

Nome Descrizione Valore
bindingType Tipo di associazione di dominio personalizzato. 'Disabilitato'
'SniEnabled'
certificateId ID risorsa del certificato da associare a questo nome host. corda
nome Nome host. stringa (obbligatorio)

CustomScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. CustomScaleRuleMetadata
digitare Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.		 corda

CustomScaleRuleMetadata

Nome Descrizione Valore

Dapr

Nome Descrizione Valore
appId Identificatore dell'applicazione Dapr corda
appPort Indica a Dapr quale porta l'applicazione è in ascolto Int
appProtocol Indica a Dapr quale protocollo usa l'applicazione. Le opzioni valide sono http e grpc. Il valore predefinito è http 'grpc'
'http'
Abilitato Valore booleano che indica se l'auto lato Dapr è abilitata Bool

EnvironmentVar

Nome Descrizione Valore
nome Nome della variabile di ambiente. corda
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente. corda
valore Valore della variabile di ambiente non segreto. corda

HttpScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità HTTP. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Nome Descrizione Valore

Ingresso

Nome Descrizione Valore
allowInsecure Bool che indica se sono consentite le connessioni HTTP a. Se impostato su false connessioni HTTP vengono reindirizzate automaticamente alle connessioni HTTPS Bool
customDomains associazioni di dominio personalizzate per i nomi host di App contenitore. CustomDomain []
esterno Bool che indica se l'app espone un endpoint HTTP esterno Bool
targetPort Porta di destinazione nei contenitori per il traffico proveniente dall'ingresso Int
traffico Pesi del traffico per le revisioni dell'app TrafficWeight[]
trasporto Protocollo di trasporto in ingresso 'auto'
'http'
'http2'

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.App/containerApps

Nome Descrizione Valore
apiVersion Versione dell'API '2022-03-01'
identità identità gestite per l'app contenitore per interagire con altri servizi di Azure senza mantenere segreti o credenziali nel codice. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà specifiche della risorsa ContainerApp ContainerAppProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.App/containerApps'

QueueScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. Int
queueName Nome coda. corda

RegistryCredentials

Nome Descrizione Valore
identità Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system' corda
passwordSecretRef Nome del segreto che contiene la password di accesso del Registro di sistema corda
server Server registro contenitori corda
nome utente Nome utente registro contenitori corda

Scala

Nome Descrizione Valore
maxReplicas Opzionale. Numero massimo di repliche di contenitori. Il valore predefinito è 10 se non è impostato. Int
minReplicas Opzionale. Numero minimo di repliche di contenitori. Int
norme Regole di ridimensionamento. ScaleRule []

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
costume Regola di scalabilità personalizzata. CustomScaleRule
http Ridimensionamento basato sulle richieste HTTP. HttpScaleRule
nome Nome regola di scalabilità corda

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull dei parametri di autenticazione. corda
triggerParameter Parametro trigger che usa il segreto corda

Segreto

Nome Descrizione Valore
nome Nome segreto. corda
valore Valore segreto. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.

Sagoma

Nome Descrizione Valore
contenitori Elenco di definizioni di contenitori per l'app contenitore. contenitore []
revisionSuffix Suffisso descrittivo aggiunto al nome della revisione corda
scala Proprietà di ridimensionamento per l'app contenitore. Ridimensionare
Volumi Elenco delle definizioni di volume per l'app contenitore. volume []

TrackedResourceTags

Nome Descrizione Valore

TrafficWeight

Nome Descrizione Valore
etichetta Associa un'etichetta di traffico a una revisione corda
latestRevision Indica che il peso del traffico appartiene a una revisione stabile più recente Bool
revisionName Nome di una revisione corda
peso Peso del traffico assegnato a una revisione Int

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

Volume

Nome Descrizione Valore
nome Nome del volume. corda
storageName Nome della risorsa di archiviazione. Non è necessario specificare emptyDir. corda
storageType Tipo di archiviazione per il volume. Se non specificato, usare EmptyDir. 'AzureFile'
'EmptyDir'

VolumeMount

Nome Descrizione Valore
mountPath Percorso all'interno del contenitore in cui deve essere montato il volume. Non deve contenere ':'. corda
volumeName Deve corrispondere al nome di un volume. corda

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
Crea un'app contenitore e un ambiente con registro

Distribuire in Azure 		Creare un ambiente dell'app contenitore con un'app contenitore di base da un Registro Azure Container. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un'app contenitore con una regola di ridimensionamento HTTP definita

Distribuire in Azure 		Creare un ambiente dell'app contenitore con un'app contenitore di base che viene ridimensionata in base al traffico HTTP.
Crea un'app contenitore all'interno di un ambiente dell'app contenitore

Distribuire in Azure 		Creare un ambiente dell'app contenitore con un'app contenitore di base. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un'app di microservizi Dapr usando app contenitore

Distribuire in Azure 		Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore

Distribuire in Azure 		Creare un'app pub-sub servicebus dapr usando App contenitore.
crea un'app contenitore con un ambiente dell'app contenitore

Distribuire in Azure 		Creare un ambiente di due app contenitore con un'app contenitore di base. Distribuisce anche un'area di lavoro Log Analytics per archiviare i log.
Crea un ambiente dell'app contenitore esterno con una rete virtuale

Distribuire in Azure 		Crea un ambiente dell'app contenitore esterno con una rete virtuale.
Crea un ambiente dell'app contenitore interno con una rete virtuale

Distribuire in Azure 		Crea un ambiente dell'app contenitore interno con una rete virtuale.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa containerApps può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/containerApps, aggiungere il modello terraform seguente.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/containerApps@2022-03-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    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"
          }
        ]
      }
    }
  })
}

Valori delle proprietà

Configurazione

Nome Descrizione Valore
activeRevisionsMode ActiveRevisionsMode controlla la modalità di gestione delle revisioni attive per l'app Contenitore:
<elenco><elemento>multiple: più revisioni possono essere attive.</item><elemento>Singolo: è possibile attivarne una sola alla volta. I pesi delle revisioni non possono essere utilizzati in questa modalità. Se non viene specificato alcun valore, si tratta dell'impostazione predefinita.</item></list>		 'Multiple'
'Single'
dapr Configurazione dapr per l'app contenitore. dapr
Ingresso Configurazioni di ingresso. in ingresso
Registri Raccolta di credenziali del registro contenitori privato per i contenitori usati dall'app Contenitore RegistryCredentials[]
segreti Raccolta di segreti usati da un'app contenitore segreto[]

Contenitore

Nome Descrizione Valore
argomenti Argomenti del comando di avvio del contenitore. string[]
comando Comando start del contenitore. string[]
Env Variabili di ambiente del contenitore. EnvironmentVar[]
immagine Tag immagine contenitore. corda
nome Nome del contenitore personalizzato. corda
Sonde Elenco di probe per il contenitore. ContainerAppProbe[]
risorse Requisiti delle risorse del contenitore. ContainerResources
volumeMounts Montaggi del volume del contenitore. VolumeMount []

ContainerAppProbe

Nome Descrizione Valore
failureThreshold Errori consecutivi minimi per il probe da considerare non riuscito dopo l'esito positivo. Il valore predefinito è 3. Il valore minimo è 1. Il valore massimo è 10. Int
httpGet HTTPGet specifica la richiesta HTTP da eseguire. ContainerAppProbeHttpGet
initialDelaySeconds Numero di secondi dopo l'avvio del contenitore prima dell'avvio dei probe di attività. Il valore minimo è 1. Il valore massimo è 60. Int
periodSeconds Frequenza (in secondi) per eseguire il probe. Il valore predefinito è 10 secondi. Il valore minimo è 1. Il valore massimo è 240. Int
successThreshold Numero minimo di successi consecutivi che il probe deve essere considerato riuscito dopo aver avuto esito negativo.Minimum consecutive successful for the probe to be consider successful after having failed. Il valore predefinito è 1. Deve essere 1 per la vita e l'avvio. Il valore minimo è 1. Il valore massimo è 10. Int
tcpSocket TCPSocket specifica un'azione che coinvolge una porta TCP. Hook TCP non ancora supportati. ContainerAppProbeTcpSocket
terminationGracePeriodSeconds La durata facoltativa in secondi del pod deve terminare normalmente in caso di errore del probe. Il periodo di tolleranza è la durata in secondi dopo che i processi in esecuzione nel pod vengono inviati un segnale di terminazione e il tempo in cui i processi vengono interrotti forzatamente con un segnale di terminazione. Impostare questo valore più lungo del tempo di pulizia previsto per il processo. Se questo valore è nil, verrà usata la terminazione del podGracePeriodSeconds. In caso contrario, questo valore esegue l'override del valore fornito dalla specifica del pod. Il valore deve essere un numero intero non negativo. Il valore zero indica l'arresto immediato tramite il segnale kill (nessuna opportunità di arresto). Si tratta di un campo alfa e richiede l'abilitazione del controllo delle funzionalità ProbeTerminationGracePeriod. Il valore massimo è 3600 secondi (1 ora) Int
timeoutSeconds Numero di secondi dopo il quale si verifica il timeout del probe. Il valore predefinito è 1 secondo. Il valore minimo è 1. Il valore massimo è 240. Int
digitare Tipo di probe. 'Liveness'
'Idoneità'
'Startup'

ContainerAppProbeHttpGet

Nome Descrizione Valore
ospite Nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. È probabile che si voglia impostare "Host" in httpHeaders. corda
httpHeaders Intestazioni personalizzate da impostare nella richiesta. HTTP consente intestazioni ripetute. ContainerAppProbeHttpGetHttpGetHttpHeadersItem[]
sentiero Percorso di accesso nel server HTTP. corda
porto Nome o numero della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)
schema Schema da usare per la connessione all'host. Il valore predefinito è HTTP. 'HTTP'
'HTTPS'

ContainerAppProbeHttpGetHttpHeadersItem

Nome Descrizione Valore
nome Nome del campo dell'intestazione stringa (obbligatorio)
valore Valore del campo dell'intestazione stringa (obbligatorio)

ContainerAppProbeTcpSocket

Nome Descrizione Valore
ospite Facoltativo: nome host a cui connettersi, per impostazione predefinita viene impostato l'indirizzo IP del pod. corda
porto Numero o nome della porta a cui accedere nel contenitore. Il numero deve essere compreso nell'intervallo compreso tra 1 e 65535. Il nome deve essere un IANA_SVC_NAME. int (obbligatorio)

ContainerAppProperties

Nome Descrizione Valore
configurazione Proprietà di configurazione dell'app contenitore non con controllo delle versioni. configurazione
managedEnvironmentId ID risorsa dell'ambiente dell'app contenitore. corda
sagoma Definizione dell'applicazione con controllo delle versioni dell'app contenitore. modello

ContainerResources

Nome Descrizione Valore
CPU CPU necessaria nei core, ad esempio 0,5 Int
memoria Memoria necessaria, ad esempio "250 Mb" corda

CustomDomain

Nome Descrizione Valore
bindingType Tipo di associazione di dominio personalizzato. 'Disabilitato'
'SniEnabled'
certificateId ID risorsa del certificato da associare a questo nome host. corda
nome Nome host. stringa (obbligatorio)

CustomScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità personalizzata. CustomScaleRuleMetadata
digitare Tipo della regola di scalabilità personalizzata
ad esempio: azure-servicebus, redis e così via.		 corda

CustomScaleRuleMetadata

Nome Descrizione Valore

Dapr

Nome Descrizione Valore
appId Identificatore dell'applicazione Dapr corda
appPort Indica a Dapr quale porta l'applicazione è in ascolto Int
appProtocol Indica a Dapr quale protocollo usa l'applicazione. Le opzioni valide sono http e grpc. Il valore predefinito è http 'grpc'
'http'
Abilitato Valore booleano che indica se l'auto lato Dapr è abilitata Bool

EnvironmentVar

Nome Descrizione Valore
nome Nome della variabile di ambiente. corda
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull del valore della variabile di ambiente. corda
valore Valore della variabile di ambiente non segreto. corda

HttpScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità personalizzata. ScaleRuleAuth[]
metadati Proprietà dei metadati per descrivere la regola di scalabilità HTTP. HttpScaleRuleMetadata

HttpScaleRuleMetadata

Nome Descrizione Valore

Ingresso

Nome Descrizione Valore
allowInsecure Bool che indica se sono consentite le connessioni HTTP a. Se impostato su false connessioni HTTP vengono reindirizzate automaticamente alle connessioni HTTPS Bool
customDomains associazioni di dominio personalizzate per i nomi host di App contenitore. CustomDomain []
esterno Bool che indica se l'app espone un endpoint HTTP esterno Bool
targetPort Porta di destinazione nei contenitori per il traffico proveniente dall'ingresso Int
traffico Pesi del traffico per le revisioni dell'app TrafficWeight[]
trasporto Protocollo di trasporto in ingresso 'auto'
'http'
'http2'

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned). 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentities Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste. UserAssignedIdentities

Microsoft.App/containerApps

Nome Descrizione Valore
identità identità gestite per l'app contenitore per interagire con altri servizi di Azure senza mantenere segreti o credenziali nel codice. ManagedServiceIdentity
ubicazione Posizione geografica in cui risiede la risorsa stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà specifiche della risorsa ContainerApp ContainerAppProperties
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.App/containerApps@2022-03-01"

QueueScaleRule

Nome Descrizione Valore
Auth Segreti di autenticazione per la regola di scalabilità della coda. ScaleRuleAuth[]
queueLength Lunghezza coda. Int
queueName Nome coda. corda

RegistryCredentials

Nome Descrizione Valore
identità Identità gestita da usare per l'autenticazione con Registro Azure Container. Per le identità assegnate dall'utente, usare l'ID risorsa di identità assegnato dall'utente completo. Per le identità assegnate dal sistema, usare 'system' corda
passwordSecretRef Nome del segreto che contiene la password di accesso del Registro di sistema corda
server Server registro contenitori corda
nome utente Nome utente registro contenitori corda

Scala

Nome Descrizione Valore
maxReplicas Opzionale. Numero massimo di repliche di contenitori. Il valore predefinito è 10 se non è impostato. Int
minReplicas Opzionale. Numero minimo di repliche di contenitori. Int
norme Regole di ridimensionamento. ScaleRule []

ScaleRule

Nome Descrizione Valore
azureQueue Ridimensionamento basato su code di Azure. QueueScaleRule
costume Regola di scalabilità personalizzata. CustomScaleRule
http Ridimensionamento basato sulle richieste HTTP. HttpScaleRule
nome Nome regola di scalabilità corda

ScaleRuleAuth

Nome Descrizione Valore
secretRef Nome del segreto dell'app contenitore da cui eseguire il pull dei parametri di autenticazione. corda
triggerParameter Parametro trigger che usa il segreto corda

Segreto

Nome Descrizione Valore
nome Nome segreto. corda
valore Valore segreto. corda

Vincoli:
Valore sensibile. Passare come parametro sicuro.

Sagoma

Nome Descrizione Valore
contenitori Elenco di definizioni di contenitori per l'app contenitore. contenitore []
revisionSuffix Suffisso descrittivo aggiunto al nome della revisione corda
scala Proprietà di ridimensionamento per l'app contenitore. Ridimensionare
Volumi Elenco delle definizioni di volume per l'app contenitore. volume []

TrackedResourceTags

Nome Descrizione Valore

TrafficWeight

Nome Descrizione Valore
etichetta Associa un'etichetta di traffico a una revisione corda
latestRevision Indica che il peso del traffico appartiene a una revisione stabile più recente Bool
revisionName Nome di una revisione corda
peso Peso del traffico assegnato a una revisione Int

UserAssignedIdentities

Nome Descrizione Valore

UserAssignedIdentity

Nome Descrizione Valore

Volume

Nome Descrizione Valore
nome Nome del volume. corda
storageName Nome della risorsa di archiviazione. Non è necessario specificare emptyDir. corda
storageType Tipo di archiviazione per il volume. Se non specificato, usare EmptyDir. 'AzureFile'
'EmptyDir'

VolumeMount

Nome Descrizione Valore
mountPath Percorso all'interno del contenitore in cui deve essere montato il volume. Non deve contenere ':'. corda
volumeName Deve corrispondere al nome di un volume. corda