На этой странице
Видео: свои репозитории0:37
Раздел «Репозитории»
Репозитории workspace: shop, ветка main; место под репозитории — до 1 ТБ.

Hangar Git хранит репозитории на самом Hangar. Код отправляется обычным git push по HTTPS: логин любой, пароль — токен Hangar. В кабинете видно файлы, README, коммиты и историю push. Сервис, подключённый к репозиторию, деплоится на каждый push в свою ветку — так же, как с GitHub.

Быстрый старт#

  1. Отправьте код

    В папке проекта выполните hangar git push. Репозиторий с именем папки создастся сам, CLI добавит remote hangar и подставит токен.

  2. Подключите сервис

    hangar git deploy ИМЯ в папке, связанной с проектом, или кнопка «Задеплоить» на странице репозитория.

  3. Пушьте дальше

    Каждый push в ветку сервиса запускает сборку и деплой. Остальные ветки просто хранятся.

bash
cd shop-api
hangar link              # связать папку с проектом (один раз)
hangar git push          # создать репозиторий и отправить код
hangar git deploy shop-api

Push и clone#

Адрес репозитория — https://api.hangar.rest/git/<workspace>/<имя>.git; он показан на странице репозитория и в hangar git list. Через CLI пароль вводить не нужно: hangar git push, hangar git clone и hangar git remote настраивают git так, что токен берётся из hangar login. Токен в настройки git не записывается.

bash
hangar git push                # текущую ветку; репозиторий создастся при первом push
hangar git push --all          # все ветки и теги
hangar git clone shop-api      # склонировать
hangar git remote shop-api     # добавить remote hangar в существующий репозиторий

Обычным git без CLI: git remote add hangar <адрес> и git push -u hangar main. Git спросит логин и пароль: логин любой, пароль — токен из Настройки → Токены или токен проекта.

bash
git remote add hangar https://api.hangar.rest/git/acme/shop-api.git
git push -u hangar main
# Username: hangar
# Password: <токен Hangar>

Доступ#

  • Токен аккаунта (hangar login, Настройки → Токены) — читать и пушить в любой репозиторий рабочего пространства; роль viewer — только читать.
  • Токен проекта (hangar tokens create) — только репозитории, привязанные к этому проекту. Удобно для CI: такой токен не откроет чужой код.
  • Проект привязывается при создании репозитория или в его настройках. hangar git push из связанной папки привязывает сам.
  • Если с одного IP идёт много неверных токенов подряд, попытки временно блокируются.

Деплой из репозитория#

Сервис с источником «Hangar Git» собирается так же, как из GitHub: Railpack или Dockerfile, корневая папка для монорепозитория, watch-паттерны. Push в ветку сервиса запускает деплой; если заданы watch-паттерны, — только когда изменились подходящие файлы.

bash
hangar git deploy shop-api --branch main --service api
# или при создании сервиса
hangar service create api --git shop-api --branch main

В кабинете: Проект → Добавить сервис → Репозиторий Hangar, либо в настройках сервиса переключить источник на Hangar Git.

Импорт с GitHub и других площадок#

Репозиторий можно перенести целиком, со всеми ветками и тегами: из GitHub, подключённого к рабочему пространству (в том числе приватный), или по публичной https-ссылке — GitLab, Bitbucket, Gitea. После импорта связь с источником не нужна.

bash
hangar git create shop --import-github acme/shop
hangar git create blog --import-url https://gitlab.com/acme/blog.git

Просмотр кода#

Кабинет → Репозитории: дерево файлов по любой ветке или тегу, файлы с номерами строк, README, история коммитов, кто и что пушил. Файлы больше 2 МБ и двоичные файлы в браузере не показываются. Из терминала:

bash
hangar git list
hangar git branches shop-api
hangar git log shop-api -n 10
hangar git files shop-api src          # содержимое папки
hangar git files shop-api README.md    # вывести файл

Место и бэкапы#

Место под репозитории зависит от тарифа: Trial — 512 МБ, Hobby — 5 ГБ, Pro — 50 ГБ на рабочее пространство. Когда место закончилось, push отклоняется, а чтение и деплой продолжают работать. Один push — до 2 ГБ. Все репозитории ежедневно копируются в хранилище бэкапов.