Налаштовуємо approve rules для merge request у безкоштовній версії GitLab CE

Всім привіт! Я Віктор, DevOps-інженер у компанії Nixys. Ми допомагаємо різним компаніям впроваджувати передові практики DevOps, MLOps та DevSecOps.

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

До нас звернулися із завданням: "Хочемо реалізувати approve rules для merge requests у безкоштовній версії GitLab". Звичайно, я переформулював ТЗ, оскільки воно звучало більш невизначено та розпливчасто, як це зазвичай буває. На перший погляд, завдання видалося досить цікавим, але, як це часто буває в нашій роботі, ми зіткнулися з низкою викликів і обмежень.

Відразу зазначу, що ми запропонували розглянути можливість переходу на GitLab Premium, оскільки це дозволило б використовувати вбудовані функції approve rules без необхідності розробки додаткових рішень. Однак після оцінки всіх факторів бізнес вирішив, що для них важливо отримати саме approve rules, а решта переваг платної версії не настільки критична. Відповідно, якщо вдасться реалізувати цей функціонал, їх це влаштує. Це цілком виправдане рішення для молодих чи невеликих команд, які потребують лише конкретних функцій без зайвих додаткових можливостей.

Основна мета цієї статті – допомогти командам, які використовують безкоштовну версію GitLab, впровадити ефективні механізми перевірки та рецензування коду, зберігаючи при цьому гнучкість та ефективність робочих процесів. Я розповім, як ми використовували GitLab API та CI/CD для автоматизації процесу approve rules, які інструменти та методи ми застосовували, а також поділюся порадами щодо налаштування та інтеграції рішення у ваш робочий процес.

Якщо у вас немає бажання читати всю статтю, можете одразу перейти до реалізації нашого рішення → Наше рішення

Порівняння безкоштовної та платної версій GitLab

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

Основні відмінності між платною та безкоштовною версіями GitLab:

Функція

GitLab CE (безкоштовна)

GitLab Premium (платна)

Управління вихідним кодом

Налаштування approve rules

Повідомлення про безпеку

Підтримка та оновлення

Платний GitLab надає додаткові функції, які можуть суттєво покращити процеси розробки, управління проектами та забезпечення безпеки. Зокрема, можливість використання approve rules є значною перевагою платної версії, проте з нашим рішенням для автоматизації перевірки merge requests можна досягти аналогічної функціональності навіть у безкоштовній версії GitLab.

Навіщо взагалі використовувати approve rules?

Вони відіграють важливу роль у забезпеченні якості коду, безпеки та ефективності командної роботи.

Approve rules дозволяють гарантувати, що зміни в кодовій базі проходять через процес рецензування та схвалення перед злиттям. Це допомагає уникнути попадання неякісного коду в основну гілку, забезпечує відповідність коду стандартам та покращує загальну стабільність та безпеку проекту.

Контроль якості

Однією з головних завдань approve rules є покращення контролю якості коду. В рамках цих правил певні люди або групи повинні схвалити зміни перед їх злиттям у основну гілку. Це допомагає:

Виявляти помилки на ранньому етапі. Рецензенти можуть помітити помилки або потенційні проблеми в коді, які могли бути втрачені автором.
Дотримуватись код-стандартів. Рецензенти можуть перевіряти, чи відповідає код стандартам і угодам про стилі написання, які були прийняті в команді.
Підвищувати якість коду. Регулярні перевірки та обговорення коду сприяють покращенню його якості та читабельності.

Безпека

У великих проектах, де над кодом працює багато розробників, approve rules відіграють важливу роль у забезпеченні безпеки.

Захист від шкідливих змін: обов'язкові перевірки коду знижують ризик впровадження шкідливого чи ненадійного коду.
Контроль доступу: обмеження права на проведення merge requests тільки з дозволу довіреними особами чи групами запобігає несанкціонованим злиттям.
Зниження вразливостей: рецензенти можуть виявити та усунути потенційні вразливості в коді до появи в продуктивному середовищі.

Командна робота та навчання

Approve rules сприяють покращенню командної роботи та розвитку навичок членів команди:

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

Хоча в платній версії GitLab такі правила вбудовані з коробки, у безкоштовній версії їх відсутність не повинна ставати на заваді реалізації ефективних процесів у молодих або невеликих командах.

