Ваш сервер сам клонує та надсилає ваші репозиторії, тож йому потрібен власний шлях до GitHub, GitLab, Bitbucket або вашого власного Git-сервера. Для публічних репозиторіїв нічого не потрібно. Для приватних один раз дайте серверу ключ або токен; після цього кожен проєкт просто працює.
Ключі та токени залишаються на вашому сервері. rdev.cloud бачить лише публічні ключі, а токен, який ви вводите на панелі, шифрується у вашому браузері для вашого сервера, перш ніж його буде надіслано.
Три способи доступу
| Спосіб | Дає доступ до | Найкраще для |
|---|---|---|
| Ключ сервера | Усіх репозиторіїв, які може відкрити ваш обліковий запис Git | Одного особистого облікового запису |
| Облікові записи | Репозиторіїв указаних вами власників, кожен із власним SSH-ключем або токеном | Кількох облікових записів, робочих і особистих, інших хостів |
| Ключ розгортання | Одного репозиторію | Найвужчого доступу, клієнтських репозиторіїв |
Коли сервер клонує, він вибирає перший, що підходить: ключ розгортання проєкту, потім обліковий запис, хост і власник якого збігаються з 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
Ключі розгортання
Ключ розгортання відкриває один репозиторій. У розділі Ключі розгортання введіть назву проєкту (наявного або того, який ви збираєтеся додати) і виберіть Створити ключ розгортання, а потім додайте ключ до ключів розгортання репозиторію, з доступом на запис, якщо агент має надсилати зміни. Додаючи проєкт, позначте Використати ключ розгортання проєкту або виконайте:
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 у розділі Перевірити доступ. Сервер намагається його прочитати й, якщо ви позначили Також перевірити, чи може він виконувати push, надіслати зміни, нічого не змінюючи. У відповіді сказано, який ключ або токен він використав, або що робити далі. З терміналу: rdev git test <url> [--write].