Tutorial: Configurar CI/CD para um aplicativo do Service Fabric usando o Azure Pipelines
Este tutorial é a quarta parte de uma série. Ele mostra como configurar a integração contínua e a implantação contínua (CI/CD) para um aplicativo do Azure Service Fabric usando o Azure Pipelines. Para concluir o tutorial, você deve ter um aplicativo do Service Fabric existente. Este tutorial usa o aplicativo descrito na primeira parte da série de tutoriais.
Neste tutorial, irá aprender a:
- Adicionar controlo de origem ao seu projeto
- Criar um pipeline de compilação no Azure Pipelines
- Criar um pipeline de versão no Azure Pipelines
- Implementar e atualizar uma aplicação automaticamente
A série de tutoriais mostra como:
- Criar uma aplicação .NET do Service Fabric
- Implementar a aplicação num cluster remoto
- Adicionar um ponto final HTTPS a um serviço de front-end ASP.NET Core
- Configurar CI/CD usando o Azure Pipelines (este tutorial)
- Configurar a monitorização e os diagnósticos da aplicação
Pré-requisitos
Antes de começar este tutorial:
- Se não tiver uma subscrição 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 ASP.NET e Web.
- Instale o SDK do Service Fabric.
- Crie um cluster do Windows Service Fabric 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.
Transferir a aplicação de votação de exemplo
Se você não criou o aplicativo de exemplo de votação na primeira parte desta série, você pode baixá-lo. Numa janela do comando, execute o seguinte comando para clonar o repositório da aplicação de exemplo para o seu 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, está pronto para configurar a integração contínua. Primeiro, prepare um perfil de publicação em seu aplicativo para uso pelo processo de implantação que é executado no Azure Pipelines. O perfil de publicação deve ser configurado para direcionar o cluster criado anteriormente. Inicie o Visual Studio e abra um projeto de aplicação 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 para usar em seu fluxo de trabalho de integração contínua, por exemplo, Cloud. Especifique o ponto final de ligação do cluster. Marque a caixa de seleção Atualizar o aplicativo para que seu aplicativo seja atualizado para cada implantação no Azure DevOps. Selecione o link Salvar perfil para salvar as configurações no perfil de publicação e, em seguida, selecione Cancelar para fechar a caixa de diálogo.
Partilhar a sua solução Visual Studio num novo repositório Git do Azure DevOps
Compartilhe seus arquivos de origem do aplicativo com um projeto no Azure DevOps para que você possa gerar compilações.
Para criar um novo repositório GitHub e repositório Azure DevOps no Visual Studio 2022, selecione Git>Create Git Repository no menu Git.
Selecione sua conta e insira o nome do repositório. Selecione Criar e enviar.
A publicação do repositório cria um novo projeto em sua conta dos Serviços de DevOps do Azure que tem o mesmo nome do repositório local.
Para visualizar o repositório recém-criado, vá para https://dev.azure.com/><organizationname>. Passe o cursor sobre o nome do seu projeto e selecione o ícone Repos .
Configurar a entrega contínua usando o Azure Pipelines
Um pipeline de compilação do Azure Pipelines descreve um fluxo de trabalho que tem um conjunto de etapas de compilação que são executadas sequencialmente. Para implantar em um cluster do Service Fabric, crie um pipeline de compilação que produza um pacote de aplicativo do Service Fabric e outros artefatos. Saiba mais sobre Pipelines de compilação do Azure Pipelines.
Um pipeline de versão do Azure Pipelines descreve um fluxo de trabalho que implementa um pacote de aplicação num cluster. Quando usados juntos, o pipeline de compilação e o pipeline de liberação executam todo o fluxo de trabalho, começando com arquivos de origem e terminando com um aplicativo em execução no cluster. Saiba mais sobre pipelines de versão do Azure Pipelines.
Criar um pipeline de compilação
Abra um navegador da Web e vá para seu novo projeto em https://dev.azure.com/<organization-name>/VotingSample.
Selecione a guia Pipelines e, em seguida, selecione Create Pipeline.
Selecione Usar o editor clássico para criar um pipeline sem usar YAML.
Para a origem, selecione Azure Repos Git. Para Projeto de equipe, selecione VotingSample. Em Repository, selecione VotingApplication. Deixe a ramificação padrão para compilações manuais e agendadas. Em seguida, selecione Continuar.
Em Selecione um modelo, selecione o modelo de aplicativo do Azure Service Fabric e selecione Aplicar.
Em Tarefas, para Pool de agentes, insira Pipelines do Azure. Para Especificação do agente, insira windows-2022.
Em Triggers, marque a caixa de seleção Habilitar integração contínua. Em Filtros de ramificação, a especificação de ramificação assume como padrão mestre. Selecione Guardar e colocar em fila de espera para iniciar manualmente uma compilação.
As compilações também são acionadas após push ou dar entrada. Para verificar o progresso da compilação, selecione a guia Compilações . Depois de verificar se a compilação é executada com êxito, defina um pipeline de liberação que implante seu aplicativo em um cluster.
Criar um pipeline de versão
Selecione a guia Pipelines e, em seguida, selecione Releases>New pipeline. Em Selecione um modelo, selecione o modelo de Implantação do Azure Service Fabric e selecione Aplicar.
Selecione Tarefas Novas> para adicionar uma nova conexão de cluster.
Em Nova Conexão do Service Fabric, selecione Autenticação de credenciais Baseada em Certificado ou Microsoft Entra. Especifique um ponto de extremidade de cluster de tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 (ou o ponto de extremidade do cluster no qual você está implantando).
Para autenticação baseada em certificado, adicione a impressão digital do certificado do servidor usado para criar o cluster. Em Certificado de cliente, adicione a codificação base 64 do ficheiro de certificado de cliente. Consulte as informações de ajuda desse campo para saber como obter essa representação codificada em base 64 do certificado. Além disso, adicione a senha para o certificado. Você pode usar o certificado de cluster ou o certificado de servidor se não tiver um certificado de cliente separado.
Para credenciais do Microsoft Entra, adicione um valor para impressão digital do certificado do servidor. Use o certificado de servidor usado para criar o cluster e as credenciais que deseja usar para se conectar ao cluster em Nome de usuário e Senha.
Selecione Guardar.
Em seguida, adicione um artefato de compilação ao pipeline para que o pipeline de liberação possa encontrar a saída da compilação. Selecione Adicionar artefatos>de pipeline.> Em Origem (Definição de compilação), selecione o pipeline de compilação 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 relâmpago no artefato, habilite o gatilho e selecione Salvar para salvar o pipeline de liberação.
Selecione Create Release Create (Criar>versão) para criar manualmente uma versão. Para monitorar o progresso da versão, selecione a guia Versões .
Verifique se a implantação foi bem-sucedida e se o aplicativo está sendo executado 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.
Consolidar e emitir alterações para acionar uma versão
Para verificar se o pipeline de integração contínua está funcionando, verifique 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, introduza uma mensagem para descrever a atualização e, em seguida, confirme as alterações.
Em Alterações do Git, selecione Push (a seta para cima) para atualizar seu código no Azure Pipelines.
Enviar as alterações para o Azure Pipelines aciona uma compilação. Para verificar o progresso da compilação, selecione a guia Pipelines no aplicativo em https://dev.azure.com/organizationname/VotingSample.
Quando a compilação termina, uma versão é criada automaticamente e começa a atualizar o aplicativo no cluster.
Verifique se a implantação foi bem-sucedida e se o aplicativo está sendo executado 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 a aplicação
Efetue alterações de código na aplicação. Salve e confirme as alterações.
Quando a atualização do aplicativo começar, 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 estiver concluída, o aplicativo estará executando a próxima versão. Neste exemplo, está executando a versão 1.0.0.20170815.4.
Próximo passo
Avance para o tutorial seguinte: