Struct BuildOptions 

#[non_exhaustive]
pub struct BuildOptions {

    pub source_provenance_hash: Vec<HashType>,
    pub requested_verify_option: VerifyOption,
    pub machine_type: MachineType,
    pub disk_size_gb: i64,
    pub substitution_option: SubstitutionOption,
    pub dynamic_substitutions: bool,
    pub automap_substitutions: bool,
    pub log_streaming_option: LogStreamingOption,
    pub worker_pool: String,
    pub pool: Option<PoolOption>,
    pub logging: LoggingMode,
    pub env: Vec<String>,
    pub secret_env: Vec<String>,
    pub volumes: Vec<Volume>,
    pub default_logs_bucket_behavior: DefaultLogsBucketBehavior,
    pub enable_structured_logging: bool,
    /* private fields */
}

Optional arguments to enable specific features of builds.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

source_provenance_hash: Vec<HashType>

Requested hash for SourceProvenance.

requested_verify_option: VerifyOption

Requested verifiability options.

machine_type: MachineType

Compute Engine machine type on which to run the build.

disk_size_gb: i64

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.

substitution_option: SubstitutionOption

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.

dynamic_substitutions: bool

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.

automap_substitutions: bool

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

log_streaming_option: LogStreamingOption

Option to define build log streaming behavior to Cloud Storage.

worker_pool: String

👎Deprecated

This field deprecated; please use pool.name instead.

pool: Option<PoolOption>

Optional. Specification for execution on a WorkerPool.

See running builds in a private pool for more information.

logging: LoggingMode

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

env: Vec<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”.

secret_env: Vec<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.

volumes: Vec<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.

default_logs_bucket_behavior: DefaultLogsBucketBehavior

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

enable_structured_logging: bool

Optional. Option to specify whether structured logging is enabled.

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

Implementations

impl BuildOptions

pub fn new() -> Self

pub fn set_source_provenance_hash<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<HashType>,

Sets the value of source_provenance_hash.

Example

use google_cloud_build_v1::model::hash::HashType;
let x = BuildOptions::new().set_source_provenance_hash([
    HashType::Sha256,
    HashType::Md5,
    HashType::GoModuleH1,
]);

pub fn set_requested_verify_option<T: Into<VerifyOption>>(self, v: T) -> Self

Sets the value of requested_verify_option.

Example

use google_cloud_build_v1::model::build_options::VerifyOption;
let x0 = BuildOptions::new().set_requested_verify_option(VerifyOption::Verified);

pub fn set_machine_type<T: Into<MachineType>>(self, v: T) -> Self

Sets the value of machine_type.

Example

use google_cloud_build_v1::model::build_options::MachineType;
let x0 = BuildOptions::new().set_machine_type(MachineType::N1Highcpu8);
let x1 = BuildOptions::new().set_machine_type(MachineType::N1Highcpu32);
let x2 = BuildOptions::new().set_machine_type(MachineType::E2Highcpu8);

pub fn set_disk_size_gb<T: Into<i64>>(self, v: T) -> Self

Sets the value of disk_size_gb.

Example

let x = BuildOptions::new().set_disk_size_gb(42);

pub fn set_substitution_option<T: Into<SubstitutionOption>>(self, v: T) -> Self

Sets the value of substitution_option.

Example

use google_cloud_build_v1::model::build_options::SubstitutionOption;
let x0 = BuildOptions::new().set_substitution_option(SubstitutionOption::AllowLoose);

pub fn set_dynamic_substitutions<T: Into<bool>>(self, v: T) -> Self

Sets the value of dynamic_substitutions.

Example

let x = BuildOptions::new().set_dynamic_substitutions(true);

pub fn set_automap_substitutions<T: Into<bool>>(self, v: T) -> Self

Sets the value of automap_substitutions.

Example

let x = BuildOptions::new().set_automap_substitutions(true);

pub fn set_log_streaming_option<T: Into<LogStreamingOption>>(self, v: T) -> Self

Sets the value of log_streaming_option.

Example

use google_cloud_build_v1::model::build_options::LogStreamingOption;
let x0 = BuildOptions::new().set_log_streaming_option(LogStreamingOption::StreamOn);
let x1 = BuildOptions::new().set_log_streaming_option(LogStreamingOption::StreamOff);

pub fn set_worker_pool<T: Into<String>>(self, v: T) -> Self

👎Deprecated

Sets the value of worker_pool.

Example

let x = BuildOptions::new().set_worker_pool("example");

pub fn set_pool<T>(self, v: T) -> Self

where T: Into<PoolOption>,

Sets the value of pool.

Example

use google_cloud_build_v1::model::build_options::PoolOption;
let x = BuildOptions::new().set_pool(PoolOption::default()/* use setters */);

pub fn set_or_clear_pool<T>(self, v: Option<T>) -> Self

where T: Into<PoolOption>,

Sets or clears the value of pool.

Example

use google_cloud_build_v1::model::build_options::PoolOption;
let x = BuildOptions::new().set_or_clear_pool(Some(PoolOption::default()/* use setters */));
let x = BuildOptions::new().set_or_clear_pool(None::<PoolOption>);

pub fn set_logging<T: Into<LoggingMode>>(self, v: T) -> Self

Sets the value of logging.

Example

use google_cloud_build_v1::model::build_options::LoggingMode;
let x0 = BuildOptions::new().set_logging(LoggingMode::Legacy);
let x1 = BuildOptions::new().set_logging(LoggingMode::GcsOnly);
let x2 = BuildOptions::new().set_logging(LoggingMode::CloudLoggingOnly);

pub fn set_env<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of env.

Example

let x = BuildOptions::new().set_env(["a", "b", "c"]);

pub fn set_secret_env<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of secret_env.

Example

let x = BuildOptions::new().set_secret_env(["a", "b", "c"]);

pub fn set_volumes<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Volume>,

Sets the value of volumes.

Example

use google_cloud_build_v1::model::Volume;
let x = BuildOptions::new()
    .set_volumes([
        Volume::default()/* use setters */,
        Volume::default()/* use (different) setters */,
    ]);

pub fn set_default_logs_bucket_behavior<T: Into<DefaultLogsBucketBehavior>>( self, v: T, ) -> Self

Sets the value of default_logs_bucket_behavior.

Example

use google_cloud_build_v1::model::build_options::DefaultLogsBucketBehavior;
let x0 = BuildOptions::new().set_default_logs_bucket_behavior(DefaultLogsBucketBehavior::RegionalUserOwnedBucket);
let x1 = BuildOptions::new().set_default_logs_bucket_behavior(DefaultLogsBucketBehavior::LegacyBucket);

pub fn set_enable_structured_logging<T: Into<bool>>(self, v: T) -> Self

Sets the value of enable_structured_logging.

Example

let x = BuildOptions::new().set_enable_structured_logging(true);

Trait Implementations

impl Clone for BuildOptions

fn clone(&self) -> BuildOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BuildOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BuildOptions

fn default() -> BuildOptions

Returns the “default value” for a type.

impl Message for BuildOptions

fn typename() -> &'static str

The typename of this message.

impl PartialEq for BuildOptions

fn eq(&self, other: &BuildOptions) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BuildOptions