Class: AWSCDK::ECSPatterns::NetworkLoadBalancedTaskImageOptions

Inherits:
Jsii::Struct
  • Object
show all
Defined in:
ecs_patterns/network_load_balanced_task_image_options.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(image:, container_name: nil, container_port: nil, docker_labels: nil, enable_logging: nil, environment: nil, execution_role: nil, family: nil, log_driver: nil, secrets: nil, task_role: nil) ⇒ NetworkLoadBalancedTaskImageOptions

Returns a new instance of NetworkLoadBalancedTaskImageOptions.

Parameters:

  • image (AWSCDK::ECS::ContainerImage) —

    The image used to start a container.

  • container_name (String, nil) (defaults to: nil) —

    The container name value to be specified in the task definition.

  • container_port (Numeric, nil) (defaults to: nil) —

    The port number on the container that is bound to the user-specified or automatically assigned host port.

  • docker_labels (Hash{String => String}, nil) (defaults to: nil) —

    A key/value map of labels to add to the container.

  • enable_logging (Boolean, nil) (defaults to: nil) —

    Flag to indicate whether to enable logging.

  • environment (Hash{String => String}, nil) (defaults to: nil) —

    The environment variables to pass to the container.

  • execution_role (AWSCDK::IAM::IRole, nil) (defaults to: nil) —

    The name of the task execution IAM role that grants the Amazon ECS container agent permission to call AWS APIs on your behalf.

  • family (String, nil) (defaults to: nil) —

    The name of a family that this task definition is registered to.

  • log_driver (AWSCDK::ECS::LogDriver, nil) (defaults to: nil) —

    The log driver to use.

  • secrets (Hash{String => AWSCDK::ECS::Secret}, nil) (defaults to: nil) —

    The secret to expose to the container as an environment variable.

  • task_role (AWSCDK::IAM::IRole, nil) (defaults to: nil) —

    The name of the task IAM role that grants containers in the task permission to call AWS APIs on your behalf.



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 17

