Microsoft.App managedEnvironments 2022-10-01

Artigo
03/16/2024

Definição de recurso do Bicep

O tipo de recurso managedEnvironments pode ser implementado com operações que visam:

Grupos de recursos – veja os comandos de implementação do grupo de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/managedEnvironments, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.App/managedEnvironments@2022-10-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
  }
  kind: 'string'
  properties: {
    appLogsConfiguration: {
      destination: 'string'
      logAnalyticsConfiguration: {
        customerId: 'string'
        sharedKey: 'string'
      }
    }
    customDomainConfiguration: {
      certificatePassword: 'string'
      certificateValue: any()
      dnsSuffix: 'string'
    }
    daprAIConnectionString: 'string'
    daprAIInstrumentationKey: 'string'
    vnetConfiguration: {
      dockerBridgeCidr: 'string'
      infrastructureSubnetId: 'string'
      internal: bool
      outboundSettings: {
        outBoundType: 'string'
        virtualNetworkApplianceIp: 'string'
      }
      platformReservedCidr: 'string'
      platformReservedDnsIP: 'string'
      runtimeSubnetId: 'string'
    }
    workloadProfiles: [
      {
        maximumCount: int
        minimumCount: int
        workloadProfileType: 'string'
      }
    ]
    zoneRedundant: bool
  }
}

Valores de propriedade

managedEnvironments

Nome	Descrição	Valor
name	O nome do recurso	cadeia (obrigatório)
localização	A localização geográfica onde reside o recurso	cadeia (obrigatório)
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
sku	Propriedades do SKU do Ambiente.	EnvironmentSkuProperties
tipo	Tipo de Ambiente.	string
propriedades	Propriedades específicas do recurso de ambiente gerido	ManagedEnvironmentProperties

ManagedEnvironmentProperties

Nome	Descrição	Valor
appLogsConfiguration	Configuração do cluster que permite a exportação do daemon de registo registos de aplicações para um destino. Atualmente, apenas "log-analytics" é Suportado	AppLogsConfiguration
customDomainConfiguration	Configuração de domínio personalizado para o ambiente	CustomDomainConfiguration
daprAIConnectionString	O Application Insights cadeia de ligação utilizado pelo Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.
daprAIInstrumentationKey	Chave de instrumentação do Azure Monitor utilizada pelo Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.
vnetConfiguration	Configuração da VNet para o ambiente	VnetConfiguration
workloadProfiles	Perfis de carga de trabalho configurados para o Ambiente Gerido.	WorkloadProfile[]
zoneRedundant	Se este Ambiente Gerido tem ou não redundância entre zonas.	bool

AppLogsConfiguration

Nome	Descrição	Valor
destino	O destino dos registos pode ser "log-analytics", "azure-monitor" ou "nenhum"	string
logAnalyticsConfiguration	A configuração do Log Analytics só tem de ser fornecida quando o destino está configurado como "log-analytics"	LogAnalyticsConfiguration

LogAnalyticsConfiguration

Nome	Descrição	Valor
customerId	ID do cliente do Log Analytics	string
sharedKey	Chave de cliente do Log Analytics	string Restrições: Valor sensível. Transmita como um parâmetro seguro.

CustomDomainConfiguration

Nome	Descrição	Valor
certificatePassword	Palavra-passe do certificado	string Restrições: Valor sensível. Transmita como um parâmetro seguro.
certificateValue	Blob PFX ou PEM	Para o Bicep, pode utilizar a função any( ).
dnsSufixo	Sufixo Dns para o domínio de ambiente	string

VnetConfiguration

