Gear/Справочник: различия между версиями

Версия от 19:21, 20 мая 2020

Данная страница находится в разработке.
Эта страница ещё не закончена. Информация, представленная здесь, может оказаться неполной или неверной.

Назначение

gear - инструмент для управления git-репозиториями с исходным кодом и пакетированием. gear поддерживает полный цикл управления репозиториями:

Создание репозитория или импорт существующих src.rpm-пакетов,
Обновление upstream-кода в репозиториях,
Наложение патчей и пакетирование,
Экспорт pkg.tar и src.rpm, сборка бинарных RPM-пакетов.

Принцип функционирования

gear-репозиторий - это git-репозиторий, содержащий файл .gear/rules. Этот файл (плюс несколько вспомогательных) описывают правила сборки содержимого git-репозитория в пакет формата pkg.tar или src.rpm.

pkg.tar - это основанный на tar формат для хранения пакета с исходным кодом, аналогичный src.rpm, но не требующий запуска rpmbuild для создания. hasher умеет собирать пакеты в формате pkg.tar.

Содержимое

gear состоит из набора утилит, помогающих осуществлять несколько различных действий:

Импорт пакетов с исходным кодом в gear-репозиторий:
- gear-srpmimport(1).
Обновление исходного кода в gear-репозитории:
- gear-update(1),
- gear-merge(1) - утилита для автоматизации merge разных бранчей.
Управление changelog (как в spec-файле, так и git-ового) в gear-репозитории:
- gear-changelog(1),
- gear-commit(1).
Поддержание git-тэгов в gear-репозитории:
- gear-create-tag(1) - обёртка вокруг git tag. Создаёт тэг заданного вида (по умолчанию <VERSION>-<RELEASE>) и с заданным сообщением.
- gear-update-tag(1) - утилита для поддержания .gear/tags
Экспортирование и сборка RPM-пакетов из gear-репозитория:
- gear(1),
- gear-rpm(1),
- gear-hsh(1),
- gear-remote(1),
- gear-remote-rpm(1),
- gear-remote-hsh(1).

Дополнительно имеются две утилиты

gear-hsh-build(1) — высокоуровневая обёртка вокруг gear(1), собирающая с помощью hasher несколько gear-репозиториев и укладывающая результирующие пакеты в локальный APT-репозиторий,
gear-buildreq(1) — утилита для запуска buildreq на содержимом gear-репозитория.

Утилиты экспортирования и сборки пакетов, а также gear-buildreq(1) являются простыми обёртками над низкоуровневой командой gear(1).

Правила `.gear/rules`

Управление `gear`-тэгами

Основная статья: Gear/tags

Особенности написания `.spec`-файлов

@@ Строка 1: / Строка 1: @@
-[[Категория:Sisyphus]]
-[[Категория:Devel]]
 [[Категория:Справочники]]
 {{Stub}}
+{{DISPLAYTITLE:gear/Справочник}}
 == Назначение ==
@@ Строка 14: / Строка 13: @@
 == Принцип функционирования ==
-<tt>gear</tt>-репозиторий - это <tt>git</tt>-репозиторий, содержащий файл <tt>.gear/rules</tt>. Этот файл (плюс несколько вспомогательных) описывают правила преобразования <tt>git</tt>-репозитория в пакет формата <tt>pkg.tar</tt> или <tt>src.rpm</tt>.
+<tt>gear</tt>-репозиторий - это <tt>git</tt>-репозиторий, содержащий файл <tt>.gear/rules</tt>. Этот файл (плюс несколько вспомогательных) описывают правила сборки содержимого <tt>git</tt>-репозитория в пакет формата <tt>pkg.tar</tt> или <tt>src.rpm</tt>.
-<tt>pkg.tar</tt> - это формат для хранения пакета с исходным кодом. От <tt>src.rpm</tt> простотой внутреннего устройства и лёгкостью создания. <tt>pkg.tar</tt>-пакеты собираются самим <tt>gear</tt> без привлечения <tt>rpmbuild</tt>. [[hasher]] умеет собирать пакеты в формате <tt>pkg.tar</tt>.
+<tt>pkg.tar</tt> - это основанный на <tt>tar</tt> формат для хранения пакета с исходным кодом, аналогичный <tt>src.rpm</tt>, но не требующий запуска <tt>rpmbuild</tt> для создания. [[hasher]] умеет собирать пакеты в формате <tt>pkg.tar</tt>.
 == Содержимое ==
-<tt>gear</tt> состоит из набора утилит, помогающих осуществлять несколько различных деятельностей:
+<tt>gear</tt> состоит из набора утилит, помогающих осуществлять несколько различных действий:
 # Импорт пакетов с исходным кодом в <tt>gear</tt>-репозиторий:
 #* <tt>gear-srpmimport(1)</tt>.
 # Обновление исходного кода в <tt>gear</tt>-репозитории:
 #* <tt>gear-update(1)</tt>,
-#* <tt>gear-merge(1)</tt>.
+#* <tt>gear-merge(1)</tt> - утилита для автоматизации merge разных бранчей.
 # Управление changelog (как в spec-файле, так и <tt>git</tt>-ового) в <tt>gear-репозитории</tt>:
-#* <tt>gear-changelog(1)</tt>,
+#* <tt>[[Gear/changelog|gear-changelog(1)]]</tt>,
 #* <tt>gear-commit(1)</tt>.
 # Поддержание <tt>git</tt>-тэгов в <tt>gear</tt>-репозитории:
-#* <tt>gear-create-tag(1)</tt>,
+#* <tt>gear-create-tag(1)</tt> - обёртка вокруг <tt>git tag</tt>. Создаёт тэг заданного вида (по умолчанию <VERSION>-<RELEASE>) и с заданным сообщением.
-#* <tt>gear-update-tag(1)</tt>.
+#* <tt>gear-update-tag(1)</tt> - утилита для поддержания <tt>.gear/tags</tt>
 # Экспортирование и сборка RPM-пакетов из <tt>gear</tt>-репозитория:
 #* <tt>gear(1)</tt>,
@@ Строка 41: / Строка 40: @@
 Дополнительно имеются две утилиты
-* <tt>gear-hsh-build(1)</tt> — высокоуровневая обёртка вокруг <tt>gear(1)</tt>, собирающая с помощью [[hasher]] несколько <tt>gear</tt>-репозиториев и укладывающая их в локальный APT-репозиторий,
+* <tt>gear-hsh-build(1)</tt> — высокоуровневая обёртка вокруг <tt>gear(1)</tt>, собирающая с помощью [[hasher]] несколько <tt>gear</tt>-репозиториев и укладывающая результирующие пакеты в локальный APT-репозиторий,
-* <tt>gear-buildreq(1)</tt> — утилита для запука [[buildreq]] на содержимом <tt>gear</tt>-репозитория.
+* <tt>gear-buildreq(1)</tt> — утилита для запуска [[buildreq]] на содержимом <tt>gear</tt>-репозитория.
 Утилиты экспортирования и сборки пакетов, а также <tt>gear-buildreq(1)</tt> являются простыми обёртками над низкоуровневой командой <tt>gear(1)</tt>.
@@ Строка 49: / Строка 48: @@
 == Управление <tt>gear</tt>-тэгами ==
+* {{Main|Gear/tags}}
 == Особенности написания <tt>.spec</tt>-файлов ==
+{{Category navigation|title=gear|category=gear|sortkey={{SUBPAGENAME}}}}