Run a self-hosted agent behind a web proxy (Een zelf-hostende agent uitvoeren achter een webproxy)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Wanneer uw zelf-hostende agent een webproxy vereist, kunt u de agent informeren over de proxy tijdens de configuratie. Hierdoor kan uw agent via de proxy verbinding maken met Azure Pipelines of TFS. Hierdoor kan de agent bronnen ophalen en artefacten downloaden. Ten slotte worden de proxygegevens doorgegeven aan taken die ook proxyinstellingen nodig hebben om het web te bereiken.

Azure Pipelines, TFS 2018 RTM en hoger

(Van toepassing op agentversie 2.122 en hoger.)

Als u wilt dat de agent wordt uitgevoerd achter een webproxy, geeft u door --proxyurl--proxyusername en --proxypassword tijdens de agentconfiguratie.

Voorbeeld:

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

We slaan uw proxyreferentie op verantwoorde wijze op elk platform op om onbedoeld lekken te voorkomen. In Linux wordt de referentie versleuteld met een symmetrische sleutel op basis van de computer-id. In macOS gebruiken we de sleutelhanger. In Windows gebruiken we het referentiearchief.

Notitie

Agent versie 122.0, die wordt geleverd met TFS 2018 RTM, heeft een bekend probleem bij het configureren als een service in Windows. Omdat de Windows Credential Store per gebruiker is, moet u de agent configureren met dezelfde gebruiker die de service gaat uitvoeren als. Als u bijvoorbeeld wilt configureren dat de agentservice als wordt uitgevoerd mydomain\buildadmin, moet u starten config.cmd als mydomain\buildadmin. U kunt dit doen door u aan te melden bij de computer met die gebruiker of met behulp van Run as a different user de Windows-shell.

Hoe de agent de proxy verwerkt binnen een build- of releasetaak

De agent praat met de Azure DevOps/TFS-service via de webproxy die in het .proxy bestand is opgegeven.

Omdat de code voor de Get Source taak in builds en Download Artifact taken in releases ook in de agent worden gebakken, volgen deze taken de configuratie van de agentproxy uit het .proxy bestand.

De agent maakt proxyconfiguratie beschikbaar via omgevingsvariabelen voor elke taakuitvoering. Auteurs van taken moeten azure-pipelines-task-lib-methoden gebruiken om de proxyconfiguratie op te halen en de proxy binnen hun taak af te handelen.

Houd er rekening mee dat veel hulpprogramma's niet automatisch gebruikmaken van de door de agent geconfigureerde proxy-instellingen. Hulpprogramma's zoals curl en dotnet kunnen bijvoorbeeld proxyomgevingsvariabelen vereisen, zoals http_proxy die ook op de computer moeten worden ingesteld.

URL's voor het overslaan van proxy's opgeven

Maak een .proxybypass bestand in de hoofdmap van de agent waarmee reguliere expressies (in ECMAScript-syntaxis) worden opgegeven die overeenkomen met URL's die de proxy moeten omzeilen. Voorbeeld:

github\.com
bitbucket\.com