com.pulumi.kubernetes.apps.v1.kotlin.StatefulSet.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.kotlin.KotlinCustomResource
import com.pulumi.kotlin.PulumiTagMarker
import com.pulumi.kotlin.ResourceMapper
import com.pulumi.kotlin.options.CustomResourceOptions
import com.pulumi.kotlin.options.CustomResourceOptionsBuilder
import com.pulumi.kubernetes.apps.v1.kotlin.outputs.StatefulSetSpec
import com.pulumi.kubernetes.apps.v1.kotlin.outputs.StatefulSetStatus
import com.pulumi.kubernetes.meta.v1.kotlin.outputs.ObjectMeta
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import com.pulumi.kubernetes.apps.v1.kotlin.outputs.StatefulSetSpec.Companion.toKotlin as statefulSetSpecToKotlin
import com.pulumi.kubernetes.apps.v1.kotlin.outputs.StatefulSetStatus.Companion.toKotlin as statefulSetStatusToKotlin
import com.pulumi.kubernetes.meta.v1.kotlin.outputs.ObjectMeta.Companion.toKotlin as objectMetaToKotlin
/**
* Builder for [StatefulSet].
*/
@PulumiTagMarker
public class StatefulSetResourceBuilder internal constructor() {
public var name: String? = null
public var args: StatefulSetArgs = StatefulSetArgs()
public var opts: CustomResourceOptions = CustomResourceOptions()
/**
* @param name The _unique_ name of the resulting resource.
*/
public fun name(`value`: String) {
this.name = value
}
/**
* @param block The arguments to use to populate this resource's properties.
*/
public suspend fun args(block: suspend StatefulSetArgsBuilder.() -> Unit) {
val builder = StatefulSetArgsBuilder()
block(builder)
this.args = builder.build()
}
/**
* @param block A bag of options that control this resource's behavior.
*/
public suspend fun opts(block: suspend CustomResourceOptionsBuilder.() -> Unit) {
this.opts = com.pulumi.kotlin.options.CustomResourceOptions.opts(block)
}
internal fun build(): StatefulSet {
val builtJavaResource = com.pulumi.kubernetes.apps.v1.StatefulSet(
this.name,
this.args.toJava(),
this.opts.toJava(),
)
return StatefulSet(builtJavaResource)
}
}
/**
* 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());
* }
* }
* ```
*/
public class StatefulSet internal constructor(
override val javaResource: com.pulumi.kubernetes.apps.v1.StatefulSet,
) : KotlinCustomResource(javaResource, StatefulSetMapper) {
/**
* 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 val apiVersion: Output
get() = javaResource.apiVersion().applyValue({ args0 -> args0 })
/**
* 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 val kind: Output
get() = javaResource.kind().applyValue({ args0 -> args0 })
/**
* Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
*/
public val metadata: Output
get() = javaResource.metadata().applyValue({ args0 ->
args0.let({ args0 ->
objectMetaToKotlin(args0)
})
})
/**
* Spec defines the desired identities of pods in this set.
*/
public val spec: Output
get() = javaResource.spec().applyValue({ args0 ->
args0.let({ args0 ->
statefulSetSpecToKotlin(args0)
})
})
/**
* Status is the current status of Pods in this StatefulSet. This data may be out of date by some window of time.
*/
public val status: Output?
get() = javaResource.status().applyValue({ args0 ->
args0.map({ args0 ->
args0.let({ args0 ->
statefulSetStatusToKotlin(args0)
})
}).orElse(null)
})
}
public object StatefulSetMapper : ResourceMapper {
override fun supportsMappingOfType(javaResource: Resource): Boolean =
com.pulumi.kubernetes.apps.v1.StatefulSet::class == javaResource::class
override fun map(javaResource: Resource): StatefulSet = StatefulSet(
javaResource as
com.pulumi.kubernetes.apps.v1.StatefulSet,
)
}
/**
* @see [StatefulSet].
* @param name The _unique_ name of the resulting resource.
* @param block Builder for [StatefulSet].
*/
public suspend fun statefulSet(name: String, block: suspend StatefulSetResourceBuilder.() -> Unit): StatefulSet {
val builder = StatefulSetResourceBuilder()
builder.name(name)
block(builder)
return builder.build()
}
/**
* @see [StatefulSet].
* @param name The _unique_ name of the resulting resource.
*/
public fun statefulSet(name: String): StatefulSet {
val builder = StatefulSetResourceBuilder()
builder.name(name)
return builder.build()
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy