docs: add project and group cluster examples

1 files changed, 82 insertions, 0 deletions

diff --git a/docs/gl_objects/clusters.rst b/docs/gl_objects/clusters.rst
new file mode 100644
index 0000000..96edd82
--- /dev/null
+++ b/docs/gl_objects/clusters.rst
@@ -0,0 +1,82 @@
+############
+Clusters
+############
+
+Reference
+---------
+
+* v4 API:
+
+  + :class:`gitlab.v4.objects.ProjectCluster`
+  + :class:`gitlab.v4.objects.ProjectClusterManager`
+  + :attr:`gitlab.v4.objects.Project.clusters`
+  + :class:`gitlab.v4.objects.GroupCluster`
+  + :class:`gitlab.v4.objects.GroupClusterManager`
+  + :attr:`gitlab.v4.objects.Group.clusters`
+
+* GitLab API: https://docs.gitlab.com/ee/api/project_clusters.html
+* GitLab API: https://docs.gitlab.com/ee/api/group_clusters.html
+
+Examples
+--------
+
+List clusters for a project::
+
+    clusters = project.clusters.list()
+
+Create an cluster for a project::
+
+    cluster = project.clusters.create(
+    {
+        "name": "cluster1",
+        "platform_kubernetes_attributes": {
+            "api_url": "http://url",
+            "token": "tokenval",
+        },
+    })
+
+Retrieve a specific cluster for a project::
+
+    cluster = project.clusters.get(cluster_id)
+
+Update an cluster for a project::
+
+    cluster.platform_kubernetes_attributes = {"api_url": "http://newurl"}
+    cluster.save()
+
+Delete an cluster for a project::
+
+    cluster = project.clusters.delete(cluster_id)
+    # or
+    cluster.delete()
+
+
+List clusters for a group::
+
+    clusters = group.clusters.list()
+
+Create an cluster for a group::
+
+    cluster = group.clusters.create(
+    {
+        "name": "cluster1",
+        "platform_kubernetes_attributes": {
+            "api_url": "http://url",
+            "token": "tokenval",
+        },
+    })
+
+Retrieve a specific cluster for a group::
+
+    cluster = group.clusters.get(cluster_id)
+
+Update an cluster for a group::
+
+    cluster.platform_kubernetes_attributes = {"api_url": "http://newurl"}
+    cluster.save()
+
+Delete an cluster for a group::
+
+    cluster = group.clusters.delete(cluster_id)
+    # or
+    cluster.delete()