- title: "SaaS certificate-based integration with Kubernetes"
  announcement_milestone: "14.5"
  announcement_date: "2021-11-15"
  removal_milestone: "15.9"
  removal_date: "2023-02-22"  # the date of the milestone release when this feature is planned to be removed
  breaking_change: true
  body: |
    The certificate-based integration with Kubernetes will be [deprecated and removed](https://about.gitlab.com/blog/2021/11/15/deprecating-the-cert-based-kubernetes-integration/). As a GitLab SaaS customer, on new namespaces, you will no longer be able to integrate GitLab and your cluster using the certificate-based approach as of GitLab 15.0. The integration for current users will be enabled per namespace.

    For a more robust, secure, forthcoming, and reliable integration with Kubernetes, we recommend you use the
    [agent for Kubernetes](https://docs.gitlab.com/ee/user/clusters/agent/) to connect Kubernetes clusters with GitLab. [How do I migrate?](https://docs.gitlab.com/ee/user/infrastructure/clusters/migrate_to_gitlab_agent.html)

    For updates and details about this deprecation, follow [this epic](https://gitlab.com/groups/gitlab-org/configure/-/epics/8).

    GitLab self-managed customers can still use the feature [with a feature flag](https://docs.gitlab.com/ee/update/deprecations.html#self-managed-certificate-based-integration-with-kubernetes).
  stage: Configure
  tiers: [Free, Premium, Ultimate]
  issue_url: 'https://gitlab.com/groups/gitlab-org/configure/-/epics/8'
  documentation_url: 'https://docs.gitlab.com/ee/user/infrastructure/clusters/#certificate-based-kubernetes-integration-deprecated'