Partilhar via


Guia de início rápido: Docker no Visual Studio

Com o Visual Studio, você pode facilmente criar, depurar e executar aplicativos .NET, ASP.NET e ASP.NET Core em contêineres e publicá-los no Registro de Contêiner do Azure, no Hub do Docker, no Serviço de Aplicativo do Azure ou em seu próprio Registro de Contêiner. Neste artigo, publicaremos um aplicativo ASP.NET Core no Registro de Contêiner do Azure.

Pré-requisitos

Instalação e configuração

Para a instalação do Docker, primeiro revise as informações em Docker Desktop para Windows: O que saber antes de instalar o. Em seguida, instale Docker Desktop.

Adicionar um projeto a um contêiner do Docker

  1. Crie um novo projeto usando o modelo de do ASP.NET Core Web App ou se quiser usar o .NET Framework em vez do .NET Core, escolha ASP.NET Aplicativo Web (.NET Framework).

  2. No ecrã Criar nova aplicação Web, verifique se a caixa de seleção Ativar Suporte Docker está selecionada.

    Captura de tela da caixa de seleção Ativar suporte ao Docker.

    A captura de tela mostra o .NET Core; se você estiver usando o .NET Framework, ele terá uma aparência um pouco diferente.

  3. Selecione o tipo de contêiner desejado (Windows ou Linux) e clique em Criar.

Visão geral do Dockerfile

Um Dockerfile, a receita para criar uma imagem final do Docker, é criado no projeto. Consulte a referência do Dockerfile para entender os comandos dentro dele.

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/core/sdk:3.1 AS build
WORKDIR /src
COPY ["WebApplication1/WebApplication1.csproj", "WebApplication1/"]
RUN dotnet restore "WebApplication1/WebApplication1.csproj"
COPY . .
WORKDIR "/src/WebApplication1"
RUN dotnet build "WebApplication1.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "WebApplication1.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "WebApplication1.dll"]

O Dockerfile de anterior é baseado na imagem dotnet/core/aspnet e inclui instruções para modificar a imagem base criando seu projeto e adicionando-o ao contêiner. Se você estiver usando o .NET Framework, a imagem base será diferente.

Quando a caixa de seleção Configurar para HTTPS do novo projeto estiver marcada, o Dockerfile expõe duas portas. Uma porta é usada para tráfego HTTP; a outra porta é usada para HTTPS. Se a caixa de seleção não estiver marcada, uma única porta (80) será exposta para o tráfego HTTP.

Depurar

Selecione do Docker na lista suspensa de depuração na barra de ferramentas e comece a depurar o aplicativo. Você pode ver uma mensagem com um prompt sobre como confiar em um certificado; Escolha confiar no certificado para continuar.

A opção Ferramentas de Contêiner na janela de saída mostra quais ações estão ocorrendo. Na primeira vez, pode demorar um pouco para baixar a imagem base, mas é muito mais rápido em execuções subsequentes.

Observação

Se você precisar alterar as portas para depuração, poderá fazer isso no arquivo launchSettings.json. Consulte Configurações de inicialização do contêiner.

Janela de Contentores

Se você tiver o Visual Studio 2019 versão 16.4 ou posterior, poderá usar a janela Containers para exibir contêineres em execução em sua máquina, bem como as imagens disponíveis.

Abra a janela Contentores usando a caixa de pesquisa no IDE (pressione Ctrl+Q para a usar), digite containere escolha a janela Contentores na lista.

Você pode posicionar a janela do Containers em um local conveniente, como abaixo do editor, movendo-a e seguindo as guias de posicionamento da janela.

Na janela, localize o seu contêiner e navegue por cada separador para visualizar as variáveis de ambiente, configurações de portas, logs e o sistema de ficheiros.

Captura de tela da janela Contêineres.

Para obter mais informações, consulte janela Usar os contêineres.

Publicar imagens do Docker

Quando o ciclo de desenvolvimento e depuração do aplicativo estiver concluído, você poderá criar uma imagem de produção do aplicativo.

  1. Altere a lista suspensa de configuração para Release e compile a aplicação.

  2. Clique com o botão direito do rato no seu projeto no Gerenciador de Soluções e escolha Publicar.

  3. Na caixa de diálogo Publicar, selecione o separador Registo de Contentores do Docker.

    Captura de tela da caixa de diálogo Publicar - escolha Registro de contêiner do Docker.

  4. Escolha Criar Novo Registro de Contêiner do Azure.

    Captura de tela da caixa de diálogo Publicar - escolha Criar um novo registro de contêiner do Azure.

  5. Preencha os valores desejados no Criar um novo Registro de Contêiner do Azure.

    Cenário Valor sugerido Descrição
    Prefixo DNS Nome globalmente exclusivo Nome que identifica exclusivamente seu registro de contêiner.
    Assinatura Escolha a sua subscrição A assinatura do Azure a ser usada.
    Grupo de Recursos myResourceGroup Nome do grupo de recursos no qual criar seu registro de contêiner. Escolha Novo para criar um novo grupo de recursos.
    SKU Padrão Camada de serviço do registro de contêiner
    Localização do Registo Uma localização perto de si Escolha um local em uma região perto de você ou perto de outros serviços que usarão seu registro de contêiner.

    Captura de tela da caixa de diálogo Criar Registro de Contêiner do Azure do Visual Studio.

  6. Clique Criar. A caixa de diálogo Publicar agora mostra o registro criado.

    Captura de tela da caixa de diálogo Publicar mostrando o Registro de Contêiner do Azure criado.

  7. Escolha Concluir para finalizar o processo de publicação da imagem do contêiner no registo recém-criado no Azure.

    Captura de tela mostrando a publicação bem-sucedida.

Próximos passos

Agora você pode extrair o contêiner do Registro para qualquer host capaz de executar imagens do Docker, por exemplo, Instâncias de Contêiner do Azure.

Com o Visual Studio, você pode facilmente criar, depurar e executar aplicativos .NET, ASP.NET e ASP.NET Core em contêineres e publicá-los no Registro de Contêiner do Azure, no Hub do Docker, no Serviço de Aplicativo do Azure ou em seu próprio Registro de Contêiner. Neste artigo, você publica um aplicativo ASP.NET Core no Registro de Contêiner do Azure.

Pré-requisitos

Instalação e configuração

Para a instalação do Docker, primeiro revise as informações em Docker Desktop para Windows: O que saber antes de instalar o. Em seguida, instale Docker Desktop.

Adicionar um projeto a um contêiner do Docker

  1. Antes de criar o projeto do Visual Studio, verifique se o Docker Desktop está executando o tipo de contêineres (Windows ou Linux) que você pretende usar em seu projeto do Visual Studio.

    Para alterar o tipo de contêiner usado pelo Docker Desktop, clique com o botão direito do mouse no ícone do Docker (baleia) na Barra de tarefas e escolha Alternar para contêineres Linux ou Alternar para contêineres do Windows.

    Advertência

    Se você alternar o tipo de contêiner depois de criar o projeto do Visual Studio, os arquivos de imagem do Docker podem falhar ao carregar.

  2. Crie um novo projeto usando o modelo de do ASP.NET Core Web App ou se quiser usar o .NET Framework em vez do .NET Core, escolha ASP.NET Aplicativo Web (.NET Framework).

  3. No ecrã Criar nova aplicação Web, verifique se a caixa de seleção Ativar Suporte Docker está selecionada.

    Captura de tela da caixa de seleção Ativar suporte ao Docker.

    A captura de tela mostra a versão mais recente com o .NET 8.0. Se você estiver usando o .NET Framework, a caixa de diálogo terá uma aparência um pouco diferente.

  4. Selecione o tipo de contêiner desejado (Windows ou Linux) e selecione Criar.

Visão geral do Dockerfile

O Visual Studio cria um Dockerfile em seu projeto, que fornece a receita de como criar uma imagem final do Docker. Para obter mais informações, consulte o de referência do Dockerfile para obter detalhes sobre os comandos usados no Dockerfile.

#See https://aka.ms/customizecontainer to learn how to customize your debug container and how Visual Studio uses this Dockerfile to build your images for faster debugging.

# This stage is used when running from VS in fast mode (Default for Debug configuration)
FROM mcr.microsoft.com/dotnet/aspnet:8.0-nanoserver-1809 AS base
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

# This stage is used to build the service project
FROM mcr.microsoft.com/dotnet/sdk:8.0-nanoserver-1809 AS build
ARG BUILD_CONFIGURATION=Release
WORKDIR /src
COPY ["MyWepApp/MyWebApp.csproj", "MyWebApp/"]
RUN dotnet restore "./MyWebApp/./MyWebApp.csproj"
COPY . .
WORKDIR "/src/MyWebApp"
RUN dotnet build "./MyWebApp.csproj" -c %BUILD_CONFIGURATION% -o /app/build

# This stage is used to publish the service project to be copied to the final stage
FROM build AS publish
ARG BUILD_CONFIGURATION=Release
RUN dotnet publish "./MyWebApp.csproj" -c %BUILD_CONFIGURATION% -o /app/publish /p:UseAppHost=false

# This stage is used in production or when running from VS in regular mode (Default when not using the Debug configuration)
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "MyWebApp.dll"]

O Dockerfile de anterior é baseado na imagem do Microsoft Container Registry (MCR) .NET 8 e inclui instruções para modificar a imagem base criando o projeto chamado MyWebApp e adicionando-o ao contêiner. Se você estiver usando o .NET Framework, a imagem base será diferente.

