Git.alt/Справочник

Что такое git.alt?

git.alt — это хостинг git-репозиториев, интегрированный с системой хранения и сборки пакетов gear.

Как им воспользоваться?

git.alt редоставляет несколько видов доступа:

• SSH-доступ. Предоставляет несколько команд: для поиска репозиториев, их клонирования, создания, удаления, запуска сборки, контроля за состоянием сборки, а также служебных.
• ssh:, git:, http: — доступ для непосредственной работы с репозиториями. git: и http:-адреса предоставляют r/o доступ, ssh: — r/w.
• Web-интерфейс. Находится по адресу http://git.altlinux.org/, предоставляет навигацию по списку репозиториев и gitweb для индивидуальных репозиториев.

SSH-доступ к git.alt выдаётся после принятия в ALT Linux Team.

SSH-доступ

git.alt доступен по SSH по адресу git.altlinux.org:222. Аккаунт для доступа — git_$USERNAME, где USERNAME — имя, присвоенное в процессе принятия в Team, с символами «-» заменёнными на «_».

Пример ~/.ssh/config:

Host git.alt
  HostName git.altlinux.org
  Port 222
  User git_USERNAME

Для работы из-за прокси и в других сложных условиях SSH также доступен по адресу git.altlinux.org:443.

Структура репозиториев

git.alt содержит два дерева репозиториев:

• репозитории /people/$USERNAME для каждого зарегистрированного пользователя
• репозитории /archive для пакетов Sisyphus

/people

Каждому зарегистрированному на git.alt разработчику предоставляется место для git-репозиториев, начинающееся с /people/$USERNAME. Структура для хранения репозиториев жёстко определена:

/people/$USERNAME/etc

Содержит репозитории packages.git, private.git, public.git, с помощью которых можно управлять почтовой подпиской.

/people/$USERNAME/packages

Директория предназначена для хранения gear-репозиториев для пакетов Сизифа. Публично доступна.

git-репозитории в этой директории будут искаться при выполнении команды find-package, и эта директория будет использоваться по умолчанию в командах init-db, clone, build.

/people/$USERNAME/private

Директория предназначена для хранения приватных репозиториев, о существовании и содержании которых должно быть известно только самому разработчику.

Для удобства работают прямые http-ссылки на файлы репозиториев, размещённых в этой директории.

/people/$USERNAME/public

Директория предназначен для хранения публичных git-репозиториев, не являющихся gear-репозиториями для пакетов Сизифа.

/archive

В этой директории размещаются gear-репозитории пакетов Sisyphus. Поскольку репозиторий для каждого пакета создаётся с помощью утилиты gear-srpmimport на основе прошедших incoming src.rpm-пакетов, а не на основе gear-репозитория, из которых были собраны src.rpm, то репозиторий /archive следует использовать для разработки только в том случае, когда gear-репозиторий для пакета отсутствует.

Работает от

git.alt работает при помощи комплекса утилит girar, исходный код которых можно найти здесь.