Skip to content
Snippets Groups Projects
  1. Feb 17, 2025
  2. Feb 05, 2025
  3. Feb 04, 2025
  4. Jan 28, 2025
    • Timo Furrer's avatar
      Introduce endpoint to discover cert-based clusters · 47309f44
      Timo Furrer authored
      This change set introduces a new root-level REST API endpoint called
      `/discover-cert-based-clusters`. It can be used by an authenticated user
      to find all registered certificate-based clusters in all descendant
      groups and projects given a (top-level) group id.
      
      A request will look like this:
      
      ```shell
      curl https://gitlab.example.com/api/v4/discover-cert-based-clusters?group_id=$GROUP_ID
      ```
      
      The response will look something like this:
      
      ```json
      {
        "groups": {
          "my-clusters-group": [
            {
              "id": 2,
              "name": "group-cluster-1"
            }
          ],
          "my-clusters-group/subgroup1/subsubgroup1": [
            {
              "id": 4,
              "name": "subsubgroup-cluster"
            }
          ]
        },
        "projects": {
          "my-clusters-group/subgroup1/subsubgroup1/subsubgroup-project-with-cluster": [
            {
              "id": 3,
              "name": "subsubgroup-project-cluster"
            }
          ],
          "my-clusters-group/project1-with-clustser": [
            {
              "id": 1,
              "name": "test"
            }
          ]
        }
      }
      ```
      
      This endpoint is meant to only exist for a couple of milestones, namely
      until 18.0 when the entire certificate-based cluster feature set is
      being removed.
      
      Users are encouraged to use this endpoint with a user agent like `curl`
      (or even a web browser) to discover the clusters that they may want to
      migrate before the feature is removed in 18.0.
      
      The endpoint will yield groups and projects clusters. Administrators are
      advised to use the `/clusters` endpoint to list instance-level clusters.
      
      Closes #512420
      
      Changelog: added
      47309f44
Loading