Package com.google.cloud.deploy.v1 (1.0.2)

A client to Google Cloud Deploy API

The interfaces provided are listed below, along with usage samples.

CloudDeployClient

Service Description: CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

Sample for CloudDeployClient:


 try (CloudDeployClient cloudDeployClient = CloudDeployClient.create()) {
   DeliveryPipelineName name =
       DeliveryPipelineName.of("[PROJECT]", "[LOCATION]", "[DELIVERY_PIPELINE]");
   DeliveryPipeline response = cloudDeployClient.getDeliveryPipeline(name);
 }
 

Classes

ApproveRolloutRequest

The request object used by ApproveRollout.

Protobuf type google.cloud.deploy.v1.ApproveRolloutRequest

ApproveRolloutRequest.Builder

The request object used by ApproveRollout.

Protobuf type google.cloud.deploy.v1.ApproveRolloutRequest

ApproveRolloutResponse

The response object from ApproveRollout.

Protobuf type google.cloud.deploy.v1.ApproveRolloutResponse

ApproveRolloutResponse.Builder

The response object from ApproveRollout.

Protobuf type google.cloud.deploy.v1.ApproveRolloutResponse

BuildArtifact

Description of an a image to use during Skaffold rendering.

Protobuf type google.cloud.deploy.v1.BuildArtifact

BuildArtifact.Builder

Description of an a image to use during Skaffold rendering.

Protobuf type google.cloud.deploy.v1.BuildArtifact

CloudDeployClient

Service Description: CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

This class provides the ability to make remote calls to the backing service through method calls that map to API methods. Sample code to get started:


 try (CloudDeployClient cloudDeployClient = CloudDeployClient.create()) {
   DeliveryPipelineName name =
       DeliveryPipelineName.of("[PROJECT]", "[LOCATION]", "[DELIVERY_PIPELINE]");
   DeliveryPipeline response = cloudDeployClient.getDeliveryPipeline(name);
 }
 

Note: close() needs to be called on the CloudDeployClient object to clean up resources such as threads. In the example above, try-with-resources is used, which automatically calls close().

The surface of this class includes several types of Java methods for each of the API's methods:

  1. A "flattened" method. With this type of method, the fields of the request type have been converted into function parameters. It may be the case that not all fields are available as parameters, and not every API method will have a flattened method entry point.
  2. A "request object" method. This type of method only takes one parameter, a request object, which must be constructed before the call. Not every API method will have a request object method.
  3. A "callable" method. This type of method takes no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

See the individual methods for example code.

Many parameters require resource names to be formatted in a particular way. To assist with these names, this class includes a format method for each type of name, and additionally a parse method to extract the individual identifiers contained within names that are returned.

This class can be customized by passing in a custom instance of CloudDeploySettings to create(). For example:

To customize credentials:


 CloudDeploySettings cloudDeploySettings =
     CloudDeploySettings.newBuilder()
         .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
         .build();
 CloudDeployClient cloudDeployClient = CloudDeployClient.create(cloudDeploySettings);
 

To customize the endpoint:


 CloudDeploySettings cloudDeploySettings =
     CloudDeploySettings.newBuilder().setEndpoint(myEndpoint).build();
 CloudDeployClient cloudDeployClient = CloudDeployClient.create(cloudDeploySettings);
 

Please refer to the GitHub repository's samples for more quickstart code snippets.

CloudDeployClient.ListDeliveryPipelinesFixedSizeCollection

CloudDeployClient.ListDeliveryPipelinesPage

CloudDeployClient.ListDeliveryPipelinesPagedResponse

CloudDeployClient.ListReleasesFixedSizeCollection

CloudDeployClient.ListReleasesPage

CloudDeployClient.ListReleasesPagedResponse

CloudDeployClient.ListRolloutsFixedSizeCollection

CloudDeployClient.ListRolloutsPage

CloudDeployClient.ListRolloutsPagedResponse

CloudDeployClient.ListTargetsFixedSizeCollection

CloudDeployClient.ListTargetsPage

CloudDeployClient.ListTargetsPagedResponse

CloudDeployGrpc

CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

