gitlab: Add access token name, Update docs, Fix webhook

Highlight that Access Token:
- can be created at project level and user level
- can be used to authenticate when cloning repositories

To clone internal or private projects, authentication is required. It
can be achieved using the Access Token. Currently, any names can be used
but [1] shows that it's likely going to be restricted to username and
token-name. As token-name is directly related to an Access Token, use
this value.

webhook can be created foreach project but also at group level, so at
the topmost group. Therefor only one webhook at the upper group can be
used to send events to Zuul: remove "project" from webhook_token
description

[1] https://gitlab.com/gitlab-org/gitlab/-/issues/212953

Change-Id: I57adb5e03658d31bd3900d2d9037101cf491466e

1 files changed, 25 insertions, 0 deletions

diff --git a/tests/fixtures/zuul-gitlab-driver.conf b/tests/fixtures/zuul-gitlab-driver.conf
index 9a5406045..d1ab4f8b8 100644
--- a/tests/fixtures/zuul-gitlab-driver.conf
+++ b/tests/fixtures/zuul-gitlab-driver.conf
@@ -20,3 +20,28 @@ api_token=0000000000000000000000000000000000000000
 [database]
 dburi=$MYSQL_FIXTURE_DBURI$
 
+[connection gitlab2]
+driver=gitlab
+server=gitlabtwo
+api_token=2222
+cloneurl=http://myusername:2222@gitlab
+
+[connection gitlab3]
+driver=gitlab
+server=gitlabthree
+api_token_name=tokenname3
+api_token=3333
+cloneurl=http://myusername:2222@gitlabthree
+
+[connection gitlab4]
+driver=gitlab
+server=gitlabfour
+api_token_name=tokenname4
+api_token=444
+
+[connection gitlab5]
+driver=gitlab
+server=gitlabfive
+api_token_name=tokenname5
+api_token=555
+cloneurl=http://gitlabfivvve