GitLab Runner

GitLab Runner is an open-source application that runs CI/CD pipeline jobs by following instructions from a special file called .gitlab-ci.yml. It enables you to run automated builds inside a Yandex Managed Service for Kubernetes cluster.

1. Obtain a registration token:

   • To configure GitLab Runner for the entire GitLab instance (GitLab administrative access is required):

     1. In your browser, open the GitLab Admin Area using the instance FQDN.
     2. Click Menu and select the Admin option.
     3. Select the Runners section.
     4. Click Register an instance runner and save the value of the registration token parameter.

   • To configure GitLab Runner for a group or project:

     1. In your browser, open the GitLab Admin Area using the instance FQDN.
     2. Select a group or project you want to configure.
     3. On the left-hand side of the window that opens, click Settings and select the CI/CD option.
     4. Under Runners, click Expand.
     5. Save the value of the registration token parameter.

2. Configure the application:

   • Namespace: Select a namespace or create a new one.

   • Application name: Enter a name for the application.

   • GitLab domain name: Enter a domain for your GitLab instance.

   • Registration token: Specify the previously retrieved registration token.

   • Privileged mode for running docker:dind (optional): Enable this option if you want to use docker:dind images.

     Warning

     The privileged mode increases the risk of information security incidents. Make sure to check out the documentation before using it.

   • List of tags: Provide a list of tags to distribute tasks between multiple GitLab Runner instances.

3. Click Install.

4. Wait for the application to change its status to Deployed.

5. Go back to the Runners page of your GitLab instance, reload the page, and make sure you see a new GitLab Runner.

• Launching GitLab CI/CD pipeline.

Yandex Cloud technical support is available 24/7. The types of requests you can submit and the appropriate response time depend on your pricing plan. You can switch to the paid support plan in the management console. You can learn more about the technical support terms here.