mirror of
https://github.com/titanscouting/tra-analysis.git
synced 2025-09-07 07:27:20 +00:00
push all website files
This commit is contained in:
898
website/functions/node_modules/google-proto-files/google/devtools/cloudbuild/v1/cloudbuild.proto
generated
vendored
Normal file
898
website/functions/node_modules/google-proto-files/google/devtools/cloudbuild/v1/cloudbuild.proto
generated
vendored
Normal file
@@ -0,0 +1,898 @@
|
||||
// Copyright 2018 Google Inc.
|
||||
//
|
||||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||||
// you may not use this file except in compliance with the License.
|
||||
// You may obtain a copy of the License at
|
||||
//
|
||||
// http://www.apache.org/licenses/LICENSE-2.0
|
||||
//
|
||||
// Unless required by applicable law or agreed to in writing, software
|
||||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
// See the License for the specific language governing permissions and
|
||||
// limitations under the License.
|
||||
|
||||
syntax = "proto3";
|
||||
|
||||
package google.devtools.cloudbuild.v1;
|
||||
|
||||
import "google/api/annotations.proto";
|
||||
import "google/api/httpbody.proto";
|
||||
import "google/cloud/audit/audit_log.proto";
|
||||
import "google/longrunning/operations.proto";
|
||||
import "google/protobuf/duration.proto";
|
||||
import "google/protobuf/empty.proto";
|
||||
import "google/protobuf/timestamp.proto";
|
||||
|
||||
option go_package = "google.golang.org/genproto/googleapis/devtools/cloudbuild/v1;cloudbuild";
|
||||
option java_multiple_files = true;
|
||||
option java_package = "com.google.cloudbuild.v1";
|
||||
option objc_class_prefix = "GCB";
|
||||
|
||||
|
||||
// Manages build requests on Google Cloud Platform.
|
||||
//
|
||||
// The main concept used by this API is a `Build`, which describes the location
|
||||
// of the source to build, how to build the source, and where to store the
|
||||
// built artifacts, if any.
|
||||
//
|
||||
// A user can list previously-requested builds or get builds by their ID to
|
||||
// determine the status of the build.
|
||||
service CloudBuild {
|
||||
// Starts a build with the specified configuration.
|
||||
//
|
||||
// This method returns a long-running `Operation`, which includes the build
|
||||
// ID. Pass the build ID to `GetBuild` to determine the build status (such as
|
||||
// `SUCCESS` or `FAILURE`).
|
||||
rpc CreateBuild(CreateBuildRequest) returns (google.longrunning.Operation) {
|
||||
option (google.api.http) = {
|
||||
post: "/v1/projects/{project_id}/builds"
|
||||
body: "build"
|
||||
};
|
||||
}
|
||||
|
||||
// Returns information about a previously requested build.
|
||||
//
|
||||
// The `Build` that is returned includes its status (such as `SUCCESS`,
|
||||
// `FAILURE`, or `WORKING`), and timing information.
|
||||
rpc GetBuild(GetBuildRequest) returns (Build) {
|
||||
option (google.api.http) = {
|
||||
get: "/v1/projects/{project_id}/builds/{id}"
|
||||
};
|
||||
}
|
||||
|
||||
// Lists previously requested builds.
|
||||
//
|
||||
// Previously requested builds may still be in-progress, or may have finished
|
||||
// successfully or unsuccessfully.
|
||||
rpc ListBuilds(ListBuildsRequest) returns (ListBuildsResponse) {
|
||||
option (google.api.http) = {
|
||||
get: "/v1/projects/{project_id}/builds"
|
||||
};
|
||||
}
|
||||
|
||||
// Cancels a build in progress.
|
||||
rpc CancelBuild(CancelBuildRequest) returns (Build) {
|
||||
option (google.api.http) = {
|
||||
post: "/v1/projects/{project_id}/builds/{id}:cancel"
|
||||
body: "*"
|
||||
};
|
||||
}
|
||||
|
||||
// Creates a new build based on the specified build.
|
||||
//
|
||||
// This method creates a new build using the original build request, which may
|
||||
// or may not result in an identical build.
|
||||
//
|
||||
// For triggered builds:
|
||||
//
|
||||
// * Triggered builds resolve to a precise revision; therefore a retry of a
|
||||
// triggered build will result in a build that uses the same revision.
|
||||
//
|
||||
// For non-triggered builds that specify `RepoSource`:
|
||||
//
|
||||
// * If the original build built from the tip of a branch, the retried build
|
||||
// will build from the tip of that branch, which may not be the same revision
|
||||
// as the original build.
|
||||
// * If the original build specified a commit sha or revision ID, the retried
|
||||
// build will use the identical source.
|
||||
//
|
||||
// For builds that specify `StorageSource`:
|
||||
//
|
||||
// * If the original build pulled source from Google Cloud Storage without
|
||||
// specifying the generation of the object, the new build will use the current
|
||||
// object, which may be different from the original build source.
|
||||
// * If the original build pulled source from Cloud Storage and specified the
|
||||
// generation of the object, the new build will attempt to use the same
|
||||
// object, which may or may not be available depending on the bucket's
|
||||
// lifecycle management settings.
|
||||
rpc RetryBuild(RetryBuildRequest) returns (google.longrunning.Operation) {
|
||||
option (google.api.http) = {
|
||||
post: "/v1/projects/{project_id}/builds/{id}:retry"
|
||||
body: "*"
|
||||
};
|
||||
}
|
||||
|
||||
// Creates a new `BuildTrigger`.
|
||||
//
|
||||
// This API is experimental.
|
||||
rpc CreateBuildTrigger(CreateBuildTriggerRequest) returns (BuildTrigger) {
|
||||
option (google.api.http) = {
|
||||
post: "/v1/projects/{project_id}/triggers"
|
||||
body: "trigger"
|
||||
};
|
||||
}
|
||||
|
||||
// Returns information about a `BuildTrigger`.
|
||||
//
|
||||
// This API is experimental.
|
||||
rpc GetBuildTrigger(GetBuildTriggerRequest) returns (BuildTrigger) {
|
||||
option (google.api.http) = {
|
||||
get: "/v1/projects/{project_id}/triggers/{trigger_id}"
|
||||
};
|
||||
}
|
||||
|
||||
// Lists existing `BuildTrigger`s.
|
||||
//
|
||||
// This API is experimental.
|
||||
rpc ListBuildTriggers(ListBuildTriggersRequest) returns (ListBuildTriggersResponse) {
|
||||
option (google.api.http) = {
|
||||
get: "/v1/projects/{project_id}/triggers"
|
||||
};
|
||||
}
|
||||
|
||||
// Deletes a `BuildTrigger` by its project ID and trigger ID.
|
||||
//
|
||||
// This API is experimental.
|
||||
rpc DeleteBuildTrigger(DeleteBuildTriggerRequest) returns (google.protobuf.Empty) {
|
||||
option (google.api.http) = {
|
||||
delete: "/v1/projects/{project_id}/triggers/{trigger_id}"
|
||||
};
|
||||
}
|
||||
|
||||
// Updates a `BuildTrigger` by its project ID and trigger ID.
|
||||
//
|
||||
// This API is experimental.
|
||||
rpc UpdateBuildTrigger(UpdateBuildTriggerRequest) returns (BuildTrigger) {
|
||||
option (google.api.http) = {
|
||||
patch: "/v1/projects/{project_id}/triggers/{trigger_id}"
|
||||
body: "trigger"
|
||||
};
|
||||
}
|
||||
|
||||
// Runs a `BuildTrigger` at a particular source revision.
|
||||
rpc RunBuildTrigger(RunBuildTriggerRequest) returns (google.longrunning.Operation) {
|
||||
option (google.api.http) = {
|
||||
post: "/v1/projects/{project_id}/triggers/{trigger_id}:run"
|
||||
body: "source"
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
// Specifies a build to retry.
|
||||
message RetryBuildRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// Build ID of the original build.
|
||||
string id = 2;
|
||||
}
|
||||
|
||||
// Specifies a build trigger to run and the source to use.
|
||||
message RunBuildTriggerRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the trigger.
|
||||
string trigger_id = 2;
|
||||
|
||||
// Source to build against this trigger.
|
||||
RepoSource source = 3;
|
||||
}
|
||||
|
||||
// Location of the source in an archive file in Google Cloud Storage.
|
||||
message StorageSource {
|
||||
// Google Cloud Storage bucket containing the source (see
|
||||
// [Bucket Name
|
||||
// Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
|
||||
string bucket = 1;
|
||||
|
||||
// Google Cloud Storage object containing the source.
|
||||
//
|
||||
// This object must be a gzipped archive file (`.tar.gz`) containing source to
|
||||
// build.
|
||||
string object = 2;
|
||||
|
||||
// Google Cloud Storage generation for the object. If the generation is
|
||||
// omitted, the latest generation will be used.
|
||||
int64 generation = 3;
|
||||
}
|
||||
|
||||
// Location of the source in a Google Cloud Source Repository.
|
||||
message RepoSource {
|
||||
// ID of the project that owns the Cloud Source Repository. If omitted, the
|
||||
// project ID requesting the build is assumed.
|
||||
string project_id = 1;
|
||||
|
||||
// Name of the Cloud Source Repository. If omitted, the name "default" is
|
||||
// assumed.
|
||||
string repo_name = 2;
|
||||
|
||||
// A revision within the Cloud Source Repository must be specified in
|
||||
// one of these ways.
|
||||
oneof revision {
|
||||
// Name of the branch to build.
|
||||
string branch_name = 3;
|
||||
|
||||
// Name of the tag to build.
|
||||
string tag_name = 4;
|
||||
|
||||
// Explicit commit SHA to build.
|
||||
string commit_sha = 5;
|
||||
}
|
||||
|
||||
// Directory, relative to the source root, in which to run the build.
|
||||
//
|
||||
// This must be a relative path. If a step's `dir` is specified and is an
|
||||
// absolute path, this value is ignored for that step's execution.
|
||||
string dir = 7;
|
||||
}
|
||||
|
||||
// Location of the source in a supported storage service.
|
||||
message Source {
|
||||
// Location of source.
|
||||
oneof source {
|
||||
// If provided, get the source from this location in Google Cloud Storage.
|
||||
StorageSource storage_source = 2;
|
||||
|
||||
// If provided, get the source from this location in a Cloud Source
|
||||
// Repository.
|
||||
RepoSource repo_source = 3;
|
||||
}
|
||||
}
|
||||
|
||||
// An image built by the pipeline.
|
||||
message BuiltImage {
|
||||
// Name used to push the container image to Google Container Registry, as
|
||||
// presented to `docker push`.
|
||||
string name = 1;
|
||||
|
||||
// Docker Registry 2.0 digest.
|
||||
string digest = 3;
|
||||
|
||||
// Stores timing information for pushing the specified image.
|
||||
// @OutputOnly
|
||||
TimeSpan push_timing = 4;
|
||||
}
|
||||
|
||||
// A step in the build pipeline.
|
||||
message BuildStep {
|
||||
// Required. The name of the container image that will run this particular
|
||||
// build step.
|
||||
//
|
||||
// If the image is available in the host's Docker daemon's cache, it
|
||||
// will be run directly. If not, the host will attempt to pull the image
|
||||
// first, using the builder service account's credentials if necessary.
|
||||
//
|
||||
// The Docker daemon's cache will already have the latest versions of all of
|
||||
// the officially supported build steps
|
||||
// ([https://github.com/GoogleCloudPlatform/cloud-builders](https://github.com/GoogleCloudPlatform/cloud-builders)).
|
||||
// The Docker daemon will also have cached many of the layers for some popular
|
||||
// images, like "ubuntu", "debian", but they will be refreshed at the time you
|
||||
// attempt to use them.
|
||||
//
|
||||
// If you built an image in a previous build step, it will be stored in the
|
||||
// host's Docker daemon's cache and is available to use as the name for a
|
||||
// later build step.
|
||||
string name = 1;
|
||||
|
||||
// A list of environment variable definitions to be used when running a step.
|
||||
//
|
||||
// The elements are of the form "KEY=VALUE" for the environment variable "KEY"
|
||||
// being given the value "VALUE".
|
||||
repeated string env = 2;
|
||||
|
||||
// A list of arguments that will be presented to the step when it is started.
|
||||
//
|
||||
// If the image used to run the step's container has an entrypoint, the `args`
|
||||
// are used as arguments to that entrypoint. If the image does not define
|
||||
// an entrypoint, the first element in args is used as the entrypoint,
|
||||
// and the remainder will be used as arguments.
|
||||
repeated string args = 3;
|
||||
|
||||
// Working directory to use when running this step's container.
|
||||
//
|
||||
// If this value is a relative path, it is relative to the build's working
|
||||
// directory. If this value is absolute, it may be outside the build's working
|
||||
// directory, in which case the contents of the path may not be persisted
|
||||
// across build step executions, unless a `volume` for that path is specified.
|
||||
//
|
||||
// If the build specifies a `RepoSource` with `dir` and a step with a `dir`,
|
||||
// which specifies an absolute path, the `RepoSource` `dir` is ignored for
|
||||
// the step's execution.
|
||||
string dir = 4;
|
||||
|
||||
// Unique identifier for this build step, used in `wait_for` to
|
||||
// reference this build step as a dependency.
|
||||
string id = 5;
|
||||
|
||||
// The ID(s) of the step(s) that this build step depends on.
|
||||
// This build step will not start until all the build steps in `wait_for`
|
||||
// have completed successfully. If `wait_for` is empty, this build step will
|
||||
// start when all previous build steps in the `Build.Steps` list have
|
||||
// completed successfully.
|
||||
repeated string wait_for = 6;
|
||||
|
||||
// Entrypoint to be used instead of the build step image's default entrypoint.
|
||||
// If unset, the image's default entrypoint is used.
|
||||
string entrypoint = 7;
|
||||
|
||||
// A list of environment variables which are encrypted using a Cloud Key
|
||||
// Management Service crypto key. These values must be specified in the
|
||||
// build's `Secret`.
|
||||
repeated string secret_env = 8;
|
||||
|
||||
// List of volumes to mount into the build step.
|
||||
//
|
||||
// Each volume will be created as an empty volume prior to execution of the
|
||||
// build step. Upon completion of the build, volumes and their contents will
|
||||
// be discarded.
|
||||
//
|
||||
// Using a named volume in only one step is not valid as it is indicative
|
||||
// of a mis-configured build request.
|
||||
repeated Volume volumes = 9;
|
||||
|
||||
// Stores timing information for executing this build step.
|
||||
// @OutputOnly
|
||||
TimeSpan timing = 10;
|
||||
|
||||
// Time limit for executing this build step. If not defined, the step has no
|
||||
// time limit and will be allowed to continue to run until either it completes
|
||||
// or the build itself times out.
|
||||
google.protobuf.Duration timeout = 11;
|
||||
|
||||
// Status of the build step. At this time, build step status is only updated
|
||||
// on build completion; step status is not updated in real-time as the build
|
||||
// progresses.
|
||||
// @OutputOnly
|
||||
Build.Status status = 12;
|
||||
}
|
||||
|
||||
// Volume describes a Docker container volume which is mounted into build steps
|
||||
// in order to persist files across build step execution.
|
||||
message Volume {
|
||||
// Name of the volume to mount.
|
||||
//
|
||||
// Volume names must be unique per build step and must be valid names for
|
||||
// Docker volumes. Each named volume must be used by at least two build steps.
|
||||
string name = 1;
|
||||
|
||||
// Path at which to mount the volume.
|
||||
//
|
||||
// Paths must be absolute and cannot conflict with other volume paths on the
|
||||
// same build step or with certain reserved volume paths.
|
||||
string path = 2;
|
||||
}
|
||||
|
||||
// Artifacts created by the build pipeline.
|
||||
message Results {
|
||||
// Container images that were built as a part of the build.
|
||||
repeated BuiltImage images = 2;
|
||||
|
||||
// List of build step digests, in the order corresponding to build step
|
||||
// indices.
|
||||
repeated string build_step_images = 3;
|
||||
|
||||
// Path to the artifact manifest. Only populated when artifacts are uploaded.
|
||||
string artifact_manifest = 4;
|
||||
|
||||
// Number of artifacts uploaded. Only populated when artifacts are uploaded.
|
||||
int64 num_artifacts = 5;
|
||||
}
|
||||
|
||||
// An artifact that was uploaded during a build. This
|
||||
// is a single record in the artifact manifest JSON file.
|
||||
message ArtifactResult {
|
||||
// The path of an artifact in a Google Cloud Storage bucket, with the
|
||||
// generation number. For example,
|
||||
// `gs://mybucket/path/to/output.jar#generation`.
|
||||
string location = 1;
|
||||
|
||||
// The file hash of the artifact.
|
||||
repeated FileHashes file_hash = 2;
|
||||
}
|
||||
|
||||
// A build resource in the Container Builder API.
|
||||
//
|
||||
// At a high level, a `Build` describes where to find source code, how to build
|
||||
// it (for example, the builder image to run on the source), and where to store
|
||||
// the built artifacts.
|
||||
//
|
||||
// Fields can include the following variables, which will be expanded when the
|
||||
// build is created:
|
||||
//
|
||||
// - $PROJECT_ID: the project ID of the build.
|
||||
// - $BUILD_ID: the autogenerated ID of the build.
|
||||
// - $REPO_NAME: the source repository name specified by RepoSource.
|
||||
// - $BRANCH_NAME: the branch name specified by RepoSource.
|
||||
// - $TAG_NAME: the tag name specified by RepoSource.
|
||||
// - $REVISION_ID or $COMMIT_SHA: the commit SHA specified by RepoSource or
|
||||
// resolved from the specified branch or tag.
|
||||
// - $SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.
|
||||
message Build {
|
||||
// Possible status of a build or build step.
|
||||
enum Status {
|
||||
// Status of the build is unknown.
|
||||
STATUS_UNKNOWN = 0;
|
||||
|
||||
// Build or step is queued; work has not yet begun.
|
||||
QUEUED = 1;
|
||||
|
||||
// Build or step is being executed.
|
||||
WORKING = 2;
|
||||
|
||||
// Build or step finished successfully.
|
||||
SUCCESS = 3;
|
||||
|
||||
// Build or step failed to complete successfully.
|
||||
FAILURE = 4;
|
||||
|
||||
// Build or step failed due to an internal cause.
|
||||
INTERNAL_ERROR = 5;
|
||||
|
||||
// Build or step took longer than was allowed.
|
||||
TIMEOUT = 6;
|
||||
|
||||
// Build or step was canceled by a user.
|
||||
CANCELLED = 7;
|
||||
}
|
||||
|
||||
// Unique identifier of the build.
|
||||
// @OutputOnly
|
||||
string id = 1;
|
||||
|
||||
// ID of the project.
|
||||
// @OutputOnly.
|
||||
string project_id = 16;
|
||||
|
||||
// Status of the build.
|
||||
// @OutputOnly
|
||||
Status status = 2;
|
||||
|
||||
// Customer-readable message about the current status.
|
||||
// @OutputOnly
|
||||
string status_detail = 24;
|
||||
|
||||
// The location of the source files to build.
|
||||
Source source = 3;
|
||||
|
||||
// Required. The operations to be performed on the workspace.
|
||||
repeated BuildStep steps = 11;
|
||||
|
||||
// Results of the build.
|
||||
// @OutputOnly
|
||||
Results results = 10;
|
||||
|
||||
// Time at which the request to create the build was received.
|
||||
// @OutputOnly
|
||||
google.protobuf.Timestamp create_time = 6;
|
||||
|
||||
// Time at which execution of the build was started.
|
||||
// @OutputOnly
|
||||
google.protobuf.Timestamp start_time = 7;
|
||||
|
||||
// Time at which execution of the build was finished.
|
||||
//
|
||||
// The difference between finish_time and start_time is the duration of the
|
||||
// build's execution.
|
||||
// @OutputOnly
|
||||
google.protobuf.Timestamp finish_time = 8;
|
||||
|
||||
// Amount of time that this build should be allowed to run, to second
|
||||
// granularity. If this amount of time elapses, work on the build will cease
|
||||
// and the build status will be `TIMEOUT`.
|
||||
//
|
||||
// Default time is ten minutes.
|
||||
google.protobuf.Duration timeout = 12;
|
||||
|
||||
// A list of images to be pushed upon the successful completion of all build
|
||||
// steps.
|
||||
//
|
||||
// The images are pushed using the builder service account's credentials.
|
||||
//
|
||||
// The digests of the pushed images will be stored in the `Build` resource's
|
||||
// results field.
|
||||
//
|
||||
// If any of the images fail to be pushed, the build status is marked
|
||||
// `FAILURE`.
|
||||
repeated string images = 13;
|
||||
|
||||
// Artifacts produced by the build that should be uploaded upon
|
||||
// successful completion of all build steps.
|
||||
Artifacts artifacts = 37;
|
||||
|
||||
// Google Cloud Storage bucket where logs should be written (see
|
||||
// [Bucket Name
|
||||
// Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
|
||||
// Logs file names will be of the format `${logs_bucket}/log-${build_id}.txt`.
|
||||
string logs_bucket = 19;
|
||||
|
||||
// A permanent fixed identifier for source.
|
||||
// @OutputOnly
|
||||
SourceProvenance source_provenance = 21;
|
||||
|
||||
// The ID of the `BuildTrigger` that triggered this build, if it was
|
||||
// triggered automatically.
|
||||
// @OutputOnly
|
||||
string build_trigger_id = 22;
|
||||
|
||||
// Special options for this build.
|
||||
BuildOptions options = 23;
|
||||
|
||||
// URL to logs for this build in Google Cloud Console.
|
||||
// @OutputOnly
|
||||
string log_url = 25;
|
||||
|
||||
// Substitutions data for `Build` resource.
|
||||
map<string, string> substitutions = 29;
|
||||
|
||||
// Tags for annotation of a `Build`. These are not docker tags.
|
||||
repeated string tags = 31;
|
||||
|
||||
// Secrets to decrypt using Cloud Key Management Service.
|
||||
repeated Secret secrets = 32;
|
||||
|
||||
// Stores timing information for phases of the build. Valid keys are:
|
||||
//
|
||||
// * BUILD: time to execute all build steps
|
||||
// * PUSH: time to push all specified images.
|
||||
// * FETCHSOURCE: time to fetch source.
|
||||
//
|
||||
// If the build does not specify source or images,
|
||||
// these keys will not be included.
|
||||
// @OutputOnly
|
||||
map<string, TimeSpan> timing = 33;
|
||||
}
|
||||
|
||||
// Artifacts produced by a build that should be uploaded upon
|
||||
// successful completion of all build steps.
|
||||
message Artifacts {
|
||||
// Files in the workspace to upload to Cloud Storage upon successful
|
||||
// completion of all build steps.
|
||||
message ArtifactObjects {
|
||||
// Cloud Storage bucket and optional object path, in the form
|
||||
// "gs://bucket/path/to/somewhere/". (see [Bucket Name
|
||||
// Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)).
|
||||
//
|
||||
// Files in the workspace matching any path pattern will be uploaded to
|
||||
// Cloud Storage with this location as a prefix.
|
||||
string location = 1;
|
||||
|
||||
// Path globs used to match files in the build's workspace.
|
||||
repeated string paths = 2;
|
||||
|
||||
// Stores timing information for pushing all artifact objects.
|
||||
// @OutputOnly
|
||||
TimeSpan timing = 3;
|
||||
}
|
||||
|
||||
// A list of images to be pushed upon the successful completion of all build
|
||||
// steps.
|
||||
//
|
||||
// The images will be pushed using the builder service account's credentials.
|
||||
//
|
||||
// The digests of the pushed images will be stored in the Build resource's
|
||||
// results field.
|
||||
//
|
||||
// If any of the images fail to be pushed, the build is marked FAILURE.
|
||||
repeated string images = 1;
|
||||
|
||||
// A list of objects to be uploaded to Cloud Storage upon successful
|
||||
// completion of all build steps.
|
||||
//
|
||||
// Files in the workspace matching specified paths globs will be uploaded to
|
||||
// the specified Cloud Storage location using the builder service account's
|
||||
// credentials.
|
||||
//
|
||||
// The location and generation of the uploaded objects will be stored in the
|
||||
// Build resource's results field.
|
||||
//
|
||||
// If any objects fail to be pushed, the build is marked FAILURE.
|
||||
ArtifactObjects objects = 2;
|
||||
}
|
||||
|
||||
// Start and end times for a build execution phase.
|
||||
message TimeSpan {
|
||||
// Start of time span.
|
||||
google.protobuf.Timestamp start_time = 1;
|
||||
|
||||
// End of time span.
|
||||
google.protobuf.Timestamp end_time = 2;
|
||||
}
|
||||
|
||||
// Metadata for build operations.
|
||||
message BuildOperationMetadata {
|
||||
// The build that the operation is tracking.
|
||||
Build build = 1;
|
||||
}
|
||||
|
||||
// Provenance of the source. Ways to find the original source, or verify that
|
||||
// some source was used for this build.
|
||||
message SourceProvenance {
|
||||
// A copy of the build's `source.storage_source`, if exists, with any
|
||||
// generations resolved.
|
||||
StorageSource resolved_storage_source = 3;
|
||||
|
||||
// A copy of the build's `source.repo_source`, if exists, with any
|
||||
// revisions resolved.
|
||||
RepoSource resolved_repo_source = 6;
|
||||
|
||||
// Hash(es) of the build source, which can be used to verify that the original
|
||||
// source integrity was maintained in the build. Note that `FileHashes` will
|
||||
// only be populated if `BuildOptions` has requested a `SourceProvenanceHash`.
|
||||
//
|
||||
// The keys to this map are file paths used as build source and the values
|
||||
// contain the hash values for those files.
|
||||
//
|
||||
// If the build source came in a single package such as a gzipped tarfile
|
||||
// (`.tar.gz`), the `FileHash` will be for the single path to that file.
|
||||
// @OutputOnly
|
||||
map<string, FileHashes> file_hashes = 4;
|
||||
}
|
||||
|
||||
// Container message for hashes of byte content of files, used in
|
||||
// SourceProvenance messages to verify integrity of source input to the build.
|
||||
message FileHashes {
|
||||
// Collection of file hashes.
|
||||
repeated Hash file_hash = 1;
|
||||
}
|
||||
|
||||
// Container message for hash values.
|
||||
message Hash {
|
||||
// Specifies the hash algorithm, if any.
|
||||
enum HashType {
|
||||
// No hash requested.
|
||||
NONE = 0;
|
||||
|
||||
// Use a sha256 hash.
|
||||
SHA256 = 1;
|
||||
|
||||
// Use a md5 hash.
|
||||
MD5 = 2;
|
||||
}
|
||||
|
||||
// The type of hash that was performed.
|
||||
HashType type = 1;
|
||||
|
||||
// The hash value.
|
||||
bytes value = 2;
|
||||
}
|
||||
|
||||
// Pairs a set of secret environment variables containing encrypted
|
||||
// values with the Cloud KMS key to use to decrypt the value.
|
||||
message Secret {
|
||||
// Cloud KMS key name to use to decrypt these envs.
|
||||
string kms_key_name = 1;
|
||||
|
||||
// Map of environment variable name to its encrypted value.
|
||||
//
|
||||
// Secret environment variables must be unique across all of a build's
|
||||
// secrets, and must be used by at least one build step. Values can be at most
|
||||
// 1 KB in size. There can be at most ten secret values across all of a
|
||||
// build's secrets.
|
||||
map<string, bytes> secret_env = 3;
|
||||
}
|
||||
|
||||
// Request to create a new build.
|
||||
message CreateBuildRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// Build resource to create.
|
||||
Build build = 2;
|
||||
}
|
||||
|
||||
// Request to get a build.
|
||||
message GetBuildRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the build.
|
||||
string id = 2;
|
||||
}
|
||||
|
||||
// Request to list builds.
|
||||
message ListBuildsRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// Number of results to return in the list.
|
||||
int32 page_size = 2;
|
||||
|
||||
// Token to provide to skip to a particular spot in the list.
|
||||
string page_token = 3;
|
||||
|
||||
// The raw filter text to constrain the results.
|
||||
string filter = 8;
|
||||
}
|
||||
|
||||
// Response including listed builds.
|
||||
message ListBuildsResponse {
|
||||
// Builds will be sorted by `create_time`, descending.
|
||||
repeated Build builds = 1;
|
||||
|
||||
// Token to receive the next page of results.
|
||||
string next_page_token = 2;
|
||||
}
|
||||
|
||||
// Request to cancel an ongoing build.
|
||||
message CancelBuildRequest {
|
||||
// ID of the project.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the build.
|
||||
string id = 2;
|
||||
}
|
||||
|
||||
// Configuration for an automated build in response to source repository
|
||||
// changes.
|
||||
message BuildTrigger {
|
||||
// Unique identifier of the trigger.
|
||||
//
|
||||
// @OutputOnly
|
||||
string id = 1;
|
||||
|
||||
// Human-readable description of this trigger.
|
||||
string description = 10;
|
||||
|
||||
// Template describing the types of source changes to trigger a build.
|
||||
//
|
||||
// Branch and tag names in trigger templates are interpreted as regular
|
||||
// expressions. Any branch or tag change that matches that regular expression
|
||||
// will trigger a build.
|
||||
RepoSource trigger_template = 7;
|
||||
|
||||
// Template describing the Build request to make when the trigger is matched.
|
||||
oneof build_template {
|
||||
// Contents of the build template.
|
||||
Build build = 4;
|
||||
|
||||
// Path, from the source root, to a file whose contents is used for the
|
||||
// template.
|
||||
string filename = 8;
|
||||
}
|
||||
|
||||
// Time when the trigger was created.
|
||||
//
|
||||
// @OutputOnly
|
||||
google.protobuf.Timestamp create_time = 5;
|
||||
|
||||
// If true, the trigger will never result in a build.
|
||||
bool disabled = 9;
|
||||
|
||||
// Substitutions data for Build resource.
|
||||
map<string, string> substitutions = 11;
|
||||
}
|
||||
|
||||
// Request to create a new `BuildTrigger`.
|
||||
message CreateBuildTriggerRequest {
|
||||
// ID of the project for which to configure automatic builds.
|
||||
string project_id = 1;
|
||||
|
||||
// `BuildTrigger` to create.
|
||||
BuildTrigger trigger = 2;
|
||||
}
|
||||
|
||||
// Returns the `BuildTrigger` with the specified ID.
|
||||
message GetBuildTriggerRequest {
|
||||
// ID of the project that owns the trigger.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the `BuildTrigger` to get.
|
||||
string trigger_id = 2;
|
||||
}
|
||||
|
||||
// Request to list existing `BuildTriggers`.
|
||||
message ListBuildTriggersRequest {
|
||||
// ID of the project for which to list BuildTriggers.
|
||||
string project_id = 1;
|
||||
}
|
||||
|
||||
// Response containing existing `BuildTriggers`.
|
||||
message ListBuildTriggersResponse {
|
||||
// `BuildTriggers` for the project, sorted by `create_time` descending.
|
||||
repeated BuildTrigger triggers = 1;
|
||||
}
|
||||
|
||||
// Request to delete a `BuildTrigger`.
|
||||
message DeleteBuildTriggerRequest {
|
||||
// ID of the project that owns the trigger.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the `BuildTrigger` to delete.
|
||||
string trigger_id = 2;
|
||||
}
|
||||
|
||||
// Request to update an existing `BuildTrigger`.
|
||||
message UpdateBuildTriggerRequest {
|
||||
// ID of the project that owns the trigger.
|
||||
string project_id = 1;
|
||||
|
||||
// ID of the `BuildTrigger` to update.
|
||||
string trigger_id = 2;
|
||||
|
||||
// `BuildTrigger` to update.
|
||||
BuildTrigger trigger = 3;
|
||||
}
|
||||
|
||||
// Optional arguments to enable specific features of builds.
|
||||
message BuildOptions {
|
||||
// Specifies the manner in which the build should be verified, if at all.
|
||||
enum VerifyOption {
|
||||
// Not a verifiable build. (default)
|
||||
NOT_VERIFIED = 0;
|
||||
|
||||
// Verified build.
|
||||
VERIFIED = 1;
|
||||
}
|
||||
|
||||
// Supported VM sizes.
|
||||
enum MachineType {
|
||||
// Standard machine type.
|
||||
UNSPECIFIED = 0;
|
||||
|
||||
// Highcpu machine with 8 CPUs.
|
||||
N1_HIGHCPU_8 = 1;
|
||||
|
||||
// Highcpu machine with 32 CPUs.
|
||||
N1_HIGHCPU_32 = 2;
|
||||
}
|
||||
|
||||
// Specifies the behavior when there is an error in the substitution checks.
|
||||
enum SubstitutionOption {
|
||||
// Fails the build if error in substitutions checks, like missing
|
||||
// a substitution in the template or in the map.
|
||||
MUST_MATCH = 0;
|
||||
|
||||
// Do not fail the build if error in substitutions checks.
|
||||
ALLOW_LOOSE = 1;
|
||||
}
|
||||
|
||||
// Specifies the behavior when writing build logs to Google Cloud Storage.
|
||||
enum LogStreamingOption {
|
||||
// Service may automatically determine build log streaming behavior.
|
||||
STREAM_DEFAULT = 0;
|
||||
|
||||
// Build logs should be streamed to Google Cloud Storage.
|
||||
STREAM_ON = 1;
|
||||
|
||||
// Build logs should not be streamed to Google Cloud Storage; they will be
|
||||
// written when the build is completed.
|
||||
STREAM_OFF = 2;
|
||||
}
|
||||
|
||||
// Requested hash for SourceProvenance.
|
||||
repeated Hash.HashType source_provenance_hash = 1;
|
||||
|
||||
// Requested verifiability options.
|
||||
VerifyOption requested_verify_option = 2;
|
||||
|
||||
// Compute Engine machine type on which to run the build.
|
||||
MachineType machine_type = 3;
|
||||
|
||||
// Requested disk size for the VM that runs the build. Note that this is *NOT*
|
||||
// "disk free"; some of the space will be used by the operating system and
|
||||
// build utilities. Also note that this is the minimum disk size that will be
|
||||
// allocated for the build -- the build may run with a larger disk than
|
||||
// requested. At present, the maximum disk size is 1000GB; builds that request
|
||||
// more than the maximum are rejected with an error.
|
||||
int64 disk_size_gb = 6;
|
||||
|
||||
// Option to specify behavior when there is an error in the substitution
|
||||
// checks.
|
||||
SubstitutionOption substitution_option = 4;
|
||||
|
||||
// Option to define build log streaming behavior to Google Cloud
|
||||
// Storage.
|
||||
LogStreamingOption log_streaming_option = 5;
|
||||
}
|
Reference in New Issue
Block a user