Ваш сервер сам клонирует и отправляет ваши репозитории, поэтому ему нужен собственный способ доступа к GitHub, GitLab, Bitbucket или вашему Git-серверу. Для публичных репозиториев ничего не нужно. Для приватных один раз дайте серверу ключ или токен; после этого каждый проект просто работает.
Ключи и токены остаются на вашем сервере. rdev.cloud видит только публичные ключи, а токен, который вы вводите в панели, шифруется в вашем браузере для вашего сервера перед отправкой.
Три способа доступа
| Способ | Доступ к | Лучше всего подходит для |
|---|---|---|
| Ключ сервера | Каждый репозиторий, который может открыть ваш Git-аккаунт | Один личный аккаунт |
| Аккаунты | Репозитории указанных вами владельцев, у каждого свой SSH-ключ или токен | Несколько аккаунтов, рабочих и личных, другие хосты |
| Deploy-ключ | Один репозиторий | Самый узкий доступ, клиентские репозитории |
При клонировании сервер выбирает первый подходящий: deploy-ключ проекта, затем аккаунт, чьи хост и владелец совпадают с URL, затем ключ сервера. Если SSH-клонирование отклонено, а репозиторий публичный, он переходит на HTTPS. Каждый клон запоминает, как был открыт, поэтому git pull и git push продолжают работать.
Ключ сервера
Откройте сервер в разделе Серверы, перейдите на вкладку Доступ и найдите Доступ к Git. В первый раз выберите Создать ключ, скопируйте ключ и добавьте его в свой аккаунт: у GitHub, GitLab и Bitbucket есть по кнопке, которая открывает нужную страницу. Тот же ключ работает для отправки изменений, поэтому ваш ИИ-агент тоже может делать push.
Из терминала сервера:
rdev git key # print the key (made on first use)
rdev git key --rotate # make a new one; remove the old one from your hosts
Аккаунты
Добавляйте столько аккаунтов, сколько нужно: два аккаунта GitHub, корпоративный GitLab, Bitbucket и собственный Gitea рядом. У каждого аккаунта есть:
- Название: короткое, например
workилиpersonal. - Хост:
github.com,gitlab.com,bitbucket.orgили ваш собственный, с:port, если SSH не на порту 22. - Владельцы: необязательные пользователи или организации. Репозитории под ними используют этот аккаунт; без владельцев его используют все репозитории на хосте.
- SSH-ключ или токен: SSH-аккаунт получает собственный ключ, который нужно добавить на хосте. Аккаунт с токеном клонирует по HTTPS с помощью персонального токена доступа (детализированный токен GitHub, персональный токен или токен проекта GitLab, API-токен Bitbucket, PAT Azure DevOps). GitLab ожидает имя пользователя
oauth2, Bitbucket — ваш адрес электронной почты.
В панели выберите Добавить аккаунт. В приложении для ноутбука тот же список находится на вкладке Интеграции. Из терминала:
rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab
Deploy-ключи
Deploy-ключ открывает один репозиторий. В разделе Deploy-ключи введите название проекта (существующего или того, который вы собираетесь добавить) и выберите Создать deploy-ключ, затем добавьте ключ в deploy-ключи репозитория, с правом записи, если агент должен делать push. При добавлении проекта отметьте Использовать deploy-ключ проекта или выполните:
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Доверие к хосту
Сервер уже знает ключи GitHub, GitLab и Bitbucket. Впервые встретив другой хост, он не подключается вслепую: хост появляется в разделе Хосты, ожидающие доверия вместе с отпечатком. Сравните его с тем, который публикует ваш Git-хост, и выберите Доверять, либо выполните rdev git trust git.example.com --fingerprint SHA256:….
Проверка доступа
Перед добавлением проекта вставьте его URL в разделе Проверить доступ. Сервер пытается прочитать его и, если вы отметили Также проверить право на отправку изменений, отправить изменения, ничего не меняя. В ответе указано, какой ключ или токен использовался, либо что делать дальше. Из терминала: rdev git test <url> [--write].