10 — Работа со своего компьютера

Для документов хватает браузера. Для настоящей работы — много файлов сразу или запуск кода — скопируйте репозиторий на свою машину.

Получить копию

Нажмите кнопку Клонировать на странице репозитория и скопируйте адрес.

git clone https://forge.kabaforce.com/owner/project.git
cd project

Ежедневный цикл

git pull              # забрать то, что изменили другие
# ... редактируем файлы ...
git status            # что я изменил?
git add .             # подготовить изменения
git commit -m "добавить заметки по установке"
git push              # отправить их в KabaForge

Если git push отклонён, значит кто-то отправил свои изменения раньше: выполните git pull, разрешите то, о чём он сообщит, и отправьте снова.

Аутентификация из командной строки

Пароль от KabaForce ID не работает по HTTPS. Вместо него создайте токен:

1. Аватар → Настройки → Приложения → Создать новый токен.
2. Дайте ему имя и только нужные права (обычно достаточно repo).
3. Скопируйте его один раз — больше он не показывается.
4. Когда git спросит пароль, вставьте токен.

Чтобы вводить его лишь однажды:

git config --global credential.helper store

SSH вместо токенов

1. Создайте ключ, если его нет: ssh-keygen -t ed25519
2. Скопируйте ~/.ssh/id_ed25519.pub.
3. Аватар → Настройки → SSH-ключи → Добавить ключ, вставьте.
4. Клонируйте по SSH-адресу, который показан в Клонировать.

После этого пароль спрашивать не будут.

Полезные мелочи

Автоматизация

Репозитории можно читать и изменять через API KabaForge с тем же токеном:

curl -H "Authorization: token ВАШ_ТОКЕН" \
  https://forge.kabaforce.com/api/v1/repos/owner/project/contents

Относитесь к токенам как к паролям: никогда не кладите их в файл, который коммитите.