mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-18 23:08:48 +00:00
gcloud: Wed Jun 28 10:42:37 UTC 2023
This commit is contained in:
Automated
parent
dc0d916cee
commit
0248e53b76
139 changed files with 3939 additions and 162 deletions
153
gcloud/alpha/builds/connections/create/gitlab
Normal file
153
gcloud/alpha/builds/connections/create/gitlab
Normal 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
|
||||
|
||||
|
|
@ -22,6 +22,10 @@ COMMANDS
|
|||
github-enterprise
|
||||
(ALPHA) Create a Cloud Build Connection of type GitHub Enterprise.
|
||||
|
||||
gitlab
|
||||
(ALPHA) Create a Cloud Build Connection for gitlab.com or GitLab
|
||||
Enterprise.
|
||||
|
||||
NOTES
|
||||
This command is currently in alpha and might change without notice. If this
|
||||
command fails with API permission errors despite specifying the correct
|
||||
|
|
|
|||
107
gcloud/alpha/builds/connections/update/gitlab
Normal file
107
gcloud/alpha/builds/connections/update/gitlab
Normal file
|
|
@ -0,0 +1,107 @@
|
|||
NAME
|
||||
gcloud alpha builds connections update gitlab - update a Cloud Build
|
||||
Connection of type gitlab.com or GitLab Enterprise
|
||||
|
||||
SYNOPSIS
|
||||
gcloud alpha builds connections update gitlab
|
||||
(CONNECTION : --region=REGION) [--async]
|
||||
[--authorizer-token-secret-version=AUTHORIZER_TOKEN_SECRET_VERSION]
|
||||
[--host-uri=HOST_URI]
|
||||
[--read-authorizer-token-secret-version=READ_AUTHORIZER_TOKEN_SECRET_VERSION]
|
||||
[--service-directory-service=SERVICE_DIRECTORY_SERVICE]
|
||||
[--ssl-ca-file=SSL_CA_FILE] [GCLOUD_WIDE_FLAG ...]
|
||||
|
||||
DESCRIPTION
|
||||
(ALPHA) Update a Cloud Build Connection of type gitlab.com or GitLab
|
||||
Enterprise.
|
||||
|
||||
EXAMPLES
|
||||
To update the ssl_ca, provide the connection name and the ssl_ca file:
|
||||
|
||||
$ gcloud alpha builds connections update gitlab my-gle-conn \
|
||||
--region=us-west1 --ssl-ca-file=mycertificate.crt
|
||||
|
||||
To update the authorization token, provide the connection name and the new
|
||||
authorization token secret version.
|
||||
|
||||
$ gcloud alpha builds connections update gitlab my-gle-conn \
|
||||
--region=us-west1 \
|
||||
--authorizer-token-secret-version=projects/myproj/secrets/\
|
||||
api-pat/versions/1
|
||||
|
||||
POSITIONAL ARGUMENTS
|
||||
Connection resource - Connection to update. 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.
|
||||
|
||||
FLAGS
|
||||
--async
|
||||
Return immediately, without waiting for the operation in progress to
|
||||
complete.
|
||||
|
||||
--authorizer-token-secret-version=AUTHORIZER_TOKEN_SECRET_VERSION
|
||||
Secret containing the api personal access token.
|
||||
|
||||
--host-uri=HOST_URI
|
||||
URI of the GitLab instance.
|
||||
|
||||
--read-authorizer-token-secret-version=READ_AUTHORIZER_TOKEN_SECRET_VERSION
|
||||
Secret containing the read_repository personal access token. Required
|
||||
for GitLab Enterprise versions older than 13.10.
|
||||
|
||||
--service-directory-service=SERVICE_DIRECTORY_SERVICE
|
||||
Service Directory service resource to use for accessing the GitLab
|
||||
Enterprise Server. Necessary only if the server has no public access
|
||||
from the internet.
|
||||
|
||||
--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 update gitlab
|
||||
|
||||
|
|
@ -22,6 +22,10 @@ COMMANDS
|
|||
github-enterprise
|
||||
(ALPHA) Update a Cloud Build Connection of type GitHub Enterprise.
|
||||
|
||||
gitlab
|
||||
(ALPHA) Update a Cloud Build Connection of type gitlab.com or GitLab
|
||||
Enterprise.
|
||||
|
||||
NOTES
|
||||
This command is currently in alpha and might change without notice. If this
|
||||
command fails with API permission errors despite specifying the correct
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue