<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Gustavo Bergamin on Medium]]></title>
        <description><![CDATA[Stories by Gustavo Bergamin on Medium]]></description>
        <link>https://medium.com/@gustavobergamim?source=rss-8d58b5e441ee------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*SzT0gvKh0dpx4bUCrcLlHw.jpeg</url>
            <title>Stories by Gustavo Bergamin on Medium</title>
            <link>https://medium.com/@gustavobergamim?source=rss-8d58b5e441ee------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 23:47:22 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@gustavobergamim/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Azure DevOps | Desenvolvendo Extensões]]></title>
            <link>https://medium.com/@gustavobergamim/azure-devops-desenvolvendo-extens%C3%B5es-dabba89d0d7e?source=rss-8d58b5e441ee------2</link>
            <guid isPermaLink="false">https://medium.com/p/dabba89d0d7e</guid>
            <category><![CDATA[extension]]></category>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[azure]]></category>
            <category><![CDATA[azure-devops]]></category>
            <dc:creator><![CDATA[Gustavo Bergamin]]></dc:creator>
            <pubDate>Mon, 10 Feb 2020 00:42:01 GMT</pubDate>
            <atom:updated>2020-02-10T00:42:01.272Z</atom:updated>
            <content:encoded><![CDATA[<p>Olá pessoal. Tudo bem?</p><p>Iniciarei uma série com alguns artigos sobre o desenvolvimento de extensões para o Azure DevOps (se você não conhece o produto, recomendo dar uma olhada na p<a href="https://azure.microsoft.com/en-us/services/devops">ágina </a>e na d<a href="https://docs.microsoft.com/en-us/azure/devops">ocumentação)</a>.</p><h4>Introdução</h4><p>O Azure DevOps, apesar de ser bem completo e suportar a maioria das necessidades do desenvolvimento de software, ainda permite que você adicione funcionalidades através de extensões.</p><p>Dessa forma, se sua organização ou projeto demanda algum recurso que a ferramenta não possui, ou possui mas poderia ser melhor, você pode desenvolver uma extensão e adicionar ao produto. Além disso, você ainda pode compartilhar com outros usuários da comunidade através da loja de extensões.</p><p>Nesta série vou mostrar como criar e configurar o projeto da extensão, incluindo a publicação na loja. Vamos começar com um projeto simples para demonstrar os conceitos básicos (sim, teremos Hello World!) e depois vamos evoluir para uma extensão funcional que interage com o Azure Pipelines na aprovação de releases. Será um passo-a-passo simplificado da extensão que desenvolvi e já <a href="https://marketplace.visualstudio.com/items?itemName=GustavoBergamim.pipeline-approval">está publicada na loja</a>.</p><p>Mas antes de botar a mão na massa e começar a criar o projeto, vamos falar um pouco sobre alguns pontos importantes antes de iniciar o desenvolvimento.</p><h4>O que podemos fazer através de extensões?</h4><p>As extensões podem ser novas tasks de build, widgets do dashboard para adicionar novas visualizações, novas ações a serem executadas dentro das funcionalidades atuais, customizações para os work items ou mesmo uma funcionalidade nova.</p><h4>Quais tecnologias preciso saber para desenvolver uma extensão?</h4><p>Para desenvolver a maioria das extensões você precisa ter conhecimento básico em desenvolvimento para WEB. É possível desenvolver extensões utilizando apenas HTML, CSS e JavaScript, mas também é possível avançar um pouco e utilizar TypeScript e React. No caso de tasks de build, pode ser necessário conhecimento em NodeJS e/ou PowerShell, dependendo da task.</p><h4>Preciso adquirir alguma licença para desenvolver uma extensão?</h4><p>Não. Você pode desenvolver sua extensão utilizando ferramentas e serviços gratuitos. Nesta série utilizaremos o Visual Studio Code como IDE, um repositório público no GitHub e uma conta gratuita no Azure DevOps para configurar o pipeline de integração e publicação, além de servir como ambiente de desenvolvimento e teste de nossa extensão.</p><h4>O que preciso conhecer antes de iniciar o desenvolvimento?</h4><p>Independente de qual funcionalidade você deseja adicionar, é importante ter pelo menos um conhecimento básico sobre a API Rest do Azure DevOps, pois através dela que teremos acesso à todos os recursos que podemos explorar nas extensões. A documentação completa da API Rest pode ser encontrada <a href="https://docs.microsoft.com/en-us/rest/api/azure/devops/">aqui</a>.</p><h4>Conceitos importantes</h4><p>Além dos pontos destacados acima, existem três conceitos importantes que utilizaremos no desenvolvimento:</p><ul><li><strong>Contribution:</strong> representa como a extensão interage com produto, ou seja, como ela contribui para a ferramenta. Contribuição pode ser uma task de build, uma informação na tela de pipelines, uma nova sessão no menu lateral, entre outros. Uma extensão pode definir mais de uma contribuição de acordo com o que ela acrescentará ao produto.</li><li><strong>Scope:</strong> define o escopo de atuação da extensão dentro da ferramenta. Por exemplo, a extensão terá acesso apenas a leitura de resultados de build. Dessa forma fica claro para o usuário quais são os recursos que serão acessados pela extensão, similar ao que acontece com os aplicativos de celular que pedem, por exemplo, permissão para acessar a camera.</li><li><strong>Extension Manifest:</strong> arquivo JSON que contém todas as definições da extensão que serão utilizadas para o empacotamento e publicação.</li></ul><p>No próximo post vamos criar e configurar o projeto baseado em um template da Microsoft.</p><p>Até a próxima pessoal.</p><h3>Referências:</h3><ul><li><strong>Azure DevOps:</strong> <a href="https://azure.microsoft.com/en-us/services/devops/">https://azure.microsoft.com/en-us/services/devops/</a></li><li><strong>Azure DevOps Docs:</strong> <a href="https://docs.microsoft.com/en-us/azure/devops/?view=azure-devops">https://docs.microsoft.com/en-us/azure/devops/?view=azure-devops</a></li><li><strong>Azure Pipelines Approval extension: </strong><a href="https://marketplace.visualstudio.com/items?itemName=GustavoBergamim.pipeline-approval">https://marketplace.visualstudio.com/items?itemName=GustavoBergamim.pipeline-approval</a></li><li><strong>Azure DevOps Rest API reference:</strong> https://docs.microsoft.com/en-us/rest/api/azure/devops</li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=dabba89d0d7e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Azure Pipelines | YAML Templates]]></title>
            <link>https://medium.com/@gustavobergamim/azure-pipelines-yaml-templates-3ef6de3b023b?source=rss-8d58b5e441ee------2</link>
            <guid isPermaLink="false">https://medium.com/p/3ef6de3b023b</guid>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[azure-devops]]></category>
            <category><![CDATA[azure-pipelines]]></category>
            <category><![CDATA[yaml]]></category>
            <category><![CDATA[azure]]></category>
            <dc:creator><![CDATA[Gustavo Bergamin]]></dc:creator>
            <pubDate>Tue, 23 Apr 2019 00:12:44 GMT</pubDate>
            <atom:updated>2019-04-23T00:12:44.217Z</atom:updated>
            <content:encoded><![CDATA[<p>E ai pessoal, beleza?</p><p>No post de hoje vamos falar um pouco sobre Azure Pipelines, mais especificamente sobre as definições de build através de arquivos YAML, focando na criação de templates reutilizáveis.</p><h4>Introdução à definição de build via YAML</h4><p>No mundo do DevOps, é muito importante a aproximação dos times de desenvolvimento e operações. Nessa linha surge o modelo de infraestrutura como código (IaC — Infrastructure as Code). Este modelo permite que os desenvolvedores participem da configuração da infraestrutura, pois as definições são feitas em arquivos que ficam junto do código da aplicação, no mesmo repositório.</p><p>Seguindo esta idéia, a Microsoft adicionou ao Azure DevOps o recurso de definição de build por arquivos YAML que são versionados junto do código-fonte.</p><p>Quando criamos uma nova definição de build no Azure DevOps, a opção principal é informar o repositório que contém o arquivo YAML com as configurações da definição de build:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/688/0*8uMSFkLzX2YNMe5B.png" /><figcaption>Tela de criação de definição de build do Azure DevOps</figcaption></figure><p>Se você é daqueles que preferem o editor visual, não se desespere, ele ainda está lá, no final da lista (por enquanto). Além disso, no Sprint 150 do Azure DevOps Services, foi liberado <a href="https://docs.microsoft.com/en-us/azure/devops/release-notes/2019/sprint-150-update#task-assistant-for-editing-yaml-files">um recurso para auxiliar visualmente a construção do arquivo YAML</a>.</p><h4>Templates YAML</h4><p>Se você trabalha com mais de uma aplicação dentro do Azure DevOps e utiliza definições de build por arquivos YAML, deve ter notado que, para aplicações da mesma linguagem/plataforma, você repete algumas etapas para compilação e empacotamento das aplicações.</p><p>Pensando nisso a Microsoft adicionou a possibilidade de criação de <a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/process/templates">templates YAML</a>, que podem conter definições de etapas e tarefas que podem ser reutilizadas nos pipelines.</p><p>Neste post vamos criar um pipeline de build de uma solution com uma aplicação ASP.Net Core, definindo as etapas básicas do processo em um template. Posteriormente, vamos adicionar uma aplicação .Net Core Console à solution e refatorar o template para compilar e empacotar as duas aplicações no mesmo pipeline.</p><p>Mãos à obra.</p><h4>Criação do Azure Pipelines YAML</h4><p>Vamos utilizar uma solution com um projeto ASP.Net Core, com a estrutura abaixo:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/284/0*vvfPtsFr__PX3-WV.png" /><figcaption>Estrutura do projeto de exemplo com uma aplicação ASP.Net Core</figcaption></figure><p>As etapas básicas do pipeline de uma aplicação .Net Core são:</p><ul><li>Restauração dos pacotes Nuget</li><li>Compilação do código fonte</li><li>Execução dos testes de unidade</li><li>Empacotamento da aplicação</li><li>Cópia do pacote para o diretório de artefatos</li><li>Publicação dos artefatos gerados</li></ul><p>Para nosso projeto de exemplo, nosso azure-pipelines.yml ficaria assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/4443c24a7106d5937f1aaa592931c66f/href">https://medium.com/media/4443c24a7106d5937f1aaa592931c66f/href</a></iframe><p>Notem que, apesar de não ter um projeto de testes na solution, eu adicionei a etapa de execução de testes neste YAML. Explicarei o porque na criação do template.</p><h4>Criando o Template</h4><p>Para transformar em template, vamos reutilizar toda a seção “steps”, parametrizando algumas informações:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/01b921a920b0404e47752aacf39fb18a/href">https://medium.com/media/01b921a920b0404e47752aacf39fb18a/href</a></iframe><p>Nos parâmetros, definimos as variáveis utilizadas dentro do template. No exemplo utilizei três variáveis:</p><ul><li><strong>buildConfiguration:</strong> define a configuração da build, com valor padrão “Release”;</li><li><strong>hasUnitTests:</strong> informa se deve ou não executar testes de unidade, com valor padrão “false”;</li><li><strong>appName:</strong> informa o nome da aplicação. Como estamos utilizando uma solution, é importante ter o nome da aplicação para realizar o empacotamento.</li></ul><p>Vamos publicar este template em um repositório, que pode ser no <a href="https://github.com/gustavobergamim/azure-pipelines-yaml-templates/tree/dev/basic-template">GitHub</a> ou no <a href="https://gustavobergamim.visualstudio.com/azure-pipelines-samples/_git/yaml-templates?version=GBdev%2Fbasic-template">Azure Repos</a>, para que ele fique disponível para ser reutilizado em nosso pipeline.</p><h4>Utilizando o Template</h4><p>No YAML da nossa aplicação de exemplo, vamos alterar a seção “steps” para referenciar nosso template. Para isso, primeiro precisamos declarar a seção “<a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&amp;tabs=schema#resources">resources</a>”, informando o repositório que contém o template.</p><p>Em nosso exemplo, vamos utilizar o template publicado no GitHub. Assim, nosso repository declarado na seção “resources” deverá ter os seguintes parâmetros:</p><ul><li><strong>repository:</strong> nome único do repositório para referência no YAML;</li><li><strong>type:</strong> identificador do tipo de repositório. Em nosso exemplo, utilizando GitHub, o valor será “github”, se fosse utilizado o Azure Repos, o valor seria apenas “git”;</li><li><strong>name:</strong> nome do repositório utilizado. No caso do GitHub, deve ser prefixado com o nome da conta: “gustavobergamim/azure-pipelines-yaml-templates”;</li><li><strong>ref:</strong> branch utilizada. Para manter os exemplos funcionais mesmo após a refatoração, utilizarei agora o branch “dev/basic-template”;</li><li><strong>endpoint:</strong> para utilizar o GitHub, é necessário configurar um Service Connection no Azure DevOps e informar o nome da conexão neste parâmetro.</li></ul><p>Configurada a seção “resources”, vamos alterar a seção “steps” substituindo todas as etapas existentes por uma etapa do tipo “<a href="https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema?view=azure-devops&amp;tabs=schema#template-references">template</a>” informando o nome do arquivo do template junto com o repositório que o contem, além dos parâmetros do template. Nosso azure-pipelines.yml ficará assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/eebc601fe1e1fdda42810d2f25f9fbcc/href">https://medium.com/media/eebc601fe1e1fdda42810d2f25f9fbcc/href</a></iframe><p>Testando o pipeline:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*uIOcw27WSWzjcIL5.png" /><figcaption>Execução do pipeline com uma aplicação ASP.Net Core</figcaption></figure><h4>Refatorando o Template</h4><p>Em nossa aplicação de exemplo, adicionei um novo projeto do tipo Console:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/276/0*B6NrQgTekpJLtJOF.png" /><figcaption>Estrutura do projeto de exemplo com uma aplicação ASP.Net Core e uma Console</figcaption></figure><p>Agora vamos refatorar nosso template para suportar mais de uma aplicação no empacotamento. Considerando as etapas básicas do pipeline de uma aplicação .Net Core que enumeramos anteriormente, durante nossa refatoração vamos dividí-las em dois templates, sendo um com as etapas de compilação e testes de unidade e o outro com o empacotamento. Vamos criar ainda um terceiro template que fará a chamada à estes dois templates.</p><p>As etapas de restauração de pacotes, compilação do código e execução dos testes de unidade foram movidas para o template abaixo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f2fe756516e3892f28dfa8db1acccdf1/href">https://medium.com/media/f2fe756516e3892f28dfa8db1acccdf1/href</a></iframe><p>As etapas de empacotamento e cópia do pacote para o diretório de artefatos foram movidas para o template abaixo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/da5cd656d178e946812b5f253a365f0d/href">https://medium.com/media/da5cd656d178e946812b5f253a365f0d/href</a></iframe><p>Note que existe um novo parâmetro: <strong>artifactFolder</strong>. Esse parâmetro é utilizado para identificar o sub-diretório em que será copiado o pacote no diretório de artefatos.</p><p>Por fim, o template abaixo orquestra a chamada aos templates acima e publica os artefatos:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/611f0559b65f722664b2db28309ded38/href">https://medium.com/media/611f0559b65f722664b2db28309ded38/href</a></iframe><p>Note que neste template utilizei uma estrutura de repetição. As etapas de compilação e execução dos testes de unidade são executadas no escopo da solution. Já o empacotamento é executado no escopo de projeto e, por isso, é preciso rodar as etapas para cada projeto da solution que vamos publicar. Por esse motivo é feita a iteração das aplicações informadas no parâmetro <strong>apps</strong>.</p><p>Vamos ao teste:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*001yzMySXO7j2G0e.png" /><figcaption>Execução do pipeline com uma aplicação ASP.Net Core e uma Console</figcaption></figure><h4>Versionamento de Pipeline</h4><p>Note que as duas execuções foram feitas utilizando o mesmo pipeline. A diferença fica por conta do branch utilizado. Em cada um deles o azure-pipelines.yml estava com definições diferentes.</p><p>Essa é uma das vantagens de manter as definições do pipeline junto do código-fonte, pois você pode definir as etapas do pipeline de acordo com a evolução da sua aplicação, mantendo a compatibilidade com versões anteriores.</p><h4>Enfim…</h4><p>Este exemplo utilizou uma aplicação bem simples, mas permitiu mostrar um pouco do que é possível criando templates para pipelines. Podemos criar repositórios corporativos de templates e reutilizar em toda a organização.</p><h3>Repositórios</h3><p>Para este post eu criei um repositório no GitHub com os templates e um projeto no Azure DevOps que contém dois repositórios, sendo um também para os templates (uma cópia do GitHub) e outro com a aplicação de exemplo, e o pipeline que utiliza o template criado.</p><ul><li>Templates no GitHub: https://github.com/gustavobergamim/azure-pipelines-yaml-templates</li><li>Projeto no Azure DevOps: https://dev.azure.com/gustavobergamim/azure-pipelines-samples</li></ul><p>E por hoje, é só pessoal. Espero que tenham gostado. E obrigado ao <a href="https://twitter.com/vinijmoura">Vinícius Moura</a> por auxiliar nas dúvidas em todo este processo.</p><p>Compartilhem suas opiniões e comentários.</p><p>Até a próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3ef6de3b023b" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>