aws-cdk-lib 2.149.0__py3-none-any.whl → 2.151.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of aws-cdk-lib might be problematic. Click here for more details.
- aws_cdk/__init__.py +6 -16
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.149.0.jsii.tgz → aws-cdk-lib@2.151.0.jsii.tgz} +0 -0
- aws_cdk/aws_apigatewayv2/__init__.py +94 -21
- aws_cdk/aws_appconfig/__init__.py +3 -3
- aws_cdk/aws_backup/__init__.py +3 -3
- aws_cdk/aws_bedrock/__init__.py +58 -46
- aws_cdk/aws_cleanrooms/__init__.py +5 -5
- aws_cdk/aws_cloudformation/__init__.py +4 -8
- aws_cdk/aws_cloudfront/__init__.py +102 -32
- aws_cdk/aws_cloudtrail/__init__.py +34 -558
- aws_cdk/aws_cloudwatch/__init__.py +1 -1
- aws_cdk/aws_codepipeline/__init__.py +11 -5
- aws_cdk/aws_cognito/__init__.py +1 -2
- aws_cdk/aws_ec2/__init__.py +263 -7
- aws_cdk/aws_ecs/__init__.py +16 -10
- aws_cdk/aws_eks/__init__.py +26 -20
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +106 -11
- aws_cdk/aws_emr/__init__.py +18 -20
- aws_cdk/aws_entityresolution/__init__.py +27 -21
- aws_cdk/aws_events/__init__.py +83 -16
- aws_cdk/aws_fsx/__init__.py +25 -23
- aws_cdk/aws_glue/__init__.py +3 -3
- aws_cdk/aws_guardduty/__init__.py +6 -4
- aws_cdk/aws_iam/__init__.py +19 -29
- aws_cdk/aws_iotsitewise/__init__.py +8 -8
- aws_cdk/aws_lambda/__init__.py +21 -2
- aws_cdk/aws_logs/__init__.py +9 -0
- aws_cdk/aws_mwaa/__init__.py +3 -3
- aws_cdk/aws_pipes/__init__.py +2 -2
- aws_cdk/aws_qbusiness/__init__.py +21 -7
- aws_cdk/aws_rds/__init__.py +252 -206
- aws_cdk/aws_s3/__init__.py +8 -2
- aws_cdk/aws_sagemaker/__init__.py +10 -10
- aws_cdk/aws_ses/__init__.py +3 -3
- aws_cdk/aws_sns/__init__.py +5 -2
- aws_cdk/aws_stepfunctions/__init__.py +5 -2
- aws_cdk/aws_stepfunctions_tasks/__init__.py +23 -8
- aws_cdk/aws_synthetics/__init__.py +174 -22
- aws_cdk/custom_resources/__init__.py +91 -23
- aws_cdk/pipelines/__init__.py +1 -1
- aws_cdk/region_info/__init__.py +32 -12
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/RECORD +48 -48
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.149.0.dist-info → aws_cdk_lib-2.151.0.dist-info}/top_level.txt +0 -0
aws_cdk/aws_ecs/__init__.py
CHANGED
|
@@ -517,7 +517,7 @@ To grant a principal permission to run your `TaskDefinition`, you can use the `T
|
|
|
517
517
|
# role: iam.IGrantable
|
|
518
518
|
|
|
519
519
|
task_def = ecs.TaskDefinition(self, "TaskDef",
|
|
520
|
-
cpu="
|
|
520
|
+
cpu="256",
|
|
521
521
|
memory_mi_b="512",
|
|
522
522
|
compatibility=ecs.Compatibility.EC2_AND_FARGATE
|
|
523
523
|
)
|
|
@@ -9605,7 +9605,7 @@ class CfnService(
|
|
|
9605
9605
|
- For tasks that are hosted on Amazon EC2 instances, the Amazon ECS container agent must register the available logging drivers with the ``ECS_AVAILABLE_LOGGING_DRIVERS`` environment variable before containers placed on that instance can use these log configuration options. For more information, see `Amazon ECS container agent configuration <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-config.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9606
9606
|
- For tasks that are on AWS Fargate , because you don't have access to the underlying infrastructure your tasks are hosted on, any additional software needed must be installed outside of the task. For example, the Fluentd output aggregators or a remote host running Logstash to send Gelf logs to.
|
|
9607
9607
|
|
|
9608
|
-
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
9608
|
+
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` . For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* . For more information about using the ``awsfirelens`` log driver, see `Send Amazon ECS logs to an AWS service or AWS Partner <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html>`_ . .. epigraph:: If you have a custom driver that isn't listed, you can fork the Amazon ECS container agent project that's `available on GitHub <https://docs.aws.amazon.com/https://github.com/aws/amazon-ecs-agent>`_ and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, we don't currently provide support for running modified copies of this software.
|
|
9609
9609
|
:param options: The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'``
|
|
9610
9610
|
:param secret_options: The secrets to pass to the log configuration. For more information, see `Specifying sensitive data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9611
9611
|
|
|
@@ -9648,7 +9648,7 @@ class CfnService(
|
|
|
9648
9648
|
|
|
9649
9649
|
For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` .
|
|
9650
9650
|
|
|
9651
|
-
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
9651
|
+
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` .
|
|
9652
9652
|
|
|
9653
9653
|
For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
9654
9654
|
|
|
@@ -12090,7 +12090,7 @@ class CfnTaskDefinition(
|
|
|
12090
12090
|
:param scope: Scope in which this resource is defined.
|
|
12091
12091
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
12092
12092
|
:param container_definitions: A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see `Amazon ECS Task Definitions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12093
|
-
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
12093
|
+
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs). The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
12094
12094
|
:param ephemeral_storage: The ephemeral storage settings to use for tasks run with the task definition.
|
|
12095
12095
|
:param execution_role_arn: The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make AWS API calls on your behalf. For informationabout the required IAM roles for Amazon ECS, see `IAM roles for Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12096
12096
|
:param family: The name of a family that this task definition is registered to. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. A family groups multiple versions of a task definition. Amazon ECS gives the first task definition that you registered to a family a revision number of 1. Amazon ECS gives sequential revision numbers to each task definition that you add. .. epigraph:: To use revision numbers when you update a task definition, specify this property. If you don't specify a value, AWS CloudFormation generates a new task definition each time that you update it.
|
|
@@ -12644,7 +12644,7 @@ class CfnTaskDefinition(
|
|
|
12644
12644
|
:param repository_credentials: The private repository authentication credentials to use.
|
|
12645
12645
|
:param resource_requirements: The type and amount of a resource to assign to a container. The only supported resource is a GPU.
|
|
12646
12646
|
:param secrets: The secrets to pass to the container. For more information, see `Specifying Sensitive Data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
12647
|
-
:param start_timeout: Time duration (in seconds) to wait before giving up on resolving dependencies for a container. For example, you specify two containers in a task definition with containerA having a dependency on containerB reaching a ``COMPLETE`` , ``SUCCESS`` , or ``HEALTHY`` status. If a ``startTimeout`` value is specified for containerB and it doesn't reach the desired status within that time then containerA gives up and not start. This results in the task transitioning to a ``STOPPED`` state. .. epigraph:: When the ``ECS_CONTAINER_START_TIMEOUT`` container agent configuration variable is used, it's enforced independently from this start timeout value. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values are 2-120 seconds.
|
|
12647
|
+
:param start_timeout: Time duration (in seconds) to wait before giving up on resolving dependencies for a container. For example, you specify two containers in a task definition with containerA having a dependency on containerB reaching a ``COMPLETE`` , ``SUCCESS`` , or ``HEALTHY`` status. If a ``startTimeout`` value is specified for containerB and it doesn't reach the desired status within that time then containerA gives up and not start. This results in the task transitioning to a ``STOPPED`` state. .. epigraph:: When the ``ECS_CONTAINER_START_TIMEOUT`` container agent configuration variable is used, it's enforced independently from this start timeout value. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values for Fargate are 2-120 seconds.
|
|
12648
12648
|
:param stop_timeout: Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit normally on its own. For tasks using the Fargate launch type, the task or service requires the following platforms: - Linux platform version ``1.3.0`` or later. - Windows platform version ``1.0.0`` or later. The max stop timeout value is 120 seconds and if the parameter is not specified, the default value of 30 seconds is used. For tasks that use the EC2 launch type, if the ``stopTimeout`` parameter isn't specified, the value set for the Amazon ECS container agent configuration variable ``ECS_CONTAINER_STOP_TIMEOUT`` is used. If neither the ``stopTimeout`` parameter or the ``ECS_CONTAINER_STOP_TIMEOUT`` agent configuration variable are set, then the default values of 30 seconds for Linux containers and 30 seconds on Windows containers are used. Your container instances require at least version 1.26.0 of the container agent to use a container stop timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* . The valid values are 2-120 seconds.
|
|
12649
12649
|
:param system_controls: A list of namespaced kernel parameters to set in the container. This parameter maps to ``Sysctls`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--sysctl`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/#security-configuration>`_ . For example, you can configure ``net.ipv4.tcp_keepalive_time`` setting to maintain longer lived connections.
|
|
12650
12650
|
:param ulimits: A list of ``ulimits`` to set in the container. This parameter maps to ``Ulimits`` in the `Create a container <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/#operation/ContainerCreate>`_ section of the `Docker Remote API <https://docs.aws.amazon.com/https://docs.docker.com/engine/api/v1.35/>`_ and the ``--ulimit`` option to `docker run <https://docs.aws.amazon.com/https://docs.docker.com/engine/reference/run/>`_ . Valid naming values are displayed in the `Ulimit <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Ulimit.html>`_ data type. This parameter requires version 1.18 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'`` .. epigraph:: This parameter is not supported for Windows containers.
|
|
@@ -13467,7 +13467,7 @@ class CfnTaskDefinition(
|
|
|
13467
13467
|
|
|
13468
13468
|
For tasks using the EC2 launch type, your container instances require at least version ``1.26.0`` of the container agent to use a container start timeout value. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see `Updating the Amazon ECS Container Agent <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-agent-update.html>`_ in the *Amazon Elastic Container Service Developer Guide* . If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version ``1.26.0-1`` of the ``ecs-init`` package. If your container instances are launched from version ``20190301`` or later, then they contain the required versions of the container agent and ``ecs-init`` . For more information, see `Amazon ECS-optimized Linux AMI <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-optimized_AMI.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
13469
13469
|
|
|
13470
|
-
The valid values are 2-120 seconds.
|
|
13470
|
+
The valid values for Fargate are 2-120 seconds.
|
|
13471
13471
|
|
|
13472
13472
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-containerdefinition.html#cfn-ecs-taskdefinition-containerdefinition-starttimeout
|
|
13473
13473
|
'''
|
|
@@ -15196,7 +15196,7 @@ class CfnTaskDefinition(
|
|
|
15196
15196
|
) -> None:
|
|
15197
15197
|
'''The ``LogConfiguration`` property specifies log configuration options to send to a custom log driver for the container.
|
|
15198
15198
|
|
|
15199
|
-
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
15199
|
+
:param log_driver: The log driver to use for the container. For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` . For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` . For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* . For more information about using the ``awsfirelens`` log driver, see `Send Amazon ECS logs to an AWS service or AWS Partner <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_firelens.html>`_ . .. epigraph:: If you have a custom driver that isn't listed, you can fork the Amazon ECS container agent project that's `available on GitHub <https://docs.aws.amazon.com/https://github.com/aws/amazon-ecs-agent>`_ and customize it to work with that driver. We encourage you to submit pull requests for changes that you would like to have included. However, we don't currently provide support for running modified copies of this software.
|
|
15200
15200
|
:param options: The configuration options to send to the log driver. This parameter requires version 1.19 of the Docker Remote API or greater on your container instance. To check the Docker Remote API version on your container instance, log in to your container instance and run the following command: ``sudo docker version --format '{{.Server.APIVersion}}'``
|
|
15201
15201
|
:param secret_options: The secrets to pass to the log configuration. For more information, see `Specifying sensitive data <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/specifying-sensitive-data.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
15202
15202
|
|
|
@@ -15241,7 +15241,7 @@ class CfnTaskDefinition(
|
|
|
15241
15241
|
|
|
15242
15242
|
For tasks on AWS Fargate , the supported log drivers are ``awslogs`` , ``splunk`` , and ``awsfirelens`` .
|
|
15243
15243
|
|
|
15244
|
-
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``
|
|
15244
|
+
For tasks hosted on Amazon EC2 instances, the supported log drivers are ``awslogs`` , ``fluentd`` , ``gelf`` , ``json-file`` , ``journald`` , ``syslog`` , ``splunk`` , and ``awsfirelens`` .
|
|
15245
15245
|
|
|
15246
15246
|
For more information about using the ``awslogs`` log driver, see `Send Amazon ECS logs to CloudWatch <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/using_awslogs.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
15247
15247
|
|
|
@@ -16666,7 +16666,7 @@ class CfnTaskDefinitionProps:
|
|
|
16666
16666
|
'''Properties for defining a ``CfnTaskDefinition``.
|
|
16667
16667
|
|
|
16668
16668
|
:param container_definitions: A list of container definitions in JSON format that describe the different containers that make up your task. For more information about container definition parameters and defaults, see `Amazon ECS Task Definitions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_defintions.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
16669
|
-
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
16669
|
+
:param cpu: The number of ``cpu`` units used by the task. If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter. If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs). The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate. - 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB) - 512 (.5 vCPU) - Available ``memory`` values: 1024 (1 GB), 2048 (2 GB), 3072 (3 GB), 4096 (4 GB) - 1024 (1 vCPU) - Available ``memory`` values: 2048 (2 GB), 3072 (3 GB), 4096 (4 GB), 5120 (5 GB), 6144 (6 GB), 7168 (7 GB), 8192 (8 GB) - 2048 (2 vCPU) - Available ``memory`` values: 4096 (4 GB) and 16384 (16 GB) in increments of 1024 (1 GB) - 4096 (4 vCPU) - Available ``memory`` values: 8192 (8 GB) and 30720 (30 GB) in increments of 1024 (1 GB) - 8192 (8 vCPU) - Available ``memory`` values: 16 GB and 60 GB in 4 GB increments This option requires Linux platform ``1.4.0`` or later. - 16384 (16vCPU) - Available ``memory`` values: 32GB and 120 GB in 8 GB increments This option requires Linux platform ``1.4.0`` or later.
|
|
16670
16670
|
:param ephemeral_storage: The ephemeral storage settings to use for tasks run with the task definition.
|
|
16671
16671
|
:param execution_role_arn: The Amazon Resource Name (ARN) of the task execution role that grants the Amazon ECS container agent permission to make AWS API calls on your behalf. For informationabout the required IAM roles for Amazon ECS, see `IAM roles for Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/security-ecs-iam-role-overview.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
16672
16672
|
:param family: The name of a family that this task definition is registered to. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed. A family groups multiple versions of a task definition. Amazon ECS gives the first task definition that you registered to a family a revision number of 1. Amazon ECS gives sequential revision numbers to each task definition that you add. .. epigraph:: To use revision numbers when you update a task definition, specify this property. If you don't specify a value, AWS CloudFormation generates a new task definition each time that you update it.
|
|
@@ -16979,6 +16979,8 @@ class CfnTaskDefinitionProps:
|
|
|
16979
16979
|
|
|
16980
16980
|
If you use the EC2 launch type, this field is optional. Any value can be used. If you use the Fargate launch type, this field is required. You must use one of the following values. The value that you choose determines your range of valid values for the ``memory`` parameter.
|
|
16981
16981
|
|
|
16982
|
+
If you use the EC2 launch type, this field is optional. Supported values are between ``128`` CPU units ( ``0.125`` vCPUs) and ``10240`` CPU units ( ``10`` vCPUs).
|
|
16983
|
+
|
|
16982
16984
|
The CPU units cannot be less than 1 vCPU when you use Windows containers on Fargate.
|
|
16983
16985
|
|
|
16984
16986
|
- 256 (.25 vCPU) - Available ``memory`` values: 512 (0.5 GB), 1024 (1 GB), 2048 (2 GB)
|
|
@@ -21436,7 +21438,7 @@ class ContainerImage(
|
|
|
21436
21438
|
'''Reference an image in an ECR repository.
|
|
21437
21439
|
|
|
21438
21440
|
:param repository: -
|
|
21439
|
-
:param tag:
|
|
21441
|
+
:param tag: If you don't specify this parameter, ``latest`` is used as default.
|
|
21440
21442
|
'''
|
|
21441
21443
|
if __debug__:
|
|
21442
21444
|
type_hints = typing.get_type_hints(_typecheckingstub__c7678d92c566cb839a4e76a199bb9ba47a55910493c94a6a2568984d1b6bd374)
|
|
@@ -30341,6 +30343,7 @@ class ListenerConfig(
|
|
|
30341
30343
|
listener: _ApplicationListener_e0620bf5,
|
|
30342
30344
|
*,
|
|
30343
30345
|
deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
|
|
30346
|
+
enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
|
|
30344
30347
|
health_check: typing.Optional[typing.Union[_HealthCheck_6f291880, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
30345
30348
|
load_balancing_algorithm_type: typing.Optional[_TargetGroupLoadBalancingAlgorithmType_ed070d6d] = None,
|
|
30346
30349
|
port: typing.Optional[jsii.Number] = None,
|
|
@@ -30358,6 +30361,7 @@ class ListenerConfig(
|
|
|
30358
30361
|
|
|
30359
30362
|
:param listener: -
|
|
30360
30363
|
:param deregistration_delay: The amount of time for Elastic Load Balancing to wait before deregistering a target. The range is 0-3600 seconds. Default: Duration.minutes(5)
|
|
30364
|
+
:param enable_anomaly_mitigation: Indicates whether anomaly mitigation is enabled. Only available when ``loadBalancingAlgorithmType`` is ``TargetGroupLoadBalancingAlgorithmType.WEIGHTED_RANDOM`` Default: false
|
|
30361
30365
|
:param health_check: Health check configuration. Default: - The default value for each property in this configuration varies depending on the target.
|
|
30362
30366
|
:param load_balancing_algorithm_type: The load balancing algorithm to select targets for routing requests. Default: round_robin.
|
|
30363
30367
|
:param port: The port on which the listener listens for requests. Default: Determined from protocol if known
|
|
@@ -30376,6 +30380,7 @@ class ListenerConfig(
|
|
|
30376
30380
|
check_type(argname="argument listener", value=listener, expected_type=type_hints["listener"])
|
|
30377
30381
|
props = _AddApplicationTargetsProps_76c7d190(
|
|
30378
30382
|
deregistration_delay=deregistration_delay,
|
|
30383
|
+
enable_anomaly_mitigation=enable_anomaly_mitigation,
|
|
30379
30384
|
health_check=health_check,
|
|
30380
30385
|
load_balancing_algorithm_type=load_balancing_algorithm_type,
|
|
30381
30386
|
port=port,
|
|
@@ -43738,6 +43743,7 @@ def _typecheckingstub__49e49c7f39199be5ac444df54afd1bd33a772db0f97806964e1456680
|
|
|
43738
43743
|
listener: _ApplicationListener_e0620bf5,
|
|
43739
43744
|
*,
|
|
43740
43745
|
deregistration_delay: typing.Optional[_Duration_4839e8c3] = None,
|
|
43746
|
+
enable_anomaly_mitigation: typing.Optional[builtins.bool] = None,
|
|
43741
43747
|
health_check: typing.Optional[typing.Union[_HealthCheck_6f291880, typing.Dict[builtins.str, typing.Any]]] = None,
|
|
43742
43748
|
load_balancing_algorithm_type: typing.Optional[_TargetGroupLoadBalancingAlgorithmType_ed070d6d] = None,
|
|
43743
43749
|
port: typing.Optional[jsii.Number] = None,
|
aws_cdk/aws_eks/__init__.py
CHANGED
|
@@ -65,6 +65,7 @@ In addition, the library also supports defining Kubernetes resource manifests wi
|
|
|
65
65
|
* [Manually importing k8s specs and CRD's](#manually-importing-k8s-specs-and-crds)
|
|
66
66
|
* [Patching Kubernetes Resources](#patching-kubernetes-resources)
|
|
67
67
|
* [Querying Kubernetes Resources](#querying-kubernetes-resources)
|
|
68
|
+
* [Add-ons](#add-ons)
|
|
68
69
|
* [Using existing clusters](#using-existing-clusters)
|
|
69
70
|
* [Logging](#logging)
|
|
70
71
|
* [Known Issues and Limitations](#known-issues-and-limitations)
|
|
@@ -1850,6 +1851,21 @@ Specifically, since the above use-case is quite common, there is an easier way t
|
|
|
1850
1851
|
load_balancer_address = cluster.get_service_load_balancer_address("my-service")
|
|
1851
1852
|
```
|
|
1852
1853
|
|
|
1854
|
+
## Add-ons
|
|
1855
|
+
|
|
1856
|
+
[Add-ons](https://docs.aws.amazon.com/eks/latest/userguide/eks-add-ons.html) is a software that provides supporting operational capabilities to Kubernetes applications. The EKS module supports adding add-ons to your cluster using the `eks.Addon` class.
|
|
1857
|
+
|
|
1858
|
+
```python
|
|
1859
|
+
# cluster: eks.Cluster
|
|
1860
|
+
|
|
1861
|
+
|
|
1862
|
+
eks.Addon(self, "Addon",
|
|
1863
|
+
cluster=cluster,
|
|
1864
|
+
addon_name="aws-guardduty-agent",
|
|
1865
|
+
addon_version="v1.6.1"
|
|
1866
|
+
)
|
|
1867
|
+
```
|
|
1868
|
+
|
|
1853
1869
|
## Using existing clusters
|
|
1854
1870
|
|
|
1855
1871
|
The Amazon EKS library allows defining Kubernetes resources such as [Kubernetes
|
|
@@ -2656,22 +2672,17 @@ class AddonProps:
|
|
|
2656
2672
|
:param cluster: The EKS cluster the Add-On is associated with.
|
|
2657
2673
|
:param addon_version: Version of the Add-On. You can check all available versions with describe-addon-versons. For example, this lists all available versions for the ``eks-pod-identity-agent`` addon: $ aws eks describe-addon-versions --addon-name eks-pod-identity-agent --query 'addons[*].addonVersions[*].addonVersion' Default: the latest version.
|
|
2658
2674
|
|
|
2659
|
-
:exampleMetadata:
|
|
2675
|
+
:exampleMetadata: infused
|
|
2660
2676
|
|
|
2661
2677
|
Example::
|
|
2662
2678
|
|
|
2663
|
-
# The code below shows an example of how to instantiate this type.
|
|
2664
|
-
# The values are placeholders you should change.
|
|
2665
|
-
from aws_cdk import aws_eks as eks
|
|
2666
|
-
|
|
2667
2679
|
# cluster: eks.Cluster
|
|
2668
2680
|
|
|
2669
|
-
addon_props = eks.AddonProps(
|
|
2670
|
-
addon_name="addonName",
|
|
2671
|
-
cluster=cluster,
|
|
2672
2681
|
|
|
2673
|
-
|
|
2674
|
-
|
|
2682
|
+
eks.Addon(self, "Addon",
|
|
2683
|
+
cluster=cluster,
|
|
2684
|
+
addon_name="aws-guardduty-agent",
|
|
2685
|
+
addon_version="v1.6.1"
|
|
2675
2686
|
)
|
|
2676
2687
|
'''
|
|
2677
2688
|
if __debug__:
|
|
@@ -16684,22 +16695,17 @@ class Addon(
|
|
|
16684
16695
|
):
|
|
16685
16696
|
'''Represents an Amazon EKS Add-On.
|
|
16686
16697
|
|
|
16687
|
-
:exampleMetadata:
|
|
16698
|
+
:exampleMetadata: infused
|
|
16688
16699
|
|
|
16689
16700
|
Example::
|
|
16690
16701
|
|
|
16691
|
-
# The code below shows an example of how to instantiate this type.
|
|
16692
|
-
# The values are placeholders you should change.
|
|
16693
|
-
from aws_cdk import aws_eks as eks
|
|
16694
|
-
|
|
16695
16702
|
# cluster: eks.Cluster
|
|
16696
16703
|
|
|
16697
|
-
addon = eks.Addon(self, "MyAddon",
|
|
16698
|
-
addon_name="addonName",
|
|
16699
|
-
cluster=cluster,
|
|
16700
16704
|
|
|
16701
|
-
|
|
16702
|
-
|
|
16705
|
+
eks.Addon(self, "Addon",
|
|
16706
|
+
cluster=cluster,
|
|
16707
|
+
addon_name="aws-guardduty-agent",
|
|
16708
|
+
addon_version="v1.6.1"
|
|
16703
16709
|
)
|
|
16704
16710
|
'''
|
|
16705
16711
|
|