summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/api-objects.rst1
-rw-r--r--docs/gl_objects/geo_nodes.rst43
2 files changed, 44 insertions, 0 deletions
diff --git a/docs/api-objects.rst b/docs/api-objects.rst
index 127cfa2..4e7961d 100644
--- a/docs/api-objects.rst
+++ b/docs/api-objects.rst
@@ -19,6 +19,7 @@ API examples
gl_objects/environments
gl_objects/events
gl_objects/features
+ gl_objects/geo_nodes
gl_objects/groups
gl_objects/issues
gl_objects/boards
diff --git a/docs/gl_objects/geo_nodes.rst b/docs/gl_objects/geo_nodes.rst
new file mode 100644
index 0000000..44ed391
--- /dev/null
+++ b/docs/gl_objects/geo_nodes.rst
@@ -0,0 +1,43 @@
+#########
+Geo nodes
+#########
+
+Reference
+---------
+
+* v4 API:
+
+ + :class:`gitlab.v4.objects.GeoNode`
+ + :class:`gitlab.v4.objects.GeoNodeManager`
+ + :attr:`gitlab.Gitlab.geonodes`
+
+* GitLab API: https://docs.gitlab.com/ee/api/geo_nodes.html
+
+Examples
+--------
+
+List the geo nodes::
+
+ nodes = gl.geonodes.list()
+
+Get the status of all the nodes::
+
+ status = gl.geonodes.status()
+
+Get a specific node and its status::
+
+ node = gl.geonodes.get(node_id)
+ node.status()
+
+Edit a node configuration::
+
+ node.url = 'https://secondary.mygitlab.domain'
+ node.save()
+
+Delete a node::
+
+ node.delete()
+
+List the sync failure on the current node::
+
+ failures = gl.geonodes.current_failures()