google-api-client 0.9.8 → 0.9.20

data/generated/google/apis/cloudbuild_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/container-builder/docs/
     module CloudbuildV1
       VERSION = 'V1'
-      REVISION = '20160525'
+      REVISION = '20161108'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudbuild_v1/classes.rb

@@ -102,6 +102,15 @@ module Google
         # 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 what tag to
         # apply to the built image when it is pushed to Google Container Registry.
+        # 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.
         # Corresponds to the JSON property `build`
         # @return [Google::Apis::CloudbuildV1::Build]
         attr_accessor :build
@@ -127,6 +136,12 @@ module Google
         # @return [Google::Apis::CloudbuildV1::StorageSource]
         attr_accessor :storage_source
       
+        # RepoSource describes the location of the source in a Google Cloud Source
+        # Repository.
+        # Corresponds to the JSON property `repoSource`
+        # @return [Google::Apis::CloudbuildV1::RepoSource]
+        attr_accessor :repo_source
+      
         def initialize(**args)
            update!(**args)
         end
@@ -134,6 +149,48 @@ module Google
         # Update properties of this object
         def update!(**args)
           @storage_source = args[:storage_source] if args.key?(:storage_source)
+          @repo_source = args[:repo_source] if args.key?(:repo_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
+      
+        # RepoSource describes the location of the source in a Google Cloud Source
+        # Repository.
+        # Corresponds to the JSON property `resolvedRepoSource`
+        # @return [Google::Apis::CloudbuildV1::RepoSource]
+        attr_accessor :resolved_repo_source
+      
+        # StorageSource describes the location of the source in an archive file in
+        # Google Cloud Storage.
+        # Corresponds to the JSON property `resolvedStorageSource`
+        # @return [Google::Apis::CloudbuildV1::StorageSource]
+        attr_accessor :resolved_storage_source
+      
+        # 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
+        # Corresponds to the JSON property `fileHashes`
+        # @return [Hash<String,Google::Apis::CloudbuildV1::FileHashes>]
+        attr_accessor :file_hashes
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @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)
+          @file_hashes = args[:file_hashes] if args.key?(:file_hashes)
         end
       end
       
@@ -234,6 +291,79 @@ module Google
         end
       end
       
+      # Configuration for an automated build in response to source repository
+      # changes.
+      class BuildTrigger
+        include Google::Apis::Core::Hashable
+      
+        # Unique identifier of the trigger.
+        # @OutputOnly
+        # Corresponds to the JSON property `id`
+        # @return [String]
+        attr_accessor :id
+      
+        # Human-readable description of this trigger.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # RepoSource describes the location of the source in a Google Cloud Source
+        # Repository.
+        # Corresponds to the JSON property `triggerTemplate`
+        # @return [Google::Apis::CloudbuildV1::RepoSource]
+        attr_accessor :trigger_template
+      
+        # If true, the trigger will never result in a build.
+        # Corresponds to the JSON property `disabled`
+        # @return [Boolean]
+        attr_accessor :disabled
+        alias_method :disabled?, :disabled
+      
+        # Time when the trigger was created.
+        # @OutputOnly
+        # Corresponds to the JSON property `createTime`
+        # @return [String]
+        attr_accessor :create_time
+      
+        # Path, from the source root, to a file whose contents is used for the
+        # template.
+        # Corresponds to the JSON property `filename`
+        # @return [String]
+        attr_accessor :filename
+      
+        # 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 what tag to
+        # apply to the built image when it is pushed to Google Container Registry.
+        # 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.
+        # Corresponds to the JSON property `build`
+        # @return [Google::Apis::CloudbuildV1::Build]
+        attr_accessor :build
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @description = args[:description] if args.key?(:description)
+          @trigger_template = args[:trigger_template] if args.key?(:trigger_template)
+          @disabled = args[:disabled] if args.key?(:disabled)
+          @create_time = args[:create_time] if args.key?(:create_time)
+          @filename = args[:filename] if args.key?(:filename)
+          @build = args[:build] if args.key?(:build)
+        end
+      end
+      
       # BuiltImage describes an image built by the pipeline.
       class BuiltImage
         include Google::Apis::Core::Hashable
@@ -260,6 +390,31 @@ module Google
         end
       end
       
