diff options
| author | Nejc Habjan <hab.nejc@gmail.com> | 2021-10-08 19:51:14 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-08 19:51:14 +0200 |
| commit | 49fae96ad6456ecca7b34dc61647b370311b4dc3 (patch) | |
| tree | 868bcbd631ee43da7df80317a665abade4d517fe | |
| parent | 7753fa2dd009a12ceac47f4444c9a43a83bb53a9 (diff) | |
| parent | 3f423efab385b3eb1afe59ad12c2da7eaaa11d76 (diff) | |
| download | gitlab-49fae96ad6456ecca7b34dc61647b370311b4dc3.tar.gz | |
Merge pull request #1624 from axl89/docs-clarification
Clarified CI Job Token auth() caveats
| -rw-r--r-- | docs/api-usage.rst | 5 |
1 files changed, 4 insertions, 1 deletions
diff --git a/docs/api-usage.rst b/docs/api-usage.rst index e9fcd8f..f30ed03 100644 --- a/docs/api-usage.rst +++ b/docs/api-usage.rst @@ -29,6 +29,8 @@ To connect to GitLab.com or another GitLab instance, create a ``gitlab.Gitlab`` gl = gitlab.Gitlab('https://gitlab.example.com', oauth_token='my_long_token_here') # job token authentication (to be used in CI) + # bear in mind the limitations of the API endpoints it supports: + # https://docs.gitlab.com/ee/ci/jobs/ci_job_token.html import os gl = gitlab.Gitlab('https://gitlab.example.com', job_token=os.environ['CI_JOB_TOKEN']) @@ -36,7 +38,8 @@ To connect to GitLab.com or another GitLab instance, create a ``gitlab.Gitlab`` gl = gitlab.Gitlab('https://gitlab.example.com', user_agent='my-package/1.0.0') # make an API request to create the gl.user object. This is mandatory if you - # use the username/password authentication. + # use the username/password authentication - not required for token authentication, + # and will not work with job tokens. gl.auth() You can also use configuration files to create ``gitlab.Gitlab`` objects: |