Compartilhar via


Início Rápido: executar um contêiner personalizado no Azure

Neste início rápido, você aprenderá a implantar um aplicativo ASP.NET em uma imagem do Windows no Registro de Contêiner do Azure do Visual Studio. O aplicativo é executado em um contêiner personalizado no Serviço de Aplicativo do Azure.

O Serviço de Aplicativo do Azure fornece pilhas de aplicativos predefinidos no Windows que são executadas no IIS (Serviços de Informações da Internet). Essas pilhas de aplicativos pré-configuradas bloqueiam o sistema operacional e impedem o acesso de baixo nível.

Contêineres personalizados do Windows não têm essas restrições. Os desenvolvedores podem usar contêineres personalizados para fornecer aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Pré-requisitos

Se você já instalou o Visual Studio 2022:

  • Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>para verificar se há atualizações.
  • Adicione os workloads no Visual Studio selecionando Ferramentas>Obter Ferramentas e Recursos.

Criar um aplicativo Web ASP .NET

  1. Abra o Visual Studio e selecione Criar um novo projeto.

  2. Em Criar um novo projeto, selecione ASP.NET Aplicativo Web (.NET Framework) e C#selecione Avançar.

    Captura de tela que mostra a caixa de diálogo Criar um novo projeto.

  3. Em Configurar o nome do projeto novo>, nomeie o aplicativomyfirstazurewebapp. No Framework, selecione .NET Framework 4.8 e, em seguida, selecione Criar.

    Captura de tela que mostra Configurar seu projeto de aplicativo Web.

  4. Você pode implantar qualquer tipo de aplicativo Web ASP.NET no Azure. Para este início rápido, selecione o modelo MVC .

  5. Em Autenticação, selecione Nenhum. Em Avançado, selecione Suporte ao contêiner e desmarque Configurar para HTTPS. Selecione Criar.

    Captura de tela que mostra a caixa de diálogo Criar Aplicativo Web ASP.NET.

  6. Se o Dockerfile não abrir automaticamente, abra-o selecionando o Gerenciador de Soluções.

  7. Você precisa de uma imagem pai com suporte. Altere a imagem pai substituindo a linha FROM pelo seguinte código e salve o arquivo:

    FROM mcr.microsoft.com/dotnet/framework/aspnet:4.8-windowsservercore-ltsc2019
    
  8. No menu do Visual Studio, selecione Depurar>Iniciar sem Depuração para executar o aplicativo Web localmente.

    Captura de tela que mostra o aplicativo em execução localmente.

Publicar no Registro de Contêiner do Azure

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no myfirstazurewebapp projeto e selecione Publicar.

  2. No Destino, selecione o Registro de Contêiner do Docker e, em seguida, selecione Avançar.

    Captura de tela que mostra a tela Selecionar Registro de Contêiner do Docker.

  3. Em Destino Específico, selecione Registro de Contêiner do Azure e selecione Avançar.

    Captura de tela que mostra o painel Publicar da visão geral do projeto.

  4. Em Publicar, selecione a assinatura correta. Para criar um novo registro de contêiner, selecione Criar novo em registros de contêiner.

    Captura de tela que mostra a tela Criar novo Registro de Contêiner do Azure.

  5. Em Criar novo, selecione a assinatura correta. Em Grupo de recursos, selecione Novo e digite myResourceGroup o nome. Depois, selecione OK. Em SKU, selecione Básico. No local do Registro, selecione um local para o registro e, em seguida, selecione Criar.

    Captura de tela que mostra os detalhes do Registro de Contêiner do Azure.

  6. Em Publicar, em Registro de Contêiner, selecione o registro que você criou e selecione Concluir.

    Captura de tela mostrando a tela Selecionar Registro de Contêiner do Azure existente.

    Aguarde a conclusão da implantação. O painel Publicar agora mostra o nome do repositório. Selecione o botão Copiar para copiar o nome do Repositório para mais tarde.

    Captura de tela que realça o nome do repositório.

