io.cloudshiftdev.awscdk.services.ecs.BaseServiceOptions.kt Maven / Gradle / Ivy
The newest version!
@file:Suppress("RedundantVisibilityModifier","RedundantUnitReturnType","RemoveRedundantQualifierName","unused","UnusedImport","ClassName","REDUNDANT_PROJECTION","DEPRECATION")
package io.cloudshiftdev.awscdk.services.ecs
import io.cloudshiftdev.awscdk.Duration
import io.cloudshiftdev.awscdk.common.CdkDslMarker
import io.cloudshiftdev.awscdk.common.CdkObject
import io.cloudshiftdev.awscdk.common.CdkObjectWrappers
import kotlin.Boolean
import kotlin.Number
import kotlin.String
import kotlin.Unit
import kotlin.collections.List
import kotlin.jvm.JvmName
/**
* The properties for the base Ec2Service or FargateService service.
*
* Example:
*
* ```
* // The code below shows an example of how to instantiate this type.
* // The values are placeholders you should change.
* import io.cloudshiftdev.awscdk.*;
* import io.cloudshiftdev.awscdk.services.ecs.*;
* import io.cloudshiftdev.awscdk.services.servicediscovery.*;
* Cluster cluster;
* ContainerDefinition containerDefinition;
* LogDriver logDriver;
* INamespace namespace;
* ServiceManagedVolume serviceManagedVolume;
* TaskDefinitionRevision taskDefinitionRevision;
* BaseServiceOptions baseServiceOptions = BaseServiceOptions.builder()
* .cluster(cluster)
* // the properties below are optional
* .capacityProviderStrategies(List.of(CapacityProviderStrategy.builder()
* .capacityProvider("capacityProvider")
* // the properties below are optional
* .base(123)
* .weight(123)
* .build()))
* .circuitBreaker(DeploymentCircuitBreaker.builder()
* .enable(false)
* .rollback(false)
* .build())
* .cloudMapOptions(CloudMapOptions.builder()
* .cloudMapNamespace(namespace)
* .container(containerDefinition)
* .containerPort(123)
* .dnsRecordType(DnsRecordType.A)
* .dnsTtl(Duration.minutes(30))
* .failureThreshold(123)
* .name("name")
* .build())
* .deploymentAlarms(DeploymentAlarmConfig.builder()
* .alarmNames(List.of("alarmNames"))
* // the properties below are optional
* .behavior(AlarmBehavior.ROLLBACK_ON_ALARM)
* .build())
* .deploymentController(DeploymentController.builder()
* .type(DeploymentControllerType.ECS)
* .build())
* .desiredCount(123)
* .enableECSManagedTags(false)
* .enableExecuteCommand(false)
* .healthCheckGracePeriod(Duration.minutes(30))
* .maxHealthyPercent(123)
* .minHealthyPercent(123)
* .propagateTags(PropagatedTagSource.SERVICE)
* .serviceConnectConfiguration(ServiceConnectProps.builder()
* .logDriver(logDriver)
* .namespace("namespace")
* .services(List.of(ServiceConnectService.builder()
* .portMappingName("portMappingName")
* // the properties below are optional
* .discoveryName("discoveryName")
* .dnsName("dnsName")
* .idleTimeout(Duration.minutes(30))
* .ingressPortOverride(123)
* .perRequestTimeout(Duration.minutes(30))
* .port(123)
* .build()))
* .build())
* .serviceName("serviceName")
* .taskDefinitionRevision(taskDefinitionRevision)
* .volumeConfigurations(List.of(serviceManagedVolume))
* .build();
* ```
*/
public interface BaseServiceOptions {
/**
* A list of Capacity Provider strategies used to place a service.
*
* Default: - undefined
*/
public fun capacityProviderStrategies(): List =
unwrap(this).getCapacityProviderStrategies()?.map(CapacityProviderStrategy::wrap) ?:
emptyList()
/**
* Whether to enable the deployment circuit breaker.
*
* If this property is defined, circuit breaker will be implicitly
* enabled.
*
* Default: - disabled
*/
public fun circuitBreaker(): DeploymentCircuitBreaker? =
unwrap(this).getCircuitBreaker()?.let(DeploymentCircuitBreaker::wrap)
/**
* The options for configuring an Amazon ECS service to use service discovery.
*
* Default: - AWS Cloud Map service discovery is not enabled.
*/
public fun cloudMapOptions(): CloudMapOptions? =
unwrap(this).getCloudMapOptions()?.let(CloudMapOptions::wrap)
/**
* The name of the cluster that hosts the service.
*/
public fun cluster(): ICluster
/**
* The alarm(s) to monitor during deployment, and behavior to apply if at least one enters a state
* of alarm during the deployment or bake time.
*
* Default: - No alarms will be monitored during deployment.
*/
public fun deploymentAlarms(): DeploymentAlarmConfig? =
unwrap(this).getDeploymentAlarms()?.let(DeploymentAlarmConfig::wrap)
/**
* Specifies which deployment controller to use for the service.
*
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*
* Default: - Rolling update (ECS)
*/
public fun deploymentController(): DeploymentController? =
unwrap(this).getDeploymentController()?.let(DeploymentController::wrap)
/**
* The desired number of instantiations of the task definition to keep running on the service.
*
* Default: - When creating the service, default is 1; when updating the service, default uses
* the current task number.
*/
public fun desiredCount(): Number? = unwrap(this).getDesiredCount()
/**
* Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
*
* For more information, see
* [Tagging Your Amazon ECS
* Resources](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)
*
* Default: false
*/
public fun enableECSManagedTags(): Boolean? = unwrap(this).getEnableECSManagedTags()
/**
* Whether to enable the ability to execute into a container.
*
* Default: - undefined
*/
public fun enableExecuteCommand(): Boolean? = unwrap(this).getEnableExecuteCommand()
/**
* The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic
* Load Balancing target health checks after a task has first started.
*
* Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not already
* set
*/
public fun healthCheckGracePeriod(): Duration? =
unwrap(this).getHealthCheckGracePeriod()?.let(Duration::wrap)
/**
* The maximum number of tasks, specified as a percentage of the Amazon ECS service's DesiredCount
* value, that can run in a service during a deployment.
*
* Default: - 100 if daemon, otherwise 200
*/
public fun maxHealthyPercent(): Number? = unwrap(this).getMaxHealthyPercent()
/**
* The minimum number of tasks, specified as a percentage of the Amazon ECS service's DesiredCount
* value, that must continue to run and remain healthy during a deployment.
*
* Default: - 0 if daemon, otherwise 50
*/
public fun minHealthyPercent(): Number? = unwrap(this).getMinHealthyPercent()
/**
* Specifies whether to propagate the tags from the task definition or the service to the tasks in
* the service.
*
* Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or
* PropagatedTagSource.NONE
*
* Default: PropagatedTagSource.NONE
*/
public fun propagateTags(): PropagatedTagSource? =
unwrap(this).getPropagateTags()?.let(PropagatedTagSource::wrap)
/**
* Configuration for Service Connect.
*
* Default: No ports are advertised via Service Connect on this service, and the service
* cannot make requests to other services via Service Connect.
*/
public fun serviceConnectConfiguration(): ServiceConnectProps? =
unwrap(this).getServiceConnectConfiguration()?.let(ServiceConnectProps::wrap)
/**
* The name of the service.
*
* Default: - CloudFormation-generated name.
*/
public fun serviceName(): String? = unwrap(this).getServiceName()
/**
* Revision number for the task definition or `latest` to use the latest active task revision.
*
* Default: - Uses the revision of the passed task definition deployed by CloudFormation
*/
public fun taskDefinitionRevision(): TaskDefinitionRevision? =
unwrap(this).getTaskDefinitionRevision()?.let(TaskDefinitionRevision::wrap)
/**
* Configuration details for a volume used by the service.
*
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*
* Default: - undefined
*/
public fun volumeConfigurations(): List =
unwrap(this).getVolumeConfigurations()?.map(ServiceManagedVolume::wrap) ?: emptyList()
/**
* A builder for [BaseServiceOptions]
*/
@CdkDslMarker
public interface Builder {
/**
* @param capacityProviderStrategies A list of Capacity Provider strategies used to place a
* service.
*/
public
fun capacityProviderStrategies(capacityProviderStrategies: List)
/**
* @param capacityProviderStrategies A list of Capacity Provider strategies used to place a
* service.
*/
public fun capacityProviderStrategies(vararg
capacityProviderStrategies: CapacityProviderStrategy)
/**
* @param circuitBreaker Whether to enable the deployment circuit breaker.
* If this property is defined, circuit breaker will be implicitly
* enabled.
*/
public fun circuitBreaker(circuitBreaker: DeploymentCircuitBreaker)
/**
* @param circuitBreaker Whether to enable the deployment circuit breaker.
* If this property is defined, circuit breaker will be implicitly
* enabled.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("c999ac5daea0c2b83243c96177c8edd645c3ba1de4636033ae014106c0343741")
public fun circuitBreaker(circuitBreaker: DeploymentCircuitBreaker.Builder.() -> Unit)
/**
* @param cloudMapOptions The options for configuring an Amazon ECS service to use service
* discovery.
*/
public fun cloudMapOptions(cloudMapOptions: CloudMapOptions)
/**
* @param cloudMapOptions The options for configuring an Amazon ECS service to use service
* discovery.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("fb9c650185d979903d62c6e0cc5a09b8219b9220d03bb9e13854afa88d61a1dc")
public fun cloudMapOptions(cloudMapOptions: CloudMapOptions.Builder.() -> Unit)
/**
* @param cluster The name of the cluster that hosts the service.
*/
public fun cluster(cluster: ICluster)
/**
* @param deploymentAlarms The alarm(s) to monitor during deployment, and behavior to apply if
* at least one enters a state of alarm during the deployment or bake time.
*/
public fun deploymentAlarms(deploymentAlarms: DeploymentAlarmConfig)
/**
* @param deploymentAlarms The alarm(s) to monitor during deployment, and behavior to apply if
* at least one enters a state of alarm during the deployment or bake time.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("e7c1ae9d7908b681d4aa2532cef441342ce3e35867fa356b27c8ee91560500e7")
public fun deploymentAlarms(deploymentAlarms: DeploymentAlarmConfig.Builder.() -> Unit)
/**
* @param deploymentController Specifies which deployment controller to use for the service.
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*/
public fun deploymentController(deploymentController: DeploymentController)
/**
* @param deploymentController Specifies which deployment controller to use for the service.
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("3c359889b51a11ae1c71de6f4d1ba9555ced43f01430b0969d0f932ab78cbe5d")
public fun deploymentController(deploymentController: DeploymentController.Builder.() -> Unit)
/**
* @param desiredCount The desired number of instantiations of the task definition to keep
* running on the service.
*/
public fun desiredCount(desiredCount: Number)
/**
* @param enableEcsManagedTags Specifies whether to enable Amazon ECS managed tags for the tasks
* within the service.
* For more information, see
* [Tagging Your Amazon ECS
* Resources](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)
*/
public fun enableEcsManagedTags(enableEcsManagedTags: Boolean)
/**
* @param enableExecuteCommand Whether to enable the ability to execute into a container.
*/
public fun enableExecuteCommand(enableExecuteCommand: Boolean)
/**
* @param healthCheckGracePeriod The period of time, in seconds, that the Amazon ECS service
* scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first
* started.
*/
public fun healthCheckGracePeriod(healthCheckGracePeriod: Duration)
/**
* @param maxHealthyPercent The maximum number of tasks, specified as a percentage of the Amazon
* ECS service's DesiredCount value, that can run in a service during a deployment.
*/
public fun maxHealthyPercent(maxHealthyPercent: Number)
/**
* @param minHealthyPercent The minimum number of tasks, specified as a percentage of the Amazon
* ECS service's DesiredCount value, that must continue to run and remain healthy during a
* deployment.
*/
public fun minHealthyPercent(minHealthyPercent: Number)
/**
* @param propagateTags Specifies whether to propagate the tags from the task definition or the
* service to the tasks in the service.
* Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or
* PropagatedTagSource.NONE
*/
public fun propagateTags(propagateTags: PropagatedTagSource)
/**
* @param serviceConnectConfiguration Configuration for Service Connect.
*/
public fun serviceConnectConfiguration(serviceConnectConfiguration: ServiceConnectProps)
/**
* @param serviceConnectConfiguration Configuration for Service Connect.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("2f57b3ab3598fda7cc799ffa927eca7cbad5b200505ff3f1d84f5653b550cec9")
public
fun serviceConnectConfiguration(serviceConnectConfiguration: ServiceConnectProps.Builder.() -> Unit)
/**
* @param serviceName The name of the service.
*/
public fun serviceName(serviceName: String)
/**
* @param taskDefinitionRevision Revision number for the task definition or `latest` to use the
* latest active task revision.
*/
public fun taskDefinitionRevision(taskDefinitionRevision: TaskDefinitionRevision)
/**
* @param volumeConfigurations Configuration details for a volume used by the service.
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*/
public fun volumeConfigurations(volumeConfigurations: List)
/**
* @param volumeConfigurations Configuration details for a volume used by the service.
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*/
public fun volumeConfigurations(vararg volumeConfigurations: ServiceManagedVolume)
}
private class BuilderImpl : Builder {
private val cdkBuilder: software.amazon.awscdk.services.ecs.BaseServiceOptions.Builder =
software.amazon.awscdk.services.ecs.BaseServiceOptions.builder()
/**
* @param capacityProviderStrategies A list of Capacity Provider strategies used to place a
* service.
*/
override
fun capacityProviderStrategies(capacityProviderStrategies: List) {
cdkBuilder.capacityProviderStrategies(capacityProviderStrategies.map(CapacityProviderStrategy.Companion::unwrap))
}
/**
* @param capacityProviderStrategies A list of Capacity Provider strategies used to place a
* service.
*/
override fun capacityProviderStrategies(vararg
capacityProviderStrategies: CapacityProviderStrategy): Unit =
capacityProviderStrategies(capacityProviderStrategies.toList())
/**
* @param circuitBreaker Whether to enable the deployment circuit breaker.
* If this property is defined, circuit breaker will be implicitly
* enabled.
*/
override fun circuitBreaker(circuitBreaker: DeploymentCircuitBreaker) {
cdkBuilder.circuitBreaker(circuitBreaker.let(DeploymentCircuitBreaker.Companion::unwrap))
}
/**
* @param circuitBreaker Whether to enable the deployment circuit breaker.
* If this property is defined, circuit breaker will be implicitly
* enabled.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("c999ac5daea0c2b83243c96177c8edd645c3ba1de4636033ae014106c0343741")
override fun circuitBreaker(circuitBreaker: DeploymentCircuitBreaker.Builder.() -> Unit): Unit =
circuitBreaker(DeploymentCircuitBreaker(circuitBreaker))
/**
* @param cloudMapOptions The options for configuring an Amazon ECS service to use service
* discovery.
*/
override fun cloudMapOptions(cloudMapOptions: CloudMapOptions) {
cdkBuilder.cloudMapOptions(cloudMapOptions.let(CloudMapOptions.Companion::unwrap))
}
/**
* @param cloudMapOptions The options for configuring an Amazon ECS service to use service
* discovery.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("fb9c650185d979903d62c6e0cc5a09b8219b9220d03bb9e13854afa88d61a1dc")
override fun cloudMapOptions(cloudMapOptions: CloudMapOptions.Builder.() -> Unit): Unit =
cloudMapOptions(CloudMapOptions(cloudMapOptions))
/**
* @param cluster The name of the cluster that hosts the service.
*/
override fun cluster(cluster: ICluster) {
cdkBuilder.cluster(cluster.let(ICluster.Companion::unwrap))
}
/**
* @param deploymentAlarms The alarm(s) to monitor during deployment, and behavior to apply if
* at least one enters a state of alarm during the deployment or bake time.
*/
override fun deploymentAlarms(deploymentAlarms: DeploymentAlarmConfig) {
cdkBuilder.deploymentAlarms(deploymentAlarms.let(DeploymentAlarmConfig.Companion::unwrap))
}
/**
* @param deploymentAlarms The alarm(s) to monitor during deployment, and behavior to apply if
* at least one enters a state of alarm during the deployment or bake time.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("e7c1ae9d7908b681d4aa2532cef441342ce3e35867fa356b27c8ee91560500e7")
override fun deploymentAlarms(deploymentAlarms: DeploymentAlarmConfig.Builder.() -> Unit): Unit
= deploymentAlarms(DeploymentAlarmConfig(deploymentAlarms))
/**
* @param deploymentController Specifies which deployment controller to use for the service.
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*/
override fun deploymentController(deploymentController: DeploymentController) {
cdkBuilder.deploymentController(deploymentController.let(DeploymentController.Companion::unwrap))
}
/**
* @param deploymentController Specifies which deployment controller to use for the service.
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("3c359889b51a11ae1c71de6f4d1ba9555ced43f01430b0969d0f932ab78cbe5d")
override
fun deploymentController(deploymentController: DeploymentController.Builder.() -> Unit):
Unit = deploymentController(DeploymentController(deploymentController))
/**
* @param desiredCount The desired number of instantiations of the task definition to keep
* running on the service.
*/
override fun desiredCount(desiredCount: Number) {
cdkBuilder.desiredCount(desiredCount)
}
/**
* @param enableEcsManagedTags Specifies whether to enable Amazon ECS managed tags for the tasks
* within the service.
* For more information, see
* [Tagging Your Amazon ECS
* Resources](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)
*/
override fun enableEcsManagedTags(enableEcsManagedTags: Boolean) {
cdkBuilder.enableEcsManagedTags(enableEcsManagedTags)
}
/**
* @param enableExecuteCommand Whether to enable the ability to execute into a container.
*/
override fun enableExecuteCommand(enableExecuteCommand: Boolean) {
cdkBuilder.enableExecuteCommand(enableExecuteCommand)
}
/**
* @param healthCheckGracePeriod The period of time, in seconds, that the Amazon ECS service
* scheduler ignores unhealthy Elastic Load Balancing target health checks after a task has first
* started.
*/
override fun healthCheckGracePeriod(healthCheckGracePeriod: Duration) {
cdkBuilder.healthCheckGracePeriod(healthCheckGracePeriod.let(Duration.Companion::unwrap))
}
/**
* @param maxHealthyPercent The maximum number of tasks, specified as a percentage of the Amazon
* ECS service's DesiredCount value, that can run in a service during a deployment.
*/
override fun maxHealthyPercent(maxHealthyPercent: Number) {
cdkBuilder.maxHealthyPercent(maxHealthyPercent)
}
/**
* @param minHealthyPercent The minimum number of tasks, specified as a percentage of the Amazon
* ECS service's DesiredCount value, that must continue to run and remain healthy during a
* deployment.
*/
override fun minHealthyPercent(minHealthyPercent: Number) {
cdkBuilder.minHealthyPercent(minHealthyPercent)
}
/**
* @param propagateTags Specifies whether to propagate the tags from the task definition or the
* service to the tasks in the service.
* Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or
* PropagatedTagSource.NONE
*/
override fun propagateTags(propagateTags: PropagatedTagSource) {
cdkBuilder.propagateTags(propagateTags.let(PropagatedTagSource.Companion::unwrap))
}
/**
* @param serviceConnectConfiguration Configuration for Service Connect.
*/
override fun serviceConnectConfiguration(serviceConnectConfiguration: ServiceConnectProps) {
cdkBuilder.serviceConnectConfiguration(serviceConnectConfiguration.let(ServiceConnectProps.Companion::unwrap))
}
/**
* @param serviceConnectConfiguration Configuration for Service Connect.
*/
@kotlin.Suppress("INAPPLICABLE_JVM_NAME")
@JvmName("2f57b3ab3598fda7cc799ffa927eca7cbad5b200505ff3f1d84f5653b550cec9")
override
fun serviceConnectConfiguration(serviceConnectConfiguration: ServiceConnectProps.Builder.() -> Unit):
Unit = serviceConnectConfiguration(ServiceConnectProps(serviceConnectConfiguration))
/**
* @param serviceName The name of the service.
*/
override fun serviceName(serviceName: String) {
cdkBuilder.serviceName(serviceName)
}
/**
* @param taskDefinitionRevision Revision number for the task definition or `latest` to use the
* latest active task revision.
*/
override fun taskDefinitionRevision(taskDefinitionRevision: TaskDefinitionRevision) {
cdkBuilder.taskDefinitionRevision(taskDefinitionRevision.let(TaskDefinitionRevision.Companion::unwrap))
}
/**
* @param volumeConfigurations Configuration details for a volume used by the service.
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*/
override fun volumeConfigurations(volumeConfigurations: List) {
cdkBuilder.volumeConfigurations(volumeConfigurations.map(ServiceManagedVolume.Companion::unwrap))
}
/**
* @param volumeConfigurations Configuration details for a volume used by the service.
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*/
override fun volumeConfigurations(vararg volumeConfigurations: ServiceManagedVolume): Unit =
volumeConfigurations(volumeConfigurations.toList())
public fun build(): software.amazon.awscdk.services.ecs.BaseServiceOptions = cdkBuilder.build()
}
private class Wrapper(
cdkObject: software.amazon.awscdk.services.ecs.BaseServiceOptions,
) : CdkObject(cdkObject),
BaseServiceOptions {
/**
* A list of Capacity Provider strategies used to place a service.
*
* Default: - undefined
*/
override fun capacityProviderStrategies(): List =
unwrap(this).getCapacityProviderStrategies()?.map(CapacityProviderStrategy::wrap) ?:
emptyList()
/**
* Whether to enable the deployment circuit breaker.
*
* If this property is defined, circuit breaker will be implicitly
* enabled.
*
* Default: - disabled
*/
override fun circuitBreaker(): DeploymentCircuitBreaker? =
unwrap(this).getCircuitBreaker()?.let(DeploymentCircuitBreaker::wrap)
/**
* The options for configuring an Amazon ECS service to use service discovery.
*
* Default: - AWS Cloud Map service discovery is not enabled.
*/
override fun cloudMapOptions(): CloudMapOptions? =
unwrap(this).getCloudMapOptions()?.let(CloudMapOptions::wrap)
/**
* The name of the cluster that hosts the service.
*/
override fun cluster(): ICluster = unwrap(this).getCluster().let(ICluster::wrap)
/**
* The alarm(s) to monitor during deployment, and behavior to apply if at least one enters a
* state of alarm during the deployment or bake time.
*
* Default: - No alarms will be monitored during deployment.
*/
override fun deploymentAlarms(): DeploymentAlarmConfig? =
unwrap(this).getDeploymentAlarms()?.let(DeploymentAlarmConfig::wrap)
/**
* Specifies which deployment controller to use for the service.
*
* For more information, see
* [Amazon ECS Deployment
* Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html)
*
* Default: - Rolling update (ECS)
*/
override fun deploymentController(): DeploymentController? =
unwrap(this).getDeploymentController()?.let(DeploymentController::wrap)
/**
* The desired number of instantiations of the task definition to keep running on the service.
*
* Default: - When creating the service, default is 1; when updating the service, default uses
* the current task number.
*/
override fun desiredCount(): Number? = unwrap(this).getDesiredCount()
/**
* Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
*
* For more information, see
* [Tagging Your Amazon ECS
* Resources](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)
*
* Default: false
*/
override fun enableECSManagedTags(): Boolean? = unwrap(this).getEnableECSManagedTags()
/**
* Whether to enable the ability to execute into a container.
*
* Default: - undefined
*/
override fun enableExecuteCommand(): Boolean? = unwrap(this).getEnableExecuteCommand()
/**
* The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy
* Elastic Load Balancing target health checks after a task has first started.
*
* Default: - defaults to 60 seconds if at least one load balancer is in-use and it is not
* already set
*/
override fun healthCheckGracePeriod(): Duration? =
unwrap(this).getHealthCheckGracePeriod()?.let(Duration::wrap)
/**
* The maximum number of tasks, specified as a percentage of the Amazon ECS service's
* DesiredCount value, that can run in a service during a deployment.
*
* Default: - 100 if daemon, otherwise 200
*/
override fun maxHealthyPercent(): Number? = unwrap(this).getMaxHealthyPercent()
/**
* The minimum number of tasks, specified as a percentage of the Amazon ECS service's
* DesiredCount value, that must continue to run and remain healthy during a deployment.
*
* Default: - 0 if daemon, otherwise 50
*/
override fun minHealthyPercent(): Number? = unwrap(this).getMinHealthyPercent()
/**
* Specifies whether to propagate the tags from the task definition or the service to the tasks
* in the service.
*
* Valid values are: PropagatedTagSource.SERVICE, PropagatedTagSource.TASK_DEFINITION or
* PropagatedTagSource.NONE
*
* Default: PropagatedTagSource.NONE
*/
override fun propagateTags(): PropagatedTagSource? =
unwrap(this).getPropagateTags()?.let(PropagatedTagSource::wrap)
/**
* Configuration for Service Connect.
*
* Default: No ports are advertised via Service Connect on this service, and the service
* cannot make requests to other services via Service Connect.
*/
override fun serviceConnectConfiguration(): ServiceConnectProps? =
unwrap(this).getServiceConnectConfiguration()?.let(ServiceConnectProps::wrap)
/**
* The name of the service.
*
* Default: - CloudFormation-generated name.
*/
override fun serviceName(): String? = unwrap(this).getServiceName()
/**
* Revision number for the task definition or `latest` to use the latest active task revision.
*
* Default: - Uses the revision of the passed task definition deployed by CloudFormation
*/
override fun taskDefinitionRevision(): TaskDefinitionRevision? =
unwrap(this).getTaskDefinitionRevision()?.let(TaskDefinitionRevision::wrap)
/**
* Configuration details for a volume used by the service.
*
* This allows you to specify
* details about the EBS volume that can be attched to ECS tasks.
*
* Default: - undefined
*/
override fun volumeConfigurations(): List =
unwrap(this).getVolumeConfigurations()?.map(ServiceManagedVolume::wrap) ?: emptyList()
}
public companion object {
public operator fun invoke(block: Builder.() -> Unit = {}): BaseServiceOptions {
val builderImpl = BuilderImpl()
return Wrapper(builderImpl.apply(block).build())
}
internal fun wrap(cdkObject: software.amazon.awscdk.services.ecs.BaseServiceOptions):
BaseServiceOptions = CdkObjectWrappers.wrap(cdkObject) as? BaseServiceOptions ?:
Wrapper(cdkObject)
internal fun unwrap(wrapped: BaseServiceOptions):
software.amazon.awscdk.services.ecs.BaseServiceOptions = (wrapped as CdkObject).cdkObject as
software.amazon.awscdk.services.ecs.BaseServiceOptions
}
}