# Copyright 2015 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. require 'date' require 'google/apis/core/base_service' require 'google/apis/core/json_representation' require 'google/apis/core/hashable' require 'google/apis/errors' module Google module Apis module CloudbuildV1alpha2 # Files in the workspace to upload to Cloud Storage upon successful completion # of all build steps. class ArtifactObjects include Google::Apis::Core::Hashable # 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. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location # Path globs used to match files in the build's workspace. # Corresponds to the JSON property `paths` # @return [Array] attr_accessor :paths # Start and end times for a build execution phase. # Corresponds to the JSON property `timing` # @return [Google::Apis::CloudbuildV1alpha2::TimeSpan] attr_accessor :timing def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @location = args[:location] if args.key?(:location) @paths = args[:paths] if args.key?(:paths) @timing = args[:timing] if args.key?(:timing) end end # An artifact that was uploaded during a build. This is a single record in the # artifact manifest JSON file. class ArtifactResult include Google::Apis::Core::Hashable # The file hash of the artifact. # Corresponds to the JSON property `fileHash` # @return [Array] attr_accessor :file_hash # The path of an artifact in a Google Cloud Storage bucket, with the generation # number. For example, `gs://mybucket/path/to/output.jar#generation`. # Corresponds to the JSON property `location` # @return [String] attr_accessor :location def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @file_hash = args[:file_hash] if args.key?(:file_hash) @location = args[:location] if args.key?(:location) end end # Artifacts produced by a build that should be uploaded upon successful # completion of all build steps. class Artifacts include Google::Apis::Core::Hashable # 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. # Corresponds to the JSON property `images` # @return [Array] attr_accessor :images # Files in the workspace to upload to Cloud Storage upon successful completion # of all build steps. # Corresponds to the JSON property `objects` # @return [Google::Apis::CloudbuildV1alpha2::ArtifactObjects] attr_accessor :objects def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @images = args[:images] if args.key?(:images) @objects = args[:objects] if args.key?(:objects) end end # A build resource in the Cloud Build 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. class Build include Google::Apis::Core::Hashable # Artifacts produced by a build that should be uploaded upon successful # completion of all build steps. # Corresponds to the JSON property `artifacts` # @return [Google::Apis::CloudbuildV1alpha2::Artifacts] attr_accessor :artifacts # Output only. The ID of the `BuildTrigger` that triggered this build, if it was # triggered automatically. # Corresponds to the JSON property `buildTriggerId` # @return [String] attr_accessor :build_trigger_id # Output only. Time at which the request to create the build was received. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time # Output only. 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. # Corresponds to the JSON property `finishTime` # @return [String] attr_accessor :finish_time # Output only. Unique identifier of the build. # Corresponds to the JSON property `id` # @return [String] attr_accessor :id # 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`. # Corresponds to the JSON property `images` # @return [Array] attr_accessor :images # Output only. URL to logs for this build in Google Cloud Console. # Corresponds to the JSON property `logUrl` # @return [String] attr_accessor :log_url # 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`. # Corresponds to the JSON property `logsBucket` # @return [String] attr_accessor :logs_bucket # Optional arguments to enable specific features of builds. # Corresponds to the JSON property `options` # @return [Google::Apis::CloudbuildV1alpha2::BuildOptions] attr_accessor :options # Output only. ID of the project. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id # TTL in queue for this build. If provided and the build is enqueued longer than # this value, the build will expire and the build status will be `EXPIRED`. The # TTL starts ticking from create_time. # Corresponds to the JSON property `queueTtl` # @return [String] attr_accessor :queue_ttl # Artifacts created by the build pipeline. # Corresponds to the JSON property `results` # @return [Google::Apis::CloudbuildV1alpha2::Results] attr_accessor :results # Secrets to decrypt using Cloud Key Management Service. # Corresponds to the JSON property `secrets` # @return [Array] attr_accessor :secrets # IAM service account whose credentials will be used at build runtime. Must be # of the format `projects/`PROJECT_ID`/serviceAccounts/`ACCOUNT``. ACCOUNT can # be email address or uniqueId of the service account. This field is in alpha # and is not publicly available. # Corresponds to the JSON property `serviceAccount` # @return [String] attr_accessor :service_account # Location of the source in a supported storage service. # Corresponds to the JSON property `source` # @return [Google::Apis::CloudbuildV1alpha2::Source] attr_accessor :source # Provenance of the source. Ways to find the original source, or verify that # some source was used for this build. # Corresponds to the JSON property `sourceProvenance` # @return [Google::Apis::CloudbuildV1alpha2::SourceProvenance] attr_accessor :source_provenance # Output only. Time at which execution of the build was started. # Corresponds to the JSON property `startTime` # @return [String] attr_accessor :start_time # Output only. Status of the build. # Corresponds to the JSON property `status` # @return [String] attr_accessor :status # Output only. Customer-readable message about the current status. # Corresponds to the JSON property `statusDetail` # @return [String] attr_accessor :status_detail # Required. The operations to be performed on the workspace. # Corresponds to the JSON property `steps` # @return [Array] attr_accessor :steps # Substitutions data for `Build` resource. # Corresponds to the JSON property `substitutions` # @return [Hash] attr_accessor :substitutions # Tags for annotation of a `Build`. These are not docker tags. # Corresponds to the JSON property `tags` # @return [Array] attr_accessor :tags # 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`. `timeout` starts ticking from `startTime`. Default # time is ten minutes. # Corresponds to the JSON property `timeout` # @return [String] attr_accessor :timeout # Output only. 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. # Corresponds to the JSON property `timing` # @return [Hash] attr_accessor :timing def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @artifacts = args[:artifacts] if args.key?(:artifacts) @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id) @create_time = args[:create_time] if args.key?(:create_time) @finish_time = args[:finish_time] if args.key?(:finish_time) @id = args[:id] if args.key?(:id) @images = args[:images] if args.key?(:images) @log_url = args[:log_url] if args.key?(:log_url) @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket) @options = args[:options] if args.key?(:options) @project_id = args[:project_id] if args.key?(:project_id) @queue_ttl = args[:queue_ttl] if args.key?(:queue_ttl) @results = args[:results] if args.key?(:results) @secrets = args[:secrets] if args.key?(:secrets) @service_account = args[:service_account] if args.key?(:service_account) @source = args[:source] if args.key?(:source) @source_provenance = args[:source_provenance] if args.key?(:source_provenance) @start_time = args[:start_time] if args.key?(:start_time) @status = args[:status] if args.key?(:status) @status_detail = args[:status_detail] if args.key?(:status_detail) @steps = args[:steps] if args.key?(:steps) @substitutions = args[:substitutions] if args.key?(:substitutions) @tags = args[:tags] if args.key?(:tags) @timeout = args[:timeout] if args.key?(:timeout) @timing = args[:timing] if args.key?(:timing) end end # Metadata for build operations. class BuildOperationMetadata include Google::Apis::Core::Hashable # A build resource in the Cloud Build 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. # Corresponds to the JSON property `build` # @return [Google::Apis::CloudbuildV1alpha2::Build] attr_accessor :build def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @build = args[:build] if args.key?(:build) end end # Optional arguments to enable specific features of builds. class BuildOptions include Google::Apis::Core::Hashable # 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. # Corresponds to the JSON property `diskSizeGb` # @return [Fixnum] attr_accessor :disk_size_gb # Option to specify whether or not to apply bash style string operations to the # substitutions. NOTE: this is always enabled for triggered builds and cannot be # overridden in the build configuration file. # Corresponds to the JSON property `dynamicSubstitutions` # @return [Boolean] attr_accessor :dynamic_substitutions alias_method :dynamic_substitutions?, :dynamic_substitutions # A list of global environment variable definitions that will exist for all # build steps in this build. If a variable is defined in both globally and in a # build step, the variable will use the build step value. The elements are of # the form "KEY=VALUE" for the environment variable "KEY" being given the value " # VALUE". # Corresponds to the JSON property `env` # @return [Array] attr_accessor :env # Option to define build log streaming behavior to Google Cloud Storage. # Corresponds to the JSON property `logStreamingOption` # @return [String] attr_accessor :log_streaming_option # Option to specify the logging mode, which determines if and where build logs # are stored. # Corresponds to the JSON property `logging` # @return [String] attr_accessor :logging # Compute Engine machine type on which to run the build. # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type # Requested verifiability options. # Corresponds to the JSON property `requestedVerifyOption` # @return [String] attr_accessor :requested_verify_option # A list of global environment variables, which are encrypted using a Cloud Key # Management Service crypto key. These values must be specified in the build's ` # Secret`. These variables will be available to all build steps in this build. # Corresponds to the JSON property `secretEnv` # @return [Array] attr_accessor :secret_env # Requested hash for SourceProvenance. # Corresponds to the JSON property `sourceProvenanceHash` # @return [Array] attr_accessor :source_provenance_hash # Option to specify behavior when there is an error in the substitution checks. # NOTE: this is always set to ALLOW_LOOSE for triggered builds and cannot be # overridden in the build configuration file. # Corresponds to the JSON property `substitutionOption` # @return [String] attr_accessor :substitution_option # Global list of volumes to mount for ALL build steps Each volume is created as # an empty volume prior to starting the build process. Upon completion of the # build, volumes and their contents are discarded. Global volume names and paths # cannot conflict with the volumes defined a build step. Using a global volume # in a build with only one step is not valid as it is indicative of a build # request with an incorrect configuration. # Corresponds to the JSON property `volumes` # @return [Array] attr_accessor :volumes # Option to specify a `WorkerPool` for the build. Format: projects/`project`/ # locations/`location`/workerPools/`workerPool` This field is experimental. # Corresponds to the JSON property `workerPool` # @return [String] attr_accessor :worker_pool def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @dynamic_substitutions = args[:dynamic_substitutions] if args.key?(:dynamic_substitutions) @env = args[:env] if args.key?(:env) @log_streaming_option = args[:log_streaming_option] if args.key?(:log_streaming_option) @logging = args[:logging] if args.key?(:logging) @machine_type = args[:machine_type] if args.key?(:machine_type) @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option) @secret_env = args[:secret_env] if args.key?(:secret_env) @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash) @substitution_option = args[:substitution_option] if args.key?(:substitution_option) @volumes = args[:volumes] if args.key?(:volumes) @worker_pool = args[:worker_pool] if args.key?(:worker_pool) end end # A step in the build pipeline. class BuildStep include Google::Apis::Core::Hashable # 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. # Corresponds to the JSON property `args` # @return [Array] attr_accessor :args # 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. # Corresponds to the JSON property `dir` # @return [String] attr_accessor :dir # Entrypoint to be used instead of the build step image's default entrypoint. If # unset, the image's default entrypoint is used. # Corresponds to the JSON property `entrypoint` # @return [String] attr_accessor :entrypoint # 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". # Corresponds to the JSON property `env` # @return [Array] attr_accessor :env # Unique identifier for this build step, used in `wait_for` to reference this # build step as a dependency. # Corresponds to the JSON property `id` # @return [String] attr_accessor :id # 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. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # Start and end times for a build execution phase. # Corresponds to the JSON property `pullTiming` # @return [Google::Apis::CloudbuildV1alpha2::TimeSpan] attr_accessor :pull_timing # 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`. # Corresponds to the JSON property `secretEnv` # @return [Array] attr_accessor :secret_env # Output only. 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. # Corresponds to the JSON property `status` # @return [String] attr_accessor :status # 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. # Corresponds to the JSON property `timeout` # @return [String] attr_accessor :timeout # Start and end times for a build execution phase. # Corresponds to the JSON property `timing` # @return [Google::Apis::CloudbuildV1alpha2::TimeSpan] attr_accessor :timing # List of volumes to mount into the build step. Each volume is created as an # empty volume prior to execution of the build step. Upon completion of the # build, volumes and their contents are discarded. Using a named volume in only # one step is not valid as it is indicative of a build request with an incorrect # configuration. # Corresponds to the JSON property `volumes` # @return [Array] attr_accessor :volumes # 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. # Corresponds to the JSON property `waitFor` # @return [Array] attr_accessor :wait_for def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @args = args[:args] if args.key?(:args) @dir = args[:dir] if args.key?(:dir) @entrypoint = args[:entrypoint] if args.key?(:entrypoint) @env = args[:env] if args.key?(:env) @id = args[:id] if args.key?(:id) @name = args[:name] if args.key?(:name) @pull_timing = args[:pull_timing] if args.key?(:pull_timing) @secret_env = args[:secret_env] if args.key?(:secret_env) @status = args[:status] if args.key?(:status) @timeout = args[:timeout] if args.key?(:timeout) @timing = args[:timing] if args.key?(:timing) @volumes = args[:volumes] if args.key?(:volumes) @wait_for = args[:wait_for] if args.key?(:wait_for) end end # An image built by the pipeline. class BuiltImage include Google::Apis::Core::Hashable # Docker Registry 2.0 digest. # Corresponds to the JSON property `digest` # @return [String] attr_accessor :digest # Name used to push the container image to Google Container Registry, as # presented to `docker push`. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # Start and end times for a build execution phase. # Corresponds to the JSON property `pushTiming` # @return [Google::Apis::CloudbuildV1alpha2::TimeSpan] attr_accessor :push_timing def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @digest = args[:digest] if args.key?(:digest) @name = args[:name] if args.key?(:name) @push_timing = args[:push_timing] if args.key?(:push_timing) end end # The request message for Operations.CancelOperation. class CancelOperationRequest include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # A generic empty message that you can re-use to avoid defining duplicated empty # messages in your APIs. A typical example is to use it as the request or the # response type of an API method. For instance: service Foo ` rpc Bar(google. # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for # `Empty` is empty JSON object ````. class Empty include Google::Apis::Core::Hashable def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) end end # Container message for hashes of byte content of files, used in # SourceProvenance messages to verify integrity of source input to the build. class FileHashes include Google::Apis::Core::Hashable # Collection of file hashes. # Corresponds to the JSON property `fileHash` # @return [Array] attr_accessor :file_hash def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @file_hash = args[:file_hash] if args.key?(:file_hash) end end # HTTPDelivery is the delivery configuration for an HTTP notification. class HttpDelivery include Google::Apis::Core::Hashable # The URI to which JSON-containing HTTP POST requests should be sent. # Corresponds to the JSON property `uri` # @return [String] attr_accessor :uri def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @uri = args[:uri] if args.key?(:uri) end end # Container message for hash values. class HashProp include Google::Apis::Core::Hashable # The type of hash that was performed. # Corresponds to the JSON property `type` # @return [String] attr_accessor :type # The hash value. # Corresponds to the JSON property `value` # NOTE: Values are automatically base64 encoded/decoded in the client library. # @return [String] attr_accessor :value def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @type = args[:type] if args.key?(:type) @value = args[:value] if args.key?(:value) end end # Response containing existing `WorkerPools`. class ListWorkerPoolsResponse include Google::Apis::Core::Hashable # `WorkerPools` for the specified project. # Corresponds to the JSON property `workerPools` # @return [Array] attr_accessor :worker_pools def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @worker_pools = args[:worker_pools] if args.key?(:worker_pools) end end # Network describes the network configuration for a `WorkerPool`. class NetworkConfig include Google::Apis::Core::Hashable # Required. Immutable. The network definition that the workers are peered to. If # this section is left empty, the workers will be peered to WorkerPool. # project_id on the default network. Must be in the format `projects/`project`/ # global/networks/`network``, where `project` is a project number, such as ` # 12345`, and `network` is the name of a VPC network in the project. # Corresponds to the JSON property `peeredNetwork` # @return [String] attr_accessor :peered_network def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @peered_network = args[:peered_network] if args.key?(:peered_network) end end # Notification is the container which holds the data that is relevant to this # particular notification. class Notification include Google::Apis::Core::Hashable # The filter string to use for notification filtering. Currently, this is # assumed to be a CEL program. See https://opensource.google/projects/cel for # more. # Corresponds to the JSON property `filter` # @return [String] attr_accessor :filter # HTTPDelivery is the delivery configuration for an HTTP notification. # Corresponds to the JSON property `httpDelivery` # @return [Google::Apis::CloudbuildV1alpha2::HttpDelivery] attr_accessor :http_delivery # SlackDelivery is the delivery configuration for delivering Slack messages via # webhooks. See Slack webhook documentation at: https://api.slack.com/messaging/ # webhooks. # Corresponds to the JSON property `slackDelivery` # @return [Google::Apis::CloudbuildV1alpha2::SlackDelivery] attr_accessor :slack_delivery # SMTPDelivery is the delivery configuration for an SMTP (email) notification. # Corresponds to the JSON property `smtpDelivery` # @return [Google::Apis::CloudbuildV1alpha2::SmtpDelivery] attr_accessor :smtp_delivery # Escape hatch for users to supply custom delivery configs. # Corresponds to the JSON property `structDelivery` # @return [Hash] attr_accessor :struct_delivery def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @filter = args[:filter] if args.key?(:filter) @http_delivery = args[:http_delivery] if args.key?(:http_delivery) @slack_delivery = args[:slack_delivery] if args.key?(:slack_delivery) @smtp_delivery = args[:smtp_delivery] if args.key?(:smtp_delivery) @struct_delivery = args[:struct_delivery] if args.key?(:struct_delivery) end end # NotifierConfig is the top-level configuration message. class NotifierConfig include Google::Apis::Core::Hashable # The API version of this configuration format. # Corresponds to the JSON property `apiVersion` # @return [String] attr_accessor :api_version # The type of notifier to use (e.g. SMTPNotifier). # Corresponds to the JSON property `kind` # @return [String] attr_accessor :kind # NotifierMetadata contains the data which can be used to reference or describe # this notifier. # Corresponds to the JSON property `metadata` # @return [Google::Apis::CloudbuildV1alpha2::NotifierMetadata] attr_accessor :metadata # NotifierSpec is the configuration container for notifications. # Corresponds to the JSON property `spec` # @return [Google::Apis::CloudbuildV1alpha2::NotifierSpec] attr_accessor :spec def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @api_version = args[:api_version] if args.key?(:api_version) @kind = args[:kind] if args.key?(:kind) @metadata = args[:metadata] if args.key?(:metadata) @spec = args[:spec] if args.key?(:spec) end end # NotifierMetadata contains the data which can be used to reference or describe # this notifier. class NotifierMetadata include Google::Apis::Core::Hashable # The human-readable and user-given name for the notifier. For example: "repo- # merge-email-notifier". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # The string representing the name and version of notifier to deploy. Expected # to be of the form of "/:". For example: "gcr.io/my-project/notifiers/smtp:1.2. # 34". # Corresponds to the JSON property `notifier` # @return [String] attr_accessor :notifier def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @name = args[:name] if args.key?(:name) @notifier = args[:notifier] if args.key?(:notifier) end end # NotifierSecret is the container that maps a secret name (reference) to its # Google Cloud Secret Manager resource path. class NotifierSecret include Google::Apis::Core::Hashable # Name is the local name of the secret, such as the verbatim string "my-smtp- # password". # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # Value is interpreted to be a resource path for fetching the actual (versioned) # secret data for this secret. For example, this would be a Google Cloud Secret # Manager secret version resource path like: "projects/my-project/secrets/my- # secret/versions/latest". # Corresponds to the JSON property `value` # @return [String] attr_accessor :value def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @name = args[:name] if args.key?(:name) @value = args[:value] if args.key?(:value) end end # NotifierSecretRef contains the reference to a secret stored in the # corresponding NotifierSpec. class NotifierSecretRef include Google::Apis::Core::Hashable # The value of `secret_ref` should be a `name` that is registered in a `Secret` # in the `secrets` list of the `Spec`. # Corresponds to the JSON property `secretRef` # @return [String] attr_accessor :secret_ref def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @secret_ref = args[:secret_ref] if args.key?(:secret_ref) end end # NotifierSpec is the configuration container for notifications. class NotifierSpec include Google::Apis::Core::Hashable # Notification is the container which holds the data that is relevant to this # particular notification. # Corresponds to the JSON property `notification` # @return [Google::Apis::CloudbuildV1alpha2::Notification] attr_accessor :notification # Configurations for secret resources used by this particular notifier. # Corresponds to the JSON property `secrets` # @return [Array] attr_accessor :secrets def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @notification = args[:notification] if args.key?(:notification) @secrets = args[:secrets] if args.key?(:secrets) end end # This resource represents a long-running operation that is the result of a # network API call. class Operation include Google::Apis::Core::Hashable # If the value is `false`, it means the operation is still in progress. If `true` # , the operation is completed, and either `error` or `response` is available. # Corresponds to the JSON property `done` # @return [Boolean] attr_accessor :done alias_method :done?, :done # The `Status` type defines a logical error model that is suitable for different # programming environments, including REST APIs and RPC APIs. It is used by [ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of # data: error code, error message, and error details. You can find out more # about this error model and how to work with it in the [API Design Guide](https: # //cloud.google.com/apis/design/errors). # Corresponds to the JSON property `error` # @return [Google::Apis::CloudbuildV1alpha2::Status] attr_accessor :error # Service-specific metadata associated with the operation. It typically contains # progress information and common metadata such as create time. Some services # might not provide such metadata. Any method that returns a long-running # operation should document the metadata type, if any. # Corresponds to the JSON property `metadata` # @return [Hash] attr_accessor :metadata # The server-assigned name, which is only unique within the same service that # originally returns it. If you use the default HTTP mapping, the `name` should # be a resource name ending with `operations/`unique_id``. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # The normal response of the operation in case of success. If the original # method returns no data on success, such as `Delete`, the response is `google. # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, # the response should be the resource. For other methods, the response should # have the type `XxxResponse`, where `Xxx` is the original method name. For # example, if the original method name is `TakeSnapshot()`, the inferred # response type is `TakeSnapshotResponse`. # Corresponds to the JSON property `response` # @return [Hash] attr_accessor :response def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @done = args[:done] if args.key?(:done) @error = args[:error] if args.key?(:error) @metadata = args[:metadata] if args.key?(:metadata) @name = args[:name] if args.key?(:name) @response = args[:response] if args.key?(:response) end end # Location of the source in a Google Cloud Source Repository. class RepoSource include Google::Apis::Core::Hashable # Regex matching branches to build. The syntax of the regular expressions # accepted is the syntax accepted by RE2 and described at https://github.com/ # google/re2/wiki/Syntax # Corresponds to the JSON property `branchName` # @return [String] attr_accessor :branch_name # Explicit commit SHA to build. # Corresponds to the JSON property `commitSha` # @return [String] attr_accessor :commit_sha # 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. # Corresponds to the JSON property `dir` # @return [String] attr_accessor :dir # Only trigger a build if the revision regex does NOT match the revision regex. # Corresponds to the JSON property `invertRegex` # @return [Boolean] attr_accessor :invert_regex alias_method :invert_regex?, :invert_regex # ID of the project that owns the Cloud Source Repository. If omitted, the # project ID requesting the build is assumed. # Corresponds to the JSON property `projectId` # @return [String] attr_accessor :project_id # Required. Name of the Cloud Source Repository. # Corresponds to the JSON property `repoName` # @return [String] attr_accessor :repo_name # Substitutions to use in a triggered build. Should only be used with # RunBuildTrigger # Corresponds to the JSON property `substitutions` # @return [Hash] attr_accessor :substitutions # Regex matching tags to build. The syntax of the regular expressions accepted # is the syntax accepted by RE2 and described at https://github.com/google/re2/ # wiki/Syntax # Corresponds to the JSON property `tagName` # @return [String] attr_accessor :tag_name def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @branch_name = args[:branch_name] if args.key?(:branch_name) @commit_sha = args[:commit_sha] if args.key?(:commit_sha) @dir = args[:dir] if args.key?(:dir) @invert_regex = args[:invert_regex] if args.key?(:invert_regex) @project_id = args[:project_id] if args.key?(:project_id) @repo_name = args[:repo_name] if args.key?(:repo_name) @substitutions = args[:substitutions] if args.key?(:substitutions) @tag_name = args[:tag_name] if args.key?(:tag_name) end end # Artifacts created by the build pipeline. class Results include Google::Apis::Core::Hashable # Path to the artifact manifest. Only populated when artifacts are uploaded. # Corresponds to the JSON property `artifactManifest` # @return [String] attr_accessor :artifact_manifest # Start and end times for a build execution phase. # Corresponds to the JSON property `artifactTiming` # @return [Google::Apis::CloudbuildV1alpha2::TimeSpan] attr_accessor :artifact_timing # List of build step digests, in the order corresponding to build step indices. # Corresponds to the JSON property `buildStepImages` # @return [Array] attr_accessor :build_step_images # List of build step outputs, produced by builder images, in the order # corresponding to build step indices. [Cloud Builders](https://cloud.google.com/ # cloud-build/docs/cloud-builders) can produce this output by writing to `$ # BUILDER_OUTPUT/output`. Only the first 4KB of data is stored. # Corresponds to the JSON property `buildStepOutputs` # @return [Array] attr_accessor :build_step_outputs # Container images that were built as a part of the build. # Corresponds to the JSON property `images` # @return [Array] attr_accessor :images # Number of artifacts uploaded. Only populated when artifacts are uploaded. # Corresponds to the JSON property `numArtifacts` # @return [Fixnum] attr_accessor :num_artifacts def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @artifact_manifest = args[:artifact_manifest] if args.key?(:artifact_manifest) @artifact_timing = args[:artifact_timing] if args.key?(:artifact_timing) @build_step_images = args[:build_step_images] if args.key?(:build_step_images) @build_step_outputs = args[:build_step_outputs] if args.key?(:build_step_outputs) @images = args[:images] if args.key?(:images) @num_artifacts = args[:num_artifacts] if args.key?(:num_artifacts) end end # SMTPDelivery is the delivery configuration for an SMTP (email) notification. class SmtpDelivery include Google::Apis::Core::Hashable # This is the SMTP account/email that appears in the `From:` of the email. If # empty, it is assumed to be sender. # Corresponds to the JSON property `fromAddress` # @return [String] attr_accessor :from_address # NotifierSecretRef contains the reference to a secret stored in the # corresponding NotifierSpec. # Corresponds to the JSON property `password` # @return [Google::Apis::CloudbuildV1alpha2::NotifierSecretRef] attr_accessor :password # The SMTP port of the server. # Corresponds to the JSON property `port` # @return [String] attr_accessor :port # This is the list of addresses to which we send the email (i.e. in the `To:` of # the email). # Corresponds to the JSON property `recipientAddresses` # @return [Array] attr_accessor :recipient_addresses # This is the SMTP account/email that is used to send the message. # Corresponds to the JSON property `senderAddress` # @return [String] attr_accessor :sender_address # The address of the SMTP server. # Corresponds to the JSON property `server` # @return [String] attr_accessor :server def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @from_address = args[:from_address] if args.key?(:from_address) @password = args[:password] if args.key?(:password) @port = args[:port] if args.key?(:port) @recipient_addresses = args[:recipient_addresses] if args.key?(:recipient_addresses) @sender_address = args[:sender_address] if args.key?(:sender_address) @server = args[:server] if args.key?(:server) end end # Pairs a set of secret environment variables containing encrypted values with # the Cloud KMS key to use to decrypt the value. class Secret include Google::Apis::Core::Hashable # Cloud KMS key name to use to decrypt these envs. # Corresponds to the JSON property `kmsKeyName` # @return [String] attr_accessor :kms_key_name # 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 64 KB in size. There can be at # most 100 secret values across all of a build's secrets. # Corresponds to the JSON property `secretEnv` # @return [Hash] attr_accessor :secret_env def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name) @secret_env = args[:secret_env] if args.key?(:secret_env) end end # SlackDelivery is the delivery configuration for delivering Slack messages via # webhooks. See Slack webhook documentation at: https://api.slack.com/messaging/ # webhooks. class SlackDelivery include Google::Apis::Core::Hashable # NotifierSecretRef contains the reference to a secret stored in the # corresponding NotifierSpec. # Corresponds to the JSON property `webhookUri` # @return [Google::Apis::CloudbuildV1alpha2::NotifierSecretRef] attr_accessor :webhook_uri def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @webhook_uri = args[:webhook_uri] if args.key?(:webhook_uri) end end # Location of the source in a supported storage service. class Source include Google::Apis::Core::Hashable # Location of the source in a Google Cloud Source Repository. # Corresponds to the JSON property `repoSource` # @return [Google::Apis::CloudbuildV1alpha2::RepoSource] attr_accessor :repo_source # Location of the source in an archive file in Google Cloud Storage. # Corresponds to the JSON property `storageSource` # @return [Google::Apis::CloudbuildV1alpha2::StorageSource] attr_accessor :storage_source def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @repo_source = args[:repo_source] if args.key?(:repo_source) @storage_source = args[:storage_source] if args.key?(:storage_source) end end # Provenance of the source. Ways to find the original source, or verify that # some source was used for this build. class SourceProvenance include Google::Apis::Core::Hashable # Output only. 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. # Corresponds to the JSON property `fileHashes` # @return [Hash] attr_accessor :file_hashes # Location of the source in a Google Cloud Source Repository. # Corresponds to the JSON property `resolvedRepoSource` # @return [Google::Apis::CloudbuildV1alpha2::RepoSource] attr_accessor :resolved_repo_source # Location of the source in an archive file in Google Cloud Storage. # Corresponds to the JSON property `resolvedStorageSource` # @return [Google::Apis::CloudbuildV1alpha2::StorageSource] attr_accessor :resolved_storage_source def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @file_hashes = args[:file_hashes] if args.key?(:file_hashes) @resolved_repo_source = args[:resolved_repo_source] if args.key?(:resolved_repo_source) @resolved_storage_source = args[:resolved_storage_source] if args.key?(:resolved_storage_source) end end # The `Status` type defines a logical error model that is suitable for different # programming environments, including REST APIs and RPC APIs. It is used by [ # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of # data: error code, error message, and error details. You can find out more # about this error model and how to work with it in the [API Design Guide](https: # //cloud.google.com/apis/design/errors). class Status include Google::Apis::Core::Hashable # The status code, which should be an enum value of google.rpc.Code. # Corresponds to the JSON property `code` # @return [Fixnum] attr_accessor :code # A list of messages that carry the error details. There is a common set of # message types for APIs to use. # Corresponds to the JSON property `details` # @return [Array>] attr_accessor :details # A developer-facing error message, which should be in English. Any user-facing # error message should be localized and sent in the google.rpc.Status.details # field, or localized by the client. # Corresponds to the JSON property `message` # @return [String] attr_accessor :message def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @code = args[:code] if args.key?(:code) @details = args[:details] if args.key?(:details) @message = args[:message] if args.key?(:message) end end # Location of the source in an archive file in Google Cloud Storage. class StorageSource include Google::Apis::Core::Hashable # Google Cloud Storage bucket containing the source (see [Bucket Name # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements) # ). # Corresponds to the JSON property `bucket` # @return [String] attr_accessor :bucket # Google Cloud Storage generation for the object. If the generation is omitted, # the latest generation will be used. # Corresponds to the JSON property `generation` # @return [Fixnum] attr_accessor :generation # Google Cloud Storage object containing the source. This object must be a # gzipped archive file (`.tar.gz`) containing source to build. # Corresponds to the JSON property `object` # @return [String] attr_accessor :object def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @bucket = args[:bucket] if args.key?(:bucket) @generation = args[:generation] if args.key?(:generation) @object = args[:object] if args.key?(:object) end end # Start and end times for a build execution phase. class TimeSpan include Google::Apis::Core::Hashable # End of time span. # Corresponds to the JSON property `endTime` # @return [String] attr_accessor :end_time # Start of time span. # Corresponds to the JSON property `startTime` # @return [String] attr_accessor :start_time def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @end_time = args[:end_time] if args.key?(:end_time) @start_time = args[:start_time] if args.key?(:start_time) end end # Volume describes a Docker container volume which is mounted into build steps # in order to persist files across build step execution. class Volume include Google::Apis::Core::Hashable # 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. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # 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. # Corresponds to the JSON property `path` # @return [String] attr_accessor :path def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @name = args[:name] if args.key?(:name) @path = args[:path] if args.key?(:path) end end # WorkerConfig defines the configuration to be used for a creating workers in # the pool. class WorkerConfig include Google::Apis::Core::Hashable # Size of the disk attached to the worker, in GB. See https://cloud.google.com/ # compute/docs/disks/ If `0` is specified, Cloud Build will use a standard disk # size. # Corresponds to the JSON property `diskSizeGb` # @return [Fixnum] attr_accessor :disk_size_gb # Machine Type of the worker, such as n1-standard-1. See https://cloud.google. # com/compute/docs/machine-types. If left blank, Cloud Build will use a standard # unspecified machine to create the worker pool. # Corresponds to the JSON property `machineType` # @return [String] attr_accessor :machine_type def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @disk_size_gb = args[:disk_size_gb] if args.key?(:disk_size_gb) @machine_type = args[:machine_type] if args.key?(:machine_type) end end # Configuration for a WorkerPool to run the builds. Workers are machines that # Cloud Build uses to run your builds. By default, all workers run in a project # owned by Cloud Build. To have full control over the workers that execute your # builds -- such as enabling them to access private resources on your private # network -- you can request Cloud Build to run the workers in your own project # by creating a custom workers pool. class WorkerPool include Google::Apis::Core::Hashable # Output only. Time at which the request to create the `WorkerPool` was received. # Corresponds to the JSON property `createTime` # @return [String] attr_accessor :create_time # Output only. Time at which the request to delete the `WorkerPool` was received. # Corresponds to the JSON property `deleteTime` # @return [String] attr_accessor :delete_time # Output only. The resource name of the `WorkerPool`. Format of the name is ` # projects/`project_id`/workerPools/`worker_pool_id``, where the value of ` # worker_pool_id` is provided in the CreateWorkerPool request. # Corresponds to the JSON property `name` # @return [String] attr_accessor :name # Network describes the network configuration for a `WorkerPool`. # Corresponds to the JSON property `networkConfig` # @return [Google::Apis::CloudbuildV1alpha2::NetworkConfig] attr_accessor :network_config # Required. Immutable. The region where the `WorkerPool` runs. Only "us-central1" # is currently supported. Note that `region` cannot be changed once the ` # WorkerPool` is created. # Corresponds to the JSON property `region` # @return [String] attr_accessor :region # Output only. WorkerPool state. # Corresponds to the JSON property `state` # @return [String] attr_accessor :state # Output only. Time at which the request to update the `WorkerPool` was received. # Corresponds to the JSON property `updateTime` # @return [String] attr_accessor :update_time # WorkerConfig defines the configuration to be used for a creating workers in # the pool. # Corresponds to the JSON property `workerConfig` # @return [Google::Apis::CloudbuildV1alpha2::WorkerConfig] attr_accessor :worker_config def initialize(**args) update!(**args) end # Update properties of this object def update!(**args) @create_time = args[:create_time] if args.key?(:create_time) @delete_time = args[:delete_time] if args.key?(:delete_time) @name = args[:name] if args.key?(:name) @network_config = args[:network_config] if args.key?(:network_config) @region = args[:region] if args.key?(:region) @state = args[:state] if args.key?(:state) @update_time = args[:update_time] if args.key?(:update_time) @worker_config = args[:worker_config] if args.key?(:worker_config) end end end end end