Executar um agente autoalojado atrás de um proxy Web

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Quando o agente auto-hospedado requer um proxy da Web, você pode informar o agente sobre o proxy durante a configuração. Isso permite que seu agente se conecte ao Azure Pipelines ou TFS por meio do proxy. Isso, por sua vez, permite que o agente obtenha fontes e baixe artefatos. Finalmente, ele passa os detalhes do proxy para tarefas que também precisam de configurações de proxy para chegar à web.

Azure Pipelines, TFS 2018 RTM e mais recentes

(Aplica-se à versão 2.122 e mais recente do agente.)

Para permitir que o agente seja executado atrás de um proxy da Web, passe --proxyurl--proxyusername e durante a configuração do agente--proxypassword.

Por exemplo:

./config.cmd --proxyurl http://127.0.0.1:8888 --proxyusername "myuser" --proxypassword "mypass"

Armazenamos sua credencial de proxy de forma responsável em cada plataforma para evitar vazamentos acidentais. No Linux, a credencial é criptografada com uma chave simétrica baseada no ID da máquina. No macOS, usamos o Porta-chaves. No Windows, usamos o Repositório de Credenciais.

Nota

A versão 122.0 do agente, fornecida com o TFS 2018 RTM, tem um problema conhecido ao configurar como um serviço no Windows. Como o Repositório de Credenciais do Windows é por usuário, você deve configurar o agente usando o mesmo usuário com o qual o serviço será executado. Por exemplo, para configurar o serviço do agente executado como mydomain\buildadmin, você deve iniciar config.cmd como mydomain\buildadmin. Você pode fazer isso fazendo login na máquina com esse usuário ou usando Run as a different user no shell do Windows.

Como o agente lida com o proxy em um trabalho de compilação ou liberação

O agente falará com o .proxy serviço Azure DevOps/TFS por meio do proxy da Web especificado no arquivo.

Como o código da tarefa em compilações e Download Artifact a Get Source tarefa em versões também são incorporados ao agente, essas tarefas seguirão a configuração de proxy do agente a partir do .proxy arquivo.

O agente expõe a configuração de proxy por meio de variáveis de ambiente para cada execução de tarefa. Os autores de tarefas precisam usar métodos azure-pipelines-task-lib para recuperar a configuração de proxy e manipular o proxy em sua tarefa.

Observe que muitas ferramentas não usam automaticamente as configurações de proxy definidas pelo agente. Por exemplo, ferramentas como curl e dotnet podem exigir variáveis de ambiente de proxy, como http_proxy também ser definido na máquina.

Especificar URLs de desvio de proxy

Crie um .proxybypass arquivo no diretório raiz do agente que especifique expressões regulares (na sintaxe ECMAScript) para corresponder às URLs que devem ignorar o proxy. Por exemplo:

github\.com
bitbucket\.com