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.
-
Create Managed Service for GitLab instance or launch a standalone instance.
-
Create an agent configuration file in the repository:
- Open your GitLab instance and select your project.
- In the
main
branch, create a new folder called.gitlab/agents/<GitLab Agent name>
. - In the
<GitLab Agent name>
folder, create a zero-length file calledconfig.yaml
.
-
Register your agent in GitLab and get an access token:
- Open your GitLab instance and select your project.
- Click Infrastructure and select the Kubernetes clusters option.
- Click Connect a cluster and select
<GitLab agent name>
as your agent name. - Click Register an agent.
- GitLab will create a token that you will need to install the application. Store the token in a secure place.
-
Configure the application:
- Namespace: Select a namespace or create a new one.
- Application name: Specify the app name, e.g.,
gitlab-agent
. - GitLab domain name: Enter the name of your GitLab domain, e.g.,
gitlab-test.gitlab.yandexcloud.net
. - Agent access token: Copy the GitLab access token into this field.
-
Click Install.
-
Wait for the application to change its status to
Deployed
. -
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.
Yandex Cloud technical support is available 24/7 to respond to requests. The types of requests available to you and their response time depend on your pricing plan. You can activate paid support in the management console. Learn more about requesting technical support.
Helm chart | Version | Pull-command | Documentation |
---|---|---|---|
yandex-cloud/gitlab-org/gitlab-agent/chart/gitlab-agent | 1.16.0-1 | Open |
Docker image | Version | Pull-command |
---|---|---|
yandex-cloud/gitlab-org/gitlab-agent/agentk | v16.1.3 |