com.pulumi.kubernetes.extensions.v1beta1.kotlin.IngressPatch.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.extensions.v1beta1.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.extensions.v1beta1.kotlin.outputs.IngressSpecPatch
import com.pulumi.kubernetes.extensions.v1beta1.kotlin.outputs.IngressStatusPatch
import com.pulumi.kubernetes.meta.v1.kotlin.outputs.ObjectMetaPatch
import com.pulumi.resources.Resource
import kotlin.Boolean
import kotlin.Deprecated
import kotlin.String
import kotlin.Suppress
import kotlin.Unit
import com.pulumi.kubernetes.extensions.v1beta1.kotlin.outputs.IngressSpecPatch.Companion.toKotlin as ingressSpecPatchToKotlin
import com.pulumi.kubernetes.extensions.v1beta1.kotlin.outputs.IngressStatusPatch.Companion.toKotlin as ingressStatusPatchToKotlin
import com.pulumi.kubernetes.meta.v1.kotlin.outputs.ObjectMetaPatch.Companion.toKotlin as objectMetaPatchToKotlin

/**
 * Builder for [IngressPatch].
 */
@PulumiTagMarker
@Deprecated(
    message = """
extensions/v1beta1/Ingress is deprecated by networking.k8s.io/v1beta1/Ingress and not supported by
    Kubernetes v1.20+ clusters.
""",
)
public class IngressPatchResourceBuilder internal constructor() {
    public var name: String? = null

    public var args: IngressPatchArgs = IngressPatchArgs()

    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 IngressPatchArgsBuilder.() -> Unit) {
        val builder = IngressPatchArgsBuilder()
        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(): IngressPatch {
        val builtJavaResource =
            com.pulumi.kubernetes.extensions.v1beta1.IngressPatch(
                this.name,
                this.args.toJava(),
                this.opts.toJava(),
            )
        return IngressPatch(builtJavaResource)
    }
}

/**
 * Patch resources are used to modify existing Kubernetes resources by using
 * Server-Side Apply updates. The name of the resource must be specified, but all other properties are optional. More than
 * one patch may be applied to the same resource, and a random FieldManager name will be used for each Patch resource.
 * Conflicts will result in an error by default, but can be forced using the "pulumi.com/patchForce" annotation. See the
 * [Server-Side Apply Docs](https://www.pulumi.com/registry/packages/kubernetes/how-to-guides/managing-resources-with-server-side-apply/) for
 * additional information about using Server-Side Apply to manage Kubernetes resources with Pulumi.
 * Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend. An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.
 * 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.  Ingress object exists.
 * 2.  Endpoint objects exist with matching names for each Ingress path (except when Service
 *     type is ExternalName).
 * 3.  Ingress entry exists for '.status.loadBalancer.ingress'.
 * If the Ingress 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.
 */
@Deprecated(
    message = """
extensions/v1beta1/Ingress is deprecated by networking.k8s.io/v1beta1/Ingress and not supported by
    Kubernetes v1.20+ clusters.
""",
)
public class IngressPatch internal constructor(
    override val javaResource: com.pulumi.kubernetes.extensions.v1beta1.IngressPatch,
) : KotlinCustomResource(javaResource, IngressPatchMapper) {
    /**
     * 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.map({ args0 ->
                args0
            }).orElse(null)
        })

    /**
     * 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.map({ args0 -> args0 }).orElse(null) })

    /**
     * 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.map({ args0 ->
                args0.let({ args0 ->
                    objectMetaPatchToKotlin(args0)
                })
            }).orElse(null)
        })

    /**
     * Spec is the desired state of the Ingress. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
     */
    public val spec: Output?
        get() = javaResource.spec().applyValue({ args0 ->
            args0.map({ args0 ->
                args0.let({ args0 ->
                    ingressSpecPatchToKotlin(args0)
                })
            }).orElse(null)
        })

    /**
     * Status is the current state of the Ingress. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
     */
    public val status: Output?
        get() = javaResource.status().applyValue({ args0 ->
            args0.map({ args0 ->
                args0.let({ args0 ->
                    ingressStatusPatchToKotlin(args0)
                })
            }).orElse(null)
        })
}

public object IngressPatchMapper : ResourceMapper {
    override fun supportsMappingOfType(javaResource: Resource): Boolean =
        com.pulumi.kubernetes.extensions.v1beta1.IngressPatch::class == javaResource::class

    override fun map(javaResource: Resource): IngressPatch = IngressPatch(
        javaResource as
            com.pulumi.kubernetes.extensions.v1beta1.IngressPatch,
    )
}

/**
 * @see [IngressPatch].
 * @param name The _unique_ name of the resulting resource.
 * @param block Builder for [IngressPatch].
 */
@Deprecated(
    message = """
extensions/v1beta1/Ingress is deprecated by networking.k8s.io/v1beta1/Ingress and not supported by
    Kubernetes v1.20+ clusters.
""",
)
public suspend fun ingressPatch(
    name: String,
    block: suspend IngressPatchResourceBuilder.() -> Unit,
): IngressPatch {
    val builder = IngressPatchResourceBuilder()
    builder.name(name)
    block(builder)
    return builder.build()
}

/**
 * @see [IngressPatch].
 * @param name The _unique_ name of the resulting resource.
 */
@Deprecated(
    message = """
extensions/v1beta1/Ingress is deprecated by networking.k8s.io/v1beta1/Ingress and not supported by
    Kubernetes v1.20+ clusters.
""",
)
public fun ingressPatch(name: String): IngressPatch {
    val builder = IngressPatchResourceBuilder()
    builder.name(name)
    return builder.build()
}