def initialize(image:, container_name: nil, container_port: nil, docker_labels: nil, enable_logging: nil, environment: nil, execution_role: nil, family: nil, log_driver: nil, secrets: nil, task_role: nil)
  @image = image
  Jsii::Type.check_type(@image, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkNvbnRhaW5lckltYWdlIn0=")), "image")
  @container_name = container_name
  Jsii::Type.check_type(@container_name, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "containerName") unless @container_name.nil?
  @container_port = container_port
  Jsii::Type.check_type(@container_port, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJudW1iZXIifQ==")), "containerPort") unless @container_port.nil?
  @docker_labels = docker_labels
  Jsii::Type.check_type(@docker_labels, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoibWFwIn19")), "dockerLabels") unless @docker_labels.nil?
  @enable_logging = enable_logging
  Jsii::Type.check_type(@enable_logging, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "enableLogging") unless @enable_logging.nil?
  @environment = environment
  Jsii::Type.check_type(@environment, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoibWFwIn19")), "environment") unless @environment.nil?
  @execution_role = execution_role
  Jsii::Type.check_type(@execution_role, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfaWFtLklSb2xlIn0=")), "executionRole") unless @execution_role.nil?
  @family = family
  Jsii::Type.check_type(@family, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "family") unless @family.nil?
  @log_driver = log_driver
  Jsii::Type.check_type(@log_driver, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkxvZ0RyaXZlciJ9")), "logDriver") unless @log_driver.nil?
  @secrets = secrets
  Jsii::Type.check_type(@secrets, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuU2VjcmV0In0sImtpbmQiOiJtYXAifX0=")), "secrets") unless @secrets.nil?
  @task_role = task_role
  Jsii::Type.check_type(@task_role, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfaWFtLklSb2xlIn0=")), "taskRole") unless @task_role.nil?
end

Instance Attribute Details

#container_name ⇒ String? (readonly)

Note:

Default: - none

The container name value to be specified in the task definition.

Returns:

  • (String, nil) 


53
54
55
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 53

def container_name
  @container_name
end

#container_port ⇒ Numeric? (readonly)

Note:

Default: 80 or 443 with listenerCertificate provided

The port number on the container that is bound to the user-specified or automatically assigned host port.

If you are using containers in a task with the awsvpc or host network mode, exposed ports should be specified using containerPort. If you are using containers in a task with the bridge network mode and you specify a container port and not a host port, your container automatically receives a host port in the ephemeral port range.

Port mappings that are automatically assigned in this way do not count toward the 100 reserved ports limit of a container instance.

For more information, see hostPort.

Returns:

  • (Numeric, nil) 


67
68
69
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 67

def container_port
  @container_port
end

#docker_labels ⇒ Hash{String => String}? (readonly)

Note:

Default: - No labels.

A key/value map of labels to add to the container.

Returns:

  • (Hash{String => String}, nil) 


72
73
74
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 72

def docker_labels
  @docker_labels
end

#enable_logging ⇒ Boolean? (readonly)

Note:

Default: true

Flag to indicate whether to enable logging.

Returns:

  • (Boolean, nil) 


77
78
79
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 77

def enable_logging
  @enable_logging
end

#environment ⇒ Hash{String => String}? (readonly)

Note:

Default: - No environment variables.

The environment variables to pass to the container.

Returns:

  • (Hash{String => String}, nil) 


82
83
84
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 82

def environment
  @environment
end

#execution_role ⇒ AWSCDK::IAM::IRole? (readonly)

Note:

Default: - No value

The name of the task execution IAM role that grants the Amazon ECS container agent permission to call AWS APIs on your behalf.

Returns:



87
88
89
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 87

def execution_role
  @execution_role
end

#family ⇒ String? (readonly)

Note:

Default: - Automatically generated name.

The name of a family that this task definition is registered to.

A family groups multiple versions of a task definition.

Returns:

  • (String, nil) 


94
95
96
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 94

def family
  @family
end

#image ⇒ AWSCDK::ECS::ContainerImage (readonly)

Note:

Default: - none

The image used to start a container.

Image or taskDefinition must be specified, but not both.

Returns:



48
49
50
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 48

def image
  @image
end

#log_driver ⇒ AWSCDK::ECS::LogDriver? (readonly)

Note:

Default: - AwsLogDriver if enableLogging is true

The log driver to use.

Returns:



99
100
101
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 99

def log_driver
  @log_driver
end

#secrets ⇒ Hash{String => AWSCDK::ECS::Secret}? (readonly)

Note:

Default: - No secret environment variables.

The secret to expose to the container as an environment variable.

Returns:



104
105
106
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 104

def secrets
  @secrets
end

#task_role ⇒ AWSCDK::IAM::IRole? (readonly)

Note:

Default: - A task role is automatically created for you.

The name of the task IAM role that grants containers in the task permission to call AWS APIs on your behalf.

Returns:



109
110
111
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 109

def task_role
  @task_role
end

Class Method Details

.jsii_properties ⇒ Object 



111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 111

def self.jsii_properties
  {
    :image => "image",
    :container_name => "containerName",
    :container_port => "containerPort",
    :docker_labels => "dockerLabels",
    :enable_logging => "enableLogging",
    :environment => "environment",
    :execution_role => "executionRole",
    :family => "family",
    :log_driver => "logDriver",
    :secrets => "secrets",
    :task_role => "taskRole",
  }
end

Instance Method Details

#to_jsii ⇒ Object 



127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
 
# File 'ecs_patterns/network_load_balanced_task_image_options.rb', line 127

def to_jsii
  result = {}
  result.merge!({
    "image" => @image,
    "containerName" => @container_name,
    "containerPort" => @container_port,
    "dockerLabels" => @docker_labels,
    "enableLogging" => @enable_logging,
    "environment" => @environment,
    "executionRole" => @execution_role,
    "family" => @family,
    "logDriver" => @log_driver,
    "secrets" => @secrets,
    "taskRole" => @task_role,
  })
  result.compact
end