Kurz: Jak používat upstreamové zdroje

Článek
04/04/2024

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

Použití upstreamových zdrojů v informačním kanálu umožňuje spravovat závislosti aplikace z jednoho informačního kanálu. Použití upstreamových zdrojů usnadňuje využívání balíčků z veřejných registrů při ochraně před výpadky nebo ohroženými balíčky. Můžete také publikovat vlastní balíčky do stejného informačního kanálu a spravovat všechny závislosti v jednom umístění.

V tomto kurzu se dozvíte, jak povolit upstreamové zdroje v informačním kanálu a využívat balíčky z veřejných registrů, jako jsou NuGet.org nebo npmjs.com.

V tomto kurzu:

Vytvořte nový informační kanál a povolte upstreamové zdroje.
Nastavte konfigurační soubor.
Spuštěním počátečního obnovení balíčku naplňte informační kanál.
Zkontrolujte informační kanál a zobrazte uloženou kopii balíčků, které jste spotřebovali z veřejného registru.

Vytvoření informačního kanálu a povolení upstreamových zdrojů

Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.
Vyberte Artifacts (Artefakty) a pak vyberte Create Feed (Vytvořit informační kanál ) a vytvořte nový informační kanál.
Zadejte název informačního kanálu a zvolte jeho viditelnost. Ujistěte se, že zaškrtnete políčko Zahrnout balíčky z běžných veřejných zdrojů , abyste povolili nadřazené zdroje, a pak vyberte Vytvořit , až budete hotovi.

Nastavení konfiguračního souboru

Teď, když jsme vytvořili informační kanál, musíme aktualizovat konfigurační soubor tak, aby odkazovat na náš informační kanál. Abychom to mohli udělat, musíme:

Získání adresy URL zdroje
Aktualizace konfiguračního souboru

Vyberte Artifacts (Artefakty) a pak vyberte Připojení to feed (Informační kanál).
Na levé straně stránky vyberte kartu npm .
Podle pokynů v části Nastavení projektu nastavte konfigurační soubor.

Pokud soubor .npmrc ještě nemáte, vytvořte nový soubor v kořenovém adresáři projektu (ve stejné složce jako váš package.json). Otevřete nový soubor .npmrc a vložte fragment kódu, který jste právě zkopírovali v předchozím kroku.

Vyberte Artefakty a pak v rozevíracím seznamu vyberte svůj informační kanál.
Vyberte Připojení pro podávání a pak v části Python vyberte pip.
Pokud jste to ještě neudělali, vytvořte virtuální prostředí .
Přidejte do virtuálního počítače soubor pip.ini (Windows) nebo pip.conf (Mac/Linux) a vložte následující fragment kódu:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Vyberte Artefakty a pak v rozevíracím seznamu vyberte svůj informační kanál.
Vyberte Připojení pro podávání a pak vyberte Maven.

Do oddílů v pom.xml přidejte následující fragment kódu <repositories><distributionManagement> :

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

<server> Přidejte soubor settings.xml:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Vytvořte osobní přístupový token s obory čtení a zápisu balíčku>a vložte osobní přístupový token do <password> značky v souboru settings.xml.

Vyberte Artefakty a pak v rozevíracím seznamu vyberte svůj informační kanál.
Vyberte Připojení pro podávání a pak vyberte Gradle.

Do úložišť a oddílů publikování v souboru build.gradle přidejte následující fragment kódu:

maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}

<server> Přidejte soubor settings.xml:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Vytvořte osobní přístupový token s obory čtení a zápisu balíčku>. Vložte osobní přístupový token do <password> značky v souboru settings.xml.

Obnovení balíčků

Teď, když jste povolili upstreamové zdroje a nastavili konfigurační soubor, můžeme spustit příkaz pro obnovení balíčku pro dotaz na upstreamový zdroj a načíst nadřazené balíčky.

Odeberte z projektu složku node_modules a v okně příkazového řádku se zvýšenými oprávněními spusťte následující příkaz:

npm install --force

Poznámka:

Argument --force vynutí stažení vzdálených souborů i v případě, že existuje místní kopie.