Criar um contêiner personalizado do Windows

  1. Entre no portal do Azure.

  2. Selecione Criar um recurso no canto superior esquerdo do portal do Azure.

  3. Em Serviços Populares, selecione Criar em Aplicativo Web.

  4. Em Criar Aplicativo Web, selecione sua assinatura e grupo de recursos. Você pode criar um novo grupo de recursos, se necessário.

  5. Forneça um nome de aplicativo, como win-container-demo. Para Publicar, selecione Contêiner. Para o Sistema Operacional, selecione Windows.

    Captura de tela que mostra como criar um aplicativo Web para contêineres.

  6. Selecione Avançar: Banco de Dados>Avançar: Contêiner.

  7. Para a origem da imagem, selecione o Hub do Docker. Para Imagem e tag, insira o nome do repositório que você copiou anteriormente em Publicar no Registro de Contêiner do Azure.

    Captura de tela que mostra como configurar seu aplicativo Web para contêineres.

    Se você tiver uma imagem personalizada para seu aplicativo Web em outro local, como no Registro de Contêiner do Azure ou em qualquer outro repositório privado, você poderá configurá-la aqui. Selecione Examinar + criar.

  8. Verifique todos os detalhes e selecione Criar.

    Captura de tela que mostra como criar seu aplicativo Web para contêineres.

    Aguarde até que o Azure crie os recursos necessários.

Procurar o contêiner personalizado

Quando a operação é concluída, o portal do Azure exibe uma notificação.

Captura de tela que mostra a implantação bem-sucedida.

  1. Selecione Ir para o recurso.

  2. Na visão geral, siga o link ao lado do domínio Padrão.

Uma nova página do navegador é aberta.

Captura de tela que mostra um contêiner personalizado do Windows iniciando.

Aguarde alguns minutos e tente novamente. Continue tentando até obter a página inicial padrão do ASP.NET.

Captura de tela que mostra um contêiner personalizado do Windows em execução.

Conferir logs de inicialização do contêiner

Pode levar algum tempo para que o contêiner do Windows seja carregado. Para ver o progresso, vá para a URL a seguir substituindo \<app_name> pelo nome do seu aplicativo.

https://<app_name>.scm.azurewebsites.net/api/logstream

Os logs transmitidos têm esta aparência:

2018-07-27T12:03:11  Welcome, you are now connected to log-streaming service.
27/07/2018 12:04:10.978 INFO - Site: win-container-demo - Start container succeeded. Container: facbf6cb214de86e58557a6d073396f640bbe2fdec88f8368695c8d1331fc94b
27/07/2018 12:04:16.767 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.017 INFO - Site: win-container-demo - Container start complete
27/07/2018 12:05:05.020 INFO - Site: win-container-demo - Container started successfully

Atualizar localmente e reimplantar

  1. No Visual Studio, vá para o Gerenciador de Soluções. Selecione Views>Home>Index.cshtml.

  2. Encontre o rótulo HTML <div class="jumbotron"> próximo à parte superior e substitua o elemento inteiro pelo seguinte código:

    <div class="jumbotron">
        <h1>ASP.NET in Azure!</h1>
        <p class="lead">This is a simple app that we've built that demonstrates how to deploy a .NET app to Azure App Service.</p>
    </div>
    
  3. Para reimplantar no Azure, clique com o botão direito do mouse no projeto myfirstazurewebapp no Gerenciador de Soluções e selecione Publicar.

  4. No painel de publicação, selecione Publicar e aguarde a conclusão da publicação.

  5. Para informar ao Serviço de Aplicativo que ele deve obter a nova imagem do Docker Hub, reinicie o aplicativo. No painel do aplicativo no portal do Azure, selecione Reiniciar>Sim.

    Captura de tela que mostra a Visão geral do Serviço de Aplicativo com o botão Reiniciar realçado.

  6. Navegue novamente até o contêiner personalizado. À medida que você atualiza a página, o aplicativo deve primeiro reverter para a página Inicial. Em seguida, ele deve exibir a página atualizada.

    Captura de tela que mostra o aplicativo Web atualizado no Azure.

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 excluindo o grupo de recursos:

  1. No menu do portal do Azure ou na home page, selecione Grupos de recursos>myResourceGroup.

  2. No painel myResourceGroup , verifique se os recursos listados são os que você deseja excluir.

  3. Selecione Excluir grupo de recursos. Digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Neste guia de início rápido, você aprenderá como implantar uma imagem do Registro de Contêiner do Azure no Serviço de Aplicativo do Azure.