CloudDeployGrpc.CloudDeployBlockingStub

CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

CloudDeployGrpc.CloudDeployFutureStub

CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

CloudDeployGrpc.CloudDeployImplBase

CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

CloudDeployGrpc.CloudDeployStub

CloudDeploy service creates and manages Continuous Delivery operations on Google Cloud Platform via Skaffold (https://skaffold.dev).

CloudDeployProto

CloudDeploySettings

Settings class to configure an instance of CloudDeployClient.

The default instance has everything set to sensible defaults:

  • The default service address (clouddeploy.googleapis.com) and default port (443) are used.
  • Credentials are acquired automatically through Application Default Credentials.
  • Retries are configured for idempotent methods but not for non-idempotent methods.

The builder of this class is recursive, so contained classes are themselves builders. When build() is called, the tree of builders is called to create the complete settings object.

For example, to set the total timeout of getDeliveryPipeline to 30 seconds:


 CloudDeploySettings.Builder cloudDeploySettingsBuilder = CloudDeploySettings.newBuilder();
 cloudDeploySettingsBuilder
     .getDeliveryPipelineSettings()
     .setRetrySettings(
         cloudDeploySettingsBuilder
             .getDeliveryPipelineSettings()
             .getRetrySettings()
             .toBuilder()
             .setTotalTimeout(Duration.ofSeconds(30))
             .build());
 CloudDeploySettings cloudDeploySettings = cloudDeploySettingsBuilder.build();
 

CloudDeploySettings.Builder

Builder for CloudDeploySettings.

Config

Service-wide configuration.

Protobuf type google.cloud.deploy.v1.Config

Config.Builder

Service-wide configuration.

Protobuf type google.cloud.deploy.v1.Config

ConfigName

ConfigName.Builder

Builder for projects/{project}/locations/{location}/config.

CreateDeliveryPipelineRequest

The request object for CreateDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.CreateDeliveryPipelineRequest

CreateDeliveryPipelineRequest.Builder

The request object for CreateDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.CreateDeliveryPipelineRequest

CreateReleaseRequest

The request object for CreateRelease,

Protobuf type google.cloud.deploy.v1.CreateReleaseRequest

CreateReleaseRequest.Builder

The request object for CreateRelease,

Protobuf type google.cloud.deploy.v1.CreateReleaseRequest

CreateRolloutRequest

CreateRolloutRequest is the request object used by CreateRollout.

Protobuf type google.cloud.deploy.v1.CreateRolloutRequest

CreateRolloutRequest.Builder

CreateRolloutRequest is the request object used by CreateRollout.

Protobuf type google.cloud.deploy.v1.CreateRolloutRequest

CreateTargetRequest

The request object for CreateTarget.

Protobuf type google.cloud.deploy.v1.CreateTargetRequest

CreateTargetRequest.Builder

The request object for CreateTarget.

Protobuf type google.cloud.deploy.v1.CreateTargetRequest

DefaultPool

Execution using the default Cloud Build pool.

Protobuf type google.cloud.deploy.v1.DefaultPool

DefaultPool.Builder

Execution using the default Cloud Build pool.

Protobuf type google.cloud.deploy.v1.DefaultPool

DeleteDeliveryPipelineRequest

The request object for DeleteDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.DeleteDeliveryPipelineRequest

DeleteDeliveryPipelineRequest.Builder

The request object for DeleteDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.DeleteDeliveryPipelineRequest

DeleteTargetRequest

The request object for DeleteTarget.

Protobuf type google.cloud.deploy.v1.DeleteTargetRequest

DeleteTargetRequest.Builder

The request object for DeleteTarget.

Protobuf type google.cloud.deploy.v1.DeleteTargetRequest

DeliveryPipeline

A DeliveryPipeline resource in the Google Cloud Deploy API. A DeliveryPipeline defines a pipeline through which a Skaffold configuration can progress.

Protobuf type google.cloud.deploy.v1.DeliveryPipeline

DeliveryPipeline.Builder

A DeliveryPipeline resource in the Google Cloud Deploy API. A DeliveryPipeline defines a pipeline through which a Skaffold configuration can progress.

Protobuf type google.cloud.deploy.v1.DeliveryPipeline

DeliveryPipelineName

DeliveryPipelineName.Builder

Builder for projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}.

