com.pulumi.kubernetes.apps.v1.kotlin.StatefulSetArgs.kt Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of pulumi-kubernetes-kotlin Show documentation
Show all versions of pulumi-kubernetes-kotlin Show documentation
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
@file:Suppress("NAME_SHADOWING", "DEPRECATION")
package com.pulumi.kubernetes.apps.v1.kotlin
import com.pulumi.core.Output
import com.pulumi.core.Output.of
import com.pulumi.kotlin.ConvertibleToJava
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.applySuspend
import com.pulumi.kubernetes.apps.v1.StatefulSetArgs.builder
import com.pulumi.kubernetes.apps.v1.kotlin.inputs.StatefulSetSpecArgs
import com.pulumi.kubernetes.apps.v1.kotlin.inputs.StatefulSetSpecArgsBuilder
import com.pulumi.kubernetes.meta.v1.kotlin.inputs.ObjectMetaArgs
import com.pulumi.kubernetes.meta.v1.kotlin.inputs.ObjectMetaArgsBuilder
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import kotlin.jvm.JvmName
/**
* StatefulSet represents a set of pods with consistent identities. Identities are defined as:
* - Network: A single stable DNS and hostname.
* - Storage: As many VolumeClaims as requested.
* The StatefulSet guarantees that a given network identity will always map to the same storage identity.
* 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 value of 'spec.replicas' matches '.status.replicas', '.status.currentReplicas',
* and '.status.readyReplicas'.
* 2. The value of '.status.updateRevision' matches '.status.currentRevision'.
* If the StatefulSet 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 StatefulSet with auto-naming
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.kubernetes.core_v1.Service;
* import com.pulumi.kubernetes.core_v1.ServiceArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.ObjectMetaArgs;
* import com.pulumi.kubernetes.core_v1.inputs.ServiceSpecArgs;
* import com.pulumi.kubernetes.apps_v1.StatefulSet;
* import com.pulumi.kubernetes.apps_v1.StatefulSetArgs;
* import com.pulumi.kubernetes.apps_v1.inputs.StatefulSetSpecArgs;
* 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 service = new Service("service", ServiceArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(ServiceSpecArgs.builder()
* .clusterIP("None")
* .ports(ServicePortArgs.builder()
* .name("web")
* .port(80)
* .build())
* .selector(Map.of("app", "nginx"))
* .build())
* .build());
* var statefulset = new StatefulSet("statefulset", StatefulSetArgs.builder()
* .spec(StatefulSetSpecArgs.builder()
* .replicas(3)
* .selector(LabelSelectorArgs.builder()
* .matchLabels(Map.of("app", "nginx"))
* .build())
* .serviceName(service.metadata().applyValue(metadata -> metadata.name()))
* .template(PodTemplateSpecArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(PodSpecArgs.builder()
* .containers(ContainerArgs.builder()
* .image("nginx:stable-alpine3.17-slim")
* .name("nginx")
* .ports(ContainerPortArgs.builder()
* .containerPort(80)
* .name("web")
* .build())
* .volumeMounts(VolumeMountArgs.builder()
* .mountPath("/usr/share/nginx/html")
* .name("www")
* .build())
* .build())
* .terminationGracePeriodSeconds(10)
* .build())
* .build())
* .volumeClaimTemplates(PersistentVolumeClaimArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .name("www")
* .build())
* .spec(PersistentVolumeClaimSpecArgs.builder()
* .accessModes("ReadWriteOnce")
* .resources(ResourceRequirementsArgs.builder()
* .requests(Map.of("storage", "1Gi"))
* .build())
* .build())
* .build())
* .build())
* .build());
* }
* }
* ```
* ### Create a StatefulSet with a user-specified name
* ```java
* package generated_program;
* import com.pulumi.Context;
* import com.pulumi.Pulumi;
* import com.pulumi.core.Output;
* import com.pulumi.kubernetes.core_v1.Service;
* import com.pulumi.kubernetes.core_v1.ServiceArgs;
* import com.pulumi.kubernetes.meta_v1.inputs.ObjectMetaArgs;
* import com.pulumi.kubernetes.core_v1.inputs.ServiceSpecArgs;
* import com.pulumi.kubernetes.apps_v1.StatefulSet;
* import com.pulumi.kubernetes.apps_v1.StatefulSetArgs;
* import com.pulumi.kubernetes.apps_v1.inputs.StatefulSetSpecArgs;
* 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 service = new Service("service", ServiceArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .name("nginx")
* .build())
* .spec(ServiceSpecArgs.builder()
* .clusterIP("None")
* .ports(ServicePortArgs.builder()
* .name("web")
* .port(80)
* .build())
* .selector(Map.of("app", "nginx"))
* .build())
* .build());
* var statefulset = new StatefulSet("statefulset", StatefulSetArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .name("web")
* .build())
* .spec(StatefulSetSpecArgs.builder()
* .replicas(3)
* .selector(LabelSelectorArgs.builder()
* .matchLabels(Map.of("app", "nginx"))
* .build())
* .serviceName(service.metadata().applyValue(metadata -> metadata.name()))
* .template(PodTemplateSpecArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .labels(Map.of("app", "nginx"))
* .build())
* .spec(PodSpecArgs.builder()
* .containers(ContainerArgs.builder()
* .image("nginx:stable-alpine3.17-slim")
* .name("nginx")
* .ports(ContainerPortArgs.builder()
* .containerPort(80)
* .name("web")
* .build())
* .volumeMounts(VolumeMountArgs.builder()
* .mountPath("/usr/share/nginx/html")
* .name("www")
* .build())
* .build())
* .terminationGracePeriodSeconds(10)
* .build())
* .build())
* .volumeClaimTemplates(PersistentVolumeClaimArgs.builder()
* .metadata(ObjectMetaArgs.builder()
* .name("www")
* .build())
* .spec(PersistentVolumeClaimSpecArgs.builder()
* .accessModes("ReadWriteOnce")
* .resources(ResourceRequirementsArgs.builder()
* .requests(Map.of("storage", "1Gi"))
* .build())
* .build())
* .build())
* .build())
* .build());
* }
* }
* ```
* @property apiVersion 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
* @property kind 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
* @property metadata Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
* @property spec Spec defines the desired identities of pods in this set.
*/
public data class StatefulSetArgs(
public val apiVersion: Output? = null,
public val kind: Output? = null,
public val metadata: Output? = null,
public val spec: Output? = null,
) : ConvertibleToJava {
override fun toJava(): com.pulumi.kubernetes.apps.v1.StatefulSetArgs =
com.pulumi.kubernetes.apps.v1.StatefulSetArgs.builder()
.apiVersion(apiVersion?.applyValue({ args0 -> args0 }))
.kind(kind?.applyValue({ args0 -> args0 }))
.metadata(metadata?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) }))
.spec(spec?.applyValue({ args0 -> args0.let({ args0 -> args0.toJava() }) })).build()
}
/**
* Builder for [StatefulSetArgs].
*/
@PulumiTagMarker
public class StatefulSetArgsBuilder internal constructor() {
private var apiVersion: Output? = null
private var kind: Output? = null
private var metadata: Output? = null
private var spec: Output? = null
/**
* @param value 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
*/
@JvmName("yioamlftrlqfavnc")
public suspend fun apiVersion(`value`: Output) {
this.apiVersion = value
}
/**
* @param value 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
*/
@JvmName("bkhqegktppowxbvg")
public suspend fun kind(`value`: Output) {
this.kind = value
}
/**
* @param value Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*/
@JvmName("tdlwltstcjyppddw")
public suspend fun metadata(`value`: Output) {
this.metadata = value
}
/**
* @param value Spec defines the desired identities of pods in this set.
*/
@JvmName("dlvfsykujfgtwure")
public suspend fun spec(`value`: Output) {
this.spec = value
}
/**
* @param value 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
*/
@JvmName("cfyasoolrbjlajcu")
public suspend fun apiVersion(`value`: String?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.apiVersion = mapped
}
/**
* @param value 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
*/
@JvmName("fatbiadfwjqnrxof")
public suspend fun kind(`value`: String?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.kind = mapped
}
/**
* @param value Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*/
@JvmName("jkhydbncjqvcrlrh")
public suspend fun metadata(`value`: ObjectMetaArgs?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.metadata = mapped
}
/**
* @param argument Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*/
@JvmName("hmnwtibcuvidkrrb")
public suspend fun metadata(argument: suspend ObjectMetaArgsBuilder.() -> Unit) {
val toBeMapped = ObjectMetaArgsBuilder().applySuspend { argument() }.build()
val mapped = of(toBeMapped)
this.metadata = mapped
}
/**
* @param value Spec defines the desired identities of pods in this set.
*/
@JvmName("veidtwpgwyscsxoy")
public suspend fun spec(`value`: StatefulSetSpecArgs?) {
val toBeMapped = value
val mapped = toBeMapped?.let({ args0 -> of(args0) })
this.spec = mapped
}
/**
* @param argument Spec defines the desired identities of pods in this set.
*/
@JvmName("nunrujbndldfvwgi")
public suspend fun spec(argument: suspend StatefulSetSpecArgsBuilder.() -> Unit) {
val toBeMapped = StatefulSetSpecArgsBuilder().applySuspend { argument() }.build()
val mapped = of(toBeMapped)
this.spec = mapped
}
internal fun build(): StatefulSetArgs = StatefulSetArgs(
apiVersion = apiVersion,
kind = kind,
metadata = metadata,
spec = spec,
)
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy