Підключіть свій обліковий запис 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. Це одразу видаляє збережений ключ. Будь-який процес, який його використовував, припиниться під час наступної дії, а екрани, які від нього залежали, повідомлять про це, замість того щоб мовчки завершуватися з помилкою.

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