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

Статья
04/04/2024

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

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

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

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

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

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

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

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

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

Получение 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

Примечание.

Аргумент --force принудительно извлекает удаленные данные, даже если локальная копия существует.