quinta-feira, 6 de fevereiro de 2020

Criando um Agent local no Azure DevOps


Quando precisamos que um projeto será entregue num servidor local, ou ainda numa rede privada, cujo o acesso via internet seja restrito, temos que criar um Agent especifico que esteja sendo executado neste ambiente para executar o Release do resultado do Build do Pipeline. O processo é bem simples e fácil, vejamos como:



Passo 1 > Criação de um token para o usuário que será proprietário do Agent

2. Acessar o menu suspenso de usuário e selecionar a opção “Personal access token”



3. Clicar na opção “New Token”



4. Preencher os dados na tela


Importante:
  • A parte de expiração deve ser muito bem definida, porque após esse prazo, será necessário a alteração do token no Agent, o prazo máximo de vida é um ano.
  • Também importante a parte de escopo do agent, pois cada permissão fornecer permissões especificas (build, code, release, etc...)


5. Após a criação, você deve copiar o token exibido, pois o mesmo nunca mais será visível.


Passo 2 – Criação do Agent

 1. Acesso as configurações da organização



2.  Acessar o item “Agent Pool”



3. Criar ou acessar um pool onde será criado o novo Agent



4. Clicar no botão “New Agent”



5. Na tela que será aberto, terá as instruções para criação do Agent no local.



6. Faça o download e depois abra uma janela de comando com o PowerShell



7. Faça a execução do primeiro comando


Observação: Em algumas versões, o comando “mkdir” (criação de diretório) pode apresentar erro, caso isso aconteça, substituir pelo comando “md”

8. Após a execução, agora será a hora de execução a configuração do Agent



8.1. Informe a URL da sua organização ([organização].visualstudio.com)


8.2. Na opção de autenticação, utiliza a padrão [PAT], tecle [ENTER]



8.3. Informe o token que foi criado para o usuário no Passo 1


8.4. Você deve informar o nome do Agent Pool onde ficará alocado o Agent



8.5. Você deve informar o nome do seu Agent, ou deixar o padrão sugerido


8.6. Depois do teste de conectividade, ele solicitará o nome da pasta de trabalho, deixe a padrão

8.7. Você deverá informar se seu Agent será iniciado automaticamente com a instância do Windows, informe “Y” para seja criado um serviço que inicie seu Agent automaticamente



Importante:
  • Para registro do serviço é necessário que o usuário que esteja executando seja um administrador do local onde está sendo instalado.


8.8. Você pode informar qual será o usuário que executará o serviço, deixe o padrão do Windows

8.9. Espere o comando finalizar




10. Não será necessário a execução do último comando, pois como você registrou o Agent como serviço, ele já estará iniciado.


11. Verifique o status do Agent, deve estar Online



Pronto, seu Agent está instalado, configurado e aguardando os Jobs e Task para executar.

Marcelo Goberto de Azevedo
Arquiteto na GFT Brasil
https://marcelogoberto.blogspot.com/