Implantar um serviço de trabalho no Azure

Para criar um novo projeto do Serviço de Trabalho com o Visual Studio, selecione Arquivo>Novo>Projeto.... Na caixa de diálogo Criar um novo projeto , pesquise "Serviço de Trabalho" e selecione o modelo de Serviço de Trabalho. Insira o nome do projeto desejado, selecione um local apropriado e selecione Avançar. Na página Informações adicionais, selecione a .NET 5.0 e verifique a opção Habilitar Docker para habilitar o suporte do Docker. Selecione o sistema operacional docker desejado.

Para criar um novo projeto do Serviço de Trabalho com o Visual Studio Code, você pode executar comandos da CLI do .NET no terminal integrado. Para obter mais informações, consulte Visual Studio Code: Terminal Integrado.

Abra o terminal integrado, execute o comando dotnet new, e substitua <Project.Name> pelo nome do projeto desejado.

dotnet new worker --name <Project.Name>

Para obter mais informações sobre o novo comando de projeto de serviço de trabalho da CLI do .NET, consulte o novo trabalho do dotnet.

Para criar um novo projeto do Serviço de Trabalho com a CLI do .NET, abra seu terminal favorito em um diretório de trabalho. Execute o comando dotnet new e substitua <Project.Name> pelo nome do projeto que você deseja.

dotnet new worker --name <Project.Name>

Para obter mais informações sobre o comando de projeto do novo serviço de trabalho da CLI do .NET, consulte dotnet new worker.

Para criar o aplicativo no Visual Studio, selecione F6 ou selecione a opção de menu Criar>Solução de Build .

Para criar o aplicativo do Visual Studio Code, abra a janela do terminal integrado e execute o dotnet build comando no diretório de trabalho.

dotnet build

Para obter mais informações sobre o comando de build da CLI do .NET, consulte dotnet build.

Para criar o aplicativo a partir da CLI do .NET, execute o dotnet build comando no diretório de trabalho.

dotnet build <path/to/project.csproj>

Especifique seu <path/to/project.csproj> valor, que é o caminho para o arquivo de projeto a ser compilado. Para obter mais informações sobre o comando de build da CLI do .NET, consulte dotnet build.

Se você tiver selecionado corretamente a caixa de seleção Habilitar Docker ao criar um novo projeto de Trabalho, pule para a etapa Criar a imagem do Docker .

Se você não selecionou essa opção, não se preocupe, ainda poderá adicioná-la agora. No Visual Studio, clique com o botão direito do mouse no nó do projeto no Gerenciador de Soluções e selecione Adicionar> Suporte aoDocker. Você será solicitado a selecionar um sistema operacional de destino; selecione OK com a seleção padrão do sistema operacional.

No Visual Studio Code, você precisa da extensão do Docker e da extensão da Conta do Azure instalada. Abra a Paleta de Comandos e selecione a opção Docker: Adicionar arquivos do Docker ao workspace . Se solicitado a selecionar a Plataforma de Aplicativos, escolha .NET: Console Core. Se solicitado a Selecionar Projeto, escolha o projeto do Serviço de Trabalho que você criou. Quando solicitado a Selecionar Sistema Operacional, escolha o primeiro sistema operacional listado. Quando solicitado se deseja ou não incluir arquivos opcionais do Docker Compose, selecioneNão.

Com a CLI, o Dockerfilenão será criado para você. Copie seu conteúdo em um novo arquivo chamado Dockerfile no diretório raiz do projeto.

Para obter mais informações sobre as imagens oficiais do .NET, consulte o Hub do Docker: Runtime do .NET e o Hub do Docker: SDK do .NET.

Clique com o botão direito do mouse no Dockerfile no Gerenciador de Soluções e selecione Criar Imagem do Docker. A janela Saída é exibida, relatando o progresso do docker build comando.

Clique com o botão direito do mouse no Dockerfile no Explorer e selecione Criar Imagem. Quando solicitado a marcar a imagem como, insira appcloudservice:latest. O terminal de saída da Tarefa Docker mostra o progresso do comando de build do Docker.

{
  "type": "docker-build",
  "label": "docker-build: release",
  "dependsOn": [
    "build"
  ],
  "dockerBuild": {
    "tag": "appcloudservice:latest",
    "dockerfile": "${workspaceFolder}/cloud-service/Dockerfile",
    "context": "${workspaceFolder}",
    "pull": true
  },
  "netCore": {
    "appProject": "${workspaceFolder}/cloud-service/App.CloudService.csproj"
  }
}

Abra uma janela de terminal no diretório raiz do Dockerfile e execute o seguinte comando docker:

docker build -t appcloudservice:latest -f Dockerfile .

Um recurso do Registro de Contêiner do Azure (ACR) permite que você crie, armazene e gerencie imagens e artefatos de contêiner em um registro privado. Para criar um registro de contêiner, você precisa criar um novo recurso no portal do Azure.

1. Selecione a Assinatura e o grupo de recursos correspondente (ou crie um novo).
2. Insira um nome do Registro.
3. Selecione um local.
4. Selecione uma SKU apropriada, por exemplo, Basic.
5. Selecione Examinar + criar.
6. Depois de ver a Validação aprovada, selecione Criar.

Um recurso do Registro de Contêiner do Azure (ACR) permite que você crie, armazene e gerencie imagens e artefatos de contêiner em um registro privado. Abra uma janela de terminal no diretório raiz do Dockerfile e execute o seguinte comando da CLI do Azure:

az login

az account set --subscription <subscription name or id>

Depois de entrar na CLI do Azure, sua sessão poderá interagir com os recursos adequadamente.

Se você ainda não tiver um grupo de recursos ao qual gostaria de associar seu serviço de trabalho, crie um usando o az group create comando:

az group create -n <resource group> -l <location>

Forneça o <resource group> nome e o <location>. Para criar um registro de contêiner, chame o az acr create comando.

az acr create -n <registry name> -g <resource group> --sku <sku> --admin-enabled true

Substitua espaços reservados por seus próprios valores apropriados:

• <registry name>: o nome do registro.
• <resource group>: o nome do grupo de recursos que você usou.
• <sku>: valores aceitos, Básico, Clássico, Premium ou Standard.

O comando anterior:

• Cria um Registro de Contêiner do Azure, dado um nome de registro, no grupo de recursos especificado.
• Habilitado um usuário administrador — isso é necessário para instâncias de contêiner do Azure.

Clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Publicar. A caixa de diálogo Publicar é exibida. Para o Destino, selecione Azure e , em seguida, Avançar.

Para o Destino Específico, selecione Registro de Contêiner do Azure e depois Avançar.

Em seguida, para o Registro de Contêiner, selecione o nome da assinatura que você usou para criar o recurso do ACR. Na área de seleção de registros de contêiner , selecione o registro de contêiner que você criou e selecione Concluir.

Isso cria um perfil de publicação, que pode ser usado para publicar a imagem no registro de contêiner. Selecione o botão Publicar para efetuar push da imagem para o registro de contêiner, a janela Saída relatará o progresso da publicação e, quando ela for concluída com êxito, você verá uma mensagem "Publicado com êxito".

Selecione o Docker na Barra de Atividades no Visual Studio Code. Expanda o painel em árvore IMAGES, depois expanda o nó de imagem appcloudservice e clique com o botão direito na marca latest.

A janela do terminal integrado relata o progresso do comando docker push no registro de contêiner.

Para enviar uma imagem por push para o registro de contêiner, você precisa entrar primeiro no Registro:

az acr login -n <registry name>

O az acr login comando faz login em um registro de contêiner por meio da CLI do Docker. Para enviar a imagem por push para o registro de contêiner, use o comando az acr build com o nome do registro de contêiner como :<registry name>

az acr build -r <registry name> -t appcloudservice .

O comando anterior:

• Empacota a fonte em um arquivo tar.
• Faz upload para o registro de contêiner.
• O registro de contêiner descompacta o arquivo tar .
• Executa o comando docker build no recurso de registro de contêiner contra o Dockerfile.
• Adiciona a imagem ao registro de contêiner.

No Visual Studio Code, selecione Docker na Barra de Atividades. Expanda o nó REGISTRIES e selecione Conectar Registro. Selecione o Azure quando solicitado e entre, se necessário.

Expanda o nó REGISTRIES, selecione Azure, sua assinatura >, o registro de contêiner > e a imagem, e então clique com o botão direito do mouse na tag. Selecione Implantar Imagem em Instâncias de Contêiner do Azure.

Para criar uma instância de contêiner, primeiro crie um grupo de contêineres usando o az container create comando.

az container create -g <resource group> \
  --name <instance name> \
  --image <registry name>.azurecr.io/<image name>:latest \
  --registry-password <password>

Forneça os valores apropriados:

• <resource group>: o nome do grupo de recursos que você tem usado neste tutorial.
• <instance name>: o nome da instância de contêiner.
• <registry name>: o nome do registro de contêiner.
• <image name>: o nome da imagem.
• <password>: a senha para o registro de contêiner – você pode obtê-la no portal do Azure, > de recurso do Registro de Contêiner.

Para criar uma instância de contêiner, você também precisa criar um novo recurso no portal do Azure.

1. Selecione a mesma Assinatura e o grupo de recursos correspondente da seção anterior.
2. Insira um nome de contêiner—appcloudservice-container
3. Selecione uma Região que corresponda à seleção de Local anterior.
4. Para a origem da imagem, selecione Registro de Contêiner do Azure.
5. Selecione o Registro pelo nome fornecido na etapa anterior.
6. Selecione a Imagem e Tag de imagem.
7. Selecione Examinar + criar.
8. Supondo que a validação foi aprovada, selecione Criar.

Pode levar um momento para que os recursos sejam criados, uma vez criados, selecione o botão Ir para o recurso .

Para obter mais informações, consulte Início Rápido: Criar uma instância de contêiner do Azure.

Para verificar se o serviço de trabalho está funcionando corretamente, você pode visualizar os logs do aplicativo em execução. Use o comando az container logs:

az container logs -g <resource group> --name <instance name>

Forneça os valores apropriados:

• <resource group>: o nome do grupo de recursos que você tem usado neste tutorial.
• <instance name>: o nome da instância de contêiner.

Você verá os logs de saída do serviço de trabalho do .NET, o que significa que você implantou com sucesso seu aplicativo conteinerizado no ACI.