Tutorial: Configurar CI/CD para um aplicativo do Service Fabric usando o Azure Pipelines
Este tutorial é a parte quatro de uma série. Ele mostra como configurar a CI/CD (integração contínua e implantação contínua) para um aplicativo do Azure Service Fabric usando o Azure Pipelines. Para concluir o tutorial, você precisa ter um aplicativo existente do Service Fabric. Este tutorial usa o aplicativo descrito na parte um da série de tutoriais.
Neste tutorial, você aprenderá a:
- Adicionar controle do código-fonte ao seu projeto
- Criar um pipeline de build no Azure Pipelines
- Criar um pipeline de lançamento no Azure Pipelines
- Implantar e atualizar automaticamente um aplicativo
A série de tutoriais mostra como:
- Criar um aplicativo .NET do Service Fabric
- Implantar o aplicativo em um cluster remoto
- Adicionar um ponto de extremidade HTTPS a um serviço de front-end do ASP.NET Core
- Configurar CI/CD usando o Azure Pipelines (este tutorial)
- Configurar monitoramento e diagnóstico para o aplicativo
Pré-requisitos
Antes de começar este tutorial:
- Se você não tiver uma assinatura do Azure, crie uma conta gratuita.
- Instale o Visual Studio 2019, incluindo a carga de trabalho de desenvolvimento do Azure e a carga de trabalho de desenvolvimento do ASP.NET e da Web.
- Instalar o SDK do Service Fabric.
- Crie um cluster do Service Fabric do Windows no Azure; por exemplo, seguindo este tutorial.
- Crie uma organização do Azure DevOps para que você possa criar um projeto no Azure DevOps e usar o Azure Pipelines.
Baixar o aplicativo de exemplo Votação
Caso não tenha criado o aplicativo de exemplo de Votação na parte um desta série, poderá baixá-lo. Em uma janela de comando, execute o comando a seguir para clonar o repositório de aplicativos de exemplo no computador local.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Preparar um perfil de publicação
Agora que você criou um aplicativo e implantou o aplicativo no Azure, você está pronto para configurar a integração contínua. Primeiro, prepare um perfil de publicação em seu aplicativo para ser usado pelo processo de implantação que é executado no Azure Pipelines. O perfil de publicação deve ser configurado para direcionar-se ao cluster criado anteriormente. Inicie o Visual Studio e abra um projeto de aplicativo do Service Fabric existente. No Gerenciador de Soluções, clique com o botão direito do mouse no aplicativo e selecione Publicar.
Escolha um perfil de destino em seu projeto de aplicativo a fim de usar para o fluxo de trabalho de integração contínua, por exemplo, Nuvem. Especifique o ponto de extremidade de conexão do cluster. Marque a caixa de seleção Atualizar o Aplicativo para que seu aplicativo seja atualizado a cada implantação no Azure DevOps. Selecione o link Salvar Perfil para salvar as configurações em seu perfil de publicação e, em seguida, selecione Cancelar para fechar a caixa de diálogo.
Compartilhar sua solução do Visual Studio em um novo repositório Git do Azure DevOps
Compartilhe os arquivos de origem do aplicativo em um projeto no Azure DevOps para que você possa gerar builds.
Para criar um novo repositório GitHub e um repositório do Azure DevOps no Visual Studio 2022, selecione Git>Criar Repositório Git no menu Git.
Selecione sua conta e insira o nome do repositório. Selecione Criar e Efetuar Push.
A publicação do repositório cria um projeto em sua conta do Azure DevOps Services com o mesmo nome do repositório local.
Para exibir o repositório recém-criado, vá para https://dev.azure.com/><organizationname>. Passe o mouse sobre o nome do projeto e selecione o Repos.
Configurar a entrega contínua usando o Azure Pipelines
Um pipeline de build do Azure Pipelines descreve um fluxo de trabalho que tem um conjunto de etapas de build que são executadas sequencialmente. Para implantar em um cluster do Service Fabric,crie um pipeline de build que produz um pacote de aplicativos do Service Fabric e outros artefatos. Saiba mais sobre os pipelines de build do Azure Pipelines.
Um pipeline de lançamento do Azure Pipelines descreve um fluxo de trabalho que implanta um pacote de aplicativos em um cluster. Quando usados juntos, o pipeline de lançamento e o pipeline de build executam todo o fluxo de trabalho, começando com os arquivos de origem e terminando com um aplicativo em execução em seu cluster. Saiba mais sobre os pipelines de lançamento do Azure Pipelines.
Criar um pipeline de build
Abra um navegador da Web e acesse seu novo projeto em https://dev.azure.com/<organization-name>/VotingSample.
Selecione a guia Pipelines e selecione Criar Pipeline.
Selecione Usar o editor clássico para criar um pipeline sem usar YAML.
Para obter a origem, selecione Azure Repos Git. Para o Projeto de equipe, selecione VotingSample. Para Repositório, selecione VotingApplication. Deixe o branch padrão para compilações manuais e agendadas. Depois selecione Continuar.
Em Selecionar um modelo, selecione o modelo Aplicativo Service Fabric do Azure e selecione Aplicar.
Em Tarefas, para Pool de agentes, insira Azure Pipelines. Para Especificação do Agente, insira windows-2022.
Em Gatilhos, selecione a caixa de seleção Habilitar integração contínua. Em Filtros de branch, a Especificação de branch assume o valor master por padrão. Selecione Salvar e enfileirar para iniciar uma compilação manualmente.
A compilação também é disparada durante o push ou o check-in. Para verificar o progresso da compilação, alterne para a guia Compilações. Depois de verificar que o build foi executado com êxito, configure um pipeline de lançamento que implanta o aplicativo em um cluster.
Criar um pipeline de lançamento
Selecione a guia Pipelines e, em seguida, selecione Lançamentos>Novo pipeline. Em Selecionar um modelo, selecione o modelo Implantação do Azure Service Fabric na lista e selecione Aplicar.
Selecione Tarefas>Novo para adicionar uma nova conexão de cluster.
Em Nova Conexão do Service Fabric, selecione a autenticação Baseada em certificado ou Credencial do Microsoft Entra. Especifique um ponto de extremidade de cluster (tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 ou o ponto de extremidade do cluster no qual você está implantando).
Para a autenticação baseada em certificado, adicione a impressão digital do certificado do servidor do certificado do servidor usado para criar o cluster. Em Certificado do cliente, adicione a codificação de base 64 do arquivo de certificado do cliente. Confira as informações de ajuda para esse campo para aprender como obter essa representação de codificação de base 64 do certificado. Essa também é a senha para o certificado. Se você não tiver um certificado do cliente ou do servidor separado, poderá usar o certificado do cluster ou do servidor.
Para credenciais do Microsoft Entra, adicione um valor para a Impressão digital do certificado do servidor. Use o certificado do servidor que você usou para criar o cluster e as credenciais que deseja usar para se conectar ao cluster em Nome de usuário e Senha.
Selecione Salvar.
Em seguida, adicione um artefato de compilação ao pipeline para que o pipeline de lançamento possa encontrar a saída da compilação. Selecione Pipeline>Artefatos>Adicionar. Em Fonte (Definição de compilação), selecione o pipeline de build criado anteriormente. Selecione Adicionar para salvar o artefato de compilação.
Habilite um gatilho de implantação contínua para que uma versão seja criada automaticamente quando a compilação for concluída. Selecione o ícone de raio no artefato, habilite o gatilho e selecione Salvar para salvar o pipeline de lançamento.
Selecione Criar Versão>Criar para criar manualmente uma versão. Você pode monitorar o andamento da versão na guia Versões.
Verifique se a implantação foi bem-sucedida e que o aplicativo está em execução no cluster. Abra um navegador da Web e vá para https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Observe a versão do aplicativo. Neste exemplo, é 1.0.0.20170616.3.
Confirmar e enviar alterações por push para disparar uma versão
Para verificar se o pipeline de integração contínua está funcionando, confira algumas alterações de código no Azure DevOps.
À medida que você escreve seu código, o Visual Studio controla as alterações de arquivo em seu projeto na seção Alterações do painel Alterações do Git.
Em Alterações, insira uma mensagem para descrever sua atualização e confirme suas alterações.
Em Alterações do Git, selecione Push (a seta para cima) para atualizar seu código no Azure Pipelines.
O push das alterações para o Azure Pipelines dispara um build. Para verificar o progresso do build, selecione a guia Pipelines no aplicativo em https://dev.azure.com/organizationname/VotingSample.
Quando o build é concluído, uma versão é criada automaticamente e inicia a atualização do aplicativo no cluster.
Verifique se a implantação foi bem-sucedida e que o aplicativo está em execução no cluster. Abra um navegador da Web e vá para https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Observe a versão do aplicativo. Neste exemplo, é 1.0.0.20170815.3.
Atualizar o aplicativo
Fazer alterações de código no aplicativo. Salve e confirme as alterações.
Quando a atualização do aplicativo for iniciada, você poderá acompanhar o progresso da atualização no Service Fabric Explorer:
A atualização do aplicativo pode levar vários minutos. Quando a atualização é concluída, o aplicativo está executando a próxima versão. Neste exemplo, ele está executando a versão 1.0.0.20170815.4.
Próxima etapa
Prosseguir para o próximo tutorial: