Nahrání úloh pipeliny do Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Nahrajte vlastní i integrované úlohy pipeline do organizace Azure DevOps nebo kolekce projektů Azure DevOps Serveru pomocí Node.js CLI (tfx-cli).

Důležitý

Při nahrávání úkolů do instance Azure DevOps Serveru nemusí být některé možnosti úloh podporované kvůli verzi agenta nebo nedostatku podpory na straně serveru.

Další informace o tfx-cli najdete v Node CLI pro Azure DevOps na GitHubu.

Požadavky

Kategorie Požadavky
Permissions Členství ve skupině Správci fondu agentů na úrovni organizace nebo kolekce Viz Skupiny zabezpečení, účty služeb a oprávnění.
Odznaky Osobní přístupový token (PAT) s rozsahem Fondy agentů (Čtení a správa) nebo token Microsoft Entra. Pro lepší zabezpečení se doporučují tokeny Entra místo osobních přístupových tokenů (PAT).
Nářadí Globálně nainstalovaná nejnovější verze Node.js a tfx-cli:npm install -g tfx-cli

Přihlášení pomocí tfx-cli

Před nahráním úkolů se přihlaste k Azure DevOps pomocí tfx-cli. Další možnosti ověřování najdete v tématu Víceplatformní ověřování rozhraní příkazového řádku pro Azure DevOps.

Po zobrazení výzvy spusťte následující příkaz a zadejte adresu URL služby a pat:

tfx login

Použijte adresu URL služby, která odpovídá vašemu prostředí:

Životní prostředí Formát adresy URL
Azure DevOps Services https://dev.azure.com/{organization}
Azure DevOps Server http://{server}:{port}/DefaultCollection

Nahrání úkolů

Spropitné

Pokud potřebujete aktualizovat přednastavené úlohy kanálu, můžete naklonovat úložiště azure-pipelines-tasks. Potom podle pokynů vytvořte požadované úkoly – jak vytvářet úkoly.

Nahrajte úkol pomocí tfx-cli:

tfx build tasks upload --task-path <PATH_TO_TASK>

PATH_TO_TASK je cesta ke složce, která obsahuje zkompilovanou úlohu, včetně task.json.

Důležitý

Agenti potrubí ukládají úlohy do mezipaměti podle verze. Pokud úlohu upravíte a znovu ji nahrajete se stejným číslem verze, budou agenti dál používat kopii uloženou v mezipaměti. Než nahrajete aktualizovaný úkol, vždy zvýšte alespoň patch verzi v task.json.

Ověřte nahrání

Potvrďte, že se úkol úspěšně nahrál:

tfx build tasks list

Výstup zobrazí seznam všech úkolů na serveru, včetně id, name, a version každého úkolu.

Odstranit úlohu

Odeberte nahraný úkol zadáním jeho ID. Získejte ID úkolu z výstupu tfx build tasks list .

tfx build tasks delete --task-id <TASK_ID>

Výstraha

Odstraněním úlohy ji smažete ze serveru. Jakýkoli kanál, který odkazuje na odstraněnou úlohu, selže při dalším spuštění.

Troubleshooting

Error Příčina Opravit
401 Neautorizováno Platnost tokenu PAT vypršela, byl odebrán nebo mu chybí oprávnění fondů agentů (čtení a správa). Vytvořte nový PAT se správným rozsahem.
403 – Zakázáno Váš účet není ve skupině Správci fondu agentů . Požádejte správce organizace, aby vás přidal.
Úkol již existuje. Nahráli jste stejnou verzi, která už je na serveru. Zvyšte číslo opravné verze v task.json a nahrajte znovu.

Další informace o tfx-cli najdete v dokumentaci k Node CLI pro Azure DevOps.

Související obsah

  • Last updated on