Выпуск Tephra

Эта страница описывает пошаговый процесс выполнения официального выпуска Tephra, включая развертывание выпускаемых артефактов в репозитории Maven и дополнительные административные шаги для завершения процесса выпуска.

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

Файл настроек Maven

Перед выполнением выпуска Tephra у вас должен быть в файле ~/.m2/settings.xml такой вхождение для аутентификации при развертывании артефактов выпуска:

<?xml version="1.0" encoding="UTF-8"?>
<settings xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"
    xmlns="http://maven.apache.org/SETTINGS/1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <servers>
    <server>
      <id>sonatype.snapshots</id>
      <username>USERNAME</username>
      <password>PASSWORD</password>
    </server>
    <server>
      <id>sonatype.release</id>
      <username>USERNAME</username>
      <password>PASSWORD</password>
    </server>
  </servers>
</settings>

Замените USERNAME и PASSWORD на правильные значения для вашего аккаунта. См. руководство по шифрованию Maven для подробностей о том, как избежать хранения нешифрованного пароля в файле settings.xml.

Ключ PGP -------Также вам потребуется создать пару ключей PGP (или GPG), которые будут использоваться для подписи артефактов выпуска. Для получения дополнительной информации о использовании плагина Maven GPG, см. эту введение от Sonatype и страницу использования плагина Maven GPG здесь. Вы также можете запустить gpg-agent для избежания многократного запроса пароля ключа GPG при выполнении выпуска.Выполнение выпуска ======================

Убедитесь, что локальная ветка обновлена

Сначала убедитесь, что ваша локальная копия ветки develop обновлена со всеми изменениями:

git checkout develop
git pull

Создание ветки выпуска

Следующим шагом создайте ветку выпуска из develop:

git checkout -b release/N.N.N

Замените N.N.N на желаемую версию выпуска.

Подготовка к выпуску

На ветке выпуска выполните подготовку к выпуску:

mvn clean release:prepare -P release

Это запросит у вас версию выпуска и тег git для использования при выпуске. По соглашению, мы используем vN.N.N для тега выпуска (например, v0.6.0 для выпуска 0.6.0).

Выполнение выпуска

Выполните выпуск, запустив:

mvn release:perform -P release

Это вытащит исходный код, используя тег выпуска, построит выпуск и разместит его в репозитории oss.sonatype.org.

Выпуск резервного репозитория в Artifactory

Выпустите пакет артефактов в Artifactory:

1. Войдите на https://oss.sonatype.org (вам потребуется использовать те же учетные данные, которые вы настроили в файле ~/.m2/settings.xml).
2. Перейдите в "Резервные репозитории".
3. Найдите репозиторий "comcontinuuity" с выпуском Tephra. Убедитесь, что раскрыли содержимое репозитория, чтобы подтвердить, что он содержит правильные артефакты Tephra.

4. Нажмите кнопку "Выпустить" в верхней части, и введите краткое описание, например, "Выпуск Tephra N.N.N".Обновление веток Git

После завершения выпуска обновите другие ветки Git с изменениями выпуска:

git checkout master
git merge release/6.6.6
git push origin master

git checkout develop
git merge master
git push origin develop

Объявление и завершение выпуска

Завершите выпуск в JIRA (в разделе администрирования Tephra):

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

Создайте новый выпуск в GitHub:

1. Создайте новый выпуск на основе используемого тега выпуска
2. Добавьте описание выпуска
3. Загрузите артефакты выпуска из tephra-distribution/target/

Наконец, объявите о выпуске на списке рассылки Tephra: tephra-user@googlegroups.com, tephra-dev@googlegroups.com