Введите не менее двух букв, чтобы искать по всем страницам документации.

↑ ↓ для навигации ↵ чтобы открыть esc чтобы закрыть

Работа с rdev

Доступ к Git

Ваш сервер сам клонирует и отправляет ваши репозитории, поэтому ему нужен собственный способ доступа к 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].