O Serviço de Aplicativo no Linux fornece pilhas de aplicativos predefinidas no Linux com suporte para idiomas como .NET, Java, Node.jse PHP. Também é possível usar uma imagem personalizada do Docker para executar seu aplicativo Web em uma pilha de aplicativos que ainda não foi definida no Azure.

Para obter mais informações sobre aplicativos em contêineres em um ambiente sem servidor, consulte aplicativos de contêiner.

Pré-requisitos

Criar um registro de contêiner

Este início rápido usa o Registro de Contêiner do Azure como registro. Você pode usar outros registros, mas as etapas podem ser ligeiramente diferentes.

Crie um registro de contêiner seguindo as instruções no Início Rápido: Criar um registro de contêiner privado usando o portal do Azure.

Importante

Certifique-se de definir a opção De usuário administrador para Habilitar ao criar o registro de contêiner. Você também pode configurá-lo na seção de Chaves de Acesso do seu painel de Registro no portal do Azure. Você precisa dessa configuração para acessar o Serviço de Aplicativo. Para obter uma identidade gerenciada, consulte Implantar do Registro de Contêiner do Azure.

Entrar

  1. Abra o VS Code.

  2. Selecione o logotipo do Azure na barra de atividades e vá para ACCOUNTS &TENANTS. Selecione Entrar no Azure e siga as instruções.

    Captura de tela que mostra como entrar no Azure no VS Code.

  3. Na barra de status na parte inferior, verifique se o endereço de email da sua conta do Azure está correto. Sua assinatura deve ser exibida no explorador do SERVIÇO DE APLICATIVO.

  4. Na barra de atividades, selecione o logotipo do Docker . No explorador REGISTRIES , verifique se o registro de contêiner criado é exibido.

    Captura de tela que mostra o valor dos Registros com o Azure expandido.

Verificar pré-requisitos

Verifique se o Docker está instalado e em execução. Se o Docker estiver em execução, o seguinte comando exibirá a versão do Docker:

docker --version

Criar e build imagens

  1. No VS Code, abra uma pasta vazia e adicione um arquivo chamado Dockerfile. No arquivo, cole o conteúdo com base na estrutura de idioma desejada:

    Neste arquivo, a imagem pai é um dos contêineres .NET internos do Serviço de Aplicativo.

    FROM mcr.microsoft.com/appsvc/dotnetcore:lts
    
    ENV PORT 8080
    EXPOSE 8080
    
    ENV ASPNETCORE_URLS "http://*:${PORT}"
    
    ENTRYPOINT ["dotnet", "/defaulthome/hostingstart/hostingstart.dll"]
    
  2. Abra a paleta de comandos e digite Docker Images: Build Image. Selecione Enter para executar o comando.

  3. Na caixa de marca de imagem, especifique a marca que deseja no seguinte formato: <acr-name>.azurecr.io/<image-name>:<tag>, em que <acr-name> é o nome do registro de contêiner que você criou. Selecione Enter.

  4. Quando a imagem terminar de construir, selecione Atualizar na parte superior do explorador de IMAGENS e verifique se a imagem foi criada com êxito.

    Captura de tela que mostra a imagem construída com tag.

Implantar para registro de contêiner

  1. Na barra de atividades, selecione o ícone do Docker . No gerenciador de IMAGENS , localize a imagem que você criou.

  2. Expanda a imagem, clique com o botão direito do mouse na marca desejada e selecione Push.

  3. Verifique se a marca de imagem começa com <acr-name>.azurecr.io e selecione Enter.

  4. Quando o VS Code terminar de enviar a imagem por push para o registro de contêiner, selecione Atualizar na parte superior do Gerenciador de REGISTROS e verifique se a imagem foi enviada por push com êxito.

    Captura de tela que mostra a imagem implantada no Registro de Contêiner do Azure.

Implantar no Serviço de Aplicativo

  1. No Gerenciador de REGISTROS , expanda a imagem, clique com o botão direito do mouse na marca e selecione Implantar Imagem no Serviço de Aplicativo do Azure.
  2. Siga os prompts para selecionar uma assinatura, um nome de aplicativo globalmente exclusivo, um grupo de recursos e um plano do Serviço de Aplicativo. Selecione B1 Basic para o tipo de preço e uma região próxima a você.

