Commit 5c1c0b33 authored by Marcia Ramos's avatar Marcia Ramos Committed by Suzanne Selhorn

Docs: Explain deprecation of the cert-based cluster features

parent d913cdfb
...@@ -4,63 +4,60 @@ group: Configure ...@@ -4,63 +4,60 @@ group: Configure
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 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
--- ---
# Kubernetes clusters **(FREE)** # Certificate-based cluster connection (DEPRECATED) **(FREE)**
> - Project-level clusters [introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/35954) in GitLab 10.1. WARNING:
> - Group-level clusters [introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/34758) in GitLab 11.6. In GitLab 14.5, the certificate-based method to connect Kubernetes clusters
> - Instance-level clusters [introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/39840) in GitLab 11.11. to GitLab was deprecated, as well as the related [features](#deprecated-features).
Kubernetes is a container orchestration platform to deploy applications This feature is now deprecated. It had the following issues:
in a cluster without downtime and that scales as you need.
- There were security issues as it required direct access to the Kube API by GitLab.
With the GitLab integration with Kubernetes, you can: - The configuration options weren't flexible.
- The integration was flaky.
1. [Connect your cluster](#connect-your-cluster-to-gitlab). - Users were constantly reporting issues with features based on this model.
1. [Manage your cluster](#manage-your-cluster).
1. [Deploy your cluster](#deploy-to-your-cluster). For this reason, we started to build features based on a new model, the
[GitLab Kubernetes Agent](../../clusters/agent/index.md).
See the [Kubernetes clusters versions supported by GitLab](connect/index.md#supported-cluster-versions). Maintaining both methods in parallel caused a lot of confusion
and significantly increased the complexity to use, develop, maintain, and
## Connect your cluster to GitLab document them. For this reason, we decided to deprecate them to focus on the
new model.
Learn how to [create new and connect existing clusters to GitLab](connect/index.md).
Certificate-based features will continue to receive security and critical
## Manage your cluster fixes, and features built on top of it will continue to work with the supported
Kubernetes versions. The removal of these features from GitLab is not
- [Cluster Management Project](../../clusters/management_project.md): scheduled yet.
create a project to manage your cluster's shared resources requiring Follow this [epic](https://gitlab.com/groups/gitlab-org/configure/-/epics/8)
`cluster-admin` privileges such as an Ingress controller. for updates.
- [Cluster Management Project Template](../../clusters/management_project_template.md): start a cluster management project directly from a template.
- [Migrate to Cluster Management Project](../../clusters/migrating_from_gma_to_project_template.md): migrate from the deprecated GitLab Managed Apps to Cluster Management Projects. You can find technical information about why we moved away from cluster certificates into
- [GitLab Managed Apps](../../clusters/applications.md) (deprecated in favor of Cluster Management Projects): configure applications in your cluster directly from GitLab. the Kubernetes Agent model on the [Agent's blueprint documentation](../../../architecture/blueprints/gitlab_to_kubernetes_communication/index.md).
- [Cluster integrations](../../clusters/integrations.md): install
third-party applications into your cluster and manage them from GitLab. ## Deprecated features
- [GitLab-managed clusters](../../project/clusters/gitlab_managed_clusters.md):
enable GitLab to automatically create resources for your clusters. - [Create a new cluster through cluster certificates](../../project/clusters/add_remove_clusters.md)
- [Cost management](../../clusters/cost_management.md): see insights into your cluster's resource usage. - [Connect an existing cluster through cluster certificates](../../project/clusters/add_existing_cluster.md)
- [Crossplane integration](../../clusters/crossplane.md): manage your cluster's resources and cloud infrastructure with Crossplane. - [Access controls](../../project/clusters/cluster_access.md)
- [GitLab-managed clusters](../../project/clusters/gitlab_managed_clusters.md)
### Monitor your cluster - [GitLab Managed Apps](../../clusters/applications.md)
- [Deploy applications through certificate-based connection](../../project/clusters/deploy_to_cluster.md)
- [Prometheus monitoring](../../project/integrations/prometheus_library/kubernetes.md): detect and monitor Kubernetes metrics with Prometheus. - [Cluster Management Project](../../clusters/management_project.md)
- [NGINX monitoring](../../project/integrations/prometheus_library/nginx.md): automatically monitor NGINX Ingress. - [Cluster integrations](../../clusters/integrations.md)
- [Clusters health](manage/clusters_health.md): monitor your cluster's health, such as CPU and memory usage. - [Cluster cost management](../../clusters/cost_management.md)
- [Cluster environments](../../clusters/environments.md)
### Secure your cluster - [Canary Deployments](../../project/canary_deployments.md)
- [Serverless](../../project/clusters/serverless/index.md)
- [Container Host Security](../../project/clusters/protect/container_host_security/index.md): monitor and block activity inside a container and enforce security policies across the cluster. - [Deploy Boards](../../project/deploy_boards.md)
- [Container Network security](../../project/clusters/protect/container_network_security/index.md): filter traffic going in and out of the cluster and traffic between pods through a firewall with Cilium NetworkPolicies. - [Pod logs](../../project/clusters/kubernetes_pod_logs.md)
- [Container Host Security](../../project/clusters/protect/container_host_security/index.md)
## Deploy to your cluster - [Clusters health](manage/clusters_health.md)
- [Crossplane integration](../../clusters/crossplane.md)
- [CI/CD Tunnel](../../clusters/agent/ci_cd_tunnel.md): use the CI/CD Tunnel to run Kubernetes commands from different projects. - [Auto Deploy](../../../topics/autodevops/stages.md#auto-deploy)
- [Inventory object](deploy/inventory_object.md): track objects applied to a cluster configured with the Kubernetes Agent.
- [Auto DevOps](../../../topics/autodevops/index.md): enable Auto DevOps ### Cluster levels
to allow GitLab automatically detect, build, test, and deploy applications.
- [Cluster environments](../../clusters/environments.md): view CI/CD environments deployed to Kubernetes clusters. The concept of project-level, group-level, and instance-level clusters becomes
- [Canary Deployments](../../project/canary_deployments.md): deploy app updates to a small portion of the fleet with this Continuous Delivery strategy. extinct in the new model, although the functionality remains to some extent.
- [Deploy to your cluster](../../project/clusters/deploy_to_cluster.md): The Agent is always configured in a GitLab project, but you can grant your
deploy applications into your cluster using cluster certificates. cluster's access to a GitLab group through the Agent.
- [Deploy Boards](../../project/deploy_boards.md): view the current health and status of each CI/CD environment running on your cluster, and the status of deployment pods.
- [Pod logs](../../project/clusters/kubernetes_pod_logs.md): view the logs of your cluster's running pods.
- [Serverless](../../project/clusters/serverless/index.md) (deprecated): deploy Serverless applications in Kubernetes environments and cloud Function as a Service (FaaS) environments.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment