Compartilhar via


Guia de início rápido: Executar um contêiner personalizado no Azure

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. 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. Eles permitem que os desenvolvedores personalizem totalmente os contêineres e concedam aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Este início rápido mostra como 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.

Pré-requisitos

  • Instalar o Docker for Windows

  • Alternar o Docker para executar contêineres do Windows

  • Instale o Visual Studio 2022 com as cargas de trabalho de desenvolvimento do ASP.NET e para a Web e desenvolvimento do Azure. No Visual Studio 2022 Community, verifique se o componente de modelos de projeto e item do .NET Framework está selecionado com ASP.NET e carga de trabalho de desenvolvimento da Web. Se você já instalou o Visual Studio 2022:

    • Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>Verificar Atualizações.
    • Adicione as cargas de trabalho no Visual Studio selecionando Ferramentas>Obter Ferramentas e Recursos.

Criar um aplicativo Web ASP .NET

Crie um aplicativo Web ASP.NET seguindo estas etapas:

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

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

    Captura de tela da caixa de diálogo Criar um novo projeto.

  3. Em Configurar seu novo projeto, na opção Nome do projeto, dê ao aplicativo o nome myfirstazurewebapp. Em Estrutura, selecione .NET Framework 4.8 e escolha Criar.

    Captura de tela de Configure o projeto de aplicativo Web.

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

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

    Captura de tela da caixa de diálogo Criar ASP.NET Aplicativo Web.

  6. Se o arquivo Dockerfile não for aberto automaticamente, abra-o no Gerenciador de Soluções.

  7. Você precisa de uma imagem pai com suporte. Altere a imagem pai, substituindo a linha FROM pelo código a seguir 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 do 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 projeto myfirstazurewebapp e selecione Publicar.

  2. Em Destino, selecione Registro de Contêiner do Docker e clique em Avançar.

    Captura da tela Selecionar Registro de Contêiner do Docker.

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

    Captura de tela da página de visão geral Publicar com base no projeto.

  4. Em Publicar, escolha a assinatura correta. Nos registros de contêiner, selecione Criar novo para criar um novo Registro de Contêiner do Azure.

    Captura da tela Criar Registro de Contêiner do Azure.

  5. Em Criar novo, selecione a assinatura correta. Em Grupo de recursos, selecione Novo, digite myResourceGroup no nome e clique em OK. Em SKU, selecione Básico. Em Local do registro, selecione um local para o registro e escolha Criar.

    Captura da tela dos detalhes do Registro de Contêiner do Azure.

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

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

    Aguarde até que a implantação seja concluída. Agora, a página Publicar mostra o nome do repositório. Selecione o botão copiar para copiar o nome do Repositório para uso posterior.

    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. Escolha 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, escolha sua assinatura e um 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 Sistema Operacional, selecione Windows.

    Captura da tela Criar um Aplicativo Web para Contêineres.

  6. Selecione Avançar: Banco de Dados e, em seguida, Próximo: Contêiner para continuar.

  7. Para Origem da Imagem, escolha Docker Hub e, para Imagem e marca, insira o nome do repositório que você copiou em Publicar no Registro de Contêiner do Azure.

    Captura de tela de Configurar seu aplicativo Web para contêineres.

    Se você tiver uma imagem personalizada em outro lugar para seu aplicativo Web, como no Registro de Contêiner do Azure ou em outro repositório privado, configure-a aqui. Selecione Examinar + criar para continuar.

  8. Verifique todos os detalhes e selecione Criar.

    Captura de tela de 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 de implantação bem-sucedida.

  1. Selecione Ir para o recurso.

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

Uma nova página do navegador é aberta na seguinte página:

Captura da tela de um contêiner personalizado do Windows sendo iniciado.

Aguarde alguns minutos e tente novamente, até chegar à home page padrão do ASP.NET:

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

Parabéns! Você está executando seu primeiro contêiner personalizado do Windows no Serviço de Aplicativo do Azure.

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, navegue até a URL a seguir, substituindo <nome_do_aplicativo> pelo nome do 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, em Gerenciador de Soluções, abra Exibições>Início>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 implantar novamente no Azure, clique com o botão direito do mouse no projeto myfirstazurewebapp no Gerenciador de Soluções e escolha Publicar.

  4. Na página de publicação, selecione Publicar e aguarde até que a publicação seja concluída.

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

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

Procure o contêiner personalizado novamente. À medida que você atualiza a página da Web, o aplicativo deve reverter para a página "Iniciando" no início e, em seguida, exibir a página da Web atualizada.

Captura de tela do 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 ao excluir o grupo de recursos.

No menu do portal do Azure ou na Página inicial, selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

O Serviço de Aplicativo do Azure no Linux fornece pilhas de aplicativos predefinidas no Linux com suporte para idiomas como .NET, Java, Node.js e 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. Este guia de início rápido mostra como implantar uma imagem de um ACR (Registro de Contêiner do Azure) para o Serviço de Aplicativo.

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 em 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 como Habilitar ao criar o registro de contêiner do Azure. Você também pode defini-la na seção Chaves de acesso da página do registro no portal do Azure. Essa configuração é necessária para o acesso ao Serviço de Aplicativo. Para identidade gerenciada, confira Implantar do tutorial do ACR.

Entrada

  1. Inicie o Visual Studio Code.

  2. Selecione o logotipo do Azure na Barra de Atividades, navegue até ACCOUNTS &TENANTS. Selecione Entrar no Azure e siga as instruções.

    Captura de tela da entrada no Azure no Visual Studio Code.

  3. Na barra de status na parte inferior, confirme o endereço de email da conta do Azure. No gerenciador do SERVIÇO DE APLICATIVO, sua assinatura deve ser exibida.

  4. Na Barra de Atividades, selecione o logotipo do Docker. No gerenciador REGISTROS, 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. O comando a seguir exibe a versão do Docker se ela estiver em execução.

docker --version

Criar e build imagens

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

    Neste Dockerfile, 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 Imagens do Docker: Build Imagem. 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 compilar, selecione Atualizar na parte superior do gerenciador de IMAGES e verifique se a imagem foi criada com êxito.

    Captura de que tela mostra a imagem criada com a marca.

Implantar para registro de contêiner

  1. Na Barra de Atividades, selecione o ícone do Docker. No gerenciador de IMAGENS, encontre a imagem criada.

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

  3. Certifique-se de que a marca da imagem começa com <acr-name>.azurecr.io e pressione Enter.

  4. Quando o Visual Studio Code terminar de enviar a imagem por push para o registro de contêiner, selecione Atualizar na parte superior do Gerenciador de REGISTRIES 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 REGISTRIES, expanda a imagem, clique com o botão direito do mouse na marca e clique em Implantar imagem no Serviço de Aplicativo do Azure.
  2. Siga os prompts para escolher uma assinatura, um nome de aplicativo exclusivo globalmente, um grupo de recursos e um plano do Serviço de Aplicativo. Escolha B1 Básico para o tipo de preço e uma região próxima de 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 seu 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 que serão usados para hospedar seu site. Este início rápido usa um plano Básico de hospedagem na infraestrutura do Linux, o que significa que o site está hospedado em um computador Linux junto com outros sites. Se você começar com o plano Básico, poderá usar o portal do Azure para aumentá-lo para que o seu seja o único site em execução em um computador. Para obter os preços, confira Preços do Serviço de Aplicativo.

Procurar no site

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

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.

No menu do portal do Azure ou na Página inicial, selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Parabéns, você concluiu com êxito este início rápido!

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.

Outras extensões 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.js e 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. Este guia de início rápido mostra como implantar uma imagem do Registro de Contêiner do Azure no Serviço de Aplicativo.

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

Pré-requisitos

Clone o repositório de amostra

Clone o aplicativo de exemplo .NET 6.0 com 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 arquivo Dockerfile.linux.

  1. Entrar 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 da imagem dotnetcore-docs-hello-world-linux.

    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 sobre como configurar o contêiner, confira Configurar contêiner personalizado.

Implantar no Azure

Entre no portal do Azure

Entre no portal do Azure.

Criar recursos do Azure

  1. Digite serviços de aplicativos na pesquisa. Em Serviços, selecione Serviços de Aplicativos.

    Captura de tela da pesquisa por 'serviços de aplicativo' no portal do Azure.

  2. Na página Serviços de Aplicativos, selecione Criar>Aplicativo Web.

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

    Captura de tela da seção Detalhes do projeto mostrando onde você seleciona a assinatura do Azure e o grupo de recursos do aplicativo Web.

  4. Em Detalhes da instância:

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

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

  5. Em Plano do Serviço de Aplicativo, selecione Criar um Plano do Serviço de Aplicativo. Insira myAppServicePlan para o nome. Para alterar para a camada Gratuita, selecione Alterar tamanho, selecione a guia Desenvolvimento/Teste, selecione F1. Escolha Aplicar.

    Captura de tela das opções de plano do Serviço de Aplicativo.

  6. Na parte superior da página, selecione a guia Contêiner.

  7. 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 seu Registro de Contêiner do Azure.
    • Imagem: selecione dotnetcore-docs-hello-world-linux.
    • Marca: selecione a mais recente.

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

  8. Selecione Revisar + criar na parte inferior da página.

    Captura de tela mostrando o botão Examinar e criar na parte inferior da página.

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

  10. Depois que a implantação for concluída, marque Ir para o recurso.

    Captura de tela mostrando a próxima etapa de 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 mostrando o aplicativo implantado.

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.

No menu do portal do Azure ou na Página inicial, selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Parabéns, você concluiu com êxito este início rápido!

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se você recompilar sua imagem, basta empurrá-la 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.

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. 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. Eles permitem que os desenvolvedores personalizem totalmente os contêineres e concedam aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Este guia de início rápido mostra como implantar um aplicativo ASP.NET em uma imagem do Windows do Registro de Contêiner do Azure no Serviço de Aplicativo do Azure.

Pré-requisitos

Clone o repositório de amostra

Clone o aplicativo de exemplo .NET 6.0 com 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 arquivo Dockerfile.windows. Este artigo usa o LTSC (Canal de Manutenção de Longo Prazo) do Windows Nano Server 2022 como o sistema operacional base, chamando explicitamente nossa 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. Entrar 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 da imagem dotnetcore-docs-hello-world-windows.

    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 sobre como configurar o contêiner, confira Configurar contêiner personalizado.

Implantar no Azure

Entre no portal do Azure

Entre no portal do Azure.

Criar recursos do Azure

  1. Digite serviços de aplicativos na pesquisa. Em Serviços, selecione Serviços de Aplicativos.

    Captura de tela da pesquisa por 'serviços de aplicativo' no portal do Azure.

  2. Na página Serviços de Aplicativos, selecione Criar>Aplicativo Web.

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

    Captura de tela da seção Detalhes do projeto mostrando onde você seleciona a assinatura do Azure e o grupo de recursos do aplicativo Web.

  4. Em Detalhes da instância:

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

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

  5. Em Plano do Serviço de Aplicativo, selecione Criar um Plano do Serviço de Aplicativo. Insira myAppServicePlan para o nome. Para alterar a camada, selecione Explorar planos de preços, selecione um plano e escolha Selecionar na parte inferior da página.

    Captura de tela das opções de plano do Serviço de Aplicativo.

  6. Na parte superior da página, selecione a guia Contêiner.

  7. 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 seu Registro de Contêiner do Azure.
    • Imagem: selecione dotnetcore-docs-hello-world-linux.
    • Marca: selecione a mais recente.

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

  8. Selecione Revisar + criar na parte inferior da página.

    Captura de tela mostrando o botão Examinar e criar na parte inferior da página.

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

  10. Depois que a implantação for concluída, marque Ir para o recurso.

    Captura de tela mostrando a próxima etapa de 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 do Serviço de Windows App com mensagens que contêineres sem uma porta exposta são executados no modo em segundo plano.

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

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.

