io.cloudshiftdev.awscdk.services.eks.KubernetesManifestProps.kt Maven / Gradle / Ivy
The newest version!
@file:Suppress("RedundantVisibilityModifier","RedundantUnitReturnType","RemoveRedundantQualifierName","unused","UnusedImport","ClassName","REDUNDANT_PROJECTION","DEPRECATION")
package io.cloudshiftdev.awscdk.services.eks
import io.cloudshiftdev.awscdk.common.CdkDslMarker
import io.cloudshiftdev.awscdk.common.CdkObject
import io.cloudshiftdev.awscdk.common.CdkObjectWrappers
import kotlin.Any
import kotlin.Boolean
import kotlin.String
import kotlin.Unit
import kotlin.collections.List
import kotlin.collections.Map
/**
* Properties for KubernetesManifest.
*
* Example:
*
* ```
* Cluster cluster;
* Map<String, String> appLabel = Map.of("app", "hello-kubernetes");
* Map<String, Object> deployment = Map.of(
* "apiVersion", "apps/v1",
* "kind", "Deployment",
* "metadata", Map.of("name", "hello-kubernetes"),
* "spec", Map.of(
* "replicas", 3,
* "selector", Map.of("matchLabels", appLabel),
* "template", Map.of(
* "metadata", Map.of("labels", appLabel),
* "spec", Map.of(
* "containers", List.of(Map.of(
* "name", "hello-kubernetes",
* "image", "paulbouwer/hello-kubernetes:1.5",
* "ports", List.of(Map.of("containerPort", 8080))))))));
* Map<String, Object> service = Map.of(
* "apiVersion", "v1",
* "kind", "Service",
* "metadata", Map.of("name", "hello-kubernetes"),
* "spec", Map.of(
* "type", "LoadBalancer",
* "ports", List.of(Map.of("port", 80, "targetPort", 8080)),
* "selector", appLabel));
* // option 1: use a construct
* // option 1: use a construct
* KubernetesManifest.Builder.create(this, "hello-kub")
* .cluster(cluster)
* .manifest(List.of(deployment, service))
* .build();
* // or, option2: use `addManifest`
* cluster.addManifest("hello-kub", service, deployment);
* ```
*/
public interface KubernetesManifestProps : KubernetesManifestOptions {
/**
* The EKS cluster to apply this manifest to.
*
* [disable-awslint:ref-via-interface]
*/
public fun cluster(): ICluster
/**
* The manifest to apply.
*
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*
* Example:
*
* ```
* List.of(Map.of(
* "apiVersion", "v1",
* "kind", "Pod",
* "metadata", Map.of("name", "mypod"),
* "spec", Map.of(
* "containers", List.of(Map.of("name", "hello", "image", "paulbouwer/hello-kubernetes:1.5",
* "ports", List.of(Map.of("containerPort", 8080)))))));
* ```
*/
public fun manifest(): List>
/**
* Overwrite any existing resources.
*
* If this is set, we will use `kubectl apply` instead of `kubectl create`
* when the resource is created. Otherwise, if there is already a resource
* in the cluster with the same name, the operation will fail.
*
* Default: false
*/
public fun overwrite(): Boolean? = unwrap(this).getOverwrite()
/**
* A builder for [KubernetesManifestProps]
*/
@CdkDslMarker
public interface Builder {
/**
* @param cluster The EKS cluster to apply this manifest to.
* [disable-awslint:ref-via-interface]
*/
public fun cluster(cluster: ICluster)
/**
* @param ingressAlb Automatically detect `Ingress` resources in the manifest and annotate them
* so they are picked up by an ALB Ingress Controller.
*/
public fun ingressAlb(ingressAlb: Boolean)
/**
* @param ingressAlbScheme Specify the ALB scheme that should be applied to `Ingress` resources.
* Only applicable if `ingressAlb` is set to `true`.
*/
public fun ingressAlbScheme(ingressAlbScheme: AlbScheme)
/**
* @param manifest The manifest to apply.
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*/
public fun manifest(manifest: List>)
/**
* @param manifest The manifest to apply.
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*/
public fun manifest(vararg manifest: Map)
/**
* @param overwrite Overwrite any existing resources.
* If this is set, we will use `kubectl apply` instead of `kubectl create`
* when the resource is created. Otherwise, if there is already a resource
* in the cluster with the same name, the operation will fail.
*/
public fun overwrite(overwrite: Boolean)
/**
* @param prune When a resource is removed from a Kubernetes manifest, it no longer appears in
* the manifest, and there is no way to know that this resource needs to be deleted.
* To address this, `kubectl apply` has a `--prune` option which will
* query the cluster for all resources with a specific label and will remove
* all the labeld resources that are not part of the applied manifest. If this
* option is disabled and a resource is removed, it will become "orphaned" and
* will not be deleted from the cluster.
*
* When this option is enabled (default), the construct will inject a label to
* all Kubernetes resources included in this manifest which will be used to
* prune resources when the manifest changes via `kubectl apply --prune`.
*
* The label name will be `aws.cdk.eks/prune-<ADDR>` where `<ADDR>` is the
* 42-char unique address of this construct in the construct tree. Value is
* empty.
*/
public fun prune(prune: Boolean)
/**
* @param skipValidation A flag to signify if the manifest validation should be skipped.
*/
public fun skipValidation(skipValidation: Boolean)
}
private class BuilderImpl : Builder {
private val cdkBuilder: software.amazon.awscdk.services.eks.KubernetesManifestProps.Builder =
software.amazon.awscdk.services.eks.KubernetesManifestProps.builder()
/**
* @param cluster The EKS cluster to apply this manifest to.
* [disable-awslint:ref-via-interface]
*/
override fun cluster(cluster: ICluster) {
cdkBuilder.cluster(cluster.let(ICluster.Companion::unwrap))
}
/**
* @param ingressAlb Automatically detect `Ingress` resources in the manifest and annotate them
* so they are picked up by an ALB Ingress Controller.
*/
override fun ingressAlb(ingressAlb: Boolean) {
cdkBuilder.ingressAlb(ingressAlb)
}
/**
* @param ingressAlbScheme Specify the ALB scheme that should be applied to `Ingress` resources.
* Only applicable if `ingressAlb` is set to `true`.
*/
override fun ingressAlbScheme(ingressAlbScheme: AlbScheme) {
cdkBuilder.ingressAlbScheme(ingressAlbScheme.let(AlbScheme.Companion::unwrap))
}
/**
* @param manifest The manifest to apply.
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*/
override fun manifest(manifest: List>) {
cdkBuilder.manifest(manifest)
}
/**
* @param manifest The manifest to apply.
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*/
override fun manifest(vararg manifest: Map): Unit = manifest(manifest.toList())
/**
* @param overwrite Overwrite any existing resources.
* If this is set, we will use `kubectl apply` instead of `kubectl create`
* when the resource is created. Otherwise, if there is already a resource
* in the cluster with the same name, the operation will fail.
*/
override fun overwrite(overwrite: Boolean) {
cdkBuilder.overwrite(overwrite)
}
/**
* @param prune When a resource is removed from a Kubernetes manifest, it no longer appears in
* the manifest, and there is no way to know that this resource needs to be deleted.
* To address this, `kubectl apply` has a `--prune` option which will
* query the cluster for all resources with a specific label and will remove
* all the labeld resources that are not part of the applied manifest. If this
* option is disabled and a resource is removed, it will become "orphaned" and
* will not be deleted from the cluster.
*
* When this option is enabled (default), the construct will inject a label to
* all Kubernetes resources included in this manifest which will be used to
* prune resources when the manifest changes via `kubectl apply --prune`.
*
* The label name will be `aws.cdk.eks/prune-<ADDR>` where `<ADDR>` is the
* 42-char unique address of this construct in the construct tree. Value is
* empty.
*/
override fun prune(prune: Boolean) {
cdkBuilder.prune(prune)
}
/**
* @param skipValidation A flag to signify if the manifest validation should be skipped.
*/
override fun skipValidation(skipValidation: Boolean) {
cdkBuilder.skipValidation(skipValidation)
}
public fun build(): software.amazon.awscdk.services.eks.KubernetesManifestProps =
cdkBuilder.build()
}
private class Wrapper(
cdkObject: software.amazon.awscdk.services.eks.KubernetesManifestProps,
) : CdkObject(cdkObject),
KubernetesManifestProps {
/**
* The EKS cluster to apply this manifest to.
*
* [disable-awslint:ref-via-interface]
*/
override fun cluster(): ICluster = unwrap(this).getCluster().let(ICluster::wrap)
/**
* Automatically detect `Ingress` resources in the manifest and annotate them so they are picked
* up by an ALB Ingress Controller.
*
* Default: false
*/
override fun ingressAlb(): Boolean? = unwrap(this).getIngressAlb()
/**
* Specify the ALB scheme that should be applied to `Ingress` resources.
*
* Only applicable if `ingressAlb` is set to `true`.
*
* Default: AlbScheme.INTERNAL
*/
override fun ingressAlbScheme(): AlbScheme? =
unwrap(this).getIngressAlbScheme()?.let(AlbScheme::wrap)
/**
* The manifest to apply.
*
* Consists of any number of child resources.
*
* When the resources are created/updated, this manifest will be applied to the
* cluster through `kubectl apply` and when the resources or the stack is
* deleted, the resources in the manifest will be deleted through `kubectl delete`.
*
* Example:
*
* ```
* List.of(Map.of(
* "apiVersion", "v1",
* "kind", "Pod",
* "metadata", Map.of("name", "mypod"),
* "spec", Map.of(
* "containers", List.of(Map.of("name", "hello", "image", "paulbouwer/hello-kubernetes:1.5",
* "ports", List.of(Map.of("containerPort", 8080)))))));
* ```
*/
override fun manifest(): List> = unwrap(this).getManifest()
/**
* Overwrite any existing resources.
*
* If this is set, we will use `kubectl apply` instead of `kubectl create`
* when the resource is created. Otherwise, if there is already a resource
* in the cluster with the same name, the operation will fail.
*
* Default: false
*/
override fun overwrite(): Boolean? = unwrap(this).getOverwrite()
/**
* When a resource is removed from a Kubernetes manifest, it no longer appears in the manifest,
* and there is no way to know that this resource needs to be deleted.
*
* To address this, `kubectl apply` has a `--prune` option which will
* query the cluster for all resources with a specific label and will remove
* all the labeld resources that are not part of the applied manifest. If this
* option is disabled and a resource is removed, it will become "orphaned" and
* will not be deleted from the cluster.
*
* When this option is enabled (default), the construct will inject a label to
* all Kubernetes resources included in this manifest which will be used to
* prune resources when the manifest changes via `kubectl apply --prune`.
*
* The label name will be `aws.cdk.eks/prune-<ADDR>` where `<ADDR>` is the
* 42-char unique address of this construct in the construct tree. Value is
* empty.
*
* Default: - based on the prune option of the cluster, which is `true` unless
* otherwise specified.
*
* [Documentation](https://kubernetes.io/docs/tasks/manage-kubernetes-objects/declarative-config/#alternative-kubectl-apply-f-directory-prune-l-your-label)
*/
override fun prune(): Boolean? = unwrap(this).getPrune()
/**
* A flag to signify if the manifest validation should be skipped.
*
* Default: false
*/
override fun skipValidation(): Boolean? = unwrap(this).getSkipValidation()
}
public companion object {
public operator fun invoke(block: Builder.() -> Unit = {}): KubernetesManifestProps {
val builderImpl = BuilderImpl()
return Wrapper(builderImpl.apply(block).build())
}
internal fun wrap(cdkObject: software.amazon.awscdk.services.eks.KubernetesManifestProps):
KubernetesManifestProps = CdkObjectWrappers.wrap(cdkObject) as? KubernetesManifestProps ?:
Wrapper(cdkObject)
internal fun unwrap(wrapped: KubernetesManifestProps):
software.amazon.awscdk.services.eks.KubernetesManifestProps = (wrapped as
CdkObject).cdkObject as software.amazon.awscdk.services.eks.KubernetesManifestProps
}
}