Завершение выпуска
В этом документе описаны заключительные действия, которые необходимо выполнить после успешного завершения голосования по выпуску в списке рассылки dev@doris.
Контрольный список завершения выпуска
| Шаг | Действие | Исполнитель |
|---|---|---|
| 1. Загрузка пакета в Release | Переместить пакет исходного кода, файлы подписей и контрольных сумм из dev в release | Участник PMC |
| 2. Публикация репозитория Maven Staging | Нажать Release в Apache Nexus | Менеджер выпуска |
| 3. Подготовка примечаний к выпуску | Обновить GitHub Release и страницу загрузок официального сайта | Менеджер выпуска |
| 4. Удаление старых версий из SVN | Оставить только последнюю версию и заменить ссылки на старые версии архивными URL | Менеджер выпуска |
| 5. Отправка письма с объявлением | Объявить о новом выпуске в dev@doris | Менеджер выпуска |
1. Загрузка пакета в Release
После успешного завершения официального голосования по выпуску сначала отправьте письмо [Result], затем подготовьте пакет выпуска. Скопируйте пакет исходного кода, файлы подписей и файлы хешей из соответствующей папки, ранее опубликованной в dev, в новый каталог (например, 1.1.0). Примечания:
- Имя файла не должно содержать суффикс
rcxx(файл можно переименовать, но подпись нельзя создавать заново). - Хеши можно вычислить заново; результат будет тем же.
Выполнить этот шаг могут только участники PMC.
Исходный путь в SVN:
https://dist.apache.org/repos/dist/dev/doris/
Целевой путь в SVN:
https://dist.apache.org/repos/dist/release/doris/
Пример команды:
svn mv -m "move doris 1.1.0-rc05 to release" \
https://dist.apache.org/repos/dist/dev/doris/1.1 \
https://dist.apache.org/repos/dist/release/doris/1.1
При первом выпуске необходимо также скопировать файл KEYS и добавить его в каталог release в SVN. После успешного добавления опубликованные файлы будут доступны по адресу:
https://dist.apache.org/repos/dist/release/doris/1.xx/
Через некоторое время они также появятся на официальном сайте Apache:
http://www.apache.org/dist/doris/1.xx/
2. Публикация ссылок на сайте Doris и GitHub
В этом разделе в качестве примера используется Doris Core. Для других компонентов замените соответствующие названия.
2.1 Создание ссылок для скачивания
| Тип ссылки | URL |
|---|---|
| Ссылка для скачивания | http://www.apache.org/dyn/closer.cgi?filename=doris/1.xx/apache-doris-1.xx-src.tar.gz&action=download |
| Скачивание через wget | https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=doris/1.xx/apache-doris-1.xx-src.tar.gz |
| Исходное расположение | https://www.apache.org/dist/doris/1.xx/ |
| Точка входа Closer | http://www.apache.org/dyn/closer.cgi/doris/1.xx/apache-doris-1.xx-src.tar.gz |
| Пакет исходного кода | http://www.apache.org/dyn/closer.cgi/doris/1.xx/apache-doris-1.xx-src.tar.gz |
| Подпись ASC | http://archive.apache.org/dist/doris/1.xx/apache-doris-1.xx-src.tar.gz.asc |
| Контрольная сумма sha512 | http://archive.apache.org/dist/doris/1.xx/apache-doris-1.xx-src.tar.gz.sha512 |
| KEYS | http://archive.apache.org/dist/doris/KEYS |
Пример команды wget:
wget --trust-server-names "https://www.apache.org/dyn/mirrors/mirrors.cgi?action=download&filename=doris/1.xx/apache-doris-1.xx-src.tar.gz"
Подробные правила см. в рекомендациях Apache по страницам загрузок.
2.2 Maven
В промежуточных репозиториях Apache Maven найдите соответствующий Staging Repo:
- Если он ещё не закрыт, сначала нажмите
close. - Нажмите
Release, чтобы выполнить официальный выпуск.
Если на шаге
closeпоявляется сообщениеNo public key: Key with id: (xxx) was not able to be located on, выполните следующую команду, чтобы отправить открытый ключ на общедоступный сервер ключей, затем повторите закрытие:gpg --keyserver hkp://keyserver.ubuntu.com --send-keys xxxЗначение
xxxможно получить с помощьюgpg -k.
2.3 Подготовка примечаний к выпуску
Необходимо обновить информацию в двух местах:
2.3.1 Страница выпуска на GitHub
https://github.com/apache/doris/releases/tag/0.9.0-rc01
2.3.2 Страница загрузок сайта Doris
Страница загрузок представляет собой файл Markdown, расположенный по следующим путям:
docs/zh-CN/downloads/downloads.md
docs/en/downloads/downloads.md
Необходимо внести два изменения:
- Заменить URL для скачивания предыдущей версии на URL архива Apache (см. следующий раздел).
- Добавить информацию о скачивании новой версии.
2.4 Удаление старых версий из SVN
2.4.1 Удаление старых версий из SVN
В SVN достаточно хранить пакеты только последней версии. После нового выпуска удалите старые версии, чтобы по следующим двум путям остались только пакеты последней версии:
https://dist.apache.org/repos/dist/release/doris/
https://dist.apache.org/repos/dist/dev/doris/
2.4.2 Замена ссылок на URL архива
На странице загрузок сайта Doris замените URL для скачивания старых версий на URL страницы архива:
| Тип | URL |
|---|---|
| Страница загрузок | http://doris.apache.org/downloads.html |
| Страница архива | http://archive.apache.org/dist/doris |
В Apache действует механизм синхронизации, который архивирует ранее выпущенные версии. Порядок действий описан в разделе Как архивировать. Даже после удаления старых пакетов из SVN они остаются доступны на странице архива.
3. Письмо с объявлением
Тема письма:
[ANNOUNCE] Apache Doris 1.xx release
Отправьте письмо в список рассылки:
dev@doris.apache.org
Текст письма:
Hi All,
We are pleased to announce the release of Apache Doris 1.xx.
Apache Doris is an MPP-based interactive SQL data warehousing for reporting and analysis.
The release is available at:
http://doris.apache.org/master/zh-CN/downloads/downloads.html
Thanks to everyone who has contributed to this release, and the release note can be found here:
https://github.com/apache/doris/releases
Best Regards,
On behalf of the Doris team,
xxx
Часто задаваемые вопросы
Вопрос 1: При выполнении svn mv возникает ошибка прав доступа?
Только участники PMC имеют право записи в каталог release в SVN. Обычным коммиттерам необходимо обратиться к участнику PMC, чтобы он выполнил операцию от их имени.
Вопрос 2: Maven сообщает об ошибке No public key после нажатия Release?
Открытый ключ GPG не был загружен на общедоступный сервер ключей. Выполните следующую команду, чтобы отправить открытый ключ на общедоступный сервер ключей, затем повторите попытку:
gpg --keyserver hkp://keyserver.ubuntu.com --send-keys <KEY_ID>
<KEY_ID> можно получить с помощью gpg -k.
Вопрос 3: Ссылка для скачивания на сайте возвращает ошибку 404?
Возможные причины:
- Файлы только что добавлены в каталог release в SVN; распространение по CDN занимает от 10 до 30 минут.
- Старые версии удалены, но ссылки на странице загрузок ещё не заменены на URL архива.
Вопрос 4: Пользователи не могут найти старую версию для скачивания?
Apache автоматически архивирует старые версии. На странице загрузок необходимо заменить ссылки на старые версии на путь http://archive.apache.org/dist/doris/<version>/.