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, 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; /** * The timestamp when the resource was created. */ readonly createTime: pulumi.Output; /** * 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; /** * Mapping of input variables to default values. Maximum 100 * Structure is documented below. */ readonly inputVariableDefaults: pulumi.Output; /** * 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; /** * 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; /** * Identifier. The resource name (full URI of the resource) following the standard naming * scheme: * "projects/{project}/locations/{location}/releases/{release}" */ readonly name: pulumi.Output; /** * 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; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ readonly project: pulumi.Output; /** * 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; /** * Set of requirements to be fulfilled on the Unit when using this Release. * Structure is documented below. */ readonly releaseRequirements: pulumi.Output; /** * 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; /** * Reference to the UnitKind this Release corresponds to (required and * immutable once created). */ readonly unitKind: pulumi.Output; /** * 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; /** * 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; }>; /** * 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; /** * The timestamp when the resource was created. */ createTime?: pulumi.Input; /** * 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; }>; /** * 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; }>; /** * 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; /** * Mapping of input variables to default values. Maximum 100 * Structure is documented below. */ inputVariableDefaults?: pulumi.Input[]>; /** * 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[]>; /** * 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; }>; /** * 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; /** * Identifier. The resource name (full URI of the resource) following the standard naming * scheme: * "projects/{project}/locations/{location}/releases/{release}" */ name?: pulumi.Input; /** * 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[]>; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The combination of labels configured directly on the resource * and default labels configured on the provider. */ pulumiLabels?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * The ID value for the new release. */ releaseId?: pulumi.Input; /** * Set of requirements to be fulfilled on the Unit when using this Release. * Structure is documented below. */ releaseRequirements?: pulumi.Input; /** * 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; /** * Reference to the UnitKind this Release corresponds to (required and * immutable once created). */ unitKind?: pulumi.Input; /** * 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; } /** * 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; }>; /** * 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; /** * Mapping of input variables to default values. Maximum 100 * Structure is documented below. */ inputVariableDefaults?: pulumi.Input[]>; /** * 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; }>; /** * 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; /** * The ID of the project in which the resource belongs. * If it is not provided, the provider project is used. */ project?: pulumi.Input; /** * The ID value for the new release. */ releaseId: pulumi.Input; /** * Set of requirements to be fulfilled on the Unit when using this Release. * Structure is documented below. */ releaseRequirements?: pulumi.Input; /** * Reference to the UnitKind this Release corresponds to (required and * immutable once created). */ unitKind: pulumi.Input; }