Diff for "LecturesCMC/PackageMaintaining2009"

Информация о курсе

• Лектор: Георгий Владимирович Курячий

• В течение курса возможно проведение практических занятий по сборке пакетов
• В конце курса будет экзамен
• Спецкурс проходит по средам в 18:00 в аудитории П-12. Первая лекция — 30 сентября

• Лицам, не имеющим пропуск на факультет ВМК МГУ, рекомендуется на первую лекцию принести одну матовую фотографию 3×4 и паспортные данные для оформления пропуска.

План курса

Конспекты и планы лекций

0. Организационное собрание, посвящённое выборе темы лекций (аудиозапись)

1. Дистрибутив ОС на основе свободного ПО: принципы формирования (конспект) (аудиозапись)

2. Пакет как составная часть дистрибутива: требования и особенности; понятие сборки пакета (конспект) (аудиозапись 0, аудиозапись 1)

3. Сборка пакета из исходных текстов; upstream, spec (конспект) (аудиозапись)

4. Сопровождающий (maintainer) пакета (конспект) (аудиозапись)

5. Изолированная среда сборки (введение) (конспект) (аудиозапись)

6. Лекция Александра Герасёва о пакетах в GNU Debian (конспект) (аудиозапись 0, аудиозапись 1)

7. Работа с upstream, Составление спецификаций (конспект)

8. Составление спецификаций - II, Исправление upstream (заплатки), Помещение в хранилище, Обратная связь с upstream и сообщения об ошибках (конспект) (видеозапись)

1. http://www.altlinux.org/Spec

   1. Работа с upstream
      1. Tarballs
      2. VCS, ревизии и теги
   2. Составление спецификаций
      1. Что должно быть в spec-файле, правила оформления

2. 

   1. Составление спецификаций - II
      1. Коротко о spec-файле
      2. Борьба с версиями
      3. Борьба с путями
      4. Борьба со сборочными зависимостями
      5. Макросы
   2. Исправление upstream (заплатки)

      1. patch и diff

      2. Проталкивание заплаток в upstream
   3. Помещение в хранилище
      1. src.rpm
      2. Электронная подпись участника Team и робота-сборщика
      3. hasher и локальное хранилище
   4. Обратная связь с upstream и сообщения об ошибках

      1.  Как правильно задавать вопросы

      2. Как правильно отвечать на вопросы
      3. Багзилла как пример BTS
         • Product, component, priority, severity, platform, summary, full description
         • патчи и обсуждения
         • зависимости и дубли
         • статус

3. Git, Gear и git.alt

   0. Повторение пройденного: что делает сопровождающий:
      0. Получить исходники
      1. Развернуть сборочную среду
      2. Создать/обновить спецификацию
      3. Собрать пакет
      4. Оттестировать пакет
      5. Поместить пакет в хранилище

   1. Git

      • Ссылки

        • http://www.altlinux.org/Git

        • http://progit.org/book/ru/

        • http://jenyay.net/Programming/Git

        • и т. д.
      • Что надо знать:
        • VCS
        • Распределённая VCS: публикация и слияние вместо совместного доступа
        • Ветки и теги

   2. Gear

      • Хранение исходного пакета в git-архиве

      • .gear/rules: есть документация!

        • copy:, tar:, name=, base=, @name@, @version@, @release@
      • Сборка пакета при помощи gear

        • gear-commit

        • gear --hasher -- hsh --apt-config=/home/george/.apt/x86_64/Sisyphus/config --lazy

      • gear-update

   3. git.alt

      • информация на сайте altlinux.org

      • Хранение git
      • ssh git.alt:

        $ ssh git.alt help
        Available commands:
        help
        charset <path to git repository> [<charset>]
        clone <path to git repository> [<path to directory>]
        default-branch <path to git repository> [<branch>]
        find-package <pattern>
        init-db <path to directory>
        ls [<path to directory>]
        mv-db <path to source directory> <path to destination directory>
        quota
        repack <path to git repository> [<value>]
        rm-db <path to git repository>
        task {--help|ls|show|new|add|delsub|run|share|approve|rm} ...
        build [-b <binary_repository_name>] <gear_repo_1> <gear_tag_1> ...
        acl {--help|<binary_repository_name> ...}

      • Сборка из хранилища

        $ git push && gear-create-tag && git push origin --tags && ssh git.alt build `basename $PWD` `git describe`

      • ACL: show check add/del replace leader nmu
      • Task, shared task

