Apache Yetus
Apache Yetus — это набор библиотек и инструментов, которые упрощают процесс разработки и выпуска программного обеспечения.
Вот список основных компонентов:
Website source — содержит документацию, которая представлена на нашем веб-сайте.
Precommit — предоставляет надёжные инструменты для работы с вкладами, включая применение патчей из различных источников проекта и их оценку в соответствии с нормами проекта через систему плагинов. Для начала работы с precommit ознакомьтесь с обзором архитектуры precommit.
Audience Annotations — позволяет проектам использовать Java-аннотации для разграничения публичных и непубличных частей своих API. Также предоставляет доклеты для создания javadocs, отфильтрованных по целевой аудитории. В настоящее время собирается с Maven 3.2.0+.
Shelldocs — обрабатывает комментарии к функциям Bash для аннотаций, аналогичных Javadoc. Также включает встроенную функцию определения области видимости аудитории, аналогичную доклету Audience Annotations.
Release Doc Maker — анализирует информацию Jira и Git для создания заметок о выпуске в формате Markdown.
yetus-maven-plugin — создаёт плагин maven, который предоставляет некоторые небольшие утилиты для некоторых необычных требований maven (например, символические ссылки), а также является maven-версиями некоторых функций Apache Yetus.
Полные инструкции по сборке выпусков и веб-сайта см. в руководстве по внесению вклада для требований и инструкций.
# Запустите контейнер Docker, который имеет все зависимости проекта
# и рабочую среду сборки.
./start-build-env.sh
# Соберите двоичный архив tarball, расположенный в yetus-dist/target/artifacts:
mvn clean install
# Создайте двоичные и исходные архивы tarball и подпишите содержимое:
mvn clean install -Papache-release
# То же самое, но если вы находитесь вне контейнера и вам нужно сообщить системе,
# что ОС использует 'gpg2' вместо 'gpg':
mvn clean install -Papache-release -Pgpg2
# Создайте двоичный и исходный архивы tarball, но пропустите их подписание:
mvn clean install -Papache-release -Dgpg.sign=skip
# Создайте веб-сайт (сначала требуется mvn install):
mvn site site:stage
После выполнения одной или нескольких команд Apache Maven артефакты будут находиться в yetus-dist/target/artifacts
или готовы к mvn deploy
.
Проект предоставляет два удобных образа контейнеров на https://ghcr.io как для помеченных выпусков, так и для основной ветки. Рекомендуется, чтобы обычные пользователи использовали помеченный выпуск, чтобы не удивляться несовместимым изменениям, которые всё ещё происходят в основной ветке.
Этот образ содержит все инструменты, поддерживаемые Apache Yetus. Он предназначен для использования, когда двоичные файлы Apache Yetus работают вне контейнера, чтобы ускорить сборку фактического тестового контейнера.
Этот образ содержит всё, что есть в ghcr.io/apache/yetus-base, плюс собранная и установленная версия Apache Yetus. Двоичные файлы находятся в /usr/bin
и... Поэтому часть пути по умолчанию. Это изображение идеально подходит для систем непрерывной интеграции (CI), которые используют образ контейнера в качестве операционной среды, или для интерактивного использования.
Вы можете оставить комментарий после Вход в систему
Неприемлемый контент может быть отображен здесь и не будет показан на странице. Вы можете проверить и изменить его с помощью соответствующей функции редактирования.
Если вы подтверждаете, что содержание не содержит непристойной лексики/перенаправления на рекламу/насилия/вульгарной порнографии/нарушений/пиратства/ложного/незначительного или незаконного контента, связанного с национальными законами и предписаниями, вы можете нажать «Отправить» для подачи апелляции, и мы обработаем ее как можно скорее.
Комментарии ( 0 )