From ea1eefef2896420ae4e4d248155e4c5d33b4034e Mon Sep 17 00:00:00 2001 From: Gauvain Pocentek Date: Wed, 1 May 2019 07:53:20 +0200 Subject: [PATCH] docs: Add an example of trigger token usage Closes #752 --- docs/gl_objects/builds.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/gl_objects/builds.rst b/docs/gl_objects/builds.rst index ee450905a..a80fe6d81 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 =================