4. 

   1. Полный цикл сборки пакета из upstream (раассказ)
   2. Эффективные инструменты сопровождения пакетов:
      1. Адаптация к системам разработки в upstream (autotools, *make и т. п.)
      2. Адаптация к различным ЯП
      3. Поиск зависимостей и сборочных зависимостей
      4. Умолчания (триггеры, обязательные действия, пути)
      5. Хранение исходных текстов и заплаток (git.alt, gear)
      6. Совместная модификация пакета (git.alt, gear)
      7. Автоматическая сборка (git.alt, git.alt)
      8. Контроль качества (sisyphus-check, repocop, QA)
5. Полный цикл сборки пакета из upstream (практика)
   • hsh-useradd george; relogin
   • /etc/hasher-priv/system

      prefix=~:/tmp 

   • .hasher/config

      def_repo=$HOME/repo 

   • .gitconfig {{{ [user]

     • email = george@altlinux.org name = Fr. Br. George

     }}}

   • nibbles: http://rpm.pbone.net/index.php3?stat=3&search=nibbles*src.rpm

   • george@arnor:~/git/nibbles> git init
     Initialized empty Git repository in /srv/git/nibbles/.git/
     george@arnor:~/git/nibbles> gear-srpmimport ~/Downloads/nibbles-0.0.4-6.src.rpm 
     george@arnor:~/git/nibbles> cleanup_spec nibbles.spec

   • diff --git a/nibbles.spec b/nibbles.spec
     index 7b77bbb..69ffafe 100644
     --- a/nibbles.spec
     +++ b/nibbles.spec
     @@ -1,8 +1,7 @@
     -# $Revision: 1.13 $, $Date: 2002/02/15 22:40:04 $
      Summary: NCurses based nibbles game
      Name: nibbles
      Version: 0.0.4
     -Release: 6
     +Release: alt1
      License: GPL
      Vendor: Project Purple ( http://www.earth.li/projectpurple/ )
      Group: Applications/Games
     @@ -25,7 +24,7 @@ ncurses one to learn how.
      %patch2 -p1
      
      %build
     -%__make CFLAGS="%rpmcflags" LDFLAGS="%rpmldflags" DATADIR=%_datadir
     +make DATADIR=%_datadir
      
      %install
      install -d $RPM_BUILD_ROOT{%_bindir,%_datadir/games,/var/games}
     @@ -34,13 +33,11 @@ install nibbles $RPM_BUILD_ROOT%_bindir
      touch $RPM_BUILD_ROOT/var/games/nibbles.score
      cp -a nibbles.levels $RPM_BUILD_ROOT%_datadir/games
      
     -gzip -9nf README TODO HISTORY CREDITS example.nibblerc
     -
      %files
      %defattr(644,root,root,755)
     -%attr(2755,root,games) %_bindir/nibbles
     +%attr(2711,root,games) %_bindir/nibbles
      %attr(664,root,games) %config(noreplace) %verify(not size mtime md5) /var/games/nibbles
      %_datadir/games/nibbles.levels
     -%doc *.gz
     +%doc README TODO HISTORY CREDITS example.nibblerc
      
      %changelog

   • {{{ diff --git a/nibbles.spec b/nibbles.spec

index 5c09658..d9d9f99 100644 --- a/nibbles.spec +++ b/nibbles.spec @@ -10,7 +10,7 @@ Patch0: %name-Makefile.patch

• Patch1: %name-window.patch Patch2: %name-score.patch

  Url: http://www.earth.li/projectpurple/progs/nibbles.html

-BuildRequires: ncurses-devel >= 5.0 +Packager: Fr. Br. George <george@altlinux.ru>

• %description Nibbles is a remake of the classic Snake/Nibbles game in ncurses. I am
  • }}}

  •  george@arnor:~/git/nibbles> add_changelog -e "- Initial build from PLD" *spec 

  •  george@arnor:~/git/nibbles> gear-commit -a 

  •  george@arnor:~/git/nibbles> gear -v --hasher -- hsh --lazy |& tee ~/tmp/.log 

  • /etc/apt/sources.list

     rpm file:/home/george/repo x86_64 hasher 

Материалы

• Объявление о спецкурсе

CategoryUneex CategoryLectures CategorySpecCourse CategoryCmc