google-cloud-build-v1 0.15.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
81
83
  # long-running operation pattern.
82
84
  # @!attribute [rw] new_issue_uri
83
85
  # @return [::String]
84
- # Link to a place that API users can report issues. Example:
86
+ # Link to a *public* URI where users can report issues. Example:
85
87
  # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
88
  # @!attribute [rw] documentation_uri
87
89
  # @return [::String]
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
203
209
  # @!attribute [rw] common
204
210
  # @return [::Google::Api::CommonLanguageSettings]
205
211
  # Some settings.
212
+ # @!attribute [rw] renamed_services
213
+ # @return [::Google::Protobuf::Map{::String => ::String}]
214
+ # Map from original service names to renamed versions.
215
+ # This is used when the default generated types
216
+ # would cause a naming conflict. (Neither name is
217
+ # fully-qualified.)
218
+ # Example: Subscriber to SubscriberServiceApi.
219
+ # @!attribute [rw] renamed_resources
220
+ # @return [::Google::Protobuf::Map{::String => ::String}]
221
+ # Map from full resource types to the effective short name
222
+ # for the resource. This is used when otherwise resource
223
+ # named from different services would cause naming collisions.
224
+ # Example entry:
225
+ # "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
226
+ # @!attribute [rw] ignored_resources
227
+ # @return [::Array<::String>]
228
+ # List of full resource types to ignore during generation.
229
+ # This is typically used for API-specific Location resources,
230
+ # which should be handled by the generator as if they were actually
231
+ # the common Location resources.
232
+ # Example entry: "documentai.googleapis.com/Location"
233
+ # @!attribute [rw] forced_namespace_aliases
234
+ # @return [::Array<::String>]
235
+ # Namespaces which must be aliased in snippets due to
236
+ # a known (but non-generator-predictable) naming collision
237
+ # @!attribute [rw] handwritten_signatures
238
+ # @return [::Array<::String>]
239
+ # Method signatures (in the form "service.method(signature)")
240
+ # which are provided separately, so shouldn't be generated.
241
+ # Snippets *calling* these methods are still generated, however.
206
242
  class DotnetSettings
207
243
  include ::Google::Protobuf::MessageExts
208
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
245
+
246
+ # @!attribute [rw] key
247
+ # @return [::String]
248
+ # @!attribute [rw] value
249
+ # @return [::String]
250
+ class RenamedServicesEntry
251
+ include ::Google::Protobuf::MessageExts
252
+ extend ::Google::Protobuf::MessageExts::ClassMethods
253
+ end
254
+
255
+ # @!attribute [rw] key
256
+ # @return [::String]
257
+ # @!attribute [rw] value
258
+ # @return [::String]
259
+ class RenamedResourcesEntry
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
209
263
  end
210
264
 
211
265
  # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
240
294
  # Example of a YAML configuration::
241
295
  #
242
296
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
297
+ # method_settings:
298
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
299
  # long_running:
246
300
  # initial_poll_delay:
247
301
  # seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
299
353
 
300
354
  # Street View Org.
301
355
  STREET_VIEW = 4
356
+
357
+ # Shopping Org.
358
+ SHOPPING = 5
359
+
360
+ # Geo Org.
361
+ GEO = 6
362
+
363
+ # Generative AI - https://developers.generativeai.google
364
+ GENERATIVE_AI = 7
302
365
  end
303
366
 
304
367
  # To where should client libraries be published?
@@ -77,6 +77,35 @@ module Google
77
77
  extend ::Google::Protobuf::MessageExts::ClassMethods
78
78
  end
79
79
 
80
+ # Location of the source in any accessible Git repository.
81
+ # @!attribute [rw] url
82
+ # @return [::String]
83
+ # Location of the Git repo to build.
84
+ #
85
+ # This will be used as a `git remote`, see
86
+ # https://git-scm.com/docs/git-remote.
87
+ # @!attribute [rw] dir
88
+ # @return [::String]
89
+ # Directory, relative to the source root, in which to run the build.
90
+ #
91
+ # This must be a relative path. If a step's `dir` is specified and is an
92
+ # absolute path, this value is ignored for that step's execution.
93
+ # @!attribute [rw] revision
94
+ # @return [::String]
95
+ # The revision to fetch from the Git repository such as a branch, a tag, a
96
+ # commit SHA, or any Git ref.
97
+ #
98
+ # Cloud Build uses `git fetch` to fetch the revision from the Git
99
+ # repository; therefore make sure that the string you provide for `revision`
100
+ # is parsable by the command. For information on string values accepted by
101
+ # `git fetch`, see
102
+ # https://git-scm.com/docs/gitrevisions#_specifying_revisions. For
103
+ # information on `git fetch`, see https://git-scm.com/docs/git-fetch.
104
+ class GitSource
105
+ include ::Google::Protobuf::MessageExts
106
+ extend ::Google::Protobuf::MessageExts::ClassMethods
107
+ end
108
+
80
109
  # Location of the source in a Google Cloud Source Repository.
81
110
  # @!attribute [rw] project_id
82
111
  # @return [::String]
@@ -158,6 +187,9 @@ module Google
158
187
  # @return [::Google::Cloud::Build::V1::RepoSource]
159
188
  # If provided, get the source from this location in a Cloud Source
160
189
  # Repository.
190
+ # @!attribute [rw] git_source
191
+ # @return [::Google::Cloud::Build::V1::GitSource]
192
+ # If provided, get the source from this Git repository.
161
193
  # @!attribute [rw] storage_source_manifest
162
194
  # @return [::Google::Cloud::Build::V1::StorageSourceManifest]
163
195
  # If provided, get the source from this manifest in Google Cloud Storage.
@@ -214,6 +246,22 @@ module Google
214
246
  extend ::Google::Protobuf::MessageExts::ClassMethods
215
247
  end
216
248
 
249
+ # An npm package uploaded to Artifact Registry using the NpmPackage
250
+ # directive.
251
+ # @!attribute [rw] uri
252
+ # @return [::String]
253
+ # URI of the uploaded npm package.
254
+ # @!attribute [rw] file_hashes
255
+ # @return [::Google::Cloud::Build::V1::FileHashes]
256
+ # Hash types and values of the npm package.
257
+ # @!attribute [r] push_timing
258
+ # @return [::Google::Cloud::Build::V1::TimeSpan]
259
+ # Output only. Stores timing information for pushing the specified artifact.
260
+ class UploadedNpmPackage
261
+ include ::Google::Protobuf::MessageExts
262
+ extend ::Google::Protobuf::MessageExts::ClassMethods
263
+ end
264
+
217
265
  # A step in the build pipeline.
218
266
  # @!attribute [rw] name
219
267
  # @return [::String]
@@ -361,10 +409,12 @@ module Google
361
409
  # indices.
362
410
  # @!attribute [rw] artifact_manifest
363
411
  # @return [::String]
364
- # Path to the artifact manifest. Only populated when artifacts are uploaded.
412
+ # Path to the artifact manifest for non-container artifacts uploaded to Cloud
413
+ # Storage. Only populated when artifacts are uploaded to Cloud Storage.
365
414
  # @!attribute [rw] num_artifacts
366
415
  # @return [::Integer]
367
- # Number of artifacts uploaded. Only populated when artifacts are uploaded.
416
+ # Number of non-container artifacts uploaded to Cloud Storage. Only populated
417
+ # when artifacts are uploaded to Cloud Storage.
368
418
  # @!attribute [rw] build_step_outputs
369
419
  # @return [::Array<::String>]
370
420
  # List of build step outputs, produced by builder images, in the order
@@ -375,13 +425,16 @@ module Google
375
425
  # Only the first 4KB of data is stored.
376
426
  # @!attribute [rw] artifact_timing
377
427
  # @return [::Google::Cloud::Build::V1::TimeSpan]
378
- # Time to push all non-container artifacts.
428
+ # Time to push all non-container artifacts to Cloud Storage.
379
429
  # @!attribute [rw] python_packages
380
430
  # @return [::Array<::Google::Cloud::Build::V1::UploadedPythonPackage>]
381
431
  # Python artifacts uploaded to Artifact Registry at the end of the build.
382
432
  # @!attribute [rw] maven_artifacts
383
433
  # @return [::Array<::Google::Cloud::Build::V1::UploadedMavenArtifact>]
384
434
  # Maven artifacts uploaded to Artifact Registry at the end of the build.
435
+ # @!attribute [rw] npm_packages
436
+ # @return [::Array<::Google::Cloud::Build::V1::UploadedNpmPackage>]
437
+ # Npm packages uploaded to Artifact Registry at the end of the build.
385
438
  class Results
386
439
  include ::Google::Protobuf::MessageExts
387
440
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -413,6 +466,7 @@ module Google
413
466
  #
414
467
  # - $PROJECT_ID: the project ID of the build.
415
468
  # - $PROJECT_NUMBER: the project number of the build.
469
+ # - $LOCATION: the location/region of the build.
416
470
  # - $BUILD_ID: the autogenerated ID of the build.
417
471
  # - $REPO_NAME: the source repository name specified by RepoSource.
418
472
  # - $BRANCH_NAME: the branch name specified by RepoSource.
@@ -466,7 +520,7 @@ module Google
466
520
  #
467
521
  # `timeout` starts ticking from `startTime`.
468
522
  #
469
- # Default time is ten minutes.
523
+ # Default time is 60 minutes.
470
524
  # @!attribute [rw] images
471
525
  # @return [::Array<::String>]
472
526
  # A list of images to be pushed upon the successful completion of all build
@@ -528,7 +582,8 @@ module Google
528
582
  # are:
529
583
  #
530
584
  # * BUILD: time to execute all build steps.
531
- # * PUSH: time to push all specified images.
585
+ # * PUSH: time to push all artifacts including docker images and non docker
586
+ # artifacts.
532
587
  # * FETCHSOURCE: time to fetch source.
533
588
  # * SETUPBUILD: time to set up build.
534
589
  #
@@ -718,6 +773,16 @@ module Google
718
773
  # The build service account credentials will be used to perform the upload.
719
774
  #
720
775
  # If any objects fail to be pushed, the build is marked FAILURE.
776
+ # @!attribute [rw] npm_packages
777
+ # @return [::Array<::Google::Cloud::Build::V1::Artifacts::NpmPackage>]
778
+ # A list of npm packages to be uploaded to Artifact Registry upon
779
+ # successful completion of all build steps.
780
+ #
781
+ # Npm packages in the specified paths will be uploaded
782
+ # to the specified Artifact Registry repository using the builder service
783
+ # account's credentials.
784
+ #
785
+ # If any packages fail to be pushed, the build is marked FAILURE.
721
786
  class Artifacts
722
787
  include ::Google::Protobuf::MessageExts
723
788
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -796,6 +861,24 @@ module Google
796
861
  include ::Google::Protobuf::MessageExts
797
862
  extend ::Google::Protobuf::MessageExts::ClassMethods
798
863
  end
864
+
865
+ # Npm package to upload to Artifact Registry upon successful completion
866
+ # of all build steps.
867
+ # @!attribute [rw] repository
868
+ # @return [::String]
869
+ # Artifact Registry repository, in the form
870
+ # "https://$REGION-npm.pkg.dev/$PROJECT/$REPOSITORY"
871
+ #
872
+ # Npm package in the workspace specified by path will be zipped and
873
+ # uploaded to Artifact Registry with this location as a prefix.
874
+ # @!attribute [rw] package_path
875
+ # @return [::String]
876
+ # Path to the package.json.
877
+ # e.g. workspace/path/to/package
878
+ class NpmPackage
879
+ include ::Google::Protobuf::MessageExts
880
+ extend ::Google::Protobuf::MessageExts::ClassMethods
881
+ end
799
882
  end
800
883
 
801
884
  # Start and end times for a build execution phase.
@@ -891,6 +974,9 @@ module Google
891
974
 
892
975
  # Use a md5 hash.
893
976
  MD5 = 2
977
+
978
+ # Use a sha512 hash.
979
+ SHA512 = 4
894
980
  end
895
981
  end
896
982
 
@@ -1016,7 +1102,7 @@ module Google
1016
1102
  # @!attribute [rw] parent
1017
1103
  # @return [::String]
1018
1104
  # The parent of the collection of `Builds`.
1019
- # Format: `projects/{project}/locations/location`
1105
+ # Format: `projects/{project}/locations/{location}`
1020
1106
  # @!attribute [rw] project_id
1021
1107
  # @return [::String]
1022
1108
  # Required. ID of the project.
@@ -1549,7 +1635,7 @@ module Google
1549
1635
  # "disk free"; some of the space will be used by the operating system and
1550
1636
  # build utilities. Also note that this is the minimum disk size that will be
1551
1637
  # allocated for the build -- the build may run with a larger disk than
1552
- # requested. At present, the maximum disk size is 1000GB; builds that request
1638
+ # requested. At present, the maximum disk size is 2000GB; builds that request
1553
1639
  # more than the maximum are rejected with an error.
1554
1640
  # @!attribute [rw] substitution_option
1555
1641
  # @return [::Google::Cloud::Build::V1::BuildOptions::SubstitutionOption]
@@ -1610,7 +1696,7 @@ module Google
1610
1696
  # it is indicative of a build request with an incorrect configuration.
1611
1697
  # @!attribute [rw] default_logs_bucket_behavior
1612
1698
  # @return [::Google::Cloud::Build::V1::BuildOptions::DefaultLogsBucketBehavior]
1613
- # Option to specify how default logs buckets are setup.
1699
+ # Optional. Option to specify how default logs buckets are setup.
1614
1700
  class BuildOptions
1615
1701
  include ::Google::Protobuf::MessageExts
1616
1702
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1634,10 +1720,10 @@ module Google
1634
1720
 
1635
1721
  # Specifies the manner in which the build should be verified, if at all.
1636
1722
  module VerifyOption
1637
- # Not a verifiable build. (default)
1723
+ # Not a verifiable build (the default).
1638
1724
  NOT_VERIFIED = 0
1639
1725
 
1640
- # Verified build.
1726
+ # Build must be verified.
1641
1727
  VERIFIED = 1
1642
1728
  end
1643
1729
 
@@ -1690,18 +1776,18 @@ module Google
1690
1776
  # rely on the default logging behavior as it may change in the future.
1691
1777
  LOGGING_UNSPECIFIED = 0
1692
1778
 
1693
- # Cloud Logging and Cloud Storage logging are enabled.
1779
+ # Build logs are stored in Cloud Logging and Cloud Storage.
1694
1780
  LEGACY = 1
1695
1781
 
1696
- # Only Cloud Storage logging is enabled.
1782
+ # Build logs are stored in Cloud Storage.
1697
1783
  GCS_ONLY = 2
1698
1784
 
1699
1785
  # This option is the same as CLOUD_LOGGING_ONLY.
1700
1786
  STACKDRIVER_ONLY = 3
1701
1787
 
1702
- # Only Cloud Logging is enabled. Note that logs for both the Cloud Console
1703
- # UI and Cloud SDK are based on Cloud Storage logs, so neither will provide
1704
- # logs if this option is chosen.
1788
+ # Build logs are stored in Cloud Logging. Selecting this option will not
1789
+ # allow [logs
1790
+ # streaming](https://cloud.google.com/sdk/gcloud/reference/builds/log).
1705
1791
  CLOUD_LOGGING_ONLY = 5
1706
1792
 
1707
1793
  # Turn off all logging. No build logs will be captured.
@@ -1798,7 +1884,7 @@ module Google
1798
1884
  # Output only. `WorkerPool` state.
1799
1885
  # @!attribute [rw] private_pool_v1_config
1800
1886
  # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config]
1801
- # Private Pool using a v1 configuration.
1887
+ # Legacy Private Pool configuration.
1802
1888
  # @!attribute [r] etag
1803
1889
  # @return [::String]
1804
1890
  # Output only. Checksum computed by the server. May be sent on update and
@@ -1860,7 +1946,7 @@ module Google
1860
1946
  # Size of the disk attached to the worker, in GB.
1861
1947
  # See [Worker pool config
1862
1948
  # file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema).
1863
- # Specify a value of up to 1000. If `0` is specified, Cloud Build will use
1949
+ # Specify a value of up to 2000. If `0` is specified, Cloud Build will use
1864
1950
  # a standard disk size.
