Share via

Spuštění agenta v místním prostředí za webovým proxy serverem

  • Článek

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Pokud váš agent v místním prostředí vyžaduje webový proxy server, můžete agenta informovat o proxy serveru během konfigurace. To umožňuje vašemu agentu připojit se ke službě Azure Pipelines nebo TFS prostřednictvím proxy serveru. To zase umožňuje agentu získat zdroje a stahovat artefakty. Nakonec předá podrobnosti o proxy serveru úkolům, které také potřebují nastavení proxy serveru, aby bylo možné se připojit k webu.

Azure Pipelines, TFS 2018 RTM a novější

(Platí pro agenta verze 2.122 a novější.)

Pokud chcete povolit spuštění agenta za webovým proxy serverem, předejte --proxyurl--proxyusername a --proxypassword během konfigurace agenta.

Příklad:

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

Vaše přihlašovací údaje proxy serveru ukládáme zodpovědně na každou platformu, abychom zabránili náhodnému úniku informací. V Linuxu se přihlašovací údaje šifrují symetrickým klíčem na základě ID počítače. V systému macOS používáme řetězce klíčů. Ve Windows používáme Úložiště přihlašovacích údajů.

Poznámka:

Agent verze 122.0, který je součástí TFS 2018 RTM, má známý problém s konfigurací jako služba ve Windows. Vzhledem k tomu, že úložiště přihlašovacích údajů systému Windows je na uživatele, musíte agenta nakonfigurovat pomocí stejného uživatele, jako bude služba spuštěna. Například ke konfiguraci služby agenta spustit jako mydomain\buildadmin, musíte spustit config.cmd jako mydomain\buildadmin. Můžete to udělat tak, že se přihlásíte k počítači s tímto uživatelem nebo použijete Run as a different user v prostředí Windows.

Jak agent zpracovává proxy server v rámci úlohy sestavení nebo vydané verze

Agent bude komunikovat se službou Azure DevOps/TFS prostřednictvím webového proxy serveru zadaného .proxy v souboru.

Vzhledem k tomu, že kód Get Source úlohy v buildech a Download Artifact úlohách ve verzích se také zapečí do agenta, budou tyto úlohy dodržovat konfiguraci proxy agenta ze .proxy souboru.

Agent zveřejňuje konfiguraci proxy serveru prostřednictvím proměnných prostředí pro každé spuštění úlohy. Autoři úloh musí k načtení konfigurace proxy serveru a zpracování proxy serveru v rámci úlohy použít metody azure-pipelines-task-lib.

Všimněte si, že mnoho nástrojů automaticky nepoužívá nastavení proxy serveru nakonfigurovaného agentem. Například nástroje, jako curl jsou a dotnet mohou vyžadovat proměnné prostředí proxy serveru, jako http_proxy je třeba nastavit také na počítači.

Určení adres URL pro obejití proxy serveru

V kořenovém adresáři agenta vytvořte .proxybypass soubor, který určuje regulární výrazy (v syntaxi ECMAScriptu), aby odpovídal adresám URL, které by měly obejít proxy server. Příklad:

github\.com
bitbucket\.com