+      # Container message for hash values.
+      class HashProp
+        include Google::Apis::Core::Hashable
+      
+        # The hash value.
+        # Corresponds to the JSON property `value`
+        # @return [String]
+        attr_accessor :value
+      
+        # The type of hash that was performed.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @value = args[:value] if args.key?(:value)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
       # StorageSource describes the location of the source in an archive file in
       # Google Cloud Storage.
       class StorageSource
@@ -307,6 +462,11 @@ module Google
         # @return [Array<Google::Apis::CloudbuildV1::BuiltImage>]
         attr_accessor :images
       
+        # List of build step digests, in order corresponding to build step indices.
+        # Corresponds to the JSON property `buildStepImages`
+        # @return [Array<String>]
+        attr_accessor :build_step_images
+      
         def initialize(**args)
            update!(**args)
         end
@@ -314,6 +474,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @images = args[:images] if args.key?(:images)
+          @build_step_images = args[:build_step_images] if args.key?(:build_step_images)
         end
       end
       
@@ -321,6 +482,15 @@ module Google
       # 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 what tag to
       # apply to the built image when it is pushed to Google Container Registry.
+      # 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.
       class Build
         include Google::Apis::Core::Hashable
       
@@ -330,6 +500,12 @@ module Google
         # @return [String]
         attr_accessor :id
       
+        # 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::CloudbuildV1::SourceProvenance]
+        attr_accessor :source_provenance
+      
         # Results describes the artifacts created by the build pipeline.
         # Corresponds to the JSON property `results`
         # @return [Google::Apis::CloudbuildV1::Results]
@@ -341,6 +517,11 @@ module Google
         # @return [String]
         attr_accessor :status
       
+        # Optional arguments to enable specific features of builds.
+        # Corresponds to the JSON property `options`
+        # @return [Google::Apis::CloudbuildV1::BuildOptions]
+        attr_accessor :options
+      
         # Time at which execution of the build was finished.
         # @OutputOnly
         # Corresponds to the JSON property `finishTime`
@@ -372,16 +553,25 @@ module Google
         # @return [String]
         attr_accessor :create_time
       
+        # URL to logs for this build in Google Cloud Logging.
+        # @OutputOnly
+        # Corresponds to the JSON property `logUrl`
+        # @return [String]
+        attr_accessor :log_url
+      
         # Customer-readable message about the current status.
         # @OutputOnly
         # Corresponds to the JSON property `statusDetail`
         # @return [String]
         attr_accessor :status_detail
       
-        # List of images expected to be built and pushed to Google Container
-        # Registry. If an image is listed here and the image is not produced by
-        # one of the build steps, the build will fail. Any images present when
-        # the build steps are complete will be pushed to Container Registry.
+        # 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<String>]
         attr_accessor :images
@@ -392,6 +582,13 @@ module Google
         # @return [String]
         attr_accessor :start_time
       
+        # The ID of the BuildTrigger that triggered this build, if it was
+        # triggered automatically.
+        # @OutputOnly
+        # Corresponds to the JSON property `buildTriggerId`
+        # @return [String]
+        attr_accessor :build_trigger_id
+      
         # Google Cloud Storage bucket where logs should be written (see
         # [Bucket Name
         # Requirements](https://cloud.google.com/storage/docs/bucket-naming#requirements)
@@ -414,21 +611,44 @@ module Google
         # Update properties of this object
         def update!(**args)
           @id = args[:id] if args.key?(:id)
+          @source_provenance = args[:source_provenance] if args.key?(:source_provenance)
           @results = args[:results] if args.key?(:results)
           @status = args[:status] if args.key?(:status)
+          @options = args[:options] if args.key?(:options)
           @finish_time = args[:finish_time] if args.key?(:finish_time)
           @timeout = args[:timeout] if args.key?(:timeout)
           @steps = args[:steps] if args.key?(:steps)
           @source = args[:source] if args.key?(:source)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @log_url = args[:log_url] if args.key?(:log_url)
           @status_detail = args[:status_detail] if args.key?(:status_detail)
           @images = args[:images] if args.key?(:images)
           @start_time = args[:start_time] if args.key?(:start_time)
+          @build_trigger_id = args[:build_trigger_id] if args.key?(:build_trigger_id)
           @logs_bucket = args[:logs_bucket] if args.key?(:logs_bucket)
           @project_id = args[:project_id] if args.key?(:project_id)
         end
       end
       
