Publikování a stažení univerzálních balíčků v Azure Artifacts
Azure DevOps Services
Univerzální balíčky umožňují vývojářům ukládat širokou škálu typů balíčků nad rámec tradičních balíčků, jako jsou NuGet, npm, balíčky Pythonu atd. Pomocí Azure CLI můžete publikovat a stahovat univerzální balíčky přímo z příkazového řádku. I když se velikost publikovaných balíčků může lišit a dosahuje až 4 TB, musí vždy udržovat základní požadavek včetně názvu a čísla verze. Tento článek vás provede postupem publikování a stažení univerzálních balíčků z informačního kanálu Azure Artifacts.
Požadavky
Organizace Azure DevOps a jeden projekt. Vytvořte organizaci nebo projekt, pokud jste to ještě neudělali.
Nainstalujte rozšíření Azure DevOps verze 0.14.0 nebo vyšší.
Vytvoření informačního kanálu
Pokud už informační kanál máte, můžete přejít k další části. V opačném případě vytvořte nový informační kanál Azure Artifacts podle následujících kroků:
Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artefaktya pak vyberte Vytvořit informační kanál.
Zadejte popisný název kanálu a nastavte Viditelnost (kdo může zobrazit balíčky ve vašem kanálu). Definujte Rozsah informačního kanálu a zaškrtněte políčko Nadřazené zdroje, pokud chcete zahrnout balíčky z veřejných registrů.
Až budete hotovi, vyberte Vytvořit.
Poznámka
Nově vytvořené kanály označují roli projektu Build Service jako čtečka kanálů a upstreamu (spolupracovník) ve výchozím nastavení.
Instalace rozšíření Azure DevOps
Použití rozhraní příkazového řádku pomáhá zjednodušit vaše úlohy. Než budete pokračovat, ujistěte se, že jste nainstalovali Azure CLI (verze 2.10.1 nebo vyšší). Kromě toho budeme muset nainstalovat rozšíření Azure DevOps pro správu služeb Azure DevOps z příkazového řádku.
Spuštěním následujícího příkazu nainstalujte rozšíření Azure DevOps:
az extension add --name azure-devopsPokud už máte nainstalované rozšíření Azure DevOps a chcete ho aktualizovat na nejnovější verzi, spusťte následující příkaz:
az extension update --name azure-devops
Připojit se k kanálu
Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artefaktya potom v rozevírací nabídce vyberte svůj informační kanál.
Vyberte Připojit k informačnímu kanálua pak v levém navigačním podokně vyberte Univerzální balíčky.
Pokud se chcete připojit k informačnímu kanálu, postupujte podle pokynů v části nastavení projektu .
Spuštěním následujícího příkazu se přihlaste k Azure CLI:
az loginSpuštěním následujícího příkazu nastavte projekt a organizaci jako výchozí konfiguraci rozhraní příkazového řádku:
az devops configure --defaults project=<YOUR_PROJECT_NAME> organization=https://dev.azure.com/<YOUR_ORGANIZATION_NAME>
Poznámka
Pokud vaše organizace používá bránu firewall nebo proxy server, ujistěte se, že adresy URL a IP adresy domény Azure Artifacts.
Publikování univerzálních balíčků
Pokud chcete publikovat univerzální balíček do informačního kanálu, musíte zadat název balíčku a číslo verze.
Název balíčku by měl být malými písmeny, začínat a končit písmeny nebo číslicemi a obsahovat pouze písmena, číslice a nekontektivní pomlčky, podtržítka a tečky. Verze balíčku by měla být také psaná malými písmeny a neměla by obsahovat metadata sestavení (přípona s '+'). Další podrobnosti najdete v sémantického verzování.
Spuštěním následujícího příkazu publikujte univerzální balíček do informačního kanálu:
Informační kanál na úrovni organizace
az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>Informační kanál s oborem projektu:
az artifacts universal publish --organization https://dev.azure.com/<YOUR_ORGANIZATION> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <PACKAGE_DIRECTORY> --description <PACKAGE_DESCRIPTION>
Poznámka
Univerzální balíčky obsahující mimořádně velký počet souborů (100K+) se nemusí podařit publikovat. V takovém případě doporučujeme soubory seskupovat do archivu ZIP nebo TAR, aby se snížil počet souborů.
Zobrazení publikovaných balíčků
Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artefaktya pak v rozevírací nabídce vyberte svůj kanál. Po úspěšném dokončení procesu publikování by měl být balíček dostupný ve vašem informačním kanálu.
Stáhnout univerzální balíčky
Spuštěním následujícího příkazu stáhněte z informačního kanálu konkrétní univerzální balíček pomocí Azure CLI:
Informační kanál omezený na organizaci
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>Informační kanál s oborem projektu:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH>
Stažení konkrétních souborů
Pokud chcete stáhnout pouze určité soubory, použijte parametr --file-filter k načtení podmnožinu souborů. Další podrobnosti najdete v tématu Vzory porovnávání souborů.
Informační kanál v rámci organizace
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>Informační kanál projektu:
az artifacts universal download --organization https://dev.azure.com/<YOUR_ORGANIZATION_NAME> --project <PROJECT_NAME> --scope project --feed <FEED_NAME> --name <PACKAGE_NAME> --version <PACKAGE_VERSION> --path <DOWNLOAD_PATH> --file-filter <MATCH_PATTERN>
příklad : například použití --file-filter logs/.log by odpovídalo jakémukoli souboru s názvem obsahujícím "logs" a končící příponou ".log" (např. build_logs.log).
Stažení nejnovější verze
Můžete použít zástupné znaky * ke stažení nejnovější verze svých univerzálních balíčků.
příklady:
--version '*': stáhněte si nejnovější verzi.--version '1.*': stáhněte si nejnovější verzi s hlavní verzí 1.--version '1.2.*': stáhněte si nejnovější verzi opravy s hlavní verzí 1 a podverze 2.
Poznámka
Vzory se zástupnými znaky nejsou podporovány u předběžných verzí (balíčky s pomlčkou v čísle verze).