summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGauvain Pocentek <gauvain@pocentek.net>2019-05-01 07:53:20 +0200
committerGauvain Pocentek <gauvain@pocentek.net>2019-06-08 07:48:25 +0200
commitea1eefef2896420ae4e4d248155e4c5d33b4034e (patch)
treedf3b4da90c27e056dab8ae1be72afcc4c5b96387
parent794d64c8ef8ef0448205b51ff4a25c1589c2b2dd (diff)
downloadgitlab-trigger_token_example.tar.gz
docs: Add an example of trigger token usagetrigger_token_example
Closes #752
-rw-r--r--docs/gl_objects/builds.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/gl_objects/builds.rst b/docs/gl_objects/builds.rst
index ee45090..a80fe6d 100644
--- a/docs/gl_objects/builds.rst
+++ b/docs/gl_objects/builds.rst
@@ -94,6 +94,16 @@ Full example with wait for finish::
pipeline.refresh()
time.sleep(1)
+You can trigger a pipeline using token authentication instead of user
+authentication. To do so create an anonymous Gitlab instance and use lazy
+objects to get the associated project::
+
+ gl = gitlab.Gitlab(URL) # no authentication
+ project = gl.projects.get(project_id, lazy=True) # no API call
+ project.trigger_pipeline('master', trigger_token)
+
+Reference: https://docs.gitlab.com/ee/ci/triggers/#trigger-token
+
Pipeline schedule
=================