Підключіть свій обліковий запис GitLab, щоб розгортати сайти зі сховища

Що дає вам підключення

Підключення GitLab дозволяє розгортати сайт з одного з ваших репозиторіїв GitLab, а також дозволяє нам публікувати вміст у GitLab Pages у вашому обліковому записі, якщо ви виберете його хостом для сайту.

Перш ніж розпочати

Обліковий запис GitLab із доступом до проєктів, які ви бажаєте розгортати.

1. Створіть ключ у GitLab

У GitLab виберіть свій аватар у верхньому правому куті, потім Edit profile → Access → Personal access tokens і згенеруйте новий токен (GitLab може позначати його як Legacy token у меню Generate token). Назвіть його, установіть термін дії та позначте такі області доступу (scopes):

• api
• write_repository

Натисніть Generate token і скопіюйте його — GitLab показує його лише раз.

2. Підключіть його тут

Відкрийте розділ Integrations на панелі керування та виберіть Connect an account. Виберіть Code hosting як групу та GitLab як обліковий запис, заповніть поле API token і натисніть Connect account.

Ми перевіряємо вставлені дані, перш ніж що-небудь зберегти. Ключ, який не працює, ніколи не зберігається, а у відповіді зазначається, що саме з ним було не так. Ключ, який працює, зберігається зашифрованим у нашому сховищі секретів — ніколи в нашій базі даних — і більше ніколи не показується, навіть вам.

Що відбувається далі

• Сайт може розгортатися безпосередньо з репозиторію в цьому обліковому записі: виберіть його у підключенні репозиторію сайту, вкажіть репозиторій і гілку, і push-сповіщення запустить розгортання.
• Кожна інша гілка може отримати власний попередній перегляд, тож ви зможете перевірити зміни до того, як вони потраплять на активний сайт.
• Хостинги статичних сайтів на базі Git, такі як Render і Azure Static Web Apps, використовують це підключення як джерело коду сайту.

Якщо підключення не вдається

Працювало, а потім перестало. Термін дії токенів GitLab завжди закінчується — зазвичай максимум через рік після створення — і GitLab надсилає вам електронного листа до закінчення терміну. Створіть новий токен і підключіть його.

Відсутня область доступу (scope). Області доступу токена не можна змінити після його створення; створіть новий токен із позначеними обома областями доступу.

Повідомляється, що ключ відхилено. Майже завжди одна з трьох причин: пробіл або розрив рядка, скопійований разом із ним, ключ, термін дії якого закінчився, або ключ, який було відкликано чи згенеровано заново після того, як ви його скопіювали. Створіть новий ключ і вставте його знову.

Підключається, але пізніше виникає помилка. Ключ проходить автентифікацію, але йому бракує дозволу, необхідного для виконання дії. Створіть новий ключ із переліченими вище дозволами, потім відключіть старе підключення та підключіть новий ключ.

Відключення

Відкрийте Integrations, знайдіть обліковий запис і натисніть Disconnect. Це негайно видалить збережений ключ. Усе, що його використовувало, зупиниться під час наступної спроби виконання дії, а екрани, які від нього залежали, сповістять про це, замість того щоб безслідно припинити роботу.

Відключення не скасовує того, що вже було зроблено — записи, розгортання або налаштування, які ми змінили у вашому обліковому записі, залишаються такими, як є. Якщо ви вважаєте, що сам ключ міг скомпрометуватися, також відкличте його у постачальника послуги; відключення видаляє нашу копію, а не їхню.