Процесс выпуска Feign

Этот репозиторий использует семантические версии. Пожалуйста, имейте это в виду при выборе номеров версий.

1. Уведомите других о выпуске

   Во время выпуска не должно быть коммитов в ветку master (примерно 10 минут). Перед началом выпуска уведомите других на gitter, чтобы они не случайно слили что-либо. Если они это сделают, и сборка завершится ошибкой из-за этого, вам придется заново создать тег выпуска, описанный ниже.

2. Добавьте git-тег

   Подготовьте следующий выпуск, запустив скрипт выпуска из чистого checkout ветки master. Этот скрипт выполнит следующие действия:

   • Обновит все версии до следующего выпуска.
   • Добавит тег выпуска.
   • Обновит все версии до следующей версии разработки.

3. Подождите CI

   Эта часть контролируется конфигурацией CircleCI, в частности задачей deploy, которая создает релизные артефакты и размещает их на Maven Central.

Кредентиалы

Для успешного выполнения процесса выпуска необходимы различные типы учетных данных. Если вы заметите, что что-то не работает из-за недостаточного разрешения, вам потребуется изменить сохраненные значения в Sonatype CircleCI Context для организации OpenFeign.SONATYPE_USER - имя пользователя аккаунта Sonatype, используемого для загрузки артефактов. SONATYPE_PASSWORD - пароль для аккаунта Sonatype. GPG_KEY - ключ GPG, используемый для подписи артефактов. GPG_PASSPHRASE - фраза-пароль для ключа GPG.### Устранение проблем с недействительными учетными данными

Если задача deploy завершается ошибкой из-за недействительных учетных данных, убедитесь, что переменные SONATYPE_USER и SONATYPE_PASSWORD верны и исправьте их.

Устранение проблем с ключами GPG

Если задача deploy завершается ошибкой при подписи артефактов, ключ GPG может быть просрочен или некорректен. Чтобы обновить GPG_KEY, вам необходимо экспортировать действительный ключ GPG в ASCII и заменить все символы новой строки на \n. Это позволит CircleCI внедрить ключ в среду таким образом, чтобы его можно было снова импортировать. Используйте следующую команду для генерации файла ключа.

gpg -a --export-secret-keys | cat -e | sed 's/$/\\n/g' > gpg_key.asc

Вставьте содержимое этого файла в переменную GPG_KEY в контексте и попробуйте задачу снова.

Первый релиз годаПлагин проверки лицензий проверяет заголовки лицензий файлов, которые включают уведомление об авторских правах, указывающее годы, в которые файл был затронут. Эта информация берется из истории git. В начале года возникает проблема с файлами, которые включают номера версий (например, pom.xml).

Когда создается тег релиза, номера версий увеличиваются, а затем коммитируются в git. При первом релизе года дальнейшие команды могут завершиться ошибкой из-за увеличения номеров версий, что делает недействительными уведомления об авторских правах. Способ решения этой проблемы следующий:Перед тем как сделать первый релиз года, переместите версию SNAPSHOT туда и обратно от текущей версии. В промежутке переустановите лицензии.

$ ./mvnw versions:set -DnewVersion=1.3.3-SNAPSHOT -DgenerateBackupPoms=false
$ ./mvnw com.mycila:license-maven-plugin:format
$ ./mvnw versions:set -DnewVersion=1.3.2-SNAPSHOT -DgenerateBackupPoms=false
$ git commit -am"Обновление заголовков авторских прав на текущий год"