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 a project:

     1. In your browser, open the GitLab Admin Area using the instance FQDN.
     2. Select the desired group or project.
     3. On the left-hand side of the resulting window, 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 an application name.

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

   • Registration token: Specify the previously retrieved registration token.

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

     Warning

     The privileged mode increases the risk of information security incidents. Please read the documentation before using it.

   • (Optional) List of tags: Provide a list of tags for task distribution across multiple GitLab Runners.

3. Click Install.

4. Click Install.

5. Wait for the GitLab Runner application to change its status to Deployed.

6. 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 responds to requests 24 hours a day, 7 days a week. The types of requests available and their response time depend on your pricing plan. You can activate paid support in the management console. Learn more about requesting technical support.