ExecutionConfig

Configuration of the environment to use when calling Skaffold.

Protobuf type google.cloud.deploy.v1.ExecutionConfig

ExecutionConfig.Builder

Configuration of the environment to use when calling Skaffold.

Protobuf type google.cloud.deploy.v1.ExecutionConfig

GetConfigRequest

Request to get a configuration.

Protobuf type google.cloud.deploy.v1.GetConfigRequest

GetConfigRequest.Builder

Request to get a configuration.

Protobuf type google.cloud.deploy.v1.GetConfigRequest

GetDeliveryPipelineRequest

The request object for GetDeliveryPipeline

Protobuf type google.cloud.deploy.v1.GetDeliveryPipelineRequest

GetDeliveryPipelineRequest.Builder

The request object for GetDeliveryPipeline

Protobuf type google.cloud.deploy.v1.GetDeliveryPipelineRequest

GetReleaseRequest

The request object for GetRelease.

Protobuf type google.cloud.deploy.v1.GetReleaseRequest

GetReleaseRequest.Builder

The request object for GetRelease.

Protobuf type google.cloud.deploy.v1.GetReleaseRequest

GetRolloutRequest

GetRolloutRequest is the request object used by GetRollout.

Protobuf type google.cloud.deploy.v1.GetRolloutRequest

GetRolloutRequest.Builder

GetRolloutRequest is the request object used by GetRollout.

Protobuf type google.cloud.deploy.v1.GetRolloutRequest

GetTargetRequest

The request object for GetTarget.

Protobuf type google.cloud.deploy.v1.GetTargetRequest

GetTargetRequest.Builder

The request object for GetTarget.

Protobuf type google.cloud.deploy.v1.GetTargetRequest

GkeCluster

Information specifying a GKE Cluster.

Protobuf type google.cloud.deploy.v1.GkeCluster

GkeCluster.Builder

Information specifying a GKE Cluster.

Protobuf type google.cloud.deploy.v1.GkeCluster

ListDeliveryPipelinesRequest

The request object for ListDeliveryPipelines.

Protobuf type google.cloud.deploy.v1.ListDeliveryPipelinesRequest

ListDeliveryPipelinesRequest.Builder

The request object for ListDeliveryPipelines.

Protobuf type google.cloud.deploy.v1.ListDeliveryPipelinesRequest

ListDeliveryPipelinesResponse

The response object from ListDeliveryPipelines.

Protobuf type google.cloud.deploy.v1.ListDeliveryPipelinesResponse

ListDeliveryPipelinesResponse.Builder

The response object from ListDeliveryPipelines.

Protobuf type google.cloud.deploy.v1.ListDeliveryPipelinesResponse

ListReleasesRequest

The request object for ListReleases.

Protobuf type google.cloud.deploy.v1.ListReleasesRequest

ListReleasesRequest.Builder

The request object for ListReleases.

Protobuf type google.cloud.deploy.v1.ListReleasesRequest

ListReleasesResponse

The response object from ListReleases.

Protobuf type google.cloud.deploy.v1.ListReleasesResponse

ListReleasesResponse.Builder

The response object from ListReleases.

Protobuf type google.cloud.deploy.v1.ListReleasesResponse

ListRolloutsRequest

ListRolloutsRequest is the request object used by ListRollouts.

Protobuf type google.cloud.deploy.v1.ListRolloutsRequest

ListRolloutsRequest.Builder

ListRolloutsRequest is the request object used by ListRollouts.

Protobuf type google.cloud.deploy.v1.ListRolloutsRequest

ListRolloutsResponse

ListRolloutsResponse is the response object reutrned by ListRollouts.

Protobuf type google.cloud.deploy.v1.ListRolloutsResponse

ListRolloutsResponse.Builder

ListRolloutsResponse is the response object reutrned by ListRollouts.

Protobuf type google.cloud.deploy.v1.ListRolloutsResponse

ListTargetsRequest

The request object for ListTargets.

