com.pulumi.kubernetes.apps.v1.Deployment Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of kubernetes Show documentation
Show all versions of kubernetes Show documentation
A Pulumi package for creating and managing Kubernetes resources.
// *** WARNING: this file was generated by pulumi-java-gen. ***
// *** Do not edit by hand unless you're certain you know what you are doing! ***
package com.pulumi.kubernetes.apps.v1;
import com.pulumi.core.Alias;
import com.pulumi.core.Output;
import com.pulumi.core.annotations.Export;
import com.pulumi.core.annotations.ResourceType;
import com.pulumi.core.internal.Codegen;
import com.pulumi.kubernetes.Utilities;
import com.pulumi.kubernetes.apps.v1.DeploymentArgs;
import com.pulumi.kubernetes.apps.v1.outputs.DeploymentSpec;
import com.pulumi.kubernetes.apps.v1.outputs.DeploymentStatus;
import com.pulumi.kubernetes.meta.v1.outputs.ObjectMeta;
import java.lang.String;
import java.util.List;
import java.util.Optional;
import javax.annotation.Nullable;
/**
* Deployment enables declarative updates for Pods and ReplicaSets.
*
* This resource waits until its status is ready before registering success
* for create/update, and populating output properties from the current state of the resource.
* The following conditions are used to determine whether the resource creation has
* succeeded or failed:
*
* 1. The Deployment has begun to be updated by the Deployment controller. If the current
* generation of the Deployment is > 1, then this means that the current generation must
* be different from the generation reported by the last outputs.
* 2. There exists a ReplicaSet whose revision is equal to the current revision of the
* Deployment.
* 3. The Deployment's '.status.conditions' has a status of type 'Available' whose 'status'
* member is set to 'True'.
* 4. If the Deployment has generation > 1, then '.status.conditions' has a status of type
* 'Progressing', whose 'status' member is set to 'True', and whose 'reason' is
* 'NewReplicaSetAvailable'. For generation <= 1, this status field does not exist,
* because it doesn't do a rollout (i.e., it simply creates the Deployment and
* corresponding ReplicaSet), and therefore there is no rollout to mark as 'Progressing'.
*
* If the Deployment has not reached a Ready state after 10 minutes, it will
* time out and mark the resource update as Failed. You can override the default timeout value
* by setting the 'customTimeouts' option on the resource.
*
* ## Example Usage
* ### Create a Deployment with auto-naming
*
* {@code
* package generated_program;
*
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.kubernetes.apps_v1.Deployment;
* import com.pulumi.kubernetes.apps_v1.DeploymentArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.ObjectMetaArgs;
* import com.pulumi.kubernetes.apps_v1.inputs.DeploymentSpecArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.LabelSelectorArgs;
* import com.pulumi.kubernetes.core_v1.inputs.PodTemplateSpecArgs;
* import com.pulumi.kubernetes.core_v1.inputs.PodSpecArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
*
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
*
* public static void stack(Context ctx) {
* var deployment = new Deployment("deployment", DeploymentArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(DeploymentSpecArgs.builder()
* .replicas(3)
* .selector(LabelSelectorArgs.builder()
* .matchLabels(Map.of("app", "nginx"))
* .build())
* .template(PodTemplateSpecArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(PodSpecArgs.builder()
* .containers(ContainerArgs.builder()
* .image("nginx:1.14.2")
* .name("nginx")
* .ports(ContainerPortArgs.builder()
* .containerPort(80)
* .build())
* .build())
* .build())
* .build())
* .build())
* .build());
*
* }
* }
* }
*
* ### Create a Deployment with a user-specified name
*
* {@code
* package generated_program;
*
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.kubernetes.apps_v1.Deployment;
* import com.pulumi.kubernetes.apps_v1.DeploymentArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.ObjectMetaArgs;
* import com.pulumi.kubernetes.apps_v1.inputs.DeploymentSpecArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.LabelSelectorArgs;
* import com.pulumi.kubernetes.core_v1.inputs.PodTemplateSpecArgs;
* import com.pulumi.kubernetes.core_v1.inputs.PodSpecArgs;
* import java.util.List;
* import java.util.ArrayList;
* import java.util.Map;
* import java.io.File;
* import java.nio.file.Files;
* import java.nio.file.Paths;
*
* public class App {
* public static void main(String[] args) {
* Pulumi.run(App::stack);
* }
*
* public static void stack(Context ctx) {
* var deployment = new Deployment("deployment", DeploymentArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .name("nginx-deployment")
* .build())
* .spec(DeploymentSpecArgs.builder()
* .replicas(3)
* .selector(LabelSelectorArgs.builder()
* .matchLabels(Map.of("app", "nginx"))
* .build())
* .template(PodTemplateSpecArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(PodSpecArgs.builder()
* .containers(ContainerArgs.builder()
* .image("nginx:1.14.2")
* .name("nginx")
* .ports(ContainerPortArgs.builder()
* .containerPort(80)
* .build())
* .build())
* .build())
* .build())
* .build())
* .build());
*
* }
* }
* }
*
*
*/
@ResourceType(type="kubernetes:apps/v1:Deployment")
public class Deployment extends com.pulumi.resources.CustomResource {
/**
* APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
*
*/
@Export(name="apiVersion", refs={String.class}, tree="[0]")
private Output apiVersion;
/**
* @return APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
*
*/
public Output apiVersion() {
return this.apiVersion;
}
/**
* Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
*
*/
@Export(name="kind", refs={String.class}, tree="[0]")
private Output kind;
/**
* @return Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
*
*/
public Output kind() {
return this.kind;
}
/**
* Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*
*/
@Export(name="metadata", refs={ObjectMeta.class}, tree="[0]")
private Output metadata;
/**
* @return Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*
*/
public Output metadata() {
return this.metadata;
}
/**
* Specification of the desired behavior of the Deployment.
*
*/
@Export(name="spec", refs={DeploymentSpec.class}, tree="[0]")
private Output spec;
/**
* @return Specification of the desired behavior of the Deployment.
*
*/
public Output spec() {
return this.spec;
}
/**
* Most recently observed status of the Deployment.
*
*/
@Export(name="status", refs={DeploymentStatus.class}, tree="[0]")
private Output status;
/**
* @return Most recently observed status of the Deployment.
*
*/
public Output> status() {
return Codegen.optional(this.status);
}
/**
*
* @param name The _unique_ name of the resulting resource.
*/
public Deployment(String name) {
this(name, DeploymentArgs.Empty);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
*/
public Deployment(String name, @Nullable DeploymentArgs args) {
this(name, args, null);
}
/**
*
* @param name The _unique_ name of the resulting resource.
* @param args The arguments to use to populate this resource's properties.
* @param options A bag of options that control this resource's behavior.
*/
public Deployment(String name, @Nullable DeploymentArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("kubernetes:apps/v1:Deployment", name, makeArgs(args, options), makeResourceOptions(options, Codegen.empty()));
}
private Deployment(String name, Output id, @Nullable com.pulumi.resources.CustomResourceOptions options) {
super("kubernetes:apps/v1:Deployment", name, null, makeResourceOptions(options, id));
}
private static DeploymentArgs makeArgs(@Nullable DeploymentArgs args, @Nullable com.pulumi.resources.CustomResourceOptions options) {
if (options != null && options.getUrn().isPresent()) {
return null;
}
var builder = args == null ? DeploymentArgs.builder() : DeploymentArgs.builder(args);
return builder
.apiVersion("apps/v1")
.kind("Deployment")
.build();
}
private static com.pulumi.resources.CustomResourceOptions makeResourceOptions(@Nullable com.pulumi.resources.CustomResourceOptions options, @Nullable Output id) {
var defaultOptions = com.pulumi.resources.CustomResourceOptions.builder()
.version(Utilities.getVersion())
.aliases(List.of(
Output.of(Alias.builder().type("kubernetes:apps/v1beta1:Deployment").build()),
Output.of(Alias.builder().type("kubernetes:apps/v1beta2:Deployment").build()),
Output.of(Alias.builder().type("kubernetes:extensions/v1beta1:Deployment").build())
))
.build();
return com.pulumi.resources.CustomResourceOptions.merge(defaultOptions, options, id);
}
/**
* Get an existing Host 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 options Optional settings to control the behavior of the CustomResource.
*/
public static Deployment get(String name, Output id, @Nullable com.pulumi.resources.CustomResourceOptions options) {
return new Deployment(name, id, options);
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy