Implantar Instância Gerenciada no Serviço de Aplicativo do Azure

A Instância Gerenciada no Serviço de Aplicativo do Azure combina a simplicidade da plataforma como um serviço com a flexibilidade do controle em nível de infraestrutura. Instância Gerenciada é projetada para aplicações que exigem personalização do sistema operacional, redes privadas e integração segura com os serviços do Azure.

Neste início rápido, você concluirá as seguintes etapas:

1. Use o Azure Developer CLI para implantar recursos de exemplo.
2. Crie uma Instância Gerenciada no Serviço de Aplicativo do Azure.
3. Implantar um aplicativo de exemplo.
4. Verifique a implantação.

Pré-requisitos

• Conta do Azure: você precisa de uma conta do Azure com uma assinatura ativa. Se você ainda não tiver uma, poderá criar uma conta gratuitamente.

• Identidade gerenciada

• Início Rápido: Carregar, baixar e listar blobs com o portal do Azure

• Script opcional de configuração (instalação): Este quickstart usa um script PowerShell nomeado Install.ps1 em um arquivo .zip comprimido para instalar fontes. Scripts de configuração não são obrigatórios para a Instância Gerenciada. Use um script de configuração quando sua aplicação exigir dependências, papéis, funcionalidades ou configurações em nível de sistema operacional, ou mudanças persistentes que seriam perdidas após o reinício de uma instância. Use RDP para diagnósticos em vez de configuração persistente.

Implantar recursos de exemplo

Você pode implantar rapidamente todos os recursos necessários nesse quickstart usando o Azure Developer CLI (AZD). O modelo do AZD usado neste início rápido é proveniente de exemplos do Azure.

mkdir managed-instance-quickstart
cd managed-instance-quickstart
azd init --template https://github.com/Azure-Samples/managed-instance-azure-app-service-quickstart.git .
azd env set AZURE_LOCATION northeurope
azd up

O comando azd up realiza as seguintes ações:

1. Cria uma identidade gerenciada atribuída ao usuário.
2. Cria um Armazenamento do Azure Blob.
3. Atribui a identidade gerenciada ao contêiner de armazenamento e ao plano de Instância Gerenciada.
4. Concede acesso para Storage-Blob-Data-Contributor no contêiner de armazenamento.
5. Compacta fontes incluídas e Install.ps1 em scripts.zip.
6. Carregue scripts.zip no contêiner de armazenamento.

O código do PowerShell a seguir é o script de configuração (instalação) usado no modelo.

# Install.ps1 - Copy and register fonts on Managed Instance
Write-Host "Installing custom fonts on Managed Instance..." -ForegroundColor Green

# Copy all TTF and OTF fonts to Windows Fonts folder and register them
Get-ChildItem -Recurse -Include *.ttf, *.otf | ForEach-Object {
    $FontFullName = $_.FullName
    $FontName = $_.BaseName + " (TrueType)"
    $Destination = "$env:windir\Fonts\$($_.Name)"

    Write-Host "Installing font: $($_.Name)"
    Copy-Item $FontFullName -Destination $Destination -Force
    New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts" -Name $FontName -PropertyType String -Value $_.Name -Force | Out-Null
}

Write-Host "Font installation completed." -ForegroundColor Green

A saída final de azd up deve ser semelhante ao exemplo a seguir.

=== Deployment Complete ===
Storage Account: stgpjqep6fdlfv6
Container Name: scripts
Managed Identity Client name: id-gpjqep6fdlfv6
Resource Group: rg-managed-instance

Os valores para Storage Account, Container Name, Managed Identity Client name, Resource Group e Script URI são usados posteriormente.

Implantar um plano de Instância Gerenciada

Siga estas etapas para criar um plano de Instância Gerenciada e implantar um aplicativo nele:

az deployment group create \
  --resource-group "<resource-group-name>" \
  --template-file infra/app-service-plan-managed-instance.json \
  --parameters \
    location="<location>" \
    appServicePlanName="<plan-name>" \
    userAssignedIdentityResourceId="<identity-id>" \
    installScriptSourceUri="<script-URI>" \
    skuName=P1V4 \
    skuCapacity=1

az webapp create \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --plan "<plan-name>" \
  --runtime "ASPNET:V4.8"

az webapp identity assign \
  --name "<app-name>" \
  --resource-group "<resource-group-name>" \
  --identities "<identity-id>"

Implantar um aplicativo de exemplo na Instância Gerenciada

Nesta etapa, você usará o Cloud Shell para implantar um aplicativo de exemplo que foi incluído no modelo do AZD na Instância Gerenciada.

• O comando a seguir implanta o aplicativo Web em seu plano de Instância Gerenciada. Atualize <app-name> e <resource-group> com os seus valores.

az webapp deploy \
  --resource-group "<resource-group-name>" \
  --name "<app-name>" \
  --src-path app.zip \
  --type zip

Navegar até o aplicativo

Para navegar até o aplicativo criado, selecione o domínio padrão na página Visão geral .

O aplicativo .NET está em execução em um plano de Instância Gerenciada. O aplicativo usa fontes do diretório C:\Windows\Fonts.

Gerenciar o plano de Instância Gerenciada

Para gerenciar o aplicativo Web, acesse o portal do Azure e procure e selecione Serviços de Aplicativos.

Na página Serviços de Aplicativos, selecione o nome do seu aplicativo Web.

Na página Visão geral, selecione o nome do plano do Serviço de Aplicativo. No Plano do Serviço de Aplicativo atual, selecione o nome do plano.

No menu à esquerda em Configurações, selecione Configuração para exibir os detalhes da configuração.

Limpar os recursos

Nas etapas anteriores, você criou os recursos do Azure em um grupo de recursos. Se você não espera precisar desses recursos no futuro, poderá excluí-los ao excluir o grupo de recursos.

az group delete

Conteúdo relacionado

• Configurar a Instância Gerenciada
• Visão geral do Serviço de Aplicativo
• Segurança no Serviço de Aplicativo
• Comparação do Ambiente do Serviço de Aplicativo