debian-mirror-gitlab/data/deprecations/14-5-certificate-based-integration-with-kubernetes.yml

- name: "Certificate-based integration with Kubernetes"
  announcement_milestone: "14.5"
  announcement_date: "2021-11-15"
  removal_milestone: "15.6"
  removal_date: "2022-11-22" # the date of the milestone release when this feature is planned to be removed
  breaking_change: true
  body: |
    [We are deprecating the certificate-based integration with Kubernetes](https://about.gitlab.com/blog/2021/11/15/deprecating-the-cert-based-kubernetes-integration/).
    The timeline of removal of the integration from the product is planned to happen in two steps, starting with milestone 15.0 and finishing in GitLab version 15.6.

    In 15.0, we plan to introduce a feature flag that will allow GitLab Self-Managed customers to keep the certificate-based integration enabled, it will be disabled by default. We plan to remove this feature flag together with the underlying code in GitLab version 15.6.
    The certificate-based integration will continue to receive security and
    critical fixes, and features built on the integration will continue to work with supported Kubernetes
    versions until the final removal in 15.6.

    For a more robust, secure, forthcoming, and reliable integration with Kubernetes, we recommend the use of the
    [Kubernetes Agent](https://docs.gitlab.com/ee/user/clusters/agent/) to connect Kubernetes clusters with GitLab. 
    We provide [migration plans](https://docs.gitlab.com/ee/user/infrastructure/clusters/migrate_to_gitlab_agent.html) in the documentation. 

    For updates and details around this deprecation, follow this [epic](https://gitlab.com/groups/gitlab-org/configure/-/epics/8).
  stage: Configure
  tiers: [Free, Silver, Gold, Core, 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'