Samouczek: Jak korzystać ze źródeł nadrzędnych

Artykuł
04/04/2024

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Korzystanie ze źródeł nadrzędnych w kanale informacyjnym umożliwia zarządzanie zależnościami aplikacji z jednego źródła danych. Korzystanie ze źródeł nadrzędnych ułatwia korzystanie z pakietów z publicznych rejestrów przy zachowaniu ochrony przed awariami lub naruszonymi pakietami. Możesz również opublikować własne pakiety w tym samym kanale informacyjnym i zarządzać wszystkimi zależnościami w jednej lokalizacji.

Ten samouczek przeprowadzi Cię przez proces włączania nadrzędnych źródeł w kanale informacyjnym i korzystania z pakietów z publicznych rejestrów, takich jak NuGet.org lub npmjs.com.

Ten samouczek obejmuje następujące kroki:

Utwórz nowy kanał informacyjny i włącz nadrzędne źródła.
Skonfiguruj plik konfiguracji.
Uruchom początkowe przywracanie pakietu, aby wypełnić źródło danych.
Sprawdź źródło danych, aby wyświetlić zapisaną kopię pakietów używanych z rejestru publicznego.

Tworzenie źródła danych i włączanie źródeł nadrzędnych

Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Artefakty, a następnie wybierz pozycję Utwórz źródło danych , aby utworzyć nowe źródło danych.
Podaj nazwę kanału informacyjnego i wybierz jego widoczność. Upewnij się, że zaznaczono pole wyboru Uwzględnij pakiety z typowych źródeł publicznych, aby włączyć źródła nadrzędne, a następnie po zakończeniu wybierz pozycję Utwórz .

Konfigurowanie pliku konfiguracji

Po utworzeniu kanału informacyjnego musimy zaktualizować plik konfiguracji, aby wskazywał nasz kanał informacyjny. Aby to zrobić, musimy:

Uzyskiwanie adresu URL źródła
Aktualizowanie pliku konfiguracji

npm
NuGet
Pip
Maven
Narzędzie Gradle

Wybierz pozycję Artefakty, a następnie wybierz pozycję Połączenie do kanału informacyjnego.
Po lewej stronie wybierz kartę npm .
Postępuj zgodnie z instrukcjami w sekcji Konfiguracja projektu, aby skonfigurować plik konfiguracji.

Jeśli nie masz jeszcze pliku npmrc , utwórz nowy w katalogu głównym projektu (w tym samym folderze co package.json). Otwórz nowy plik npmrc i wklej właśnie skopiowany fragment kodu w poprzednim kroku.

Wybierz pozycję Artefakty, a następnie wybierz źródło danych z listy rozwijanej.
Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję pip w sekcji Python.
Utwórz środowisko wirtualne, jeśli jeszcze tego nie zrobiono.
Dodaj plik pip.ini (Windows) lub pip.conf (Mac/Linux) do maszyny wirtualnej i wklej następujący fragment kodu:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Wybierz pozycję Artefakty, a następnie wybierz źródło danych z listy rozwijanej.
Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję Maven.

Dodaj następujący fragment kodu do <repositories> sekcji i <distributionManagement> w pom.xml:

<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>

Dodaj element <server> do pliku 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>

Utwórz osobisty token dostępu z zakresami odczytu i zapisu pakietu>i wklej osobisty token dostępu do tagu <password> w pliku settings.xml.

Wybierz pozycję Artefakty, a następnie wybierz źródło danych z listy rozwijanej.
Wybierz pozycję Połączenie do kanału informacyjnego, a następnie wybierz pozycję Gradle.

Dodaj następujący fragment kodu do repozytoriów i sekcji publikowania w pliku build.gradle:

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

Dodaj element <server> do pliku 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>

Utwórz osobisty token dostępu z zakresami odczytu i zapisu pakietu>. Wklej osobisty token dostępu do tagu <password> w pliku settings.xml.

Przywracanie pakietów

Po włączeniu nadrzędnych źródeł i skonfigurowaniu pliku konfiguracji możemy uruchomić polecenie przywracania pakietu, aby wykonać zapytanie względem nadrzędnego źródła i pobrać pakiety nadrzędne.

npm
NuGet
Pip
Maven
Narzędzie Gradle

Usuń folder node_modules z projektu i uruchom następujące polecenie w oknie wiersza polecenia z podwyższonym poziomem uprawnień:

npm install --force

Uwaga

--force Argument wymusi ściąganie zdalnych, nawet jeśli istnieje kopia lokalna.