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
Build cloud applications and infrastructure by combining the safety and reliability of infrastructure as code with the power of the Kotlin programming language.
The newest version!
@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("mjqsqbrwqabuodng")
    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("gygnorvgjhnnrsem")
    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("pkjarxnejxghbhmb")
    public suspend fun metadata(`value`: Output) {
        this.metadata = value
    }

    /**
     * @param value Spec defines the desired identities of pods in this set.
     */
    @JvmName("coksypivwdajuhaj")
    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("reksrjlrytgwgats")
    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("xsbelkevqwnslhaw")
    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("pefhhsmehmyscwkw")
    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("axrbmtxjauwbgqxh")
    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("dejkigkekpoanjfj")
    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("oyqgnsiljeunmfha")
    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,
    )
}