debian-mirror-gitlab/doc/user/clusters/agent/index.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

73 lines
3.8 KiB
Markdown
Raw Normal View History

2020-11-24 15:15:51 +05:30
---
stage: Configure
group: Configure
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-11-24 15:15:51 +05:30
---
2022-04-04 11:22:00 +05:30
# Connecting a Kubernetes cluster with GitLab
2020-11-24 15:15:51 +05:30
2022-01-26 12:08:38 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/223061) in GitLab 13.4.
2021-12-11 22:18:48 +05:30
> - Support for `grpcs` [introduced](https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/issues/7) in GitLab 13.6.
2022-05-07 20:08:51 +05:30
> - Agent server [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/300960) on GitLab.com under `wss://kas.gitlab.com` through an Early Adopter Program in GitLab 13.10.
2022-06-21 17:19:12 +05:30
> - [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/3834) in GitLab 13.11, the GitLab agent became available on GitLab.com.
2022-01-26 12:08:38 +05:30
> - [Moved](https://gitlab.com/groups/gitlab-org/-/epics/6290) from GitLab Premium to GitLab Free in 14.5.
2022-04-04 11:22:00 +05:30
> - [Renamed](https://gitlab.com/groups/gitlab-org/-/epics/7167) from "GitLab Kubernetes Agent" to "GitLab agent for Kubernetes" in GitLab 14.6.
2020-11-24 15:15:51 +05:30
2022-04-04 11:22:00 +05:30
You can connect your Kubernetes cluster with GitLab to deploy, manage,
2022-06-21 17:19:12 +05:30
and monitor your cloud-native solutions.
2020-11-24 15:15:51 +05:30
2022-05-07 20:08:51 +05:30
To connect a Kubernetes cluster to GitLab, you must first [install an agent in your cluster](install/index.md).
The agent runs in the cluster, and you can use it to:
- Communicate with a cluster, which is behind a firewall or NAT.
- Access API endpoints in a cluster in real time.
- Push information about events happening in the cluster.
- Enable a cache of Kubernetes objects, which are kept up-to-date with very low latency.
For more details about the agent's purpose and architecture, see the [architecture documentation](https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/blob/master/doc/architecture.md).
## Workflows
You can choose from two primary workflows.
In a [**GitOps** workflow](gitops.md), you keep your Kubernetes manifests in GitLab. You install a GitLab agent in your cluster, and
2022-04-04 11:22:00 +05:30
any time you update your manifests, the agent updates the cluster. This workflow is fully driven with Git and is considered pull-based,
because the cluster is pulling updates from your GitLab repository.
2022-05-07 20:08:51 +05:30
In a [**CI/CD** workflow](ci_cd_tunnel.md), you use GitLab CI/CD to query and update your cluster by using the Kubernetes API.
2022-04-04 11:22:00 +05:30
This workflow is considered push-based, because GitLab is pushing requests from GitLab CI/CD to your cluster.
## Supported cluster versions
GitLab supports the following Kubernetes versions. You can upgrade your
Kubernetes version to a supported version at any time:
2022-06-21 17:19:12 +05:30
- 1.21 (support ends on November 22, 2022)
2022-04-04 11:22:00 +05:30
- 1.20 (support ends on July 22, 2022)
GitLab supports at least two production-ready Kubernetes minor
versions at any given time. GitLab regularly reviews the supported versions and
provides a three-month deprecation period before removing support for a specific
version. The list of supported versions is based on:
- The versions supported by major managed Kubernetes providers.
- The versions [supported by the Kubernetes community](https://kubernetes.io/releases/version-skew-policy/#supported-versions).
[This epic](https://gitlab.com/groups/gitlab-org/-/epics/4827) tracks support for other Kubernetes versions.
Some GitLab features might work on versions not listed here.
2022-05-07 20:08:51 +05:30
## Migrate to the agent from the legacy certificate-based integration
2021-04-17 20:07:23 +05:30
2022-05-07 20:08:51 +05:30
Read about how to [migrate to the agent for Kubernetes](../../infrastructure/clusters/migrate_to_gitlab_agent.md) from the certificate-based integration.
2021-04-17 20:07:23 +05:30
2022-04-04 11:22:00 +05:30
## Related topics
2021-04-17 20:07:23 +05:30
2022-05-07 20:08:51 +05:30
- [GitOps workflow](gitops.md)
- [GitLab CI/CD workflow](ci_cd_tunnel.md)
- [Install the agent](install/index.md)
- [Work with the agent](repository.md)
2022-04-04 11:22:00 +05:30
- [Troubleshooting](troubleshooting.md)
2022-05-07 20:08:51 +05:30
- [Contribute to the agent's development](https://gitlab.com/gitlab-org/cluster-integration/gitlab-agent/-/tree/master/doc)