GitLab Agent

GitLab Agent is used to connect a Kubernetes cluster to GitLab.

GitLab Agent enables you to:

• Work with clusters behind NAT.
• Get real-time access to the cluster API.
• Receive information about events in a cluster.
• Activate a cache of Kubernetes objects that are updated with very low latency.

You can deploy GitLab Agent within a Yandex Managed Service for GitLab instance and as a standalone install.

Please note that GitLab Agent does not run CI/CD pipelines. To do this, install GitLab Runner.

1. Create Managed Service for GitLab instance or launch a standalone instance.

2. Create an agent configuration file in the repository:

   1. Open your GitLab instance and select your project.
   2. In the main branch, create a new folder called .gitlab/agents/<GitLab Agent name>.
   3. In the <GitLab Agent name> folder, create a zero-length file called config.yaml.

3. Register your agent in GitLab and get an access token:

   1. Open your GitLab instance and select your project.
   2. Click Infrastructure and select the Kubernetes clusters option.
   3. Click Connect a cluster and select <GitLab agent name> as your agent name.
   4. Click Register an agent.
   5. GitLab will create a token that you will need to install the application. Store the token in a secure place.

4. Configure the application:

   • Namespace: Select a namespace or create a new one.
   • Application name: Enter the application name, for example, gitlab-agent
   • GitLab domain name: Enter the name of your GitLab domain, such as gitlab-test.gitlab.yandexcloud.net.
   • Agent access token: Copy the GitLab access token into this field.

5. Click Install.

6. Wait for the application status to change to Deployed.

7. Open your GitLab instance and click Infrastucture → Kubernetes clusters. Make sure the agent status changed to Connected.

For more information about GitLab Agent settings, see the application documentation.

• Connect a Kubernetes cluster to GitLab.

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.