Пошук готового рішення

Звичайно, як це зазвичай буває, насамперед ми вивчили доступну документацію, а також пошукали інформацію на форумах та інших відкритих джерелах.

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

Складність налаштування. Багато рішень вимагали значних зусиль для інтеграції та налаштування.Наприклад, деякі інструменти передбачали встановлення додаткових сервісів або контейнерів, що збільшувало складність інфраструктури та потребувало додаткових ресурсів.
Обмежена функціональність. Деякі знайдені рішення були надто простими і не забезпечували достатнього рівня гнучкості та контролю, який нам був потрібен. Наприклад, вони могли перевіряти лише кількість поставлених лайків на merge request, але не дозволяли налаштовувати, хто саме має дати це схвалення.

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

Тому ми вирішили розробити власне рішення, яке повністю задовольнятиме наші вимоги і легко інтегруватиметься в систему.

Проба готового рішення

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

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

ci-mr: stage: test tags: - docker script: - echo "$" - echo "$" - echo "CI_PROJECT_ID $" - echo "CI_COMMIT_SHA $" - "export MR_INFO=$(curl --silent --request GET --header \"PRIVATE-TOKEN: $GITLAB_TOKEN_FOR_CI\" $/projects/$/merge_requests | jq -c \".[] | select(.sha == \"$\" and .state == \"opened\")\")" - echo "$" - export MR_ID=$(echo $MR_INFO | jq '.iid') - echo "$" - export MR_TITLE=$(echo $MR_INFO | jq -r '.title') - echo "$" - export MR_WIP=$(echo $MR_INFO | jq -r '.work_in_progress') - echo "$" - export MR_UPVOTES=$(echo $MR_INFO | jq '.upvotes') - echo "$" - export MR_DOWNVOTES=$(echo $MR_INFO | jq'). downvotes') - echo "$" - MR_VOTES=$((MR_UPVOTES - MR_DOWNVOTES)) - NEED_VOTES_REAL=$ - echo "MR_ID $ MR_TITLE $ MR_WIP $ MR_UPVOTES $ MR_DOWNVOTES $" - echo "MR_VO -1, MR OK if votes >=$" - | if ["$"-ge "$"]; then echo "MR OK"; else echo "MR ERROR Need more votes"; exit 1; fi image: laptevss/gitlab-api-util rules: - if: '$CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME =~ /^release\/.*$/'

Реалізація така:

Створюється окремий користувач (я створив з ім'ям "check-approve") з доступом до необхідного репозиторію та мінімальними правами - Reporter.
Для нього генерується токен, який ми кладемо у змінну GITLAB_TOKEN_FOR_CI.
Проводиться налаштування репозиторію, відключається можливість пуша безпосередньо в необхідну гілку та включається перевірка злиття (Merge checks).
Створюється окремий пайплайн, який інклюдиться у існуючі. Він за допомогою запитів до API гітлабу отримує необхідну інформацію про merge request та підраховує кількість "лайків" та "дизлайків". Далі проводиться підсумовування значень, і воно порівнюється з виставленим нами параметром (я як тест поставив 1, тобто достатньо тільки одного лайка або одного дизлайка і двох лайків).Якщо значення вище або дорівнює нашому параметру, то розблокується можливість мержить, якщо ні, потрібно більше лайків.

З нюансів:

У голосуванні може брати участь кожен користувач із доступом до репозиторію. Усі голоси будуть рівнозначними.
Кожен користувач може поставити і лайк, і дизлайк одночасно.
Після успішного мержу користувачі мають можливість прибрати свої голоси або змінити їх.
При простому перезапуску пайплайну кількість підрахованих попереднього разу голосів не зміниться, якщо не натиснути перед цим кнопку "Approve". Для наступних перерахунків потрібно протискати "Revoke approval" і знову "Approve" і лише після цього перезапускати пайплайн.

Це спірне рішення, і я маю сумніви, що воно підійде комусь. Тож я вирішив переписати метод перевірки. Потрібно було зачепитися за персоналізовану інформацію з merge request, яку можна витягти з API.

Насамперед я почав дивитися у бік коментарів, тому що був впевнений, що можна витягнути інформацію про користувача та тіло коментаря до merge request. Відповідно, на цих даних я хотів зробити перевірку, наприклад, якщо користувач ivan.ivanov залишив коментар з тілом "Approve". Я знайшов рішення і навіть запровадив.

Під час тестування я думав про те, що, можливо, можна отримати дані про користувачів, які натиснули кнопку “Approve”. Однак я постійно відганяв цю думку, будучи впевненим, що якби така можливість існувала, то підтримку approve rules не стали б виносити до GitLab Premium. Для мене це здавалося очевидною істиною. І яке ж було моє здивування, коли я, не витримавши, закопався в документацію і виявив, що така можливість справді існує!

Тільки уявіть собі: GitLab робить approve rules платною функцією, але при цьому залишає можливість отримувати інформацію про підтвердження через API. Офіційно! Я, звичайно, знатно наплювався, коли усвідомив, що до цього займався повною нісенітницею, намагаючись обійти обмеження безкоштовної версії.З одного боку, я зрозумів, скільки часу і зусиль було витрачено на розробку обхідних шляхів. З іншого боку, у мене з'явилося чітке розуміння, як можна вирішити завдання простим та елегантним способом, використовуючи доступні можливості API.

Цей момент став переломним. Я зміг інтегрувати процес перевірки та апрува так, що все запрацювало як "з коробки", без необхідності у складних та ненадійних обхідних шляхах. Усвідомлення цієї можливості в API GitLab дало нам новий інструмент, який значно спростив нашу роботу та зробив вирішення завдання набагато ефективнішим.

Наше рішення

У цьому прикладі ми припускаємо, що у вас вже налаштований проект GitLab і є базове розуміння роботи з CI/CD.

Крок 1: Включаємо перевірку злиття

Settings → Merge requests. Для "Merge checks" ставимо галочку "Pipelines must succeed".

Крок 2: Налаштовуємо "Protected branches"

Переходимо Settings → Repository → Protected branches і для необхідних гілок включаємо захист. У мене це гілки main, stage та dev, які я створив заздалегідь.

Крок 3: Налаштування токена доступу

Для доступу до API GitLab нам знадобиться персональний токен із мінімальними правами.

Створіть токен окремого користувача, створіть йому токен, далі в налаштуваннях GitLab видайте йому мінімальні права (“Reporter”) від свого робочого репозиторію.

Крок 4: Налаштування змінних

Додайте змінну для списку користувачів, які можуть надіслати merge request (APPROVAL_AUTHORS) і змінну з токеном створеним на попередньому кроці (GITLAB_TOKEN_FOR_CI). Це можна зробити через інтерфейс GitLab або файл .gitlab-ci.yml.

variables: GITLAB_TOKEN_FOR_CI: "" APPROVAL_AUTHORS: "ivan.ivanov,alex.admin,super.develop"

Крок 5: Налаштування pipeline

Створіть або відредагуйте файл .gitlab-ci-check-approve.yml, додавши наступний скрипт (звичайно, можна просто додати стадію до вже наявного pipeline, тут кому як зручніше):

ci-mr: stage: test tags: - docker script: - echo "APPROVAL_AUTHORS '$'" - echo "CI_MERGE_REQUEST_TARGET_BRANCH_NAME '$'" - | MR_INFO=$(curl --silent --request GET --header "PRIVATE-TOKEN: $GITLAB_TOKEN_FOR_CI" \ $/projects/$/merge_requests | jq -c ".[] \ | select(.sha == \"$ \" and .state == \"opened\" and .target_branch == \"$\")") - MR_ID=$(echo $MR_INFO | jq '.iid') - | APPROVALS=$(curl --silent --request GET --header "PRIVATE-TOKEN: $" \ "$/projects/$/merge_requests/$/approvals") - echo "$" - | APPROVAL_AUTHORS_ARRAY=($) APPROVED=false для AUTO в "$"; do if echo "$" | jq -e ".approved_by[] | select(.user.username == \"$\")" > /dev/null; then APPROVED=true break fi done - | if ["$" = true]; then echo "Great job! Your merge request has been approved!"; else echo "Добре! Будь ласка, approval з одного з цих користувачів: $ to proceed."; exit 1; fi image: laptevss/gitlab-api-util rules: - if: '$CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "stage" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "dev"'

Пояснення коду

Змінні: Змінні GITLAB_TOKEN_FOR_CI і APPROVAL_AUTHORS задаються через налаштування проекту.
Отримання інформації про merge request (MR_INFO): Використовується curl для запиту інформації про merge requests Фільтрується за SHA коммітом, статусом "opened" та цільовою гілкою (target_branch). За підсумками отримуємо інформацію щодо нашого відкритого merge request.
Отримання ID merge request (MR_ID): Вилучається iid з MR_INFO
Отримання інформації про схвалення (APPROVALS): Використовується curl для запиту інформації про наявні апруви необхідного merge request.
Перевірка схвалень: Перебирається масив змінної APPROVAL_AUTHORS і перевіряється, чи є серед тих, хто реально схвалив хоча б один з них. Якщо таких апрувів не знайдено, виводиться повідомлення з проханням отримати схвалення від необхідних користувачів, якщо збіг є, то виводиться повідомлення про успішний апрув.
Правила запуску стадії: у блоці rules вказані гілки, для яких ця стадія запускатиметься.

Власне, ми і переробили метод зі статті через те, що інформація, що отримується з API GitLab, містить інформацію про користувача, включаючи його username, на відміну від лайків/дизлайків, які знеособлені. У результаті такого підходу немає можливості виділити конкретного привілейованого пользователя.

Не кидайте тапками за неоптимальність скрипту, так, можна написати елегантніше, не забираючи зайву інформацію, скоротивши код і т.д. Суть не в цьому.

Інтеграція та використання

Цей скрипт можна інтегрувати в існуючі пайплайни GitLab, додавши його як інклюд:

include: - project: 'test/pipelines' file: '.gitlab-ci-check-approve.yml'

Виглядає це так:

stages: - build - test include: - project: 'test/pipelines' file: '.gitlab-ci-check-approve.yml' run-myapp: stage: build script: - echo "Hello world" tags: - docker

В результаті ми отримуємо наступну структуру:

test (група) │ ├── pipelines (репозиторій з пайплайнами) │ ├── .gitlab-ci-build-myapp.yml │ └── .gitlab-ci-check-approve.yml │ └── myapp (репозиторій додатком) ├── .gitlab-ci.yml └── text.txt

include: - project: 'test/pipelines' file: '.gitlab-ci-build-myapp.yml'

stages: - build - test include: - project: 'test/pipelines' file: '.gitlab-ci-check-approve.yml' run-myapp: stage: build script: - echo "Hello world" tags: - docker

ci-mr: stage: test tags: - docker script: - echo "APPROVAL_AUTHORS '$'" - echo "CI_MERGE_REQUEST_TARGET_BRANCH_NAME '$'" - | MR_INFO=$(curl --silent --request GET --header "PRIVATE-TOKEN: $GITLAB_TOKEN_FOR_CI" \ $/projects/$/merge_requests | jq -c ".[] \ | select(.sha == \"$ \"and .state == \"opened\" and .target_branch == \"$\")") - MR_ID=$(echo $MR_INFO | jq '.iid') - | APPROVALS=$(curl --silent --request GET --header "PRIVATE-TOKEN: $" \ "$/projects/$/merge_requests/$/approvals") - echo "$" - | APPROVAL_AUTHORS_ARRAY=($) APPROVED=false для AUTO в "$"; do if echo "$" | jq -e ".approved_by[] | select(.user.username == \"$\")" > /dev/null; then APPROVED=true break fi done - | if ["$" = true]; then echo "Great job! Your merge request has been approved!"; else echo "Добре! Будь ласка, скористався одним з цих користувачів: $ to proceed."; exit 1; fi image: laptevss/gitlab-api-util rules: - if: '$CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "stage" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "dev"'

Перевірка результату:

Отже, зараз у нас є тільки protected гілки main, stage і dev. Створимо ще пару гілок, крім них, нехай будуть test і test2 .

Зараз усі гілки ідентичні. Вливаємо у гілку test2 зміни у файлі text.txt.

Тепер створюємо merge request у гілку test. Кнопка merge активна, злиття доступне. Так і має бути, адже гілка test не захищена і вона не внесена в умову стадії rules .

Спробуємо влити зміни в будь-яку із захищених гілок main, stage або dev. Оскільки в пайплайні .gitlab-ci-check-approve.yml у блоці rules ці гілки вказані, то стадія перевірки апрувів запуститься самостійно.
В результаті, якщо ми не отримаємо схвалення від зазначених користувачів, наш merge request буде заблоковано.

Більшість є! Please get approval з одного з наступних користувачів: ivan.ivanov,alex.admin,super.develop to proceed.Cleaning up Project directory and file based variables ERROR: Job failed: exit code 1

Якщо отриманий апрув від зазначених користувачів, потрібно лише перезапустити пайплайн:

Great job! Your merge request has been approved! Cleaning up project directory and file based variables Job succeeded

Все готове, можна вливати зміни.

Висновок

Автоматизація перевірки схвалень merge requests за допомогою GitLab CI/CD та GitLab API – це ефективний та надійний спосіб оптимізувати процес керування кодом у вашій команді. Незважаючи на початкові труднощі та невірні припущення, ми змогли знайти рішення, яке робить процес перевірки схвалення merge request у безкоштовній версії GitLab максимально близьким до функціоналу преміум-версії.

Так, наше рішення вимагає створення окремих користувачів, генерації токенів доступу, налаштування змінних та пайплайнів, а також використання скриптів для перевірки схвалень. Цей процес може здатися складним на етапі впровадження, але всі ці кроки потрібно виконати лише один раз. Після цього налаштований пайплайн можна просто інклюдити у ваші проекти. Таке рішення дозволяє суттєво скоротити витрати на платне програмне забезпечення, якщо для ваших потреб критично важлива лише функція approve rules для merge request.

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

Сподіваюся, що ця стаття буде корисною і допоможе вам в автоматизації процесів контролю злиття у ваших проектах. Якщо у вас виникнуть запитання чи пропозиції, не соромтеся залишати їх у коментарях. Бажаю вам успішної розробки та продуктивної роботи з GitLab!

How to Create a Merge Request in GitLab (Step-by-Step Guide)

GitLab є популярним Open source software development platform, що забезпечує широке число нюансів для управління кодом, в тому числі й традиції, code review, і continuous integration. Один з найбільш важливих аспектів GitLab є здатність до створення merge requests, які дозволять розробникам, щоб розробити зміни до проектів code base.

У цьому матеріалі, ми будемо показувати, що ви створили merge request в GitLab. We will cover the following topics:

What is a merge request?
How to create a merge request in GitLab
How to review and approve a merge request
How to merge a merge request

Закінчивши цей матеріал, ви повинні бути здатні використовувати GitLab для створення і управління merge requests, які будуть допомагати вам зробити більш ефективним з вашим team on software development projects.

How to Create a Merge Request in GitLab

A merge request is a way to propose changes to a project’s code base. Це дозволить вам сформулювати з іншими розробниками на проекті, і сприяти тому, що зміни є виконані в consistent і orderly fashion.

У цьому повідомленні, ми будемо показувати, що ви створили merge request в GitLab. Ви будете охоплювати пререquisites для створення merge request, the steps involved in creating a merge request, і як resolve merge conflicts.

Для створення merge request в GitLab, вам потрібно:

A GitLab account
A project to which you have write access
Source branch and target branch of the merge request

Source branch is branch that contains the changes that you want to merge into target branch. target branch is branch that you want to merge the changes into.

Creating a Merge Request

Для створення merge request, follow these steps:

1. Go to the project’s Merge Requests page.
2. Click the New Merge Request button.
3. Enter a title and description for the merge request.
4. Select the source branch and target branch.
5. Click the Create Merge Request button.

Once you have created a merge request, it will be reviewed by the project’s maintainers. Якщо merge request is approved, the changes will be merged into target branch.

Resolving Merge Conflicts

Якщо є будь-які conflicts між source branch і target branch, ви будете потрібні, щоб вирішити їх перед merge request can be merged. Для того, щоб розв'язати conflict, follow these steps:

1. Click the Compare & Resolve button on merge request page.
2. Click the Resolve Conflicts button.
3. Resolve the conflicts in the editor.
4. Click the Save button.

Після того, як ви вирішили все conflicts, merge request буде ready to be merged.

У цьому повідомленні, ми висловлювалися, як витворити merge request в GitLab.Використовуються пререquisites for creating a merge request, the steps involved in creating a merge request, і як resolve merge conflicts.

We hope that this guide has been helpful. Якщо ви маєте будь-які запитання, докладно вірити безкоштовно до листа.

Prerequisites

Для створення merge request в GitLab, вам потрібно:

A GitLab account
A project to which you have write access
Source branch and target branch of the merge request

Source branch is branch that contains the changes that you want to merge into target branch. target branch is branch that you want to merge the changes into.

Creating a Merge Request

Для створення merge request, follow these steps:

Once you have created a merge request, it will be reviewed by the project’s maintainers. Якщо merge request is approved, the changes will be merged into target branch.

Resolving Merge Conflicts

1. Click the Compare & Resolve button on merge request page.
2. Click the Resolve Conflicts button.
3. Resolve the conflicts in the editor.
4. Click the Save button.

Після того, як ви вирішили все conflicts, merge request буде ready to be merged.

У цьому повідомленні, ми висловлювалися, як витворити merge request в GitLab. Використовуються пререquisites for creating a merge request, the steps involved in creating a merge request, і як resolve merge conflicts.

We hope that this guide has been helpful. Якщо ви маєте будь-які запитання, докладно вірити безкоштовно до листа.

How to Create a Merge Request in GitLab

Merge request is a way to propose changes to a project’s main branch. Це дозволить вам розробляти з іншими розробниками на проекті, і для того, щоб всі зміни були переглянуті і прийняті до того, як merged in the main branch.

Для створення merge request в GitLab, наступні ці кроки:

1. Fork the project. Якщо ви не збираєтеся вдатися до проекту, ви будете потребувати перед ним. Це буде створити копію проекту в вашому своєму рахунку.
2. Зніміть керований проект до вашого місцевого підприємства.
3. Make changes to the code.
4. Commit ваші зміни до вашої місцевої репозиторії.
5. Push your changes to your remote repository.
6. Go to the project’s Merge Requests** page.
7. Click the New Merge Request** button.
8. Enter a title and description for the merge request.
9. Виберіть source branch and target branch.
10. Click the Create Merge Request** button.

The merge request буде створено, і це буде визначено для проектів maintainers. maintainers буде review the changes in the merge request, and they will either approve or reject the request.

Якщо merge request is approved, the changes will be merged into main branch. Якщо merge request is rejected, ви будете потребувати, щоб змінити зміни до the code and resubmit the merge request.

Reviewing a Merge Request

Коли merge request is created, it is assigned to the project’s maintainers. maintainers є відповідальними для reviewing the changes in the merge request, and for approving or rejecting the request.

Для перегляду merge request, follow these steps:

1. Go to the project’s Merge Requests page.
2. Click the Merge Request link in the project’s Merge Requests page.
3. Review the changes in the merge request.
4. Add comments to merge request if you have any feedback.
5. Click the Approve or Reject button to indicate your approval or disapproval of the merge request.

Одного разу всі зміни в merge request мають бути прийняті, merge request може бути merged into main branch.

Merging a Merge Request

Одного разу всі зміни в merge request мають бути прийняті, ви можете merge the request. Для merge request, follow these steps:

1. Go to the merge request's Actions menu.
2. Click the Merge button.
3. Enter a commit message and click the Merge button.

Merge request will be merged into target branch, and the source branch will be deleted.

Merge requests є valuable tool for collaborating на проекти з іншими розробниками. Вони дозволяють виконати зміни до проектів's main branch, і для забезпечення того, щоб всі зміни були переглянуті і прийняті до того, як merged in the main branch.

Якщо ви працюєте на проекті з іншими розробниками, я буду вивчати вас, щоб використовувати merge requests to collaborate on your code. Це буде сприяти тому, що ваш проект є розроблений в consistent і maintainable way.

How do I create a merge request in GitLab?

Для створення merge request в GitLab, наступні ці кроки:

1. Navigate to repository where you want to create the merge request.
2. Click the New Merge Request button.
3. In the Source branch field, select the branch that you want to merge into target branch.
4. In the Target branch field, select the branch that you want to merge the source branch into.
5. (Optional) In the Title field, enter a title for the merge request.
6. (Optional) In the Description поле, для відображення зміни, що ви робите.
7. Click the Create merge request button.

What are the different merge request statuses?

Різні merge request statuses в GitLab are:

Opened: The merge request has been created but has not yet been reviewed.
Pending: The merge request has been reviewed and is awaiting approval.
Merged: Merge request буде been approved and merged into target branch.
Closed: The merge request has been closed for any reason other than being merged.

How do I approve a merge request?

Для застосування merge request, follow these steps:

1. Navigate to the merge request that you want to approve.
2. Click the Approve button.
3. (Optional) In the Comment поле, введіть коментар про те, що ви робите merge request.
4. Click the Submit button.

How do I reject a merge request?

Щоб відповісти на merge request, follow these steps:

1. Navigate to the merge request that you want to reject.
2. Click the Reject button.
3. (Optional) In the Comment поле, введіть коментар про те, що ви збираєтеся merge request.
4. Click the Submit button.

What are the different merge request options?

Різні merge request options в GitLab є:

Squash: Цей варіант merges source branch in target branch and squashes commits from source branch in single commit.
Rebase: Цей варіант merges source branch in the target branch and rebase commits from the source branch on the target branch.
Merge: Ця опція merges the source branch in the target branch without squashing or rebasing the commits.

How do I set up a merge request template?

Натисніть на merge request template, follow these steps:

1. Navigate to repository where you want to create the template.
2. Click the Settings tab.
3. Click the Merge Requests tab.
4. Click the Templates link.
5. Click the New template button.
6. Enter a name for the template.
7. (Optional) Введіть опис для template.
8. Click the Create template button.

How do I use a merge request template?

Для використання merge request template, follow these steps:

1. Navigate to repository where you want to create the merge request.
2. Click the New Merge Request button.
3. Click the Use template link.
4. Select the template that you want to use.
5. Click the Create merge request button.

What are the best practices for creating merge requests?

The best practices for creating merge requests include:

За допомогою clear and concise titles for your merge requests.
Проводячи detailed description of changes that you are making.
Squash or rebase your commits для створення merge request.
Виконати ваші merge request reviewed by інші developers до merging it.

Ви бачите ці значні практики, ви можете допомогти вам, що ваші merge requests є clear, concise, і easy to review.

У цьому розділі, ми повинні вивчити, як створювати merge request в GitLab. We covered the following topics:

What is a merge request?
How to create a merge request in GitLab
How to review and merge a merge request
How to resolve conflicts

We hope that this tutorial has been helpful. Для більшої інформації на GitLab, звертайтеся до офіційного документації.

Author Profile

Marcus Greenwood Hatch, встановлений в 2011 by Marcus Greenwood, has evolved сильно через рік. Marcus, призначений розробником, об'єднує rich background в розробці ланцюжка B2B і consumer software для різного роду організацій, включаючи зайві funds і web agencies.

Оригінально, Hatch був розроблений для безсумнівно merge content management with social networking. Були помічені, що соціальні функціонування були здійснені після того, як в CMS-driven веб-сайтах і входять до зміни, що. Hatch був побудований до будь-якого соціального, натхнюючи повністю integrated experience for users.

Now, Hatch embarks на новому chapter. У той час, як наша боротьба була розписана в будівництві технічних магазинів і fostering Open-source collaboration, нашого сучасного і майбутнього ставиться до роздумів про мислення і повідомлення про думи з питань. Ви будете expanded наших horizons до cover extension array topics and inquiries, розгортання в незрозумілий і unexplored.

Latest entries

December 26, 2023 Error FixingUser: Anonymous is not authorized to perform: execute-api:invoke on resource: Як fix this error
December 26, 2023 How To GuidesValid Intents Must Be Provided for the Client: Why It’s Important and How to Do It
December 26, 2023 Error FixingHow to Fix the Root Filesystem Потрібно Manual fsck Error
December 26, 2023 TroubleshootingHow to Fix the `sed unterminated s` Command

Як зробити merge в GitLab