No menu do portal do Azure ou na Página inicial, selecione Grupos de recursos. Em seguida, na página Grupos de recursos, selecione myResourceGroup.

Na página myResourceGroup, certifique-se de que os recursos listados são aqueles que deseja excluir.

Selecione Excluir grupo de recursos, digite myResourceGroup na caixa de texto para confirmar e selecione Excluir.

Parabéns, você concluiu com êxito este início rápido!

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se você recompilar sua imagem, basta empurrá-la 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.

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. 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. Eles permitem que os desenvolvedores personalizem totalmente os contêineres e concedam aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Este guia de início rápido mostra como implantar um aplicativo ASP.NET em uma imagem do Windows do Registro de Artefato da Microsoft no Serviço de Aplicativo do Azure.

Pré-requisitos

Conectar-se ao Azure

Entre em sua conta do Azure usando o comando Connect-AzAccount 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 no local eastus. Para ver todos os locais com suporte para o Serviço de Aplicativo, execute o comando Get-AzLocation.

New-AzResourceGroup -Name myResourceGroup -Location eastus

O comando retorna Login Succeeded.

Criar seu Plano do Serviço de Aplicativo

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

O exemplo a seguir cria um Plano do Serviço de Aplicativo chamado myAppServicePlan no tipo de preço 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 seu aplicativo Web

Crie um novo aplicativo usando o comando New-AzWebApp:

New-AzWebApp -Name myWebApp -AppServicePlan myAppServicePlan -Location eastus -ResourceGroupName myResourceGroup -ContainerImageName mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • O parâmetro Name especifica o nome do aplicativo Web.
  • O parâmetro AppServicePlan especifica o nome do Plano do Serviço de Aplicativo.
  • O parâmetro Location especifica a localização.
  • O parâmetro ResourceGroupName especifica o nome do Grupo de Recursos.
  • O parâmetro ContainerImageName especifica um nome da 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 do Serviço de Windows App com mensagens que contêineres sem uma porta exposta são executados no modo em segundo plano.

Limpar os recursos

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

Remove-AzResourceGroup myResourceGroup

Parabéns, você concluiu com êxito este início rápido!

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se você recompilar sua imagem, basta empurrá-la 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.

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. 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. Eles permitem que os desenvolvedores personalizem totalmente os contêineres e concedam aos aplicativos em contêiner acesso total à funcionalidade do Windows.

Este guia de início rápido mostra como implantar um aplicativo ASP.NET em uma imagem do Windows do Registro de Artefato da Microsoft no Serviço de Aplicativo do Azure.

Pré-requisitos

Conectar-se ao Azure

Entre em sua conta do Azure usando o comando az login e seguindo o prompt:

az login

Criar um grupo de recursos

Crie um grupo de recursos com o comando az group create. 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 no local eastus. Para ver todos os locais com suporte para o Serviço de Aplicativo, execute o comando az appservice list-locations.

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 seguinte exemplo cria um Plano do Serviço de Aplicativo chamado myAppServicePlan no tipo de preço 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 extensão appservice-kube.

Criar seu 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 (os caracteres válidos são a-z, 0-9 e -).

az webapp create --name myContainerApp --plan myAppServicePlan --resource-group myResourceGroup --deployment-container-image-name mcr.microsoft.com/azure-app-service/windows/parkingpage:latest
  • O parâmetro Name especifica o nome do aplicativo Web.
  • O parâmetro AppServicePlan especifica o nome do Plano do Serviço de Aplicativo.
  • O parâmetro Location especifica a localização.
  • O parâmetro ResourceGroupName especifica o nome do Grupo de Recursos.
  • O parâmetro deployment-container-image-name 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 do Serviço de Windows App com mensagens que contêineres sem uma porta exposta são executados no modo em segundo plano.

Limpar os recursos

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

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

Parabéns, você concluiu com êxito este início rápido!

O aplicativo do Serviço de Aplicativo é retirado do registro de contêiner sempre que ele é iniciado. Se você recompilar sua imagem, basta empurrá-la 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.