Quando a caixa de seleção Configurar para HTTPS do novo projeto estiver marcada, o Dockerfile expõe duas portas. Uma porta é usada para tráfego HTTP; a outra porta é usada para HTTPS. Se a caixa de seleção não estiver marcada, uma única porta (80) será exposta para o tráfego HTTP.

Com o Visual Studio 2022 versão 17.7 ou posterior, você pode direcionar .NET 8. Nesse caso, você tem o benefício de poder executar seu aplicativo com mais segurança, como um usuário normal, em vez de com permissões elevadas. O Dockerfile padrão gerado pelo Visual Studio para projetos .NET 8 é configurado para ser executado como um usuário normal. Para habilitar esse comportamento em um projeto existente, adicione a linha USER app ao Dockerfile na imagem base. Além disso, como a porta 80 é restrita para usuários normais, exponha as portas 8080 e 8081 em vez de 80 e 443. A porta 8080 é usada para tráfego HTTP e a porta 8081 é usada para HTTPS. Para ser executado como um usuário normal, o contêiner deve usar uma imagem base do .NET 8 e o aplicativo deve ser executado como um aplicativo .NET 8. Quando configurado corretamente, seu Dockerfile deve conter código como no exemplo a seguir:

FROM mcr.microsoft.com/dotnet/aspnet:8.0-preview AS base
USER app
WORKDIR /app
EXPOSE 8080
EXPOSE 8081

Depurar

Selecione do Docker na lista suspensa de depuração na barra de ferramentas e comece a depurar o aplicativo. Você pode ver uma mensagem com um prompt sobre como confiar em um certificado; Escolha confiar no certificado para continuar.

A opção Ferramentas de Contêiner na janela de saída mostra quais ações estão ocorrendo. Na primeira vez, pode demorar um pouco para baixar a imagem base, mas é mais rápido em execuções subsequentes.

Após a conclusão da compilação, o navegador abre e exibe a página inicial do aplicativo. Na barra de endereço do navegador, pode ver o URL localhost e o número de porta para depuração.

Observação

Se você precisar alterar as portas para depuração, poderá fazer isso no arquivo launchSettings.json. Consulte Configurações de inicialização do contêiner.

Janela de Contentores

Pode utilizar a janela Contentores para ver os contentores em execução na sua máquina e outras imagens que tenha disponíveis.

Abra a janela Contentores usando a caixa de pesquisa no IDE (pressione Ctrl+Q para a usar), digite containere escolha a janela Contentores na lista.

Você pode posicionar a janela do Containers em um local conveniente, como abaixo do editor, movendo-a e seguindo as guias de posicionamento da janela.

Na janela, localize o seu contêiner e navegue por cada separador para visualizar as variáveis de ambiente, configurações de portas, logs e o sistema de ficheiros.

Captura de tela da janela Contêineres.

Para obter mais informações, consulte janela Usar os contêineres.

Publicar imagens do Docker

Quando o ciclo de desenvolvimento e depuração do aplicativo estiver concluído, você poderá criar uma imagem de produção do aplicativo.

  1. Altere a lista suspensa de configuração para Release e compile a aplicação.

  2. Clique com o botão direito do rato no seu projeto no Gerenciador de Soluções e escolha Publicar.

  3. Na caixa de diálogo Publicar, selecione o separador Registo de Contentores do Docker.

    Captura de tela da caixa de diálogo Publicar - escolha Registro de contêiner do Docker.

  4. Escolha Criar Novo Registro de Contêiner do Azure.

    Captura de tela da caixa de diálogo Publicar - escolha Criar um novo registro de contêiner do Azure.

  5. Preencha os valores desejados no Criar um novo Registro de Contêiner do Azure.

    Cenário Valor sugerido Descrição
    Prefixo DNS Nome globalmente exclusivo Nome que identifica exclusivamente seu registro de contêiner.
    Assinatura Escolha a sua subscrição A assinatura do Azure a ser usada.
    Grupo de Recursos myResourceGroup Nome do grupo de recursos no qual criar seu registro de contêiner. Escolha Novo para criar um novo grupo de recursos.
    SKU Padrão Camada de serviço do registro de contêiner
    Localização do Registo Uma localização perto de si Escolha um local em uma região perto de você ou perto de outros serviços que possam usar seu registro de contêiner.

    Captura de tela da caixa de diálogo Criar Registro de Contêiner do Azure do Visual Studio.

  6. Selecione Criar. A caixa de diálogo Publicar agora mostra o registro criado.

    Captura de tela da caixa de diálogo Publicar mostrando o Registro de Contêiner do Azure criado.

  7. Escolha Concluir para finalizar o processo de publicação da imagem do contêiner no registo recém-criado no Azure.

    Captura de tela mostrando a publicação bem-sucedida.

Próximos passos

Agora você pode extrair o contêiner do Registro para qualquer host capaz de executar imagens do Docker, por exemplo, Instâncias de Contêiner do Azure.

Recursos adicionais