Após a implantação, seu aplicativo estará disponível em http://<app-name>.azurewebsites.net.

Um grupo de recursos é uma coleção nomeada de todos os recursos do aplicativo no Azure. Por exemplo, um grupo de recursos pode conter uma referência a um site, um banco de dados e uma função do Azure.

Um plano do Serviço de Aplicativo define os recursos físicos a serem usados para hospedar seu site. Este início rápido usa o plano básico de hospedagem na infraestrutura do Linux, o que significa que o site está hospedado em um computador Linux ao lado de outros sites. Se você começar com o plano Básico, poderá usar o portal do Azure para escalar verticalmente para que um computador execute apenas seu site. Para obter preços, consulte os preços do Serviço de Aplicativo.

Procurar no site

O painel Saída mostra o status das operações de implantação. Quando a operação for concluída, selecione Abrir Site na notificação pop-up para abrir o site no navegador.

O aplicativo do Serviço de Aplicativo efetua pull do registro de contêiner sempre que ele é iniciado. Se você recriar a imagem, só precisará e fazer push dela para o registro de contêiner e o aplicativo efetuará o pull quando for reiniciado. Para dizer ao aplicativo para efetuar pull da imagem atualizada imediatamente, reinicie-o.

Para solucionar problemas, acesse Encontrei um Problema.

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 excluindo o grupo de recursos:

  1. No menu do portal do Azure ou na home page, selecione Grupos de recursos>myResourceGroup.

  2. No painel myResourceGroup , verifique se os recursos listados são os que você deseja excluir.

  3. Selecione Excluir grupo de recursos. Digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Outras extensões do Azure:

Neste início rápido, você aprenderá a implantar uma imagem do Registro de Contêiner do Azure no Serviço de Aplicativo do Azure.

O Serviço de Aplicativo do Azure no Linux fornece pilhas de aplicativos predefinidas no Linux com suporte para idiomas como .NET, Java, Node.jse PHP. Também é possível usar uma imagem personalizada do Docker para executar seu aplicativo Web em uma pilha de aplicativos que ainda não foi definida no Azure.

Para obter mais informações sobre aplicativos em contêineres em um ambiente sem servidor, consulte a visão geral dos Aplicativos de Contêiner do Azure.

Pré-requisitos

Clone o repositório de amostra

Clone o aplicativo de exemplo do .NET 6.0 usando o seguinte comando:

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

Enviar a imagem por push ao Registro de Contêiner do Azure

Verifique se você está na pasta raiz do repositório clonado, que contém um Dockerfile.linux arquivo.

  1. Entre na CLI do Azure.

    az login
    
  2. Entre no Registro de Contêiner do Azure.

    az acr login -n <your_registry_name>
    
  3. Compile a imagem de contêiner. Este exemplo usa o nome dotnetcore-docs-hello-world-linuxda imagem.

    docker build -f Dockerfile.linux -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux . 
    
  4. Envie por push a imagem de contêiner para o Registro de Contêiner do Azure.

    docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-linux:latest
    

    Observação

    O Dockerfile define o número da porta como 80 internamente. Para obter mais informações, vá para Configurar contêiner personalizado.

Implantar no Azure

  1. Entre no portal do Azure.

  2. Digite serviços de aplicativo na pesquisa. Em Serviços, selecione Serviços de Aplicativo.

    Captura de tela que mostra como pesquisar serviços de aplicativo no portal do Azure.

  3. No painel Serviços de Aplicativo , selecione Criar>Aplicativo Web.

  4. Na guia Noções básicas , em detalhes do Projeto, selecione a assinatura correta. Para criar um novo grupo de recursos, selecione Criar novo. Digite myResourceGroup para o nome.

    Captura de tela que mostra a seção de detalhes do projeto em que você seleciona a assinatura do Azure e o grupo de recursos do aplicativo Web.

  5. Em Detalhes da instância:

    • Insira um nome exclusivo globalmente para o aplicativo Web.
    • Selecione Contêiner.
    • Para o Sistema Operacional, selecione Linux.
    • Em Região, selecione a região na qual você planeja atender seu aplicativo.

    Captura de tela que mostra a seção de detalhes da instância em que você fornece um nome para a máquina virtual e seleciona sua região, imagem e tamanho.

  6. Em Plano do Serviço de Aplicativo, selecione Criar novo. Insira myAppServicePlan para o nome. Para alterar para a camada Gratuita, selecione Alterar tamanho>Dev/Teste>F1>Aplicar.

    Captura de tela que mostra as opções de plano.

  7. Na parte superior do painel, selecione a guia Contêiner .

  8. Na guia Contêiner , para Fonte de Imagem, selecione Registro de Contêiner do Azure. Nas Opções do Registro de Contêiner do Azure, defina os seguintes valores:

    • Registro: selecione o registro de contêiner.
    • Imagem: selecione dotnetcore-docs-hello-world-linux.
    • Marca: selecione o mais recente.

    Captura de tela que mostra as opções do Registro de Contêiner do Azure.

  9. Selecione Examinar + criar na parte inferior do painel.

    Captura de tela que mostra o botão na parte inferior do painel.

  10. Após a execução da validação, selecione Criar.

  11. Após a conclusão da implantação, selecione Acessar o recurso.

    Captura de tela que mostra o botão para ir para o recurso.

Navegar até o aplicativo

Navegue até o aplicativo implantado no navegador da Web na URL http://<app-name>.azurewebsites.net.

Captura de tela que mostra o aplicativo implantado.

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se recompilar a imagem, transmita-a para o registro de contêiner. O aplicativo efetua pull na imagem atualizada quando é reiniciado. Para dizer ao aplicativo para efetuar pull da imagem atualizada imediatamente, reinicie-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 excluindo o grupo de recursos:

  1. No menu do portal do Azure ou na home page, selecione Grupos de recursos>myResourceGroup.

  2. No painel myResourceGroup , verifique se os recursos listados são os que você deseja excluir.

  3. Selecione Excluir grupo de recursos. Digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Neste guia de início rápido, você aprenderá a implantar um aplicativo ASP.NET em uma imagem do Windows do Azure Container Registry para o Azure App Service.

O Serviço de Aplicativo do Azure fornece pilhas de aplicativos predefinidas no Windows, como ASP.NET ou Node.js, que são executadas no IIS (Serviços de Informações da Internet). Essas pilhas de aplicativos pré-configuradas bloqueiam o sistema operacional e impedem o acesso de baixo nível.

Contêineres personalizados do Windows não têm essas restrições. Os desenvolvedores podem usar contêineres personalizados para fornecer aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Pré-requisitos

Clone o repositório de amostra

Clone o aplicativo de exemplo do .NET 6.0 usando o seguinte comando:

git clone https://github.com/Azure-Samples/dotnetcore-docs-hello-world.git

Enviar a imagem por push ao Registro de Contêiner do Azure

Verifique se você está na pasta raiz do repositório clonado. Esse repositório contém um Dockerfile.windows arquivo. Este artigo usa o Canal de Manutenção em Longo Prazo Windows Nano Server 2022 como sistema operacional base e chama explicitamente a base do Windows.

Observação

Mesmo que esse contêiner seja um contêiner do Windows, os caminhos ainda precisam usar barras avançadas. Para obter mais informações, consulte Gravar um Dockerfile.

  1. Entre na CLI do Azure.

    az login
    
  2. Entre no Registro de Contêiner do Azure.

    az acr login -n <your_registry_name>
    
  3. Compile a imagem de contêiner. Este exemplo usa o nome dotnetcore-docs-hello-world-windowsda imagem.

    docker build -f Dockerfile.windows -t <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows . 
    
  4. Envie por push a imagem de contêiner para o Registro de Contêiner do Azure.

    docker push <your_registry_name>.azurecr.io/dotnetcore-docs-hello-world-windows:latest
    

    Observação

    O Dockerfile define o número da porta como 80 internamente. Para obter mais informações, consulte Configurar contêiner personalizado.