Nome	Descrição	Valor
dockerBridgeCidr	Intervalo IP de notação CIDR atribuído à ponte do Docker, rede. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
infrastructureSubnetId	ID de recurso de uma sub-rede para componentes de infraestrutura. Esta sub-rede tem de estar na mesma VNET que a sub-rede definida em runtimeSubnetId. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
interno	Valor booleano que indica que o ambiente tem apenas um balanceador de carga interno. Estes ambientes não têm um recurso IP estático público. Têm de fornecer runtimeSubnetId e infrastructureSubnetId se ativar esta propriedade	bool
outboundSettings	Configuração utilizada para controlar o tráfego de saída da Saída do Ambiente	ManagedEnvironmentOutboundSettings
platformReservedCidr	Intervalo de IP na notação CIDR que pode ser reservado para endereços IP de infraestrutura de ambiente. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
platformReservedDnsIP	Um endereço IP do intervalo de IP definido pela plataformaReservedCidr que será reservado para o servidor DNS interno.	string
runtimeSubnetId	Este campo foi preterido e não é utilizado. Se quiser fornecer a sua própria sub-rede na qual os contentores da Container App são injetados, deve tirar partido da infraestruturaSubnetId.	string

ManagedEnvironmentOutboundSettings

Nome	Descrição	Valor
outBoundType	Tipo de saída para o cluster	"LoadBalancer" "UserDefinedRouting"
virtualNetworkApplianceIp	IP da Aplicação Virtual utilizado como controlador de saída para o Ambiente	string

WorkloadProfile

Nome	Descrição	Valor
maximumCount	A capacidade máxima.	int (obrigatório)
minimumCount	A capacidade mínima.	int (obrigatório)
workloadProfileType	Tipo de perfil de carga de trabalho para as cargas de trabalho serem executadas.	cadeia (obrigatório)

EnvironmentSkuProperties

Nome	Descrição	Valor
name	Nome do SKU.	"Consumo" "Premium" (obrigatório)

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo	Description
Cria uma Aplicação de Contentor e Um Ambiente com o Registo	Crie um Ambiente de Aplicação de Contentor com uma Aplicação de Contentor básica a partir de um Azure Container Registry. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria duas Container App com um Ambiente de Aplicação de Contentor	Crie um Ambiente de Duas Aplicações de Contentor com uma Aplicação de Contentor básica. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria uma Aplicação de Contentor dentro de um Ambiente de Aplicação de Contentor	Crie um Ambiente de Aplicação de Contentor com uma Aplicação de Contentor básica. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria uma Aplicação de Contentor com uma regra de dimensionamento HTTP definida	Crie um Ambiente de Aplicação de Contentor com uma Aplicação de Contentor básica que seja dimensionada com base no tráfego HTTP.
Cria um ambiente externo da Aplicação de Contentor com uma VNET	Cria um ambiente externo da Aplicação de Contentor com uma VNET.
Cria um ambiente interno da Aplicação de Contentor com uma VNET	Cria um ambiente interno da Aplicação de Contentor com uma VNET.

Definição de recurso de modelo do ARM

O tipo de recurso managedEnvironments pode ser implementado com operações que visam:

Grupos de recursos – veja comandos de implementação de grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/managedEnvironments, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.App/managedEnvironments",
  "apiVersion": "2022-10-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string"
  },
  "kind": "string",
  "properties": {
    "appLogsConfiguration": {
      "destination": "string",
      "logAnalyticsConfiguration": {
        "customerId": "string",
        "sharedKey": "string"
      }
    },
    "customDomainConfiguration": {
      "certificatePassword": "string",
      "certificateValue": {},
      "dnsSuffix": "string"
    },
    "daprAIConnectionString": "string",
    "daprAIInstrumentationKey": "string",
    "vnetConfiguration": {
      "dockerBridgeCidr": "string",
      "infrastructureSubnetId": "string",
      "internal": "bool",
      "outboundSettings": {
        "outBoundType": "string",
        "virtualNetworkApplianceIp": "string"
      },
      "platformReservedCidr": "string",
      "platformReservedDnsIP": "string",
      "runtimeSubnetId": "string"
    },
    "workloadProfiles": [
      {
        "maximumCount": "int",
        "minimumCount": "int",
        "workloadProfileType": "string"
      }
    ],
    "zoneRedundant": "bool"
  }
}

Valores de propriedade

managedEnvironments

Nome	Descrição	Valor
tipo	O tipo de recurso	'Microsoft.App/managedEnvironments'
apiVersion	A versão da API de recursos	'2022-10-01'
name	O nome do recurso	cadeia (obrigatório)
localização	A localização geográfica onde o recurso se encontra	cadeia (obrigatório)
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
sku	Propriedades de SKU do Ambiente.	EnvironmentSkuProperties
tipo	Tipo de Ambiente.	string
propriedades	Propriedades específicas do recurso de ambiente gerido	ManagedEnvironmentProperties

ManagedEnvironmentProperties

Nome	Descrição	Valor
appLogsConfiguration	Configuração do cluster que permite a exportação do daemon de registo registos de aplicações para um destino. Atualmente, apenas "log-analytics" é Suportado	AppLogsConfiguration
customDomainConfiguration	Configuração de domínio personalizado para o ambiente	CustomDomainConfiguration
daprAIConnectionString	O Application Insights cadeia de ligação utilizado pela Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor sensível. Transmita como um parâmetro seguro.
daprAIInstrumentationKey	Chave de instrumentação do Azure Monitor utilizada pela Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor sensível. Transmita como um parâmetro seguro.
vnetConfiguration	Configuração da Vnet para o ambiente	VnetConfiguration
workloadProfiles	Perfis de carga de trabalho configurados para o Ambiente Gerido.	WorkloadProfile[]
zoneRedundant	Se este Ambiente Gerido tem ou não redundância entre zonas.	bool

AppLogsConfiguration

Nome	Descrição	Valor
destino	O destino dos registos pode ser "log-analytics", "azure-monitor" ou "none"	string
logAnalyticsConfiguration	A configuração do Log Analytics só tem de ser fornecida quando o destino estiver configurado como "log-analytics"	LogAnalyticsConfiguration

LogAnalyticsConfiguration

Nome	Descrição	Valor
customerId	ID do cliente do Log Analytics	string
sharedKey	Chave de cliente do Log Analytics	string Restrições: Valor sensível. Transmita como um parâmetro seguro.

CustomDomainConfiguration

Nome	Descrição	Valor
certificatePassword	Palavra-passe do certificado	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.
certificateValue	Blob PFX ou PEM
dnsSuffix	Sufixo DNS para o domínio de ambiente	string

VnetConfiguration

Nome	Descrição	Valor
dockerBridgeCidr	Intervalo de IP de notação CIDR atribuído à ponte do Docker, rede. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
infrastructureSubnetId	ID de recurso de uma sub-rede para componentes de infraestrutura. Esta sub-rede tem de estar na mesma VNET que a sub-rede definida em runtimeSubnetId. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
interno	Valor booleano que indica que o ambiente tem apenas um balanceador de carga interno. Estes ambientes não têm um recurso de IP estático público. Têm de fornecer runtimeSubnetId e infrastructureSubnetId se ativar esta propriedade	bool
outboundSettings	Configuração utilizada para controlar o tráfego de saída de Saída do Ambiente	ManagedEnvironmentOutboundSettings
platformReservedCidr	Intervalo de IP na notação CIDR que pode ser reservado para endereços IP de infraestrutura de ambiente. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
platformReservedDnsIP	Um endereço IP do intervalo de IP definido por platformReservedCidr que será reservado para o servidor DNS interno.	string
runtimeSubnetId	Este campo foi preterido e não é utilizado. Se quiser fornecer a sua própria sub-rede na qual os contentores das Container Apps são injetados, deve tirar partido da infraestruturaSubnetId.	string

ManagedEnvironmentOutboundSettings

Nome	Descrição	Valor
outBoundType	Tipo de saída para o cluster	"LoadBalancer" "UserDefinedRouting"
virtualNetworkApplianceIp	IP da Aplicação Virtual utilizado como controlador de saída para o Ambiente	string

WorkloadProfile

Nome	Descrição	Valor
maximumCount	A capacidade máxima.	int (obrigatório)
minimumCount	A capacidade mínima.	int (obrigatório)
workloadProfileType	Tipo de perfil de carga de trabalho para as cargas de trabalho serem executadas.	cadeia (obrigatório)

EnvironmentSkuProperties

