@pulumi/gcp
Version:
A Pulumi package for creating and managing Google Cloud Platform resources.
424 lines • 19.2 kB
TypeScript
import * as pulumi from "@pulumi/pulumi";
import * as inputs from "../types/input";
import * as outputs from "../types/output";
/**
* A version to be propagated and deployed to Units. It points to a specific version of a Blueprint that can be applied to Units, for example, via a Rollout.
*
* > **Warning:** This resource is in beta, and should be used with the terraform-provider-google-beta provider.
* See Provider Versions for more details on beta resources.
*
* ## Example Usage
*
* ### Saas Runtime Release Basic
*
* ```typescript
* import * as pulumi from "@pulumi/pulumi";
* import * as gcp from "@pulumi/gcp";
*
* const exampleSaas = new gcp.saasruntime.SaaS("example_saas", {
* saasId: "example-saas",
* location: "global",
* locations: [{
* name: "us-central1",
* }],
* });
* const exampleUnitkind = new gcp.saasruntime.UnitKind("example_unitkind", {
* location: "global",
* unitKindId: "example-unitkind",
* saas: exampleSaas.id,
* });
* const examplePrevious = new gcp.saasruntime.Release("example_previous", {
* location: "global",
* releaseId: "previous-release",
* unitKind: exampleUnitkind.id,
* blueprint: {
* "package": "us-central1-docker.pkg.dev/ci-test-project-188019/test-repo/tf-test-easysaas-alpha-image@sha256:7992fdbaeaf998ecd31a7f937bb26e38a781ecf49b24857a6176c1e9bfc299ee",
* },
* });
* const example = new gcp.saasruntime.Release("example", {
* location: "global",
* releaseId: "example-release",
* unitKind: exampleUnitkind.id,
* blueprint: {
* "package": "us-central1-docker.pkg.dev/ci-test-project-188019/test-repo/tf-test-easysaas-beta-image@sha256:7bba0fa85b2956df7768f7b32e715b6fe11f4f4193e2a70a35bf3f286a6cdf9e",
* },
* inputVariableDefaults: [{
* variable: "name",
* value: "test",
* type: "STRING",
* }],
* });
* ```
*
* ## Import
*
* Release can be imported using any of these accepted formats:
*
* * `projects/{{project}}/locations/{{location}}/releases/{{release_id}}`
* * `{{project}}/{{location}}/{{release_id}}`
* * `{{location}}/{{release_id}}`
*
* When using the `pulumi import` command, Release can be imported using one of the formats above. For example:
*
* ```sh
* $ pulumi import gcp:saasruntime/release:Release default projects/{{project}}/locations/{{location}}/releases/{{release_id}}
* $ pulumi import gcp:saasruntime/release:Release default {{project}}/{{location}}/{{release_id}}
* $ pulumi import gcp:saasruntime/release:Release default {{location}}/{{release_id}}
* ```
*/
export declare class Release extends pulumi.CustomResource {
/**
* Get an existing Release resource's state with the given name, ID, and optional extra
* properties used to qualify the lookup.
*
* @param name The _unique_ name of the resulting resource.
* @param id The _unique_ provider ID of the resource to lookup.
* @param state Any extra arguments used during the lookup.
* @param opts Optional settings to control the behavior of the CustomResource.
*/
static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ReleaseState, opts?: pulumi.CustomResourceOptions): Release;
/**
* Returns true if the given object is an instance of Release. This is designed to work even
* when multiple copies of the Pulumi SDK have been loaded into the same process.
*/
static isInstance(obj: any): obj is Release;
/**
* Annotations is an unstructured key-value map stored with a resource that
* may be set by external tools to store and retrieve arbitrary metadata.
* They are not queryable and should be preserved when modifying objects.
* More info: https://kubernetes.io/docs/user-guide/annotations
* **Note**: This field is non-authoritative, and will only manage the annotations present in your configuration.
* Please refer to the field `effectiveAnnotations` for all of the annotations present on the resource.
*/
readonly annotations: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* Blueprints are OCI Images that contain all of the artifacts needed to
* provision a unit. Metadata such as, type of the engine used to actuate the
* blueprint (e.g. terraform, helm etc) and version will come from the image
* manifest. If the hostname is omitted, it will be assumed to be the regional
* path to Artifact Registry (eg. us-east1-docker.pkg.dev).
* Structure is documented below.
*/
readonly blueprint: pulumi.Output<outputs.saasruntime.ReleaseBlueprint | undefined>;
/**
* The timestamp when the resource was created.
*/
readonly createTime: pulumi.Output<string>;
/**
* Whether Terraform will be prevented from destroying the resource. Defaults to DELETE.
* When a 'terraform destroy' or 'pulumi up' would delete the resource,
* the command will fail if this field is set to "PREVENT" in Terraform state.
* When set to "ABANDON", the command will remove the resource from Terraform
* management without updating or deleting the resource in the API.
* When set to "DELETE", deleting the resource is allowed.
*/
readonly deletionPolicy: pulumi.Output<string>;
/**
* All of annotations (key/value pairs) present on the resource in GCP, including the annotations configured through Terraform, other clients and services.
*/
readonly effectiveAnnotations: pulumi.Output<{
[key: string]: string;
}>;
/**
* All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
*/
readonly effectiveLabels: pulumi.Output<{
[key: string]: string;
}>;
/**
* An opaque value that uniquely identifies a version or
* generation of a resource. It can be used to confirm that the client
* and server agree on the ordering of a resource being written.
*/
readonly etag: pulumi.Output<string>;
/**
* Mapping of input variables to default values. Maximum 100
* Structure is documented below.
*/
readonly inputVariableDefaults: pulumi.Output<outputs.saasruntime.ReleaseInputVariableDefault[] | undefined>;
/**
* List of input variables declared on the blueprint and can be present with
* their values on the unit spec
* Structure is documented below.
*/
readonly inputVariables: pulumi.Output<outputs.saasruntime.ReleaseInputVariable[]>;
/**
* The labels on the resource, which can be used for categorization.
* similar to Kubernetes resource labels.
* **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
* Please refer to the field `effectiveLabels` for all of the labels present on the resource.
*/
readonly labels: pulumi.Output<{
[key: string]: string;
} | undefined>;
/**
* Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
*/
readonly location: pulumi.Output<string>;
/**
* Identifier. The resource name (full URI of the resource) following the standard naming
* scheme:
* "projects/{project}/locations/{location}/releases/{release}"
*/
readonly name: pulumi.Output<string>;
/**
* List of output variables declared on the blueprint and can be present with
* their values on the unit status
* Structure is documented below.
*/
readonly outputVariables: pulumi.Output<outputs.saasruntime.ReleaseOutputVariable[]>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
readonly project: pulumi.Output<string>;
/**
* The combination of labels configured directly on the resource
* and default labels configured on the provider.
*/
readonly pulumiLabels: pulumi.Output<{
[key: string]: string;
}>;
/**
* The ID value for the new release.
*/
readonly releaseId: pulumi.Output<string>;
/**
* Set of requirements to be fulfilled on the Unit when using this Release.
* Structure is documented below.
*/
readonly releaseRequirements: pulumi.Output<outputs.saasruntime.ReleaseReleaseRequirements | undefined>;
/**
* The unique identifier of the resource. UID is unique in the time
* and space for this resource within the scope of the service. It is
* typically generated by the server on successful creation of a resource
* and must not be changed. UID is used to uniquely identify resources
* with resource name reuses. This should be a UUID4.
*/
readonly uid: pulumi.Output<string>;
/**
* Reference to the UnitKind this Release corresponds to (required and
* immutable once created).
*/
readonly unitKind: pulumi.Output<string>;
/**
* The timestamp when the resource was last updated. Any
* change to the resource made by users must refresh this value.
* Changes to a resource made by the service should refresh this value.
*/
readonly updateTime: pulumi.Output<string>;
/**
* Create a Release resource with the given unique name, arguments, and options.
*
* @param name The _unique_ name of the resource.
* @param args The arguments to use to populate this resource's properties.
* @param opts A bag of options that control this resource's behavior.
*/
constructor(name: string, args: ReleaseArgs, opts?: pulumi.CustomResourceOptions);
}
/**
* Input properties used for looking up and filtering Release resources.
*/
export interface ReleaseState {
/**
* Annotations is an unstructured key-value map stored with a resource that
* may be set by external tools to store and retrieve arbitrary metadata.
* They are not queryable and should be preserved when modifying objects.
* More info: https://kubernetes.io/docs/user-guide/annotations
* **Note**: This field is non-authoritative, and will only manage the annotations present in your configuration.
* Please refer to the field `effectiveAnnotations` for all of the annotations present on the resource.
*/
annotations?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* Blueprints are OCI Images that contain all of the artifacts needed to
* provision a unit. Metadata such as, type of the engine used to actuate the
* blueprint (e.g. terraform, helm etc) and version will come from the image
* manifest. If the hostname is omitted, it will be assumed to be the regional
* path to Artifact Registry (eg. us-east1-docker.pkg.dev).
* Structure is documented below.
*/
blueprint?: pulumi.Input<inputs.saasruntime.ReleaseBlueprint | undefined>;
/**
* The timestamp when the resource was created.
*/
createTime?: pulumi.Input<string | undefined>;
/**
* Whether Terraform will be prevented from destroying the resource. Defaults to DELETE.
* When a 'terraform destroy' or 'pulumi up' would delete the resource,
* the command will fail if this field is set to "PREVENT" in Terraform state.
* When set to "ABANDON", the command will remove the resource from Terraform
* management without updating or deleting the resource in the API.
* When set to "DELETE", deleting the resource is allowed.
*/
deletionPolicy?: pulumi.Input<string | undefined>;
/**
* All of annotations (key/value pairs) present on the resource in GCP, including the annotations configured through Terraform, other clients and services.
*/
effectiveAnnotations?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
*/
effectiveLabels?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* An opaque value that uniquely identifies a version or
* generation of a resource. It can be used to confirm that the client
* and server agree on the ordering of a resource being written.
*/
etag?: pulumi.Input<string | undefined>;
/**
* Mapping of input variables to default values. Maximum 100
* Structure is documented below.
*/
inputVariableDefaults?: pulumi.Input<pulumi.Input<inputs.saasruntime.ReleaseInputVariableDefault>[] | undefined>;
/**
* List of input variables declared on the blueprint and can be present with
* their values on the unit spec
* Structure is documented below.
*/
inputVariables?: pulumi.Input<pulumi.Input<inputs.saasruntime.ReleaseInputVariable>[] | undefined>;
/**
* The labels on the resource, which can be used for categorization.
* similar to Kubernetes resource labels.
* **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
* Please refer to the field `effectiveLabels` for all of the labels present on the resource.
*/
labels?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
*/
location?: pulumi.Input<string | undefined>;
/**
* Identifier. The resource name (full URI of the resource) following the standard naming
* scheme:
* "projects/{project}/locations/{location}/releases/{release}"
*/
name?: pulumi.Input<string | undefined>;
/**
* List of output variables declared on the blueprint and can be present with
* their values on the unit status
* Structure is documented below.
*/
outputVariables?: pulumi.Input<pulumi.Input<inputs.saasruntime.ReleaseOutputVariable>[] | undefined>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
project?: pulumi.Input<string | undefined>;
/**
* The combination of labels configured directly on the resource
* and default labels configured on the provider.
*/
pulumiLabels?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* The ID value for the new release.
*/
releaseId?: pulumi.Input<string | undefined>;
/**
* Set of requirements to be fulfilled on the Unit when using this Release.
* Structure is documented below.
*/
releaseRequirements?: pulumi.Input<inputs.saasruntime.ReleaseReleaseRequirements | undefined>;
/**
* The unique identifier of the resource. UID is unique in the time
* and space for this resource within the scope of the service. It is
* typically generated by the server on successful creation of a resource
* and must not be changed. UID is used to uniquely identify resources
* with resource name reuses. This should be a UUID4.
*/
uid?: pulumi.Input<string | undefined>;
/**
* Reference to the UnitKind this Release corresponds to (required and
* immutable once created).
*/
unitKind?: pulumi.Input<string | undefined>;
/**
* The timestamp when the resource was last updated. Any
* change to the resource made by users must refresh this value.
* Changes to a resource made by the service should refresh this value.
*/
updateTime?: pulumi.Input<string | undefined>;
}
/**
* The set of arguments for constructing a Release resource.
*/
export interface ReleaseArgs {
/**
* Annotations is an unstructured key-value map stored with a resource that
* may be set by external tools to store and retrieve arbitrary metadata.
* They are not queryable and should be preserved when modifying objects.
* More info: https://kubernetes.io/docs/user-guide/annotations
* **Note**: This field is non-authoritative, and will only manage the annotations present in your configuration.
* Please refer to the field `effectiveAnnotations` for all of the annotations present on the resource.
*/
annotations?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* Blueprints are OCI Images that contain all of the artifacts needed to
* provision a unit. Metadata such as, type of the engine used to actuate the
* blueprint (e.g. terraform, helm etc) and version will come from the image
* manifest. If the hostname is omitted, it will be assumed to be the regional
* path to Artifact Registry (eg. us-east1-docker.pkg.dev).
* Structure is documented below.
*/
blueprint?: pulumi.Input<inputs.saasruntime.ReleaseBlueprint | undefined>;
/**
* Whether Terraform will be prevented from destroying the resource. Defaults to DELETE.
* When a 'terraform destroy' or 'pulumi up' would delete the resource,
* the command will fail if this field is set to "PREVENT" in Terraform state.
* When set to "ABANDON", the command will remove the resource from Terraform
* management without updating or deleting the resource in the API.
* When set to "DELETE", deleting the resource is allowed.
*/
deletionPolicy?: pulumi.Input<string | undefined>;
/**
* Mapping of input variables to default values. Maximum 100
* Structure is documented below.
*/
inputVariableDefaults?: pulumi.Input<pulumi.Input<inputs.saasruntime.ReleaseInputVariableDefault>[] | undefined>;
/**
* The labels on the resource, which can be used for categorization.
* similar to Kubernetes resource labels.
* **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
* Please refer to the field `effectiveLabels` for all of the labels present on the resource.
*/
labels?: pulumi.Input<{
[key: string]: pulumi.Input<string>;
} | undefined>;
/**
* Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122.
*/
location: pulumi.Input<string>;
/**
* The ID of the project in which the resource belongs.
* If it is not provided, the provider project is used.
*/
project?: pulumi.Input<string | undefined>;
/**
* The ID value for the new release.
*/
releaseId: pulumi.Input<string>;
/**
* Set of requirements to be fulfilled on the Unit when using this Release.
* Structure is documented below.
*/
releaseRequirements?: pulumi.Input<inputs.saasruntime.ReleaseReleaseRequirements | undefined>;
/**
* Reference to the UnitKind this Release corresponds to (required and
* immutable once created).
*/
unitKind: pulumi.Input<string>;
}
//# sourceMappingURL=release.d.ts.map