Начало работы с пакетами Maven в Azure Artifacts

Сервисы Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Пакеты Maven — это двоичные файлы Java, созданные с помощью средства сборки Apache Maven. С помощью фидов Azure Artifacts можно хранить различные типы пакетов в одном фиде. Затем сохраненные пакеты можно восстановить для сборки проекта или совместного использования с командой и клиентами. Каналы Azure Artifacts также поддерживают получение пакетов из общедоступных реестров, таких как Maven Central, Google Maven Repository, Gradle Plugins и JitPack через внешние источники.

В этой статье описано, как настроить проект Maven, подключить его к веб-каналу Azure Artifacts, а также опубликовать и восстановить пакеты Maven.

Предварительные требования

Продукт Требования
Azure DevOps — Организация Azure DevOps.
— проект Azure DevOps .
- Скачайте и установите Apache Maven.

Создать ленту

Если у вас уже есть веб-канал, перейдите к следующему разделу. В противном случае создайте новый веб-канал следующим образом:

  1. Войдите в организацию Azure DevOps и перейдите к проекту.

  2. Выберите Артефакты, затем выберите Создать фид.

  3. Укажите имя веб-канала, выберите видимость , чтобы определить, кто может просматривать пакеты и выбрать область веб-канала. Если вы хотите включить пакеты из общедоступных реестров, таких как Maven Central или Google Maven Репозиторий, проверьте включение пакетов из общих общедоступных источников.

  4. После завершения работы выберите Создать.

Подключиться к каналу

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

  1. Создайте личный маркер доступа с Упаковка и > областью. Скопируйте ваш PAT и сохраните его в безопасном месте, так как он потребуется вам в следующих шагах.

  2. Войдите в Azure DevOps и перейдите к проекту.

  3. Выберите Артефакты, а затем выберите ваш веб-канал в раскрывающемся меню.

  4. Выберите "Подключиться к каналу" и выберите Maven в области навигации слева.

  5. Если вы впервые используете Azure Artifacts с Maven на этом компьютере, убедитесь, что установлены необходимые компоненты.

  6. Откройте файл pom.xml и добавьте предоставленный фрагмент кода в раздел установки проекта, в секции <repositories> и <distributionManagement>. pom.xml должен выглядеть следующим образом:

        <repositories>
        <repository>
            <id>FEED_NAME</id>
            <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
            <releases>
            <enabled>true</enabled>
            </releases>
            <snapshots>
            <enabled>true</enabled>
            </snapshots>
        </repository>
    </repositories>
    <distributionManagement>
        <repository>
            <id>FEED_NAME</id>
            <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
            <releases>
            <enabled>true</enabled>
            </releases>
            <snapshots>
            <enabled>true</enabled>
            </snapshots>
        </repository>
    </distributionManagement>

  7. Откройте settings.xml уровня пользователя и добавьте PAT в <password> тег. Этот файл должен храниться локально, поэтому убедитесь, что не переносите его в исходный код, чтобы ваши учетные данные не были раскрыты. Файл settings.xml должен выглядеть следующим образом:

        <servers>
        <server>
            <id>MavenDemo</id>
            <username><ORGANIZATION_NAME></username>
            <password>[PERSONAL_ACCESS_TOKEN]</password>
        </server>
    </servers>

Публикация пакетов

Теперь, когда вы выполнили проверку подлинности с помощью потока, вы готовы к публикации и восстановлению пакетов.

  1. Если вы еще не создадите пакет, откройте окно командной строки и перейдите в каталог проекта, где находится файл pom.xml , а затем выполните следующую команду, чтобы упаковать проект. Эта команда компилирует код, выполняет тесты, включенные и упаковает проект в распространяемый формат (например, JAR-файл).

    mvn package

  2. Выполните следующую команду в каталоге вашего проекта, чтобы опубликовать пакет в ваш канал пакетов:

    mvn deploy

  3. После успешной публикации пакета он скоро будет доступен в веб-канале Azure Artifacts.

    Снимок экрана: пакет Maven, развернутый в веб-канале.

Примечание.

Если ваша организация использует брандмауэр или прокси-сервер, убедитесь, что вы разрешили доступ к URL-адресам и IP-адресам домена Azure Artifacts.

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

Чтобы восстановить пакеты из вашего фида, выполните команду mvn install из каталога вашего проекта, чтобы установить все зависимости, перечисленные в pom.xml. Если пакет, который вы хотите установить из веб-канала, не находится в pom.xml, вот как добавить его и восстановить из веб-канала:

  1. Войдите в Azure DevOps и перейдите к проекту.

  2. Выберите Артефакты, а затем выберите ваш веб-канал в раскрывающемся меню.

  3. Выберите пакет, который нужно установить, перейдите к обзору>Maven, а затем скопируйте фрагмент зависимостей. Он должен выглядеть примерно так:

    <dependency>
  <groupId>MyGroup</groupId>
  <artifactId>MavenQuickStartDemo</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

  4. Откройте файл pom.xml и вставьте фрагмент кода в <dependencies> тег.

  5. Выполните следующую команду из каталога, где находится файл pom.xml , чтобы восстановить пакеты:

    mvn install

Связанный контент

  • Last updated on