1865
1951
  class WorkerConfig
1866
1952
  include ::Google::Protobuf::MessageExts
@@ -1881,6 +1967,16 @@ module Google
1881
1967
  # @!attribute [rw] egress_option
1882
1968
  # @return [::Google::Cloud::Build::V1::PrivatePoolV1Config::NetworkConfig::EgressOption]
1883
1969
  # Option to configure network egress for the workers.
1970
+ # @!attribute [rw] peered_network_ip_range
1971
+ # @return [::String]
1972
+ # Immutable. Subnet IP range within the peered network. This is specified
1973
+ # in CIDR notation with a slash and the subnet prefix size. You can
1974
+ # optionally specify an IP address before the subnet prefix value. e.g.
1975
+ # `192.168.0.0/29` would specify an IP range starting at 192.168.0.0 with a
1976
+ # prefix size of 29 bits.
1977
+ # `/16` would specify a prefix size of 16 bits, with an automatically
1978
+ # determined IP within the peered VPC.
1979
+ # If unspecified, a value of `/24` will be used.
1884
1980
  class NetworkConfig
1885
1981
  include ::Google::Protobuf::MessageExts
1886
1982
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1940,7 +2036,7 @@ module Google
1940
2036
  # @return [::String]
1941
2037
  # Required. The name of the `WorkerPool` to delete.
1942
2038
  # Format:
1943
- # `projects/{project}/locations/{workerPool}/workerPools/{workerPool}`.
2039
+ # `projects/{project}/locations/{location}/workerPools/{workerPool}`.
1944
2040
  # @!attribute [rw] etag
1945
2041
  # @return [::String]
1946
2042
  # Optional. If this is provided, it must match the server's etag on the
@@ -43,8 +43,12 @@ module Google
43
43
  # if (any.is(Foo.class)) {
44
44
  # foo = any.unpack(Foo.class);
45
45
  # }
46
+ # // or ...
47
+ # if (any.isSameTypeAs(Foo.getDefaultInstance())) {
48
+ # foo = any.unpack(Foo.getDefaultInstance());
49
+ # }
46
50
  #
47
- # Example 3: Pack and unpack a message in Python.
51
+ # Example 3: Pack and unpack a message in Python.
48
52
  #
49
53
  # foo = Foo(...)
50
54
  # any = Any()
@@ -54,7 +58,7 @@ module Google
54
58
  # any.Unpack(foo)
55
59
  # ...
56
60
  #
57
- # Example 4: Pack and unpack a message in Go
61
+ # Example 4: Pack and unpack a message in Go
58
62
  #
59
63
  # foo := &pb.Foo{...}
60
64
  # any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
73
77
  # in the type URL, for example "foo.bar.com/x/y.z" will yield type
74
78
  # name "y.z".
75
79
  #
76
- #
77
80
  # JSON
78
- #
81
+ # ====
79
82
  # The JSON representation of an `Any` value uses the regular
80
83
  # representation of the deserialized, embedded message, with an
81
84
  # additional field `@type` which contains the type URL. Example:
@@ -69,7 +69,6 @@ module Google
69
69
  # Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
70
70
  # .setNanos((int) ((millis % 1000) * 1000000)).build();
71
71
  #
72
- #
73
72
  # Example 5: Compute Timestamp from Java `Instant.now()`.
74
73
  #
75
74
  # Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
78
77
  # Timestamp.newBuilder().setSeconds(now.getEpochSecond())
79
78
  # .setNanos(now.getNano()).build();
80
79
  #
81
- #
82
80
  # Example 6: Compute Timestamp from current time in Python.
83
81
  #
84
82
  # timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
108
106
  # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
109
107
  # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
110
108
  # the Joda Time's [`ISODateTimeFormat.dateTime()`](
111
- # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
109
+ # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
112
110
  # ) to obtain a formatter capable of generating timestamps in this format.
113
111
  # @!attribute [rw] seconds
114
112
  # @return [::Integer]
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-build-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.15.0
4
+ version: 0.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-03-16 00:00:00.000000000 Z
11
+ date: 2023-06-06 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.18.0
19
+ version: 0.19.1
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.18.0
29
+ version: 0.19.1
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a