awsx.ecs.EC2Service
Explore with Pulumi AI
Create an ECS Service resource for EC2 with the given unique name, arguments, and options.
Creates Task definition if taskDefinitionArgs
is specified.
Create EC2Service Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new EC2Service(name: string, args?: EC2ServiceArgs, opts?: CustomResourceOptions);
@overload
def EC2Service(resource_name: str,
args: Optional[EC2ServiceArgs] = None,
opts: Optional[ResourceOptions] = None)
@overload
def EC2Service(resource_name: str,
opts: Optional[ResourceOptions] = None,
alarms: Optional[pulumi_aws.ecs.ServiceAlarmsArgs] = None,
cluster: Optional[str] = None,
continue_before_steady_state: Optional[bool] = None,
deployment_circuit_breaker: Optional[pulumi_aws.ecs.ServiceDeploymentCircuitBreakerArgs] = None,
deployment_controller: Optional[pulumi_aws.ecs.ServiceDeploymentControllerArgs] = None,
deployment_maximum_percent: Optional[int] = None,
deployment_minimum_healthy_percent: Optional[int] = None,
desired_count: Optional[int] = None,
enable_ecs_managed_tags: Optional[bool] = None,
enable_execute_command: Optional[bool] = None,
force_new_deployment: Optional[bool] = None,
health_check_grace_period_seconds: Optional[int] = None,
iam_role: Optional[str] = None,
load_balancers: Optional[Sequence[pulumi_aws.ecs.ServiceLoadBalancerArgs]] = None,
name: Optional[str] = None,
network_configuration: Optional[pulumi_aws.ecs.ServiceNetworkConfigurationArgs] = None,
ordered_placement_strategies: Optional[Sequence[pulumi_aws.ecs.ServiceOrderedPlacementStrategyArgs]] = None,
placement_constraints: Optional[Sequence[pulumi_aws.ecs.ServicePlacementConstraintArgs]] = None,
platform_version: Optional[str] = None,
propagate_tags: Optional[str] = None,
scheduling_strategy: Optional[str] = None,
service_connect_configuration: Optional[pulumi_aws.ecs.ServiceServiceConnectConfigurationArgs] = None,
service_registries: Optional[pulumi_aws.ecs.ServiceServiceRegistriesArgs] = None,
tags: Optional[Mapping[str, str]] = None,
task_definition: Optional[str] = None,
task_definition_args: Optional[EC2ServiceTaskDefinitionArgs] = None,
triggers: Optional[Mapping[str, str]] = None)
func NewEC2Service(ctx *Context, name string, args *EC2ServiceArgs, opts ...ResourceOption) (*EC2Service, error)
public EC2Service(string name, EC2ServiceArgs? args = null, CustomResourceOptions? opts = null)
public EC2Service(String name, EC2ServiceArgs args)
public EC2Service(String name, EC2ServiceArgs args, CustomResourceOptions options)
type: awsx:ecs:EC2Service
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args EC2ServiceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args EC2ServiceArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args EC2ServiceArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args EC2ServiceArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args EC2ServiceArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
EC2Service Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The EC2Service resource accepts the following input properties:
- Alarms
Pulumi.
Aws. Ecs. Inputs. Service Alarms Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- Cluster string
- ARN of an ECS cluster.
- Continue
Before boolSteady State - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - Deployment
Circuit Pulumi.Breaker Aws. Ecs. Inputs. Service Deployment Circuit Breaker Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- Deployment
Controller Pulumi.Aws. Ecs. Inputs. Service Deployment Controller Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- Deployment
Maximum intPercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - Deployment
Minimum intHealthy Percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- Desired
Count int - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - bool
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- Enable
Execute boolCommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- Force
New boolDeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - Health
Check intGrace Period Seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- Iam
Role string - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - Load
Balancers List<Pulumi.Aws. Ecs. Inputs. Service Load Balancer> - Configuration block for load balancers. See below.
- Name string
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- Network
Configuration Pulumi.Aws. Ecs. Inputs. Service Network Configuration Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- Ordered
Placement List<Pulumi.Strategies Aws. Ecs. Inputs. Service Ordered Placement Strategy> - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - Placement
Constraints List<Pulumi.Aws. Ecs. Inputs. Service Placement Constraint> - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - Platform
Version string - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - string
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - Scheduling
Strategy string - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - Service
Connect Pulumi.Configuration Aws. Ecs. Inputs. Service Service Connect Configuration The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- Service
Registries Pulumi.Aws. Ecs. Inputs. Service Service Registries Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- Dictionary<string, string>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Definition string - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - Task
Definition EC2ServiceArgs Task Definition - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- Triggers Dictionary<string, string>
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
- Alarms
Service
Alarms Args Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- Cluster string
- ARN of an ECS cluster.
- Continue
Before boolSteady State - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - Deployment
Circuit ServiceBreaker Deployment Circuit Breaker Args Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- Deployment
Controller ServiceDeployment Controller Args Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- Deployment
Maximum intPercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - Deployment
Minimum intHealthy Percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- Desired
Count int - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - bool
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- Enable
Execute boolCommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- Force
New boolDeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - Health
Check intGrace Period Seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- Iam
Role string - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - Load
Balancers ServiceLoad Balancer Args - Configuration block for load balancers. See below.
- Name string
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- Network
Configuration ServiceNetwork Configuration Args Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- Ordered
Placement ServiceStrategies Ordered Placement Strategy Args - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - Placement
Constraints ServicePlacement Constraint Args - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - Platform
Version string - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - string
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - Scheduling
Strategy string - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - Service
Connect ServiceConfiguration Service Connect Configuration Args The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- Service
Registries ServiceService Registries Args Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- map[string]string
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Definition string - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - Task
Definition EC2ServiceArgs Task Definition Args - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- Triggers map[string]string
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
- alarms
Service
Alarms Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- cluster String
- ARN of an ECS cluster.
- continue
Before BooleanSteady State - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - deployment
Circuit ServiceBreaker Deployment Circuit Breaker Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- deployment
Controller ServiceDeployment Controller Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- deployment
Maximum IntegerPercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - deployment
Minimum IntegerHealthy Percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- desired
Count Integer - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - Boolean
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- enable
Execute BooleanCommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- force
New BooleanDeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - health
Check IntegerGrace Period Seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- iam
Role String - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - load
Balancers List<ServiceLoad Balancer> - Configuration block for load balancers. See below.
- name String
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- network
Configuration ServiceNetwork Configuration Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- ordered
Placement List<ServiceStrategies Ordered Placement Strategy> - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - placement
Constraints List<ServicePlacement Constraint> - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - platform
Version String - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - String
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - scheduling
Strategy String - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - service
Connect ServiceConfiguration Service Connect Configuration The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- service
Registries ServiceService Registries Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- Map<String,String>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Definition String - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - task
Definition EC2ServiceArgs Task Definition - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- triggers Map<String,String>
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
- alarms
pulumi
Aws.types.input. Service Alarms Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- cluster string
- ARN of an ECS cluster.
- continue
Before booleanSteady State - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - deployment
Circuit pulumiBreaker Aws.types.input. Service Deployment Circuit Breaker Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- deployment
Controller pulumiAws.types.input. Service Deployment Controller Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- deployment
Maximum numberPercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - deployment
Minimum numberHealthy Percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- desired
Count number - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - boolean
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- enable
Execute booleanCommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- force
New booleanDeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - health
Check numberGrace Period Seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- iam
Role string - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - load
Balancers pulumiAws.types.input. Service Load Balancer[] - Configuration block for load balancers. See below.
- name string
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- network
Configuration pulumiAws.types.input. Service Network Configuration Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- ordered
Placement pulumiStrategies Aws.types.input. Service Ordered Placement Strategy[] - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - placement
Constraints pulumiAws.types.input. Service Placement Constraint[] - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - platform
Version string - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - string
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - scheduling
Strategy string - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - service
Connect pulumiConfiguration Aws.types.input. Service Service Connect Configuration The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- service
Registries pulumiAws.types.input. Service Service Registries Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- {[key: string]: string}
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Definition string - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - task
Definition EC2ServiceArgs Task Definition - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- triggers {[key: string]: string}
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
- alarms
pulumi_
aws.ecs. Service Alarms Args Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- cluster str
- ARN of an ECS cluster.
- continue_
before_ boolsteady_ state - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - deployment_
circuit_ pulumi_breaker aws.ecs. Service Deployment Circuit Breaker Args Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- deployment_
controller pulumi_aws.ecs. Service Deployment Controller Args Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- deployment_
maximum_ intpercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - deployment_
minimum_ inthealthy_ percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- desired_
count int - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - bool
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- enable_
execute_ boolcommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- force_
new_ booldeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - health_
check_ intgrace_ period_ seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- iam_
role str - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - load_
balancers Sequence[pulumi_aws.ecs. Service Load Balancer Args] - Configuration block for load balancers. See below.
- name str
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- network_
configuration pulumi_aws.ecs. Service Network Configuration Args Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- ordered_
placement_ Sequence[pulumi_strategies aws.ecs. Service Ordered Placement Strategy Args] - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - placement_
constraints Sequence[pulumi_aws.ecs. Service Placement Constraint Args] - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - platform_
version str - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - str
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - scheduling_
strategy str - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - service_
connect_ pulumi_configuration aws.ecs. Service Service Connect Configuration Args The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- service_
registries pulumi_aws.ecs. Service Service Registries Args Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- Mapping[str, str]
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task_
definition str - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - task_
definition_ EC2Serviceargs Task Definition Args - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- triggers Mapping[str, str]
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
- alarms Property Map
Information about the CloudWatch alarms. See below.
This type is defined in the AWS Classic package.
- cluster String
- ARN of an ECS cluster.
- continue
Before BooleanSteady State - If
true
, this provider will not wait for the service to reach a steady state (likeaws ecs wait services-stable
) before continuing. Defaultfalse
. - deployment
Circuit Property MapBreaker Configuration block for deployment circuit breaker. See below.
This type is defined in the AWS Classic package.
- deployment
Controller Property Map Configuration block for deployment controller configuration. See below.
This type is defined in the AWS Classic package.
- deployment
Maximum NumberPercent - Upper limit (as a percentage of the service's desiredCount) of the number of running tasks that can be running in a service during a deployment. Not valid when using the
DAEMON
scheduling strategy. - deployment
Minimum NumberHealthy Percent - Lower limit (as a percentage of the service's desiredCount) of the number of running tasks that must remain running and healthy in a service during a deployment.
- desired
Count Number - Number of instances of the task definition to place and keep running. Defaults to 0. Do not specify if using the
DAEMON
scheduling strategy. - Boolean
- Specifies whether to enable Amazon ECS managed tags for the tasks within the service.
- enable
Execute BooleanCommand - Specifies whether to enable Amazon ECS Exec for the tasks within the service.
- force
New BooleanDeployment - Enable to force a new task deployment of the service. This can be used to update tasks to use a newer Docker image with same image/tag combination (e.g.,
myimage:latest
), roll Fargate tasks onto a newer platform version, or immediately deployordered_placement_strategy
andplacement_constraints
updates. - health
Check NumberGrace Period Seconds - Seconds to ignore failing load balancer health checks on newly instantiated tasks to prevent premature shutdown, up to 2147483647. Only valid for services configured to use load balancers.
- iam
Role String - ARN of the IAM role that allows Amazon ECS to make calls to your load balancer on your behalf. This parameter is required if you are using a load balancer with your service, but only if your task definition does not use the
awsvpc
network mode. If usingawsvpc
network mode, do not specify this role. If your account has already created the Amazon ECS service-linked role, that role is used by default for your service unless you specify a role here. - load
Balancers List<Property Map> - Configuration block for load balancers. See below.
- name String
Name of the service (up to 255 letters, numbers, hyphens, and underscores)
The following arguments are optional:
- network
Configuration Property Map Network configuration for the service. This parameter is required for task definitions that use the
awsvpc
network mode to receive their own Elastic Network Interface, and it is not supported for other network modes. See below.This type is defined in the AWS Classic package.
- ordered
Placement List<Property Map>Strategies - Service level strategy rules that are taken into consideration during task placement. List from top to bottom in order of precedence. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. The maximum number ofordered_placement_strategy
blocks is5
. See below. - placement
Constraints List<Property Map> - Rules that are taken into consideration during task placement. Updates to this configuration will take effect next task deployment unless
force_new_deployment
is enabled. Maximum number ofplacement_constraints
is10
. See below. - platform
Version String - Platform version on which to run your service. Only applicable for
launch_type
set toFARGATE
. Defaults toLATEST
. More information about Fargate platform versions can be found in the AWS ECS User Guide. - String
- Specifies whether to propagate the tags from the task definition or the service to the tasks. The valid values are
SERVICE
andTASK_DEFINITION
. - scheduling
Strategy String - Scheduling strategy to use for the service. The valid values are
REPLICA
andDAEMON
. Defaults toREPLICA
. Note that Tasks using the Fargate launch type or theCODE_DEPLOY
orEXTERNAL
deployment controller types don't support theDAEMON
scheduling strategy. - service
Connect Property MapConfiguration The ECS Service Connect configuration for this service to discover and connect to services, and be discovered by, and connected from, other services within a namespace. See below.
This type is defined in the AWS Classic package.
- service
Registries Property Map Service discovery registries for the service. The maximum number of
service_registries
blocks is1
. See below.This type is defined in the AWS Classic package.
- Map<String>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Definition String - Family and revision (
family:revision
) or full ARN of the task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided. - task
Definition Property MapArgs - The args of task definition that you want to run in your service. Either [taskDefinition] or [taskDefinitionArgs] must be provided.
- triggers Map<String>
- Map of arbitrary keys and values that, when changed, will trigger an in-place update (redeployment). Useful with
plantimestamp()
. See example above.
Outputs
All input properties are implicitly available as output properties. Additionally, the EC2Service resource produces the following output properties:
- Service
Pulumi.
Aws. Ecs. Service - Underlying ECS Service resource This type is defined in the AWS Classic package.
- Service Service
- Underlying ECS Service resource This type is defined in the AWS Classic package.
- service Service
- Underlying ECS Service resource This type is defined in the AWS Classic package.
- service
pulumi
Aws. Service - Underlying ECS Service resource This type is defined in the AWS Classic package.
- service
pulumi_
aws.ecs. Service - Underlying ECS Service resource This type is defined in the AWS Classic package.
- service aws::Service
- Underlying ECS Service resource This type is defined in the AWS Classic package.
Supporting Types
DefaultLogGroup, DefaultLogGroupArgs
- Args
Pulumi.
Awsx. Awsx. Inputs. Log Group - Arguments to use instead of the default values during creation.
- Existing
Pulumi.
Awsx. Awsx. Inputs. Existing Log Group - Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - Skip bool
- Skip creation of the log group.
- Args
Log
Group - Arguments to use instead of the default values during creation.
- Existing
Existing
Log Group - Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - Skip bool
- Skip creation of the log group.
- args
Log
Group - Arguments to use instead of the default values during creation.
- existing
Existing
Log Group - Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - skip Boolean
- Skip creation of the log group.
- args
awsx.
Log Group - Arguments to use instead of the default values during creation.
- existing
awsx.
Existing Log Group - Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - skip boolean
- Skip creation of the log group.
- args
awsx.
Log Group - Arguments to use instead of the default values during creation.
- existing
awsx.
Existing Log Group - Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - skip bool
- Skip creation of the log group.
- args Property Map
- Arguments to use instead of the default values during creation.
- existing Property Map
- Identity of an existing log group to use. Cannot be used in combination with
args
oropts
. - skip Boolean
- Skip creation of the log group.
DefaultRoleWithPolicy, DefaultRoleWithPolicyArgs
- Args
Pulumi.
Awsx. Awsx. Inputs. Role With Policy - Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - Role
Arn string - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - Skip bool
- Skips creation of the role if set to
true
.
- Args
Role
With Policy - Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - Role
Arn string - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - Skip bool
- Skips creation of the role if set to
true
.
- args
Role
With Policy - Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - role
Arn String - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - skip Boolean
- Skips creation of the role if set to
true
.
- args
awsx.
Role With Policy - Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - role
Arn string - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - skip boolean
- Skips creation of the role if set to
true
.
- args
awsx.
Role With Policy - Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - role_
arn str - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - skip bool
- Skips creation of the role if set to
true
.
- args Property Map
- Args to use when creating the role and policies. Can't be specified if
roleArn
is used. - role
Arn String - ARN of existing role to use instead of creating a new role. Cannot be used in combination with
args
oropts
. - skip Boolean
- Skips creation of the role if set to
true
.
EC2ServiceTaskDefinition, EC2ServiceTaskDefinitionArgs
- Container
Task
Definition Container Definition Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- Containers
Dictionary<string, Task
Definition Container Definition> All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- Cpu string
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- Ephemeral
Storage Pulumi.Aws. Ecs. Inputs. Task Definition Ephemeral Storage The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- Execution
Role Pulumi.Awsx. Awsx. Inputs. Default Role With Policy - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- Family string
- An optional unique name for your task definition. If not specified, then a default will be created.
- Inference
Accelerators List<Pulumi.Aws. Ecs. Inputs. Task Definition Inference Accelerator> - Configuration block(s) with Inference Accelerators settings. Detailed below.
- Ipc
Mode string - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - Log
Group Pulumi.Awsx. Awsx. Inputs. Default Log Group - A set of volume blocks that containers in your task may use.
- Memory string
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- Network
Mode string - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - Pid
Mode string - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - Placement
Constraints List<Pulumi.Aws. Ecs. Inputs. Task Definition Placement Constraint> - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - Proxy
Configuration Pulumi.Aws. Ecs. Inputs. Task Definition Proxy Configuration Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- Runtime
Platform Pulumi.Aws. Ecs. Inputs. Task Definition Runtime Platform Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- Skip
Destroy bool - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - Dictionary<string, string>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Role Pulumi.Awsx. Awsx. Inputs. Default Role With Policy - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- Track
Latest bool - Whether should track latest task definition or the one created with the resource. Default is
false
. - Volumes
List<Pulumi.
Aws. Ecs. Inputs. Task Definition Volume> - Configuration block for volumes that containers in your task may use. Detailed below.
- Container
Task
Definition Container Definition Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- Containers
map[string]Task
Definition Container Definition All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- Cpu string
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- Ephemeral
Storage TaskDefinition Ephemeral Storage The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- Execution
Role DefaultRole With Policy - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- Family string
- An optional unique name for your task definition. If not specified, then a default will be created.
- Inference
Accelerators TaskDefinition Inference Accelerator - Configuration block(s) with Inference Accelerators settings. Detailed below.
- Ipc
Mode string - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - Log
Group DefaultLog Group - A set of volume blocks that containers in your task may use.
- Memory string
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- Network
Mode string - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - Pid
Mode string - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - Placement
Constraints TaskDefinition Placement Constraint - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - Proxy
Configuration TaskDefinition Proxy Configuration Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- Runtime
Platform TaskDefinition Runtime Platform Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- Skip
Destroy bool - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - map[string]string
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Task
Role DefaultRole With Policy - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- Track
Latest bool - Whether should track latest task definition or the one created with the resource. Default is
false
. - Volumes
Task
Definition Volume - Configuration block for volumes that containers in your task may use. Detailed below.
- container
Task
Definition Container Definition Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- containers
Map<String,Task
Definition Container Definition> All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- cpu String
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- ephemeral
Storage TaskDefinition Ephemeral Storage The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- execution
Role DefaultRole With Policy - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- family String
- An optional unique name for your task definition. If not specified, then a default will be created.
- inference
Accelerators List<TaskDefinition Inference Accelerator> - Configuration block(s) with Inference Accelerators settings. Detailed below.
- ipc
Mode String - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - log
Group DefaultLog Group - A set of volume blocks that containers in your task may use.
- memory String
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- network
Mode String - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - pid
Mode String - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - placement
Constraints List<TaskDefinition Placement Constraint> - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - proxy
Configuration TaskDefinition Proxy Configuration Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- runtime
Platform TaskDefinition Runtime Platform Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- skip
Destroy Boolean - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - Map<String,String>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Role DefaultRole With Policy - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- track
Latest Boolean - Whether should track latest task definition or the one created with the resource. Default is
false
. - volumes
List<Task
Definition Volume> - Configuration block for volumes that containers in your task may use. Detailed below.
- container
Task
Definition Container Definition Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- containers
{[key: string]: Task
Definition Container Definition} All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- cpu string
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- ephemeral
Storage pulumiAws.types.input. Task Definition Ephemeral Storage The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- execution
Role awsx.Default Role With Policy - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- family string
- An optional unique name for your task definition. If not specified, then a default will be created.
- inference
Accelerators pulumiAws.types.input. Task Definition Inference Accelerator[] - Configuration block(s) with Inference Accelerators settings. Detailed below.
- ipc
Mode string - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - log
Group awsx.Default Log Group - A set of volume blocks that containers in your task may use.
- memory string
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- network
Mode string - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - pid
Mode string - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - placement
Constraints pulumiAws.types.input. Task Definition Placement Constraint[] - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - proxy
Configuration pulumiAws.types.input. Task Definition Proxy Configuration Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- runtime
Platform pulumiAws.types.input. Task Definition Runtime Platform Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- skip
Destroy boolean - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - {[key: string]: string}
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Role awsx.Default Role With Policy - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- track
Latest boolean - Whether should track latest task definition or the one created with the resource. Default is
false
. - volumes
pulumi
Aws.types.input. Task Definition Volume[] - Configuration block for volumes that containers in your task may use. Detailed below.
- container
Task
Definition Container Definition Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- containers
Mapping[str, Task
Definition Container Definition] All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- cpu str
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- ephemeral_
storage pulumi_aws.ecs. Task Definition Ephemeral Storage Args The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- execution_
role awsx.Default Role With Policy - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- family str
- An optional unique name for your task definition. If not specified, then a default will be created.
- inference_
accelerators Sequence[pulumi_aws.ecs. Task Definition Inference Accelerator Args] - Configuration block(s) with Inference Accelerators settings. Detailed below.
- ipc_
mode str - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - log_
group awsx.Default Log Group - A set of volume blocks that containers in your task may use.
- memory str
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- network_
mode str - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - pid_
mode str - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - placement_
constraints Sequence[pulumi_aws.ecs. Task Definition Placement Constraint Args] - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - proxy_
configuration pulumi_aws.ecs. Task Definition Proxy Configuration Args Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- runtime_
platform pulumi_aws.ecs. Task Definition Runtime Platform Args Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- skip_
destroy bool - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - Mapping[str, str]
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task_
role awsx.Default Role With Policy - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- track_
latest bool - Whether should track latest task definition or the one created with the resource. Default is
false
. - volumes
Sequence[pulumi_
aws.ecs. Task Definition Volume Args] - Configuration block for volumes that containers in your task may use. Detailed below.
- container Property Map
Single container to make a TaskDefinition from. Useful for simple cases where there aren't multiple containers, especially when creating a TaskDefinition to call [run] on.
Either [container] or [containers] must be provided.
- containers Map<Property Map>
All the containers to make a TaskDefinition from. Useful when creating a Service that will contain many containers within.
Either [container] or [containers] must be provided.
- cpu String
- The number of cpu units used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- ephemeral
Storage Property Map The amount of ephemeral storage to allocate for the task. This parameter is used to expand the total amount of ephemeral storage available, beyond the default amount, for tasks hosted on AWS Fargate. See Ephemeral Storage.
This type is defined in the AWS Classic package.
- execution
Role Property Map - The execution role that the Amazon ECS container agent and the Docker daemon can assume. Will be created automatically if not defined.
- family String
- An optional unique name for your task definition. If not specified, then a default will be created.
- inference
Accelerators List<Property Map> - Configuration block(s) with Inference Accelerators settings. Detailed below.
- ipc
Mode String - IPC resource namespace to be used for the containers in the task The valid values are
host
,task
, andnone
. - log
Group Property Map - A set of volume blocks that containers in your task may use.
- memory String
- The amount (in MiB) of memory used by the task. If not provided, a default will be computed based on the cumulative needs specified by [containerDefinitions]
- network
Mode String - Docker networking mode to use for the containers in the task. Valid values are
none
,bridge
,awsvpc
, andhost
. - pid
Mode String - Process namespace to use for the containers in the task. The valid values are
host
andtask
. - placement
Constraints List<Property Map> - Configuration block for rules that are taken into consideration during task placement. Maximum number of
placement_constraints
is10
. Detailed below. - proxy
Configuration Property Map Configuration block for the App Mesh proxy. Detailed below.
This type is defined in the AWS Classic package.
- runtime
Platform Property Map Configuration block for runtime_platform that containers in your task may use.
This type is defined in the AWS Classic package.
- skip
Destroy Boolean - Whether to retain the old revision when the resource is destroyed or replacement is necessary. Default is
false
. - Map<String>
- Key-value map of resource tags. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - task
Role Property Map - IAM role that allows your Amazon ECS container task to make calls to other AWS services. Will be created automatically if not defined.
- track
Latest Boolean - Whether should track latest task definition or the one created with the resource. Default is
false
. - volumes List<Property Map>
- Configuration block for volumes that containers in your task may use. Detailed below.
ExistingLogGroup, ExistingLogGroupArgs
LogGroup, LogGroupArgs
- Kms
Key stringId - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- Log
Group stringClass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - Name string
- The name of the log group. If omitted, this provider will assign a random, unique name.
- Name
Prefix string - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - Retention
In intDays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- Skip
Destroy bool - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- Dictionary<string, string>
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- Kms
Key stringId - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- Log
Group stringClass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - Name string
- The name of the log group. If omitted, this provider will assign a random, unique name.
- Name
Prefix string - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - Retention
In intDays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- Skip
Destroy bool - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- map[string]string
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- kms
Key StringId - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- log
Group StringClass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - name String
- The name of the log group. If omitted, this provider will assign a random, unique name.
- name
Prefix String - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - retention
In IntegerDays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- skip
Destroy Boolean - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- Map<String,String>
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- kms
Key stringId - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- log
Group stringClass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - name string
- The name of the log group. If omitted, this provider will assign a random, unique name.
- name
Prefix string - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - retention
In numberDays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- skip
Destroy boolean - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- {[key: string]: string}
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- kms_
key_ strid - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- log_
group_ strclass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - name str
- The name of the log group. If omitted, this provider will assign a random, unique name.
- name_
prefix str - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - retention_
in_ intdays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- skip_
destroy bool - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- Mapping[str, str]
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- kms
Key StringId - The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.
- log
Group StringClass - Specified the log class of the log group. Possible values are:
STANDARD
orINFREQUENT_ACCESS
. - name String
- The name of the log group. If omitted, this provider will assign a random, unique name.
- name
Prefix String - Creates a unique name beginning with the specified prefix. Conflicts with
name
. - retention
In NumberDays - Specifies the number of days you want to retain log events in the specified log group. Possible values are: 1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, and 0. If you select 0, the events in the log group are always retained and never expire.
- skip
Destroy Boolean - Set to true if you do not wish the log group (and any logs it may contain) to be deleted at destroy time, and instead just remove the log group from the state.
- Map<String>
- A map of tags to assign to the resource. .If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
RoleWithPolicy, RoleWithPolicyArgs
- Description string
- Description of the role.
- Force
Detach boolPolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - Inline
Policies List<Pulumi.Aws. Iam. Inputs. Role Inline Policy> - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - Managed
Policy List<string>Arns - Max
Session intDuration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- Name string
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- Name
Prefix string - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - Path string
- Path to the role. See IAM Identifiers for more information.
- Permissions
Boundary string - ARN of the policy that is used to set the permissions boundary for the role.
- Policy
Arns List<string> - ARNs of the policies to attach to the created role.
- Dictionary<string, string>
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- Description string
- Description of the role.
- Force
Detach boolPolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - Inline
Policies RoleInline Policy - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - Managed
Policy []stringArns - Max
Session intDuration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- Name string
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- Name
Prefix string - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - Path string
- Path to the role. See IAM Identifiers for more information.
- Permissions
Boundary string - ARN of the policy that is used to set the permissions boundary for the role.
- Policy
Arns []string - ARNs of the policies to attach to the created role.
- map[string]string
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- description String
- Description of the role.
- force
Detach BooleanPolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - inline
Policies List<RoleInline Policy> - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - managed
Policy List<String>Arns - max
Session IntegerDuration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- name String
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- name
Prefix String - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - path String
- Path to the role. See IAM Identifiers for more information.
- permissions
Boundary String - ARN of the policy that is used to set the permissions boundary for the role.
- policy
Arns List<String> - ARNs of the policies to attach to the created role.
- Map<String,String>
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- description string
- Description of the role.
- force
Detach booleanPolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - inline
Policies pulumiAws.types.input.iam. Role Inline Policy[] - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - managed
Policy string[]Arns - max
Session numberDuration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- name string
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- name
Prefix string - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - path string
- Path to the role. See IAM Identifiers for more information.
- permissions
Boundary string - ARN of the policy that is used to set the permissions boundary for the role.
- policy
Arns string[] - ARNs of the policies to attach to the created role.
- {[key: string]: string}
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- description str
- Description of the role.
- force_
detach_ boolpolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - inline_
policies Sequence[pulumi_aws.iam. Role Inline Policy Args] - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - managed_
policy_ Sequence[str]arns - max_
session_ intduration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- name str
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- name_
prefix str - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - path str
- Path to the role. See IAM Identifiers for more information.
- permissions_
boundary str - ARN of the policy that is used to set the permissions boundary for the role.
- policy_
arns Sequence[str] - ARNs of the policies to attach to the created role.
- Mapping[str, str]
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
- description String
- Description of the role.
- force
Detach BooleanPolicies - Whether to force detaching any policies the role has before destroying it. Defaults to
false
. - inline
Policies List<Property Map> - Configuration block defining an exclusive set of IAM inline policies associated with the IAM role. See below. If no blocks are configured, the provider will not manage any inline policies in this resource. Configuring one empty block (i.e.,
inline_policy {}
) will cause the provider to remove all inline policies added out of band onapply
. - managed
Policy List<String>Arns - max
Session NumberDuration - Maximum session duration (in seconds) that you want to set for the specified role. If you do not specify a value for this setting, the default maximum of one hour is applied. This setting can have a value from 1 hour to 12 hours.
- name String
- Friendly name of the role. If omitted, the provider will assign a random, unique name. See IAM Identifiers for more information.
- name
Prefix String - Creates a unique friendly name beginning with the specified prefix. Conflicts with
name
. - path String
- Path to the role. See IAM Identifiers for more information.
- permissions
Boundary String - ARN of the policy that is used to set the permissions boundary for the role.
- policy
Arns List<String> - ARNs of the policies to attach to the created role.
- Map<String>
- Key-value mapping of tags for the IAM role. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level.
TaskDefinitionContainerDefinition, TaskDefinitionContainerDefinitionArgs
- Image string
- The image used to start a container. This string is passed directly to the Docker daemon.
- Name string
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- Command List<string>
- Cpu int
- Depends
On List<TaskDefinition Container Dependency> - Disable
Networking bool - Dns
Search List<string>Domains - Dns
Servers List<string> - Docker
Labels object - Docker
Security List<string>Options - Entry
Point List<string> - Environment
List<Task
Definition Key Value Pair> - The environment variables to pass to a container
- Environment
Files List<TaskDefinition Environment File> - The list of one or more files that contain the environment variables to pass to a container
- Essential bool
- Extra
Hosts List<TaskDefinition Host Entry> - Firelens
Configuration TaskDefinition Firelens Configuration - Health
Check TaskDefinition Health Check - Hostname string
- Interactive bool
- Links List<string>
- Linux
Parameters TaskDefinition Linux Parameters - Log
Configuration TaskDefinition Log Configuration - Memory int
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- Memory
Reservation int - Mount
Points List<TaskDefinition Mount Point> - Port
Mappings List<TaskDefinition Port Mapping> - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- Privileged bool
- Pseudo
Terminal bool - Readonly
Root boolFilesystem - Repository
Credentials TaskDefinition Repository Credentials - Resource
Requirements List<TaskDefinition Resource Requirement> - Secrets
List<Task
Definition Secret> - Start
Timeout int - Stop
Timeout int - System
Controls List<TaskDefinition System Control> - Ulimits
List<Task
Definition Ulimit> - User string
- Volumes
From List<TaskDefinition Volume From> - Working
Directory string
- Image string
- The image used to start a container. This string is passed directly to the Docker daemon.
- Name string
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- Command []string
- Cpu int
- Depends
On []TaskDefinition Container Dependency - Disable
Networking bool - Dns
Search []stringDomains - Dns
Servers []string - Docker
Labels interface{} - Docker
Security []stringOptions - Entry
Point []string - Environment
[]Task
Definition Key Value Pair - The environment variables to pass to a container
- Environment
Files []TaskDefinition Environment File - The list of one or more files that contain the environment variables to pass to a container
- Essential bool
- Extra
Hosts []TaskDefinition Host Entry - Firelens
Configuration TaskDefinition Firelens Configuration - Health
Check TaskDefinition Health Check - Hostname string
- Interactive bool
- Links []string
- Linux
Parameters TaskDefinition Linux Parameters - Log
Configuration TaskDefinition Log Configuration - Memory int
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- Memory
Reservation int - Mount
Points []TaskDefinition Mount Point - Port
Mappings []TaskDefinition Port Mapping - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- Privileged bool
- Pseudo
Terminal bool - Readonly
Root boolFilesystem - Repository
Credentials TaskDefinition Repository Credentials - Resource
Requirements []TaskDefinition Resource Requirement - Secrets
[]Task
Definition Secret - Start
Timeout int - Stop
Timeout int - System
Controls []TaskDefinition System Control - Ulimits
[]Task
Definition Ulimit - User string
- Volumes
From []TaskDefinition Volume From - Working
Directory string
- image String
- The image used to start a container. This string is passed directly to the Docker daemon.
- name String
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- command List<String>
- cpu Integer
- depends
On List<TaskDefinition Container Dependency> - disable
Networking Boolean - dns
Search List<String>Domains - dns
Servers List<String> - docker
Labels Object - docker
Security List<String>Options - entry
Point List<String> - environment
List<Task
Definition Key Value Pair> - The environment variables to pass to a container
- environment
Files List<TaskDefinition Environment File> - The list of one or more files that contain the environment variables to pass to a container
- essential Boolean
- extra
Hosts List<TaskDefinition Host Entry> - firelens
Configuration TaskDefinition Firelens Configuration - health
Check TaskDefinition Health Check - hostname String
- interactive Boolean
- links List<String>
- linux
Parameters TaskDefinition Linux Parameters - log
Configuration TaskDefinition Log Configuration - memory Integer
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- memory
Reservation Integer - mount
Points List<TaskDefinition Mount Point> - port
Mappings List<TaskDefinition Port Mapping> - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- privileged Boolean
- pseudo
Terminal Boolean - readonly
Root BooleanFilesystem - repository
Credentials TaskDefinition Repository Credentials - resource
Requirements List<TaskDefinition Resource Requirement> - secrets
List<Task
Definition Secret> - start
Timeout Integer - stop
Timeout Integer - system
Controls List<TaskDefinition System Control> - ulimits
List<Task
Definition Ulimit> - user String
- volumes
From List<TaskDefinition Volume From> - working
Directory String
- image string
- The image used to start a container. This string is passed directly to the Docker daemon.
- name string
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- command string[]
- cpu number
- depends
On TaskDefinition Container Dependency[] - disable
Networking boolean - dns
Search string[]Domains - dns
Servers string[] - docker
Labels any - docker
Security string[]Options - entry
Point string[] - environment
Task
Definition Key Value Pair[] - The environment variables to pass to a container
- environment
Files TaskDefinition Environment File[] - The list of one or more files that contain the environment variables to pass to a container
- essential boolean
- extra
Hosts TaskDefinition Host Entry[] - firelens
Configuration TaskDefinition Firelens Configuration - health
Check TaskDefinition Health Check - hostname string
- interactive boolean
- links string[]
- linux
Parameters TaskDefinition Linux Parameters - log
Configuration TaskDefinition Log Configuration - memory number
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- memory
Reservation number - mount
Points TaskDefinition Mount Point[] - port
Mappings TaskDefinition Port Mapping[] - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- privileged boolean
- pseudo
Terminal boolean - readonly
Root booleanFilesystem - repository
Credentials TaskDefinition Repository Credentials - resource
Requirements TaskDefinition Resource Requirement[] - secrets
Task
Definition Secret[] - start
Timeout number - stop
Timeout number - system
Controls TaskDefinition System Control[] - ulimits
Task
Definition Ulimit[] - user string
- volumes
From TaskDefinition Volume From[] - working
Directory string
- image str
- The image used to start a container. This string is passed directly to the Docker daemon.
- name str
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- command Sequence[str]
- cpu int
- depends_
on Sequence[TaskDefinition Container Dependency] - disable_
networking bool - dns_
search_ Sequence[str]domains - dns_
servers Sequence[str] - docker_
labels Any - docker_
security_ Sequence[str]options - entry_
point Sequence[str] - environment
Sequence[Task
Definition Key Value Pair] - The environment variables to pass to a container
- environment_
files Sequence[TaskDefinition Environment File] - The list of one or more files that contain the environment variables to pass to a container
- essential bool
- extra_
hosts Sequence[TaskDefinition Host Entry] - firelens_
configuration TaskDefinition Firelens Configuration - health_
check TaskDefinition Health Check - hostname str
- interactive bool
- links Sequence[str]
- linux_
parameters TaskDefinition Linux Parameters - log_
configuration TaskDefinition Log Configuration - memory int
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- memory_
reservation int - mount_
points Sequence[TaskDefinition Mount Point] - port_
mappings Sequence[TaskDefinition Port Mapping] - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- privileged bool
- pseudo_
terminal bool - readonly_
root_ boolfilesystem - repository_
credentials TaskDefinition Repository Credentials - resource_
requirements Sequence[TaskDefinition Resource Requirement] - secrets
Sequence[Task
Definition Secret] - start_
timeout int - stop_
timeout int - system_
controls Sequence[TaskDefinition System Control] - ulimits
Sequence[Task
Definition Ulimit] - user str
- volumes_
from Sequence[TaskDefinition Volume From] - working_
directory str
- image String
- The image used to start a container. This string is passed directly to the Docker daemon.
- name String
- The name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed
- command List<String>
- cpu Number
- depends
On List<Property Map> - disable
Networking Boolean - dns
Search List<String>Domains - dns
Servers List<String> - docker
Labels Any - docker
Security List<String>Options - entry
Point List<String> - environment List<Property Map>
- The environment variables to pass to a container
- environment
Files List<Property Map> - The list of one or more files that contain the environment variables to pass to a container
- essential Boolean
- extra
Hosts List<Property Map> - firelens
Configuration Property Map - health
Check Property Map - hostname String
- interactive Boolean
- links List<String>
- linux
Parameters Property Map - log
Configuration Property Map - memory Number
- The amount (in MiB) of memory to present to the container. If your container attempts to exceed the memory specified here, the container is killed.
- memory
Reservation Number - mount
Points List<Property Map> - port
Mappings List<Property Map> - Port mappings allow containers to access ports on the host container instance to send or receive traffic.
- privileged Boolean
- pseudo
Terminal Boolean - readonly
Root BooleanFilesystem - repository
Credentials Property Map - resource
Requirements List<Property Map> - secrets List<Property Map>
- start
Timeout Number - stop
Timeout Number - system
Controls List<Property Map> - ulimits List<Property Map>
- user String
- volumes
From List<Property Map> - working
Directory String
TaskDefinitionContainerDependency, TaskDefinitionContainerDependencyArgs
- Condition string
- Container
Name string
- Condition string
- Container
Name string
- condition String
- container
Name String
- condition string
- container
Name string
- condition str
- container_
name str
- condition String
- container
Name String
TaskDefinitionDevice, TaskDefinitionDeviceArgs
- Container
Path string - Host
Path string - Permissions List<string>
- Container
Path string - Host
Path string - Permissions []string
- container
Path String - host
Path String - permissions List<String>
- container
Path string - host
Path string - permissions string[]
- container_
path str - host_
path str - permissions Sequence[str]
- container
Path String - host
Path String - permissions List<String>
TaskDefinitionEnvironmentFile, TaskDefinitionEnvironmentFileArgs
TaskDefinitionFirelensConfiguration, TaskDefinitionFirelensConfigurationArgs
TaskDefinitionHealthCheck, TaskDefinitionHealthCheckArgs
- Command List<string>
- A string array representing the command that the container runs to determine if it is healthy.
- Interval int
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- Retries int
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- Start
Period int - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- Timeout int
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
- Command []string
- A string array representing the command that the container runs to determine if it is healthy.
- Interval int
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- Retries int
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- Start
Period int - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- Timeout int
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
- command List<String>
- A string array representing the command that the container runs to determine if it is healthy.
- interval Integer
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- retries Integer
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- start
Period Integer - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- timeout Integer
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
- command string[]
- A string array representing the command that the container runs to determine if it is healthy.
- interval number
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- retries number
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- start
Period number - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- timeout number
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
- command Sequence[str]
- A string array representing the command that the container runs to determine if it is healthy.
- interval int
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- retries int
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- start_
period int - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- timeout int
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
- command List<String>
- A string array representing the command that the container runs to determine if it is healthy.
- interval Number
- The time period in seconds between each health check execution. You may specify between 5 and 300 seconds. The default value is 30 seconds.
- retries Number
- The number of times to retry a failed health check before the container is considered unhealthy. You may specify between 1 and 10 retries. The default value is three retries.
- start
Period Number - The optional grace period within which to provide containers time to bootstrap before failed health checks count towards the maximum number of retries. You may specify between 0 and 300 seconds. The startPeriod is disabled by default.
- timeout Number
- The time period in seconds to wait for a health check to succeed before it is considered a failure. You may specify between 2 and 60 seconds. The default value is 5 seconds.
TaskDefinitionHostEntry, TaskDefinitionHostEntryArgs
- hostname str
- ip_
address str
TaskDefinitionKernelCapabilities, TaskDefinitionKernelCapabilitiesArgs
TaskDefinitionKeyValuePair, TaskDefinitionKeyValuePairArgs
TaskDefinitionLinuxParameters, TaskDefinitionLinuxParametersArgs
- capabilities Property Map
- devices List<Property Map>
- init
Process BooleanEnabled - max
Swap Number - Number
- swappiness Number
- tmpfs List<Property Map>
TaskDefinitionLogConfiguration, TaskDefinitionLogConfigurationArgs
- Log
Driver string - Options object
- Secret
Options List<TaskDefinition Secret>
- Log
Driver string - Options interface{}
- Secret
Options []TaskDefinition Secret
- log
Driver String - options Object
- secret
Options List<TaskDefinition Secret>
- log
Driver String - options Any
- secret
Options List<Property Map>
TaskDefinitionMountPoint, TaskDefinitionMountPointArgs
- Container
Path string - Read
Only bool - Source
Volume string
- Container
Path string - Read
Only bool - Source
Volume string
- container
Path String - read
Only Boolean - source
Volume String
- container
Path string - read
Only boolean - source
Volume string
- container_
path str - read_
only bool - source_
volume str
- container
Path String - read
Only Boolean - source
Volume String
TaskDefinitionPortMapping, TaskDefinitionPortMappingArgs
- App
Protocol Pulumi.Awsx. Ecs. Task Definition Port Mapping App Protocol - Container
Port int - Container
Port stringRange - Host
Port int - Name string
- Protocol string
- Target
Group Pulumi.Aws. LB. Target Group - This type is defined in the AWS Classic package.
- App
Protocol TaskDefinition Port Mapping App Protocol - Container
Port int - Container
Port stringRange - Host
Port int - Name string
- Protocol string
- Target
Group TargetGroup - This type is defined in the AWS Classic package.
- app
Protocol TaskDefinition Port Mapping App Protocol - container
Port Integer - container
Port StringRange - host
Port Integer - name String
- protocol String
- target
Group TargetGroup - This type is defined in the AWS Classic package.
- app
Protocol TaskDefinition Port Mapping App Protocol - container
Port number - container
Port stringRange - host
Port number - name string
- protocol string
- target
Group pulumiAws.lb. Target Group - This type is defined in the AWS Classic package.
- app_
protocol TaskDefinition Port Mapping App Protocol - container_
port int - container_
port_ strrange - host_
port int - name str
- protocol str
- target_
group pulumi_aws.lb. Target Group - This type is defined in the AWS Classic package.
- app
Protocol "http" | "http2" | "grpc" - container
Port Number - container
Port StringRange - host
Port Number - name String
- protocol String
- target
Group aws:lb:TargetGroup - This type is defined in the AWS Classic package.
TaskDefinitionPortMappingAppProtocol, TaskDefinitionPortMappingAppProtocolArgs
- Http
- http
- Http2
- http2
- Grpc
- grpc
- Task
Definition Port Mapping App Protocol Http - http
- Task
Definition Port Mapping App Protocol Http2 - http2
- Task
Definition Port Mapping App Protocol Grpc - grpc
- Http
- http
- Http2
- http2
- Grpc
- grpc
- Http
- http
- Http2
- http2
- Grpc
- grpc
- HTTP
- http
- HTTP2
- http2
- GRPC
- grpc
- "http"
- http
- "http2"
- http2
- "grpc"
- grpc
TaskDefinitionRepositoryCredentials, TaskDefinitionRepositoryCredentialsArgs
- Credentials
Parameter string
- Credentials
Parameter string
- credentials
Parameter String
- credentials
Parameter string
- credentials
Parameter String
TaskDefinitionResourceRequirement, TaskDefinitionResourceRequirementArgs
TaskDefinitionSecret, TaskDefinitionSecretArgs
- name str
- value_
from str
TaskDefinitionSystemControl, TaskDefinitionSystemControlArgs
TaskDefinitionTmpfs, TaskDefinitionTmpfsArgs
- Size int
- Container
Path string - Mount
Options List<string>
- Size int
- Container
Path string - Mount
Options []string
- size Integer
- container
Path String - mount
Options List<String>
- size number
- container
Path string - mount
Options string[]
- size int
- container_
path str - mount_
options Sequence[str]
- size Number
- container
Path String - mount
Options List<String>
TaskDefinitionUlimit, TaskDefinitionUlimitArgs
- hard_
limit int - name str
- soft_
limit int
TaskDefinitionVolumeFrom, TaskDefinitionVolumeFromArgs
- Read
Only bool - Source
Container string
- Read
Only bool - Source
Container string
- read
Only Boolean - source
Container String
- read
Only boolean - source
Container string
- read_
only bool - source_
container str
- read
Only Boolean - source
Container String
Package Details
- Repository
- AWSx (Pulumi Crosswalk for AWS) pulumi/pulumi-awsx
- License
- Apache-2.0