Protobuf type google.cloud.deploy.v1.ListTargetsRequest

ListTargetsRequest.Builder

The request object for ListTargets.

Protobuf type google.cloud.deploy.v1.ListTargetsRequest

ListTargetsResponse

The response object from ListTargets.

Protobuf type google.cloud.deploy.v1.ListTargetsResponse

ListTargetsResponse.Builder

The response object from ListTargets.

Protobuf type google.cloud.deploy.v1.ListTargetsResponse

LocationName

LocationName.Builder

Builder for projects/{project}/locations/{location}.

OperationMetadata

Represents the metadata of the long-running operation.

Protobuf type google.cloud.deploy.v1.OperationMetadata

OperationMetadata.Builder

Represents the metadata of the long-running operation.

Protobuf type google.cloud.deploy.v1.OperationMetadata

PipelineCondition

PipelineCondition contains all conditions relevant to a Delivery Pipeline.

Protobuf type google.cloud.deploy.v1.PipelineCondition

PipelineCondition.Builder

PipelineCondition contains all conditions relevant to a Delivery Pipeline.

Protobuf type google.cloud.deploy.v1.PipelineCondition

PipelineReadyCondition

PipelineReadyCondition contains information around the status of the Pipeline.

Protobuf type google.cloud.deploy.v1.PipelineReadyCondition

PipelineReadyCondition.Builder

PipelineReadyCondition contains information around the status of the Pipeline.

Protobuf type google.cloud.deploy.v1.PipelineReadyCondition

PrivatePool

Execution using a private Cloud Build pool.

Protobuf type google.cloud.deploy.v1.PrivatePool

PrivatePool.Builder

Execution using a private Cloud Build pool.

Protobuf type google.cloud.deploy.v1.PrivatePool

Release

A Release resource in the Google Cloud Deploy API. A Release defines a specific Skaffold configuration instance that can be deployed.

Protobuf type google.cloud.deploy.v1.Release

Release.Builder

A Release resource in the Google Cloud Deploy API. A Release defines a specific Skaffold configuration instance that can be deployed.

Protobuf type google.cloud.deploy.v1.Release

Release.TargetRender

Details of rendering for a single target.

Protobuf type google.cloud.deploy.v1.Release.TargetRender

Release.TargetRender.Builder

Details of rendering for a single target.

Protobuf type google.cloud.deploy.v1.Release.TargetRender

ReleaseName

ReleaseName.Builder

Builder for projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/releases/{release}.

Rollout

A Rollout resource in the Google Cloud Deploy API. A Rollout contains information around a specific deployment to a Target.

Protobuf type google.cloud.deploy.v1.Rollout

Rollout.Builder

A Rollout resource in the Google Cloud Deploy API. A Rollout contains information around a specific deployment to a Target.

Protobuf type google.cloud.deploy.v1.Rollout

RolloutName

RolloutName.Builder

Builder for projects/{project}/locations/{location}/deliveryPipelines/{delivery_pipeline}/releases/{release}/rollouts/{rollout}.

SerialPipeline

SerialPipeline defines a sequential set of stages for a DeliveryPipeline.

Protobuf type google.cloud.deploy.v1.SerialPipeline

SerialPipeline.Builder

SerialPipeline defines a sequential set of stages for a DeliveryPipeline.

Protobuf type google.cloud.deploy.v1.SerialPipeline

SkaffoldVersion

Details of a supported Skaffold version.

Protobuf type google.cloud.deploy.v1.SkaffoldVersion

SkaffoldVersion.Builder

Details of a supported Skaffold version.

Protobuf type google.cloud.deploy.v1.SkaffoldVersion

Stage

Stage specifies a location to which to deploy.

Protobuf type google.cloud.deploy.v1.Stage

Stage.Builder

Stage specifies a location to which to deploy.

Protobuf type google.cloud.deploy.v1.Stage

Target

A Target resource in the Google Cloud Deploy API. A Target defines a location to which a Skaffold configuration can be deployed.

Protobuf type google.cloud.deploy.v1.Target

Target.Builder

A Target resource in the Google Cloud Deploy API. A Target defines a location to which a Skaffold configuration can be deployed.

Protobuf type google.cloud.deploy.v1.Target

TargetArtifact

The artifacts produced by a target render operation.

Protobuf type google.cloud.deploy.v1.TargetArtifact

TargetArtifact.Builder

The artifacts produced by a target render operation.

Protobuf type google.cloud.deploy.v1.TargetArtifact

TargetName

TargetName.Builder

Builder for projects/{project}/locations/{location}/targets/{target}.

TargetsPresentCondition

TargetsPresentCondition contains information on any Targets defined in the Delivery Pipeline that do not actually exist.

Protobuf type google.cloud.deploy.v1.TargetsPresentCondition

TargetsPresentCondition.Builder

TargetsPresentCondition contains information on any Targets defined in the Delivery Pipeline that do not actually exist.

Protobuf type google.cloud.deploy.v1.TargetsPresentCondition

UpdateDeliveryPipelineRequest

The request object for UpdateDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.UpdateDeliveryPipelineRequest

UpdateDeliveryPipelineRequest.Builder

The request object for UpdateDeliveryPipeline.

Protobuf type google.cloud.deploy.v1.UpdateDeliveryPipelineRequest

UpdateTargetRequest

The request object for UpdateTarget.

Protobuf type google.cloud.deploy.v1.UpdateTargetRequest

UpdateTargetRequest.Builder

The request object for UpdateTarget.

Protobuf type google.cloud.deploy.v1.UpdateTargetRequest

Interfaces

ApproveRolloutRequestOrBuilder

ApproveRolloutResponseOrBuilder

BuildArtifactOrBuilder

ConfigOrBuilder

CreateDeliveryPipelineRequestOrBuilder

CreateReleaseRequestOrBuilder

CreateRolloutRequestOrBuilder

CreateTargetRequestOrBuilder

DefaultPoolOrBuilder

DeleteDeliveryPipelineRequestOrBuilder

DeleteTargetRequestOrBuilder

DeliveryPipelineOrBuilder

ExecutionConfigOrBuilder

GetConfigRequestOrBuilder

GetDeliveryPipelineRequestOrBuilder

GetReleaseRequestOrBuilder

GetRolloutRequestOrBuilder

GetTargetRequestOrBuilder

GkeClusterOrBuilder

ListDeliveryPipelinesRequestOrBuilder

ListDeliveryPipelinesResponseOrBuilder

ListReleasesRequestOrBuilder

ListReleasesResponseOrBuilder

ListRolloutsRequestOrBuilder

ListRolloutsResponseOrBuilder

ListTargetsRequestOrBuilder

ListTargetsResponseOrBuilder

OperationMetadataOrBuilder

PipelineConditionOrBuilder

PipelineReadyConditionOrBuilder

PrivatePoolOrBuilder

Release.TargetRenderOrBuilder

ReleaseOrBuilder

RolloutOrBuilder

SerialPipelineOrBuilder

SkaffoldVersionOrBuilder

StageOrBuilder

TargetArtifactOrBuilder

TargetOrBuilder

TargetsPresentConditionOrBuilder

UpdateDeliveryPipelineRequestOrBuilder

UpdateTargetRequestOrBuilder

Enums

DeliveryPipeline.PipelineCase

ExecutionConfig.ExecutionEnvironmentCase

ExecutionConfig.ExecutionEnvironmentUsage

Possible usages of this configuration.

Protobuf enum google.cloud.deploy.v1.ExecutionConfig.ExecutionEnvironmentUsage

Release.RenderState

Valid states of the render operation.

Protobuf enum google.cloud.deploy.v1.Release.RenderState

Release.TargetRender.TargetRenderState

Valid states of the render operation.

Protobuf enum google.cloud.deploy.v1.Release.TargetRender.TargetRenderState

Rollout.ApprovalState

Valid approval states of a Rollout.

Protobuf enum google.cloud.deploy.v1.Rollout.ApprovalState

Rollout.State

Valid states of a Rollout.

Protobuf enum google.cloud.deploy.v1.Rollout.State

Target.DeploymentTargetCase

TargetArtifact.UriCase