chore(clusters): deprecate clusters support

JohnVillalovos · JohnVillalovos · commit f1603e24ea28 · 2022-07-28T16:36:35.000-07:00
Cluster support was deprecated in GitLab 14.5 [1]. And disabled by default in GitLab 15.0 [2] * Update docs to mark clusters as deprecated * Remove testing of clusters * Add a `gitlab_version` pytest fixture [1] https://docs.gitlab.com/ee/api/project_clusters.html [2] https://gitlab.com/groups/gitlab-org/configure/-/epics/8
diff --git a/docs/api-objects.rst b/docs/api-objects.rst
@@ -11,7 +11,6 @@ API examples
    gl_objects/emojis
    gl_objects/badges
    gl_objects/branches
-   gl_objects/clusters
    gl_objects/messages
    gl_objects/ci_lint
    gl_objects/commits
@@ -63,3 +62,4 @@ API examples
    gl_objects/variables
    gl_objects/sidekiq
    gl_objects/wikis
+   gl_objects/clusters
diff --git a/docs/gl_objects/clusters.rst b/docs/gl_objects/clusters.rst
@@ -1,6 +1,11 @@
-############
-Clusters
-############
+#####################
+Clusters (DEPRECATED) 
+#####################
+
+.. warning::
+   Cluster support was deprecated in GitLab 14.5 and disabled by default as of
+   GitLab 15.0
+
 
 Reference
 ---------
diff --git a/tests/functional/api/test_clusters.py b/tests/functional/api/test_clusters.py
diff --git a/tests/functional/conftest.py b/tests/functional/conftest.py
@@ -1,3 +1,4 @@
+import dataclasses
 import logging
 import tempfile
 import time
@@ -12,6 +13,24 @@
 from tests.functional import helpers
 
 
+@dataclasses.dataclass
+class GitlabVersion:
+    major: int
+    minor: int
+    patch: str
+    revision: str
+
+    def __post_init__(self):
+        self.major, self.minor = int(self.major), int(self.minor)
+
+
+@pytest.fixture(scope="session")
+def gitlab_version(gl) -> GitlabVersion:
+    version, revision = gl.version()
+    major, minor, patch = version.split(".")
+    return GitlabVersion(major=major, minor=minor, patch=patch, revision=revision)
+
+
 @pytest.fixture(scope="session")
 def fixture_dir(test_dir):
     return test_dir / "functional" / "fixtures"
