Extensão Azure DevOps

Este repositório contém uma extensão para o azure devops com uma task.

A estrutura deste template pode ser utilizada para criar extensões para o azure devops.

Esta task utiliza task-lib azure-pipelines-task-lib.

Esta task utiliza o PowerShell3 Task Executer. Podem ser usados os seguinte comandos.

Pré-requisitos

Esta extensão foi criada a partir do tutorial da microsoft. Aqui eles dizem todos os passos para criar uma extensão.

No powershell instalar executar:

Install-Module VstsTaskSdk -AllowClobber

How-to

1. Atualizar a informação dentro do ficheiro task.json:
   • guid gerador de guid
   • id (não pode ter espaços)
   • name
   • friendlyname
   • description
   • instanceNameFormat (isto é opcional)
   • visibility (isto é opcional)
   • execution - caso tenha mais do que uma task a adicionar
   • adicionar groups e inputs necessários
2. Atualizar a informação dentro do ficheiro vss-extension.json:
   • id (não pode ter espaços)
   • name
   • description
   • friendlyname
   • contributors.id (mesmo que o id)
   • files - caso tenha mais do que uma task ou ficheiros a adicionar
3. Caso necessário atualizar a versão VstsTaskSdk:
   • Substituir o conteúdo da pasta VstsTaskSdk com o novo conteudo
4. Atualizar o powershell task.ps1 com o script necessário.
5. Substituir os icons da extenção aqui e aqui. Ambos tem de ser 128x128.
6. Documentar a extensão no README.

Novas versões

Caso mais tarde seja necessário adicionar nova versão da task basta copiar a pasta taskv1 pra taskv2 exemplo singleassembly

Aqui é necessário alterar a variável major da pipeline para versionar a nova versão, a antiga versão fica congelada, caso haja necessidade de fazer alterações a versão deve ser incrementada automáticamente

Alterar o ficheiro vss-extension.json em contributions adicionar nova task.

Congelar versão anteriror task.json.

Caso seja necessário alterar versões anteriores é necessário incrementar manualmente a versão em task.json.

Histórico

Foi fixada a pasta ps_module com a versão 0.11.0. Esta pasta tem de estar dentro da pasta task para funcionamento correto.

Pipelines

O ficheiro azure-pipelines.yml já tem os passos da pipeline definida. Aqui serão feitos os replaces necessários nos ficheiros vss-extension.json e task.json.

O ficheiro devops-extensibility-template.json contém a definição da relase. No Azure DevOps basta importar a definição, modificar o agent pool adicionar o artefacto da pipeline criada anteriormente.

Extensões

Depois da release finalizada com sucesso é necessário partilhar a extensão com a organização primaverabss.

As extensões da podem ser consultadas aqui.

Depois de partilhada a extensão deve ser instalada nas extensões no Azure DevOps