Nome	Descrição	Valor
name	Nome do SKU.	"Consumo" "Premium" (obrigatório)

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo	Description
Cria uma Aplicação de Contentor e um Ambiente com o Registo	Crie um Ambiente de Aplicação de Contentor com uma Aplicação de Contentor básica a partir de um Azure Container Registry. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria uma aplicação de contentor com um Ambiente de Aplicação de Contentor	Crie um Ambiente de Duas Container Apps com uma Aplicação de Contentor básica. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria uma Aplicação de Contentor num Ambiente de Aplicação de Contentor	Crie um Ambiente de Aplicação de Contentor com uma Aplicação de Contentor básica. Também implementa uma Área de Trabalho do Log Analytics para armazenar registos.
Cria uma Aplicação de Contentor com uma regra de dimensionamento HTTP definida	Crie um Ambiente de Container App com uma Aplicação de Contentor básica que seja dimensionada com base no tráfego HTTP.
Cria um ambiente externo das Container Apps com uma VNET	Cria um ambiente externo da Aplicação de Contentor com uma VNET.
Cria um ambiente interno das Container Apps com uma VNET	Cria um ambiente interno das Container Apps com uma VNET.

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso managedEnvironments pode ser implementado com operações que visam:

Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.App/managedEnvironments, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/managedEnvironments@2022-10-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      appLogsConfiguration = {
        destination = "string"
        logAnalyticsConfiguration = {
          customerId = "string"
          sharedKey = "string"
        }
      }
      customDomainConfiguration = {
        certificatePassword = "string"
        dnsSuffix = "string"
      }
      daprAIConnectionString = "string"
      daprAIInstrumentationKey = "string"
      vnetConfiguration = {
        dockerBridgeCidr = "string"
        infrastructureSubnetId = "string"
        internal = bool
        outboundSettings = {
          outBoundType = "string"
          virtualNetworkApplianceIp = "string"
        }
        platformReservedCidr = "string"
        platformReservedDnsIP = "string"
        runtimeSubnetId = "string"
      }
      workloadProfiles = [
        {
          maximumCount = int
          minimumCount = int
          workloadProfileType = "string"
        }
      ]
      zoneRedundant = bool
    }
    sku = {
      name = "string"
    }
    kind = "string"
  })
}

Valores de propriedade

managedEnvironments

Nome	Descrição	Valor
tipo	O tipo de recurso	"Microsoft.App/managedEnvironments@2022-10-01"
name	O nome do recurso	cadeia (obrigatório)
localização	A localização geográfica onde reside o recurso	cadeia (obrigatório)
parent_id	Para implementar num grupo de recursos, utilize o ID desse grupo de recursos.	cadeia (obrigatório)
etiquetas	Etiquetas de recursos.	Dicionário de nomes e valores de etiquetas.
sku	Propriedades do SKU do Ambiente.	EnvironmentSkuProperties
tipo	Tipo de Ambiente.	string
propriedades	Propriedades específicas do recurso de ambiente gerido	ManagedEnvironmentProperties

ManagedEnvironmentProperties

Nome	Descrição	Valor
appLogsConfiguration	Configuração do cluster que permite a exportação do daemon de registo registos de aplicações para um destino. Atualmente, apenas "log-analytics" é Suportado	AppLogsConfiguration
customDomainConfiguration	Configuração de domínio personalizado para o ambiente	CustomDomainConfiguration
daprAIConnectionString	O Application Insights cadeia de ligação utilizado pelo Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.
daprAIInstrumentationKey	Chave de instrumentação do Azure Monitor utilizada pelo Dapr para exportar a telemetria de comunicação do Serviço para o Serviço	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.
vnetConfiguration	Configuração da VNet para o ambiente	VnetConfiguration
workloadProfiles	Perfis de carga de trabalho configurados para o Ambiente Gerido.	WorkloadProfile[]
zoneRedundant	Se este Ambiente Gerido tem ou não redundância entre zonas.	bool

AppLogsConfiguration

