Руководство: Использование вышестоящих источников

Статья
09/27/2024

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

Использование вышестоящих источников в веб-канале позволяет управлять зависимостями приложения из одного веб-канала. Использование вышестоящих источников упрощает использование пакетов из общедоступных реестров при защите от сбоев или скомпрометированных пакетов. Вы также можете публиковать собственные пакеты в одном канале и управлять всеми зависимостями в одном расположении.

В этом руководстве описано, как включить вышестоящий источник в веб-канале и использовать пакеты из общедоступных реестров, таких как NuGet.org или npmjs.com.

При работе с этим руководством вы сделаете следующее:

Создайте веб-канал и включите источники вышестоящего канала.
Настройте файл конфигурации.
Запустите начальное восстановление пакета, чтобы заполнить веб-канал.
Проверьте веб-канал, чтобы просмотреть сохраненную копию пакетов, потребляемых из общедоступного реестра.

Создание веб-канала и включение источников вышестоящего канала

Войдите в организацию Azure DevOps и перейдите к проекту.
Выберите артефакты и нажмите кнопку "Создать веб-канал", чтобы создать новый веб-канал .
Укажите имя веб-канала и выберите его видимость. Убедитесь, что установлен флажок "Включить пакеты из общих общедоступных источников ", чтобы включить вышестоящий источник, а затем нажмите кнопку "Создать " после завершения.

Примечание.

Чтобы добавить веб-канал из другой организации в качестве вышестоящего источника, владелец целевого веб-канала должен предоставить общий доступ к целевому представлению со всеми веб-каналами и людьми в организациях, связанных с моим клиентом Microsoft Entra, перейдя к представлению "Параметры>> канала", нажмите кнопку с многоточием справа для указанного изменения представления.>

Настройка файла конфигурации

Теперь, когда мы создали наш веб-канал, нам нужно обновить файл конфигурации, чтобы указать на наш веб-канал. Для этого необходимо:

Получение URL-адреса источника
Обновление файла конфигурации

Выберите артефакты и нажмите кнопку "Подключиться к каналу".
В левой части страницы выберите вкладку npm .
Следуйте инструкциям в разделе "Настройка проекта", чтобы настроить файл конфигурации.

Если у вас еще нет NPMRC-файла , создайте новый файл в корне проекта (в той же папке, что и package.json). Откройте новый NPMRC-файл и вставьте фрагмент кода, скопированный на предыдущем шаге.

Выберите артефакты и выберите веб-канал из раскрывающегося списка.
Выберите "Подключиться к каналу" и выберите pip в разделе Python.
Создайте виртуальную среду , если это еще не сделано.
Добавьте файл pip.ini (Windows) или pip.conf (Mac/Linux) в virtualenv и вставьте следующий фрагмент кода:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Выберите артефакты и выберите веб-канал из раскрывающегося списка.
Выберите "Подключиться к каналу" и выберите Maven.

Добавьте в pom.xml следующий фрагмент <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> 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>

Создайте личный маркер доступа с помощью областей чтения и записи упаковки>и вставьте свой личный маркер доступа в <password> тег в файле settings.xml.

Выберите артефакты и выберите веб-канал из раскрывающегося списка.
Выберите "Подключиться к каналу" и выберите "Gradle".

Добавьте следующий фрагмент кода в репозитории и разделы публикации в файле build.gradle:

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

Добавьте файл <server> 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>

Создайте личный маркер доступа с помощью областей чтения и записи упаковки>. Вставьте личный <password> маркер доступа в тег в файле settings.xml.

Восстановление пакетов

Теперь, когда вы включили вышестоящий источник и настроили файл конфигурации, мы можем запустить команду восстановления пакета, чтобы запросить вышестоящий источник и получить вышестоящий пакет.

Удалите папку node_modules из проекта и выполните следующую команду в окне командной строки с повышенными привилегиями:

npm install --force