+      # Response containing existing BuildTriggers.
+      class ListBuildTriggersResponse
+        include Google::Apis::Core::Hashable
+      
+        # BuildTriggers for the project, sorted by create_time descending.
+        # Corresponds to the JSON property `triggers`
+        # @return [Array<Google::Apis::CloudbuildV1::BuildTrigger>]
+        attr_accessor :triggers
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @triggers = args[:triggers] if args.key?(:triggers)
+        end
+      end
+      
       # Request to cancel an ongoing build.
       class CancelBuildRequest
         include Google::Apis::Core::Hashable
@@ -442,6 +662,26 @@ module Google
         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<Google::Apis::CloudbuildV1::HashProp>]
+        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
+      
       # The response message for Operations.ListOperations.
       class ListOperationsResponse
         include Google::Apis::Core::Hashable
@@ -467,31 +707,157 @@ module Google
         end
       end
       
+      # RepoSource describes the location of the source in a Google Cloud Source
+      # Repository.
+      class RepoSource
+        include Google::Apis::Core::Hashable
+      
+        # Name of the repo. If omitted, the name "default" is assumed.
+        # Corresponds to the JSON property `repoName`
+        # @return [String]
+        attr_accessor :repo_name
+      
+        # Name of the tag to build.
+        # Corresponds to the JSON property `tagName`
+        # @return [String]
+        attr_accessor :tag_name
+      
+        # ID of the project that owns the repo. If omitted, the project ID requesting
+        # the build is assumed.
+        # Corresponds to the JSON property `projectId`
+        # @return [String]
+        attr_accessor :project_id
+      
+        # Name of the branch to build.
+        # 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
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @repo_name = args[:repo_name] if args.key?(:repo_name)
+          @tag_name = args[:tag_name] if args.key?(:tag_name)
+          @project_id = args[:project_id] if args.key?(:project_id)
+          @branch_name = args[:branch_name] if args.key?(:branch_name)
+          @commit_sha = args[:commit_sha] if args.key?(:commit_sha)
+        end
+      end
+      
       # BuildStep describes a step to perform in the build pipeline.
       class BuildStep
         include Google::Apis::Core::Hashable
       
-        # Command-line arguments to use when running this step's container.
+        # Optional 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
+      
+        # 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<String>]
+        attr_accessor :env
+      
+        # 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<String>]
+        attr_accessor :wait_for
+      
+        # 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, these args
+        # will be used as arguments to that entrypoint. If the image does not define
+        # an entrypoint, the first element in args will be used as the entrypoint,
+        # and the remainder will be used as arguments.
         # Corresponds to the JSON property `args`
         # @return [Array<String>]
         attr_accessor :args
       
+        # The name of the container image that will run this particular build step.
+        # If the image is already 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). 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
+      
         # Working directory (relative to project source root) to use when running
         # this operation's container.
         # Corresponds to the JSON property `dir`
         # @return [String]
         attr_accessor :dir
       
-        # Name of the container image to use for creating this stage in the
-        # pipeline, as presented to `docker pull`.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
+        def initialize(**args)
+           update!(**args)
+        end
       
-        # Additional environment variables to set for this step's container.
-        # Corresponds to the JSON property `env`
+        # Update properties of this object
+        def update!(**args)
+          @id = args[:id] if args.key?(:id)
+          @env = args[:env] if args.key?(:env)
+          @wait_for = args[:wait_for] if args.key?(:wait_for)
+          @args = args[:args] if args.key?(:args)
+          @name = args[:name] if args.key?(:name)
+          @dir = args[:dir] if args.key?(:dir)
+        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
+      
+      # Optional arguments to enable specific features of builds.
+      class BuildOptions
+        include Google::Apis::Core::Hashable
+      
+        # Requested hash for SourceProvenance.
+        # Corresponds to the JSON property `sourceProvenanceHash`
         # @return [Array<String>]
-        attr_accessor :env
+        attr_accessor :source_provenance_hash
+      
+        # Requested verifiability options.
+        # Corresponds to the JSON property `requestedVerifyOption`
+        # @return [String]
+        attr_accessor :requested_verify_option
       
         def initialize(**args)
            update!(**args)
@@ -499,10 +865,8 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @args = args[:args] if args.key?(:args)
-          @dir = args[:dir] if args.key?(:dir)
-          @name = args[:name] if args.key?(:name)
-          @env = args[:env] if args.key?(:env)
+          @source_provenance_hash = args[:source_provenance_hash] if args.key?(:source_provenance_hash)
+          @requested_verify_option = args[:requested_verify_option] if args.key?(:requested_verify_option)
         end
       end