Class: Google::Cloud::Build::V1::BuildOptions

Inherits:
Object
  • Object
show all
Extended by:
Protobuf::MessageExts::ClassMethods
Includes:
Protobuf::MessageExts
Defined in:
proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb

Overview

Optional arguments to enable specific features of builds.

Defined Under Namespace

Modules: DefaultLogsBucketBehavior, LogStreamingOption, LoggingMode, MachineType, SubstitutionOption, VerifyOption Classes: PoolOption

Instance Attribute Summary collapse

Instance Attribute Details

#automap_substitutions ⇒ ::Boolean

Returns Option to include built-in and custom substitutions as env variables for all build steps.

Returns:

  • (::Boolean) —

    Option to include built-in and custom substitutions as env variables for all build steps.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#default_logs_bucket_behavior ⇒ ::Google::Cloud::Build::V1::BuildOptions::DefaultLogsBucketBehavior

Returns Optional. Option to specify how default logs buckets are setup.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#disk_size_gb ⇒ ::Integer

Returns 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 4000GB; builds that request more than the maximum are rejected with an error.

Returns:

  • (::Integer) —

    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 4000GB; builds that request more than the maximum are rejected with an error.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#dynamic_substitutions ⇒ ::Boolean

Returns 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.

Returns:

  • (::Boolean) —

    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.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#enable_structured_logging ⇒ ::Boolean

Returns Optional. Option to specify whether structured logging is enabled.

If true, JSON-formatted logs are parsed as structured logs.

Returns:

  • (::Boolean) —

    Optional. Option to specify whether structured logging is enabled.

    If true, JSON-formatted logs are parsed as structured logs.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#env ⇒ ::Array<::String>

Returns 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".

Returns:

  • (::Array<::String>) —

    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".



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#log_streaming_option ⇒ ::Google::Cloud::Build::V1::BuildOptions::LogStreamingOption

Returns Option to define build log streaming behavior to Cloud Storage.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#logging ⇒ ::Google::Cloud::Build::V1::BuildOptions::LoggingMode

Returns Option to specify the logging mode, which determines if and where build logs are stored.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#machine_type ⇒ ::Google::Cloud::Build::V1::BuildOptions::MachineType

Returns Compute Engine machine type on which to run the build.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#pool ⇒ ::Google::Cloud::Build::V1::BuildOptions::PoolOption

Returns Optional. Specification for execution on a WorkerPool.

See running builds in a private pool for more information.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#requested_verify_option ⇒ ::Google::Cloud::Build::V1::BuildOptions::VerifyOption

Returns Requested verifiability options.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#secret_env ⇒ ::Array<::String>

Returns 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.

Returns:

  • (::Array<::String>) —

    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.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#source_provenance_hash ⇒ ::Array<::Google::Cloud::Build::V1::Hash::HashType>

Returns Requested hash for SourceProvenance.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#substitution_option ⇒ ::Google::Cloud::Build::V1::BuildOptions::SubstitutionOption

Returns 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.

Returns:



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#volumes ⇒ ::Array<::Google::Cloud::Build::V1::Volume>

Returns 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.

Returns:

  • (::Array<::Google::Cloud::Build::V1::Volume>) —

    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.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end

#worker_pool ⇒ ::String

Deprecated.

This field is deprecated and may be removed in the next major version update.

Returns This field deprecated; please use pool.name instead.

Returns:

  • (::String) —

    This field deprecated; please use pool.name instead.



2081
2082
2083
2084
2085
2086
2087
2088
2089
2090
2091
2092
2093
2094
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
2130
2131
2132
2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
 
# File 'proto_docs/google/devtools/cloudbuild/v1/cloudbuild.rb', line 2081

class BuildOptions
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Details about how a build should be executed on a `WorkerPool`.
  #
  # See [running builds in a private
  # pool](https://cloud.google.com/build/docs/private-pools/run-builds-in-private-pool)
  # for more information.
  # @!attribute [rw] name
  #   @return [::String]
  #     The `WorkerPool` resource to execute the build on.
  #     You must have `cloudbuild.workerpools.use` on the project hosting the
  #     WorkerPool.
  #
  #     Format projects/\\{project}/locations/\\{location}/workerPools/\\{workerPoolId}
  class PoolOption
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Specifies the manner in which the build should be verified, if at all.
  #
  # If a verified build is requested, and any part of the process to generate
  # and upload provenance fails, the build will also fail.
  #
  # If the build does not request verification then that process may occur, but
  # is not guaranteed to. If it does occur and fails, the build will not fail.
  #
  # For more information, see [Viewing Build
  # Provenance](https://cloud.google.com/build/docs/securing-builds/view-build-provenance).
  module VerifyOption
    # Not a verifiable build (the default).
    NOT_VERIFIED = 0

    # Build must be verified.
    VERIFIED = 1
  end

  # Supported Compute Engine machine types.
  # For more information, see [Machine
  # types](https://cloud.google.com/compute/docs/machine-types).
  module MachineType
    # Standard machine type.
    UNSPECIFIED = 0

    # Highcpu machine with 8 CPUs.
    N1_HIGHCPU_8 = 1

    # Highcpu machine with 32 CPUs.
    N1_HIGHCPU_32 = 2

    # Highcpu e2 machine with 8 CPUs.
    E2_HIGHCPU_8 = 5

    # Highcpu e2 machine with 32 CPUs.
    E2_HIGHCPU_32 = 6

    # E2 machine with 1 CPU.
    E2_MEDIUM = 7
  end

  # Specifies the behavior when there is an error in the substitution checks.
  module 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
  end

  # Specifies the behavior when writing build logs to Cloud Storage.
  module LogStreamingOption
    # Service may automatically determine build log streaming behavior.
    STREAM_DEFAULT = 0

    # Build logs should be streamed to Cloud Storage.
    STREAM_ON = 1

    # Build logs should not be streamed to Cloud Storage; they will be
    # written when the build is completed.
    STREAM_OFF = 2
  end

  # Specifies the logging mode.
  module LoggingMode
    # The service determines the logging mode. The default is `LEGACY`. Do not
    # rely on the default logging behavior as it may change in the future.
    LOGGING_UNSPECIFIED = 0

    # Build logs are stored in Cloud Logging and Cloud Storage.
    LEGACY = 1

    # Build logs are stored in Cloud Storage.
    GCS_ONLY = 2

    # This option is the same as CLOUD_LOGGING_ONLY.
    STACKDRIVER_ONLY = 3

    # Build logs are stored in Cloud Logging. Selecting this option will not
    # allow [logs
    # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
    CLOUD_LOGGING_ONLY = 5

    # Turn off all logging. No build logs will be captured.
    NONE = 4
  end

  # Default Cloud Storage log bucket behavior options.
  module DefaultLogsBucketBehavior
    # Unspecified.
    DEFAULT_LOGS_BUCKET_BEHAVIOR_UNSPECIFIED = 0

    # Bucket is located in user-owned project in the same region as the
    # build. The builder service account must have access to create and write
    # to Cloud Storage buckets in the build project.
    REGIONAL_USER_OWNED_BUCKET = 1

    # Bucket is located in a Google-owned project and is not regionalized.
    LEGACY_BUCKET = 2
  end
end