Implantar no Azure

  1. Entre no portal do Azure.

  2. Insira os serviços de aplicativo na caixa de pesquisa. Em Serviços, selecione Serviços de Aplicativo.

    Captura de tela que mostra como pesquisar serviços de aplicativo no portal do Azure.

  3. Nos Serviços de Aplicativo, selecione Criar>Aplicativo Web.

  4. Na guia Noções básicas , em detalhes do Projeto, selecione a assinatura correta. Selecione Criar novo. Insira myResourceGroup como o nome.

    Captura de tela que mostra a seção Detalhes do Projeto em que você seleciona a assinatura do Azure e o grupo de recursos do aplicativo Web.

  5. Em Detalhes da instância:

    • Insira um nome exclusivo globalmente para o aplicativo Web.
    • Selecione Contêiner.
    • Para o Sistema Operacional, selecione Linux.
    • Para Região, selecione a região da qual você deseja atender seu aplicativo.

    Captura de tela que mostra a seção Detalhes da Instância em que você fornece um nome para a máquina virtual e seleciona sua região, imagem e tamanho.

  6. Em Plano do Serviço de Aplicativo, selecione Criar novo. Insira myAppServicePlan como nome. Para alterar a camada, selecione Explorar planos de preços, selecione um plano e escolha Selecionar na parte inferior do painel.

    Captura de tela que mostra as opções de plano do Serviço de Aplicativo.

  7. Na parte superior do painel, selecione a guia Contêiner .

  8. Na guia Contêiner , para Fonte de Imagem, selecione Registro de Contêiner do Azure. Nas Opções do Registro de Contêiner do Azure, defina os seguintes valores:

    • Registro: selecione o registro de contêiner.
    • Imagem: selecione dotnetcore-docs-hello-world-linux.
    • Marca: selecione o mais recente.

    Captura de tela que mostra as opções do Registro de Contêiner do Azure.

  9. Selecione Examinar + criar na parte inferior do painel.

    Captura de tela que mostra o botão Examinar e criar na parte inferior do painel.

  10. Após a execução da validação, selecione Criar.

  11. Após a conclusão da implantação, selecione Acessar o recurso.

    Captura de tela que mostra como ir para o recurso.

Vá para o aplicativo

Vá para o aplicativo implantado no navegador da Web na URL http://<app-name>.azurewebsites.net.

Captura de tela que mostra o Serviço de Aplicativo do Windows.

O sistema operacional host aparece no rodapé, o que confirma que o aplicativo é executado em um contêiner do Windows.

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se recompilar a imagem, transmita-a para o registro de contêiner. O aplicativo efetua pull na imagem atualizada quando é reiniciado. Para dizer ao aplicativo para efetuar pull da imagem atualizada imediatamente, reinicie-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 excluindo o grupo de recursos:

  1. No menu do portal do Azure ou na home page, selecione Grupos de recursos>myResourceGroup.

  2. No painel myResourceGroup , verifique se os recursos listados são os que você deseja excluir.

  3. Selecione Excluir grupo de recursos. Digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Nesta introdução rápida, você aprenderá a implantar um aplicativo ASP.NET em uma imagem do Windows do Registro de Artefatos da Microsoft para o Serviço de Aplicativo do Azure.

O Serviço de Aplicativo do Azure fornece pilhas de aplicativos predefinidos no Windows que são executadas no IIS (Serviços de Informações da Internet). As pilhas de aplicativos pré-configuradas bloqueiam o sistema operacional e impedem o acesso de baixo nível.

Contêineres personalizados do Windows não têm essas restrições. Os desenvolvedores podem usar contêineres personalizados para fornecer aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Pré-requisitos

Conectar-se ao Azure

Entre em sua conta do Azure usando o Connect-AzAccount comando e seguindo o prompt:

Connect-AzAccount

Criar um grupo de recursos

Crie um grupo de recursos com o comando New-AzResourceGroup. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.

O exemplo a seguir cria um grupo de recursos chamado myResourceGroup na localização eastus. Para ver todos os locais com suporte para o Serviço de Aplicativo, execute o Get-AzLocation comando.

New-AzResourceGroup -Name myResourceGroup -Location eastus

O comando retorna Login Succeeded.

Criar seu plano do Serviço de Aplicativo

Crie um novo plano do Serviço de Aplicativo usando o New-AzAppServicePlan comando.

O exemplo a seguir cria um plano do Serviço de Aplicativo chamado myAppServicePlan na camada de preços PremiumV3 (-Tier PremiumV3). O parâmetro -HyperV especifica o contêiner do Windows.

New-AzAppServicePlan -Name myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -Tier PremiumV3 -HyperV

Criar o aplicativo Web

Crie um novo aplicativo usando o New-AzWebApp comando:

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • O Name parâmetro especifica o nome do aplicativo Web.
  • O AppServicePlan parâmetro especifica o nome do plano do Serviço de Aplicativo.
  • O Location parâmetro especifica o local.
  • O ResourceGroupName parâmetro especifica o nome do grupo de recursos.
  • O ContainerImageName parâmetro especifica um nome de imagem de contêiner e uma marca opcional.

O comando pode levar alguns minutos para ser concluído.

Navegar até o aplicativo

Navegue até o aplicativo implantado no navegador da Web na URL http://<app-name>.azurewebsites.net.

Captura de tela que mostra o Serviço de Aplicativo do Windows.

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se recompilar a imagem, transmita-a para o registro de contêiner. O aplicativo efetua pull na imagem atualizada quando é reiniciado. Para dizer ao aplicativo para efetuar pull da imagem atualizada imediatamente, reinicie-o.

Limpar os recursos

Remova o grupo de recursos usando o Remove-AzResourceGroup comando:

Remove-AzResourceGroup myResourceGroup

Nesta introdução rápida, você aprenderá a implantar um aplicativo ASP.NET em uma imagem do Windows do Registro de Artefatos da Microsoft para o Serviço de Aplicativo do Azure.

O Serviço de Aplicativo do Azure fornece pilhas de aplicativos predefinidos no Windows que são executadas no IIS (Serviços de Informações da Internet). Essas pilhas de aplicativos pré-configuradas bloqueiam o sistema operacional e impedem o acesso de baixo nível.

Contêineres personalizados do Windows não têm essas restrições. Os desenvolvedores podem usar contêineres personalizados para fornecer aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Pré-requisitos

Conectar-se ao Azure

Entre em sua conta do Azure. Use o az login comando e siga o prompt:

az login

Criar um grupo de recursos

Crie um grupo de recursos usando o az group create comando. Um grupo de recursos do Azure é um contêiner lógico no qual os recursos do Azure são implantados e gerenciados.

O exemplo a seguir cria um grupo de recursos chamado myResourceGroup na localização eastus. Para ver todos os locais com suporte para o Serviço de Aplicativo, execute o az appservice list-locations comando.

az group create --name myResourceGroup --location eastus

Criar seu plano do Serviço de Aplicativo

Crie um Plano do Serviço de Aplicativo no grupo de recursos com o comando az appservice plan create.

O exemplo a seguir cria um plano do Serviço de Aplicativo nomeado myAppServicePlan na camada de preços P1V3 (--sku P1V3).

az appservice plan create --resource-group myResourceGroup --location eastus --name myAppServicePlan --hyper-v --sku p1v3

Observação

Se você encontrar o erro "O comportamento desse comando foi alterado pela seguinte extensão: appservice-kube", remova a appservice-kube extensão.

Criar o aplicativo Web

Crie um aplicativo Web de contêiner personalizado no plano do Serviço de Aplicativo myAppServicePlan com o comando az webapp create. Não se esqueça de substituir myContainerApp por um nome de aplicativo exclusivo (caracteres válidos são a-z, 0-9e -).

az webapp create --name myContainerApp --plan myAppServicePlan --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • O Name parâmetro especifica o nome do aplicativo Web.
  • O AppServicePlan parâmetro especifica o nome do plano do Serviço de Aplicativo.
  • O Location parâmetro especifica o local.
  • O ResourceGroupName parâmetro especifica o nome do grupo de recursos.
  • O deployment-container-image-name parâmetro especifica um nome de imagem de contêiner e uma marca opcional.

Navegar até o aplicativo

Navegue até o aplicativo implantado no navegador da Web na URL http://<app-name>.azurewebsites.net.

Captura de tela que mostra o Serviço de Aplicativo do Windows.

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se recompilar a imagem, transmita-a para o registro de contêiner. O aplicativo efetua pull na imagem atualizada quando é reiniciado. Para dizer ao aplicativo para efetuar pull da imagem atualizada imediatamente, reinicie-o.

Limpar os recursos

Remova o grupo de recursos usando o az group delete comando:

az group delete --no-wait --name <resource_group>