imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-18 14:56:05 +00:00
Code Activity

gcloud: Wed Jun 28 10:42:37 UTC 2023

Browse source
This commit is contained in:
Automated 2023-06-28 10:42:37 +00:00
parent dc0d916cee
commit 0248e53b76
139 changed files with 3939 additions and 162 deletions
Download patch file Download diff file Expand all files Collapse all files

153
gcloud/alpha/builds/connections/create/gitlab Normal file
View file

@ -0,0 +1,153 @@
NAME
gcloud alpha builds connections create gitlab - create a Cloud Build
Connection for gitlab.com or GitLab Enterprise
SYNOPSIS
gcloud alpha builds connections create gitlab
(CONNECTION : --region=REGION)
--authorizer-token-secret-version=AUTHORIZER_TOKEN_SECRET_VERSION
--read-authorizer-token-secret-version=READ_AUTHORIZER_TOKEN_SECRET_VERSION
--webhook-secret-secret-version=WEBHOOK_SECRET_SECRET_VERSION [--async]
[--host-uri=HOST_URI]
[--service-directory-service=SERVICE_DIRECTORY_SERVICE
: --ssl-ca-file=SSL_CA_FILE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) Create a Cloud Build Connection for gitlab.com or GitLab
Enterprise.
A gitlab.com or GitLab Enterprise Connection can be created by using a
personal access token with api scope permission. A read_repository scoped
personal access token will also be required on gitlab.com or if the
self-hosted GitLab server doesn't support project access token (GitLab
Enterprise server version < 13.10).
If the GitLab Enterprise server can only be accessed within a VPC, a
Service Directory service resource can be provided for connecting to it.
EXAMPLES
To create a GitLab connection for gitlab.com, provide all the required
parameters:
$ gcloud alpha builds connections create gitlab my-gitlab-conn \
--project=myproj --region=us-central1 \
--read-authorizer-token-secret-version=projects/myproj/secrets/\
read-pat/versions/1 \
--authorizer-token-secret-version=projects/myproj/secrets/\
api-pat/versions/1 \
--webhook-secret-secret-version=projects/myproj/secrets/\
whsecret/versions/1
To create a GitLab connection for a GitLab server, provide host-uri
parameter as well:
$ gcloud alpha builds connections create gitlab my-gle-conn \
--host-uri=https://my.gle-server.net --project=myproj \
--region=us-central1 \
--authorizer-token-secret-version=projects/myproj/secrets/\
api-pat/versions/1 \
--read-authorizer-token-secret-version=projects/myproj/secrets/\
read-pat/versions/1 \
--webhook-secret-secret-version=projects/myproj/secrets/\
whsecret/versions/1
To create a GitLab connection for a private GitLab server. provide the
service-directory-service and ssl-ca-file as well:
$ gcloud alpha builds connections create gitlab my-gle-conn \
--host-uri=https://my.private-gle-server.net --project=myproj \
--region=us-central1 \
--service-directory-service=projects/myproj/namespaces/x/\
services/mysds --ssl-ca-file=mycertificate.crt \
--authorizer-token-secret-version=projects/myproj/secrets/\
api-pat/versions/1 \
--read-authorizer-token-secret-version=projects/myproj/secrets/\
read-pat/versions/1 \
--webhook-secret-secret-version=projects/myproj/secrets/\
whsecret/versions/1
POSITIONAL ARGUMENTS
Connection resource - Connection to create. The arguments in this group
can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other
ways.
To set the project attribute:
◆ provide the argument connection on the command line with a fully
specified name;
◆ set the property core/project;
◆ provide the argument --project on the command line.
This must be specified.
CONNECTION
ID of the connection or fully qualified identifier for the
connection.
To set the connection attribute:
▸ provide the argument connection on the command line.
This positional argument must be specified if any of the other
arguments in this group are specified.
--region=REGION
The Google Cloud region.
To set the region attribute:
▸ provide the argument connection on the command line with a fully
specified name;
▸ provide the argument --region on the command line;
▸ set the property builds/region.
REQUIRED FLAGS
--authorizer-token-secret-version=AUTHORIZER_TOKEN_SECRET_VERSION
Secret containing the api personal access token.
--read-authorizer-token-secret-version=READ_AUTHORIZER_TOKEN_SECRET_VERSION
Secret containing the read_api personal access token.
--webhook-secret-secret-version=WEBHOOK_SECRET_SECRET_VERSION
Secret containing the webhook secret string for validating webhook
events sent by GitLab.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to
complete.
--host-uri=HOST_URI
URI of the GitLab instance.
Group of arguments for configuring access through Service Directory.
--service-directory-service=SERVICE_DIRECTORY_SERVICE
Service Directory service resource to use for accessing the
gitlab.com or GitLab Enterprise Server. Necessary only if the server
has no public access from the internet.
This flag argument must be specified if any of the other arguments in
this group are specified.
--ssl-ca-file=SSL_CA_FILE
File containing the SSL_CA to be used.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account,
--billing-project, --configuration, --flags-file, --flatten, --format,
--help, --impersonate-service-account, --log-http, --project, --quiet,
--trace-token, --user-output-enabled, --verbosity.
Run $ gcloud help for details.
API REFERENCE
This command uses the cloudbuild/v2 API. The full documentation for this
API can be found at: https://cloud.google.com/cloud-build/docs/
NOTES
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct
project, you might be trying to access an API with an invitation-only early
access allowlist. This variant is also available:
$ gcloud beta builds connections create gitlab