Nome	Descrição	Valor
destino	O destino dos registos pode ser "log-analytics", "azure-monitor" ou "nenhum"	string
logAnalyticsConfiguration	A configuração do Log Analytics só tem de ser fornecida quando o destino está configurado como "log-analytics"	LogAnalyticsConfiguration

LogAnalyticsConfiguration

Nome	Descrição	Valor
customerId	ID do cliente do Log Analytics	string
sharedKey	Chave de cliente do Log Analytics	string Restrições: Valor confidencial. Transmita como um parâmetro seguro.

CustomDomainConfiguration

Nome	Descrição	Valor
certificatePassword	Palavra-passe do certificado	string Restrições: Valor sensível. Transmita como um parâmetro seguro.
certificateValue	Blob PFX ou PEM
dnsSufixo	Sufixo Dns para o domínio de ambiente	string

VnetConfiguration

Nome	Descrição	Valor
dockerBridgeCidr	Intervalo IP de notação CIDR atribuído à ponte do Docker, rede. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
infrastructureSubnetId	ID de recurso de uma sub-rede para componentes de infraestrutura. Esta sub-rede tem de estar na mesma VNET que a sub-rede definida em runtimeSubnetId. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
interno	Valor booleano que indica que o ambiente tem apenas um balanceador de carga interno. Estes ambientes não têm um recurso IP estático público. Têm de fornecer runtimeSubnetId e infrastructureSubnetId se ativar esta propriedade	bool
outboundSettings	Configuração utilizada para controlar o tráfego de saída da Saída do Ambiente	ManagedEnvironmentOutboundSettings
platformReservedCidr	Intervalo de IP na notação CIDR que pode ser reservado para endereços IP de infraestrutura de ambiente. Não pode sobrepor-se a outros intervalos de IP fornecidos.	string
platformReservedDnsIP	Um endereço IP do intervalo de IP definido pela plataformaReservedCidr que será reservado para o servidor DNS interno.	string
runtimeSubnetId	Este campo foi preterido e não é utilizado. Se quiser fornecer a sua própria sub-rede na qual os contentores da Container App são injetados, deve tirar partido da infraestruturaSubnetId.	string

ManagedEnvironmentOutboundSettings

Nome	Descrição	Valor
outBoundType	Tipo de saída para o cluster	"LoadBalancer" "UserDefinedRouting"
virtualNetworkApplianceIp	IP da Aplicação Virtual utilizado como controlador de saída para o Ambiente	string

WorkloadProfile

Nome	Descrição	Valor
maximumCount	A capacidade máxima.	int (obrigatório)
minimumCount	A capacidade mínima.	int (obrigatório)
workloadProfileType	Tipo de perfil de carga de trabalho para as cargas de trabalho serem executadas.	cadeia (obrigatório)

EnvironmentSkuProperties

Nome	Descrição	Valor
name	Nome do SKU.	"Consumo" "Premium" (obrigatório)

Partilhar via

Microsoft.App managedEnvironments 2022-10-01

Definição de recurso do Bicep

Formato do recurso

Valores de propriedade

managedEnvironments

ManagedEnvironmentProperties

AppLogsConfiguration

LogAnalyticsConfiguration

CustomDomainConfiguration

VnetConfiguration

ManagedEnvironmentOutboundSettings

WorkloadProfile

EnvironmentSkuProperties

Modelos de início rápido

Definição de recurso de modelo do ARM

Formato do recurso

Valores de propriedade

managedEnvironments

ManagedEnvironmentProperties

AppLogsConfiguration

LogAnalyticsConfiguration

CustomDomainConfiguration

VnetConfiguration

ManagedEnvironmentOutboundSettings

WorkloadProfile

EnvironmentSkuProperties

Modelos de início rápido

Definição de recurso terraform (fornecedor AzAPI)

Formato do recurso

Valores de propriedade

managedEnvironments

ManagedEnvironmentProperties

AppLogsConfiguration

LogAnalyticsConfiguration

CustomDomainConfiguration

VnetConfiguration

ManagedEnvironmentOutboundSettings

WorkloadProfile

EnvironmentSkuProperties

Comentários

Comentários

Recursos adicionais