Criar um Ambiente do Serviço de Aplicativo usando um modelo do Azure Resource Manager

O Ambiente do Serviço de Aplicativo pode ser criado usando um modelo do Azure Resource Manager que permite que você faça uma implantação repetível.

Descrição geral

O Ambiente do Serviço de Aplicativo do Azure pode ser criado com um ponto de extremidade acessível pela Internet ou um ponto de extremidade em um endereço interno em uma Rede Virtual do Azure. Quando criado com um ponto de extremidade interno, esse ponto de extremidade é fornecido por um componente do Azure chamado ILB (balanceador de carga interno). O Ambiente do Serviço de Aplicativo em um endereço IP interno é chamado de ILB ASE. O Ambiente do Serviço de Aplicativo com um ponto de extremidade público é chamado de ASE Externo.

Um ASE pode ser criado usando o portal do Azure ou um modelo do Azure Resource Manager. Este artigo descreve as etapas e a sintaxe necessárias para criar um ASE externo ou ILB ASE com modelos do Gerenciador de Recursos. Saiba como criar um Ambiente do Serviço de Aplicativo no portal do Azure.

Ao criar um Ambiente do Serviço de Aplicativo no portal do Azure, você pode criar sua rede virtual ao mesmo tempo ou escolher uma rede virtual pré-existente para implantar.

Ao criar um Ambiente do Serviço de Aplicativo a partir de um modelo, você deve começar com:

• Uma Rede Virtual do Azure.
• Uma sub-rede nessa rede virtual. Recomendamos um tamanho de sub-rede com 256 endereços para acomodar as necessidades futuras de /24 crescimento e escala. Depois que o Ambiente do Serviço de Aplicativo for criado, não será possível alterar o tamanho.
• O local em que você deseja implantar.

Configurando o ambiente do Serviço de Aplicativo

O modelo básico do Gerenciador de Recursos que cria um Ambiente do Serviço de Aplicativo tem esta aparência:

{
    "type": "Microsoft.Web/hostingEnvironments",
    "apiVersion": "2022-03-01",
    "name": "[parameters('aseName')]",
    "location": "[resourceGroup().location]",
    "kind": "ASEV3",
    "properties": {
        "internalLoadBalancingMode": "Web, Publishing",
        "virtualNetwork": {
            "id": "[parameters('subnetResourceId')]"
        },
        "networkingConfiguration": { },
        "customDnsSuffixConfiguration": { }
    },
    "identity": {
        "type": "SystemAssigned"
    }
}

Além das propriedades principais, há outras opções de configuração que você pode usar para configurar seu Ambiente do Serviço de Aplicativo.

• nome: Obrigatório. Este parâmetro define um nome exclusivo do Ambiente do Serviço de Aplicativo. O nome não deve ter mais de 36 caracteres.
• virtualNetwork -> id: Obrigatório. Especifica a ID do recurso da sub-rede. A sub-rede deve estar vazia e delegada a Microsoft.Web/hostingEnvironments
• internalLoadBalancingMode: Obrigatório. Na maioria dos casos, defina essa propriedade como "Web, Publishing", o que significa que tanto o tráfego HTTP/HTTPS quanto o tráfego FTP estão em um VIP interno (Internal Load Balancer). Se esta propriedade estiver definida como "Nenhum", todo o tráfego permanecerá no VIP público (External Load Balancer).
• zoneRedundant: Opcional. Define com true/false se o Ambiente do Serviço de Aplicativo será implantado em Zonas de Disponibilidade (AZ). Para obter mais informações, consulte Regiões e zonas de disponibilidade.
• dedicatedHostCount: Opcional. Na maioria dos casos, defina essa propriedade como 0 ou ficou de fora. Você pode defini-lo como 2 se quiser implantar seu Ambiente do Serviço de Aplicativo com isolamento de hardware físico em hosts dedicados.
• upgradePreference: Opcional. Define se a atualização é iniciada automaticamente ou se é dada uma janela de 15 dias para iniciar a implantação. Os valores válidos são "Nenhum", "Cedo", "Tarde", "Manual". Mais informações sobre a preferência de atualização.
• clusterSettings: Opcional. Para obter mais informações, consulte Configurações de cluster.
• networkingConfiguration -> allowNewPrivateEndpointConnections: Opcional. Para obter mais informações, consulte Configuração de rede.
• networkingConfiguration -> remoteDebugEnabled: Opcional. Para obter mais informações, consulte Configuração de rede.
• networkingConfiguration -> ftpEnabled: Opcional. Para obter mais informações, consulte Configuração de rede.
• networkingConfiguration -> inboundIpAddressOverride: Opcional. Permitir que você crie um Ambiente do Serviço de Aplicativo com seu próprio endereço IP público do Azure (especifique a ID do recurso) ou defina um IP estático para implantações ILB. Essa configuração não pode ser alterada após a criação do Ambiente do Serviço de Aplicativo.
• customDnsSuffixConfiguration: Opcional. Permite especificar um sufixo de domínio personalizado para o Ambiente do Serviço de Aplicativo. Requer um certificado válido de um Cofre de Chaves e acesso usando uma Identidade Gerenciada. Para obter mais informações sobre os parâmetros específicos, consulte sufixo de domínio personalizado de configuração.

Implantando o ambiente do Serviço de Aplicativo

Depois de criar o modelo ARM, por exemplo, chamado azuredeploy.json e, opcionalmente, um arquivo de parâmetros, por exemplo, chamado azuredeploy.parameters.json, você pode criar o Ambiente do Serviço de Aplicativo usando o trecho de código da CLI do Azure. Altere os caminhos de arquivo para corresponder aos locais de arquivo de modelo do Resource Manager em sua máquina. Lembre-se de fornecer seu próprio valor para o nome do grupo de recursos:

templatePath="PATH/azuredeploy.json"
parameterPath="PATH/azuredeploy.parameters.json"

az deployment group create --resource-group "YOUR-RG-NAME-HERE" --template-file $templatePath --parameters $parameterPath

A criação do Ambiente do Serviço de Aplicativo geralmente leva cerca de uma hora, mas se for um Ambiente do Serviço de Aplicativo redundante de zona ou se estivermos enfrentando uma demanda inesperada em uma região, o processo de criação pode levar várias horas para ser concluído.

Próximos passos