Class: AWSCDK::ECS::FirelensLogRouterProps

Inherits:
ContainerDefinitionProps
  • Object
show all
Defined in:
ecs/firelens_log_router_props.rb

Overview

The properties in a firelens log router.

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(image:, command: nil, container_name: nil, cpu: nil, credential_specs: nil, disable_networking: nil, dns_search_domains: nil, dns_servers: nil, docker_labels: nil, docker_security_options: nil, enable_restart_policy: nil, entry_point: nil, environment: nil, environment_files: nil, essential: nil, extra_hosts: nil, gpu_count: nil, health_check: nil, hostname: nil, inference_accelerator_resources: nil, interactive: nil, linux_parameters: nil, logging: nil, memory_limit_mib: nil, memory_reservation_mib: nil, port_mappings: nil, privileged: nil, pseudo_terminal: nil, readonly_root_filesystem: nil, restart_attempt_period: nil, restart_ignored_exit_codes: nil, secrets: nil, start_timeout: nil, stop_timeout: nil, system_controls: nil, ulimits: nil, user: nil, version_consistency: nil, working_directory: nil, task_definition:, firelens_config:) ⇒ FirelensLogRouterProps

Returns a new instance of FirelensLogRouterProps.

Parameters:

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

    The image used to start a container.

  • command (Array<String>, nil) (defaults to: nil) —

    The command that is passed to the container.

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

    The name of the container.

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

    The minimum number of CPU units to reserve for the container.

  • credential_specs (Array<AWSCDK::ECS::CredentialSpec>, nil) (defaults to: nil) —

    A list of ARNs in SSM or Amazon S3 to a credential spec (CredSpec) file that configures the container for Active Directory authentication.

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

    Specifies whether networking is disabled within the container.

  • dns_search_domains (Array<String>, nil) (defaults to: nil) —

    A list of DNS search domains that are presented to the container.

  • dns_servers (Array<String>, nil) (defaults to: nil) —

    A list of DNS servers that are presented to the container.

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

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

  • docker_security_options (Array<String>, nil) (defaults to: nil) —

    A list of strings to provide custom labels for SELinux and AppArmor multi-level security systems.

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

    Enable a restart policy for a container.

  • entry_point (Array<String>, nil) (defaults to: nil) —

    The ENTRYPOINT value to pass to the container.

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

    The environment variables to pass to the container.

  • environment_files (Array<AWSCDK::ECS::EnvironmentFile>, nil) (defaults to: nil) —

    The environment files to pass to the container.

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

    Specifies whether the container is marked essential.

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

    A list of hostnames and IP address mappings to append to the /etc/hosts file on the container.

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

    The number of GPUs assigned to the container.

  • health_check (AWSCDK::ECS::HealthCheck, nil) (defaults to: nil) —

    The health check command and associated configuration parameters for the container.

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

    The hostname to use for your container.

  • inference_accelerator_resources (Array<String>, nil) (defaults to: nil) —

    The inference accelerators referenced by the container.

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

    When this parameter is true, you can deploy containerized applications that require stdin or a tty to be allocated.

  • linux_parameters (AWSCDK::ECS::LinuxParameters, nil) (defaults to: nil) —

    Linux-specific modifications that are applied to the container, such as Linux kernel capabilities.

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

    The log configuration specification for the container.

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

    The amount (in MiB) of memory to present to the container.

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

    The soft limit (in MiB) of memory to reserve for the container.

  • port_mappings (Array<AWSCDK::ECS::PortMapping>, nil) (defaults to: nil) —

    The port mappings to add to the container definition.

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

    Specifies whether the container is marked as privileged.

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

    When this parameter is true, a TTY is allocated.

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

    When this parameter is true, the container is given read-only access to its root file system.

  • restart_attempt_period (AWSCDK::Duration, nil) (defaults to: nil) —

    A period of time that the container must run for before a restart can be attempted.

  • restart_ignored_exit_codes (Array<Numeric>, nil) (defaults to: nil) —

    A list of exit codes that Amazon ECS will ignore and not attempt a restart on.

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

    The secret environment variables to pass to the container.

  • start_timeout (AWSCDK::Duration, nil) (defaults to: nil) —

    Time duration (in seconds) to wait before giving up on resolving dependencies for a container.

  • stop_timeout (AWSCDK::Duration, nil) (defaults to: nil) —

    Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit normally on its own.

  • system_controls (Array<AWSCDK::ECS::SystemControl>, nil) (defaults to: nil) —

    A list of namespaced kernel parameters to set in the container.

  • ulimits (Array<AWSCDK::ECS::Ulimit>, nil) (defaults to: nil) —

    An array of ulimits to set in the container.

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

    The user to use inside the container.

  • version_consistency (AWSCDK::ECS::VersionConsistency, nil) (defaults to: nil) —

    Specifies whether Amazon ECS will resolve the container image tag provided in the container definition to an image digest.

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

    The working directory in which to run commands inside the container.

  • task_definition (AWSCDK::ECS::TaskDefinition) —

    The name of the task definition that includes this container definition.

  • firelens_config (AWSCDK::ECS::FirelensConfig) —

    Firelens configuration.



48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
 
# File 'ecs/firelens_log_router_props.rb', line 48

def initialize(image:, command: nil, container_name: nil, cpu: nil, credential_specs: nil, disable_networking: nil, dns_search_domains: nil, dns_servers: nil, docker_labels: nil, docker_security_options: nil, enable_restart_policy: nil, entry_point: nil, environment: nil, environment_files: nil, essential: nil, extra_hosts: nil, gpu_count: nil, health_check: nil, hostname: nil, inference_accelerator_resources: nil, interactive: nil, linux_parameters: nil, logging: nil, memory_limit_mib: nil, memory_reservation_mib: nil, port_mappings: nil, privileged: nil, pseudo_terminal: nil, readonly_root_filesystem: nil, restart_attempt_period: nil, restart_ignored_exit_codes: nil, secrets: nil, start_timeout: nil, stop_timeout: nil, system_controls: nil, ulimits: nil, user: nil, version_consistency: nil, working_directory: nil, task_definition:, firelens_config:)
  @image = image
  Jsii::Type.check_type(@image, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkNvbnRhaW5lckltYWdlIn0=")), "image")
  @command = command
  Jsii::Type.check_type(@command, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "command") unless @command.nil?
  @container_name = container_name
  Jsii::Type.check_type(@container_name, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "containerName") unless @container_name.nil?
  @cpu = cpu
  Jsii::Type.check_type(@cpu, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJudW1iZXIifQ==")), "cpu") unless @cpu.nil?
  @credential_specs = credential_specs
  Jsii::Type.check_type(@credential_specs, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuQ3JlZGVudGlhbFNwZWMifSwia2luZCI6ImFycmF5In19")), "credentialSpecs") unless @credential_specs.nil?
  @disable_networking = disable_networking
  Jsii::Type.check_type(@disable_networking, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "disableNetworking") unless @disable_networking.nil?
  @dns_search_domains = dns_search_domains
  Jsii::Type.check_type(@dns_search_domains, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "dnsSearchDomains") unless @dns_search_domains.nil?
  @dns_servers = dns_servers
  Jsii::Type.check_type(@dns_servers, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "dnsServers") unless @dns_servers.nil?
  @docker_labels = docker_labels
  Jsii::Type.check_type(@docker_labels, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoibWFwIn19")), "dockerLabels") unless @docker_labels.nil?
  @docker_security_options = docker_security_options
  Jsii::Type.check_type(@docker_security_options, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "dockerSecurityOptions") unless @docker_security_options.nil?
  @enable_restart_policy = enable_restart_policy
  Jsii::Type.check_type(@enable_restart_policy, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "enableRestartPolicy") unless @enable_restart_policy.nil?
  @entry_point = entry_point
  Jsii::Type.check_type(@entry_point, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "entryPoint") unless @entry_point.nil?
  @environment = environment
  Jsii::Type.check_type(@environment, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoibWFwIn19")), "environment") unless @environment.nil?
  @environment_files = environment_files
  Jsii::Type.check_type(@environment_files, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuRW52aXJvbm1lbnRGaWxlIn0sImtpbmQiOiJhcnJheSJ9fQ==")), "environmentFiles") unless @environment_files.nil?
  @essential = essential
  Jsii::Type.check_type(@essential, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "essential") unless @essential.nil?
  @extra_hosts = extra_hosts
  Jsii::Type.check_type(@extra_hosts, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoibWFwIn19")), "extraHosts") unless @extra_hosts.nil?
  @gpu_count = gpu_count
  Jsii::Type.check_type(@gpu_count, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJudW1iZXIifQ==")), "gpuCount") unless @gpu_count.nil?
  @health_check = health_check.is_a?(Hash) ? ::AWSCDK::ECS::HealthCheck.new(**health_check.transform_keys(&:to_sym)) : health_check
  Jsii::Type.check_type(@health_check, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkhlYWx0aENoZWNrIn0=")), "healthCheck") unless @health_check.nil?
  @hostname = hostname
  Jsii::Type.check_type(@hostname, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "hostname") unless @hostname.nil?
  @inference_accelerator_resources = inference_accelerator_resources
  Jsii::Type.check_type(@inference_accelerator_resources, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6InN0cmluZyJ9LCJraW5kIjoiYXJyYXkifX0=")), "inferenceAcceleratorResources") unless @inference_accelerator_resources.nil?
  @interactive = interactive
  Jsii::Type.check_type(@interactive, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "interactive") unless @interactive.nil?
  @linux_parameters = linux_parameters
  Jsii::Type.check_type(@linux_parameters, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkxpbnV4UGFyYW1ldGVycyJ9")), "linuxParameters") unless @linux_parameters.nil?
  @logging = logging
  Jsii::Type.check_type(@logging, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkxvZ0RyaXZlciJ9")), "logging") unless @logging.nil?
  @memory_limit_mib = memory_limit_mib
  Jsii::Type.check_type(@memory_limit_mib, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJudW1iZXIifQ==")), "memoryLimitMiB") unless @memory_limit_mib.nil?
  @memory_reservation_mib = memory_reservation_mib
  Jsii::Type.check_type(@memory_reservation_mib, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJudW1iZXIifQ==")), "memoryReservationMiB") unless @memory_reservation_mib.nil?
  @port_mappings = port_mappings.is_a?(Array) ? port_mappings.map { |jsii_v0| jsii_v0.is_a?(Hash) ? ::AWSCDK::ECS::PortMapping.new(**jsii_v0.transform_keys(&:to_sym)) : jsii_v0 } : port_mappings
  Jsii::Type.check_type(@port_mappings, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuUG9ydE1hcHBpbmcifSwia2luZCI6ImFycmF5In19")), "portMappings") unless @port_mappings.nil?
  @privileged = privileged
  Jsii::Type.check_type(@privileged, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "privileged") unless @privileged.nil?
  @pseudo_terminal = pseudo_terminal
  Jsii::Type.check_type(@pseudo_terminal, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "pseudoTerminal") unless @pseudo_terminal.nil?
  @readonly_root_filesystem = readonly_root_filesystem
  Jsii::Type.check_type(@readonly_root_filesystem, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJib29sZWFuIn0=")), "readonlyRootFilesystem") unless @readonly_root_filesystem.nil?
  @restart_attempt_period = restart_attempt_period
  Jsii::Type.check_type(@restart_attempt_period, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5EdXJhdGlvbiJ9")), "restartAttemptPeriod") unless @restart_attempt_period.nil?
  @restart_ignored_exit_codes = restart_ignored_exit_codes
  Jsii::Type.check_type(@restart_ignored_exit_codes, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7InByaW1pdGl2ZSI6Im51bWJlciJ9LCJraW5kIjoiYXJyYXkifX0=")), "restartIgnoredExitCodes") unless @restart_ignored_exit_codes.nil?
  @secrets = secrets
  Jsii::Type.check_type(@secrets, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuU2VjcmV0In0sImtpbmQiOiJtYXAifX0=")), "secrets") unless @secrets.nil?
  @start_timeout = start_timeout
  Jsii::Type.check_type(@start_timeout, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5EdXJhdGlvbiJ9")), "startTimeout") unless @start_timeout.nil?
  @stop_timeout = stop_timeout
  Jsii::Type.check_type(@stop_timeout, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5EdXJhdGlvbiJ9")), "stopTimeout") unless @stop_timeout.nil?
  @system_controls = system_controls.is_a?(Array) ? system_controls.map { |jsii_v0| jsii_v0.is_a?(Hash) ? ::AWSCDK::ECS::SystemControl.new(**jsii_v0.transform_keys(&:to_sym)) : jsii_v0 } : system_controls
  Jsii::Type.check_type(@system_controls, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuU3lzdGVtQ29udHJvbCJ9LCJraW5kIjoiYXJyYXkifX0=")), "systemControls") unless @system_controls.nil?
  @ulimits = ulimits.is_a?(Array) ? ulimits.map { |jsii_v0| jsii_v0.is_a?(Hash) ? ::AWSCDK::ECS::Ulimit.new(**jsii_v0.transform_keys(&:to_sym)) : jsii_v0 } : ulimits
  Jsii::Type.check_type(@ulimits, JSON.parse(Base64.strict_decode64("eyJjb2xsZWN0aW9uIjp7ImVsZW1lbnR0eXBlIjp7ImZxbiI6ImF3cy1jZGstbGliLmF3c19lY3MuVWxpbWl0In0sImtpbmQiOiJhcnJheSJ9fQ==")), "ulimits") unless @ulimits.nil?
  @user = user
  Jsii::Type.check_type(@user, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "user") unless @user.nil?
  @version_consistency = version_consistency
  Jsii::Type.check_type(@version_consistency, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLlZlcnNpb25Db25zaXN0ZW5jeSJ9")), "versionConsistency") unless @version_consistency.nil?
  @working_directory = working_directory
  Jsii::Type.check_type(@working_directory, JSON.parse(Base64.strict_decode64("eyJwcmltaXRpdmUiOiJzdHJpbmcifQ==")), "workingDirectory") unless @working_directory.nil?
  @task_definition = task_definition
  Jsii::Type.check_type(@task_definition, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLlRhc2tEZWZpbml0aW9uIn0=")), "taskDefinition")
  @firelens_config = firelens_config.is_a?(Hash) ? ::AWSCDK::ECS::FirelensConfig.new(**firelens_config.transform_keys(&:to_sym)) : firelens_config
  Jsii::Type.check_type(@firelens_config, JSON.parse(Base64.strict_decode64("eyJmcW4iOiJhd3MtY2RrLWxpYi5hd3NfZWNzLkZpcmVsZW5zQ29uZmlnIn0=")), "firelensConfig")
end

Instance Attribute Details

#command ⇒ Array<String>? (readonly)

Note:

Default: - CMD value built into container image.

The command that is passed to the container.

If you provide a shell command as a single string, you have to quote command-line arguments.

Returns:

  • (Array<String>, nil) 


148
149
150
 
# File 'ecs/firelens_log_router_props.rb', line 148

def command
  @command
end

#container_name ⇒ String? (readonly)

Note:

Default: - id of node associated with ContainerDefinition.

The name of the container.

Returns:

  • (String, nil) 


153
154
155
 
# File 'ecs/firelens_log_router_props.rb', line 153

def container_name
  @container_name
end

#cpu ⇒ Numeric? (readonly)

Note:

Default: - No minimum CPU units reserved.

The minimum number of CPU units to reserve for the container.

Returns:

  • (Numeric, nil) 


158
159
160
 
# File 'ecs/firelens_log_router_props.rb', line 158

def cpu
  @cpu
end

#credential_specs ⇒ Array<AWSCDK::ECS::CredentialSpec>? (readonly)

Note:

Default: - No credential specs.

A list of ARNs in SSM or Amazon S3 to a credential spec (CredSpec) file that configures the container for Active Directory authentication.

We recommend that you use this parameter instead of the docker_security_options.

Currently, only one credential spec is allowed per container definition.

Returns:



167
168
169
 
# File 'ecs/firelens_log_router_props.rb', line 167

def credential_specs
  @credential_specs
end

#disable_networking ⇒ Boolean? (readonly)

Note:

Default: false

Specifies whether networking is disabled within the container.

When this parameter is true, networking is disabled within the container.

Returns:

  • (Boolean, nil) 


174
175
176
 
# File 'ecs/firelens_log_router_props.rb', line 174

def disable_networking
  @disable_networking
end

#dns_search_domains ⇒ Array<String>? (readonly)

Note:

Default: - No search domains.

A list of DNS search domains that are presented to the container.

Returns:

  • (Array<String>, nil) 


179
180
181
 
# File 'ecs/firelens_log_router_props.rb', line 179

def dns_search_domains
  @dns_search_domains
end

#dns_servers ⇒ Array<String>? (readonly)

Note:

Default: - Default DNS servers.

A list of DNS servers that are presented to the container.

Returns:

  • (Array<String>, nil) 


184
185
186
 
# File 'ecs/firelens_log_router_props.rb', line 184

def dns_servers
  @dns_servers
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) 


189
190
191
 
# File 'ecs/firelens_log_router_props.rb', line 189

def docker_labels
  @docker_labels
end

#docker_security_options ⇒ Array<String>? (readonly)

Note:

Default: - No security labels.

A list of strings to provide custom labels for SELinux and AppArmor multi-level security systems.

Returns:

  • (Array<String>, nil) 


194
195
196
 
# File 'ecs/firelens_log_router_props.rb', line 194

def docker_security_options
  @docker_security_options
end

#enable_restart_policy ⇒ Boolean? (readonly)

Note:

Default: - false unless restartIgnoredExitCodes or restartAttemptPeriod is set.

Enable a restart policy for a container.

When you set up a restart policy, Amazon ECS can restart the container without needing to replace the task.

Returns:

  • (Boolean, nil)

See Also:



202
203
204
 
# File 'ecs/firelens_log_router_props.rb', line 202

def enable_restart_policy
  @enable_restart_policy
end

#entry_point ⇒ Array<String>? (readonly)

Note:

Default: - Entry point configured in container.

The ENTRYPOINT value to pass to the container.

Returns:

  • (Array<String>, nil)

See Also:



208
209
210
 
# File 'ecs/firelens_log_router_props.rb', line 208

def entry_point
  @entry_point
end

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

Note:

Default: - No environment variables.

The environment variables to pass to the container.

Returns:

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


213
214
215
 
# File 'ecs/firelens_log_router_props.rb', line 213

def environment
  @environment
end

#environment_files ⇒ Array<AWSCDK::ECS::EnvironmentFile>? (readonly)

Note:

Default: - No environment files.

The environment files to pass to the container.

Returns:

See Also:



219
220
221
 
# File 'ecs/firelens_log_router_props.rb', line 219

def environment_files
  @environment_files
end

#essential ⇒ Boolean? (readonly)

Note:

Default: true

Specifies whether the container is marked essential.

If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, then its failure does not affect the rest of the containers in a task. All tasks must have at least one essential container.

If this parameter is omitted, a container is assumed to be essential.

Returns:

  • (Boolean, nil) 


231
232
233
 
# File 'ecs/firelens_log_router_props.rb', line 231

def essential
  @essential
end

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

Note:

Default: - No extra hosts.

A list of hostnames and IP address mappings to append to the /etc/hosts file on the container.

Returns:

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


236
237
238
 
# File 'ecs/firelens_log_router_props.rb', line 236

def extra_hosts
  @extra_hosts
end

#firelens_config ⇒ AWSCDK::ECS::FirelensConfig (readonly)

Firelens configuration.

Returns:



403
404
405
 
# File 'ecs/firelens_log_router_props.rb', line 403

def firelens_config
  @firelens_config
end

#gpu_count ⇒ Numeric? (readonly)

Note:

Default: - No GPUs assigned.

The number of GPUs assigned to the container.

Returns:

  • (Numeric, nil) 


241
242
243
 
# File 'ecs/firelens_log_router_props.rb', line 241

def gpu_count
  @gpu_count
end

#health_check ⇒ AWSCDK::ECS::HealthCheck? (readonly)

Note:

Default: - Health check configuration from container.

The health check command and associated configuration parameters for the container.

Returns:



246
247
248
 
# File 'ecs/firelens_log_router_props.rb', line 246

def health_check
  @health_check
end

#hostname ⇒ String? (readonly)

Note:

Default: - Automatic hostname.

The hostname to use for your container.

Returns:

  • (String, nil) 


251
252
253
 
# File 'ecs/firelens_log_router_props.rb', line 251

def hostname
  @hostname
end

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

The image used to start a container.

This string is passed directly to the Docker daemon. Images in the Docker Hub registry are available by default. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest. TODO: Update these to specify using classes of IContainerImage

Returns:



141
142
143
 
# File 'ecs/firelens_log_router_props.rb', line 141

def image
  @image
end

#inference_accelerator_resources ⇒ Array<String>? (readonly)

Note:

Default: - No inference accelerators assigned.

The inference accelerators referenced by the container.

Returns:

  • (Array<String>, nil) 


256
257
258
 
# File 'ecs/firelens_log_router_props.rb', line 256

def inference_accelerator_resources
  @inference_accelerator_resources
end

#interactive ⇒ Boolean? (readonly)

Note:

Default: - false

When this parameter is true, you can deploy containerized applications that require stdin or a tty to be allocated.

Returns:

  • (Boolean, nil)

See Also:



262
263
264
 
# File 'ecs/firelens_log_router_props.rb', line 262

def interactive
  @interactive
end

#linux_parameters ⇒ AWSCDK::ECS::LinuxParameters? (readonly)

Note:

Default: - No Linux parameters.

Linux-specific modifications that are applied to the container, such as Linux kernel capabilities.

For more information see KernelCapabilities.

Returns:



269
270
271
 
# File 'ecs/firelens_log_router_props.rb', line 269

def linux_parameters
  @linux_parameters
end

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

Note:

Default: - Containers use the same logging driver that the Docker daemon uses.

The log configuration specification for the container.

Returns:



274
275
276
 
# File 'ecs/firelens_log_router_props.rb', line 274

def logging
  @logging
end

#memory_limit_mib ⇒ Numeric? (readonly)

Note:

Default: - No memory limit.

The amount (in MiB) of memory to present to the container.

If your container attempts to exceed the allocated memory, the container is terminated.

At least one of memoryLimitMiB and memoryReservationMiB is required for non-Fargate services.

Returns:

  • (Numeric, nil) 


284
285
286
 
# File 'ecs/firelens_log_router_props.rb', line 284

def memory_limit_mib
  @memory_limit_mib
end

#memory_reservation_mib ⇒ Numeric? (readonly)

Note:

Default: - No memory reserved.

The soft limit (in MiB) of memory to reserve for the container.

When system memory is under heavy contention, Docker attempts to keep the container memory to this soft limit. However, your container can consume more memory when it needs to, up to either the hard limit specified with the memory parameter (if applicable), or all of the available memory on the container instance, whichever comes first.

At least one of memoryLimitMiB and memoryReservationMiB is required for non-Fargate services.

Returns:

  • (Numeric, nil) 


297
298
299
 
# File 'ecs/firelens_log_router_props.rb', line 297

def memory_reservation_mib
  @memory_reservation_mib
end

#port_mappings ⇒ Array<AWSCDK::ECS::PortMapping>? (readonly)

Note:

Default: - No ports are mapped.

The port mappings to add to the container definition.

Returns:



302
303
304
 
# File 'ecs/firelens_log_router_props.rb', line 302

def port_mappings
  @port_mappings
end

#privileged ⇒ Boolean? (readonly)

Note:

Default: false

Specifies whether the container is marked as privileged.

When this parameter is true, the container is given elevated privileges on the host container instance (similar to the root user).

Returns:

  • (Boolean, nil) 


309
310
311
 
# File 'ecs/firelens_log_router_props.rb', line 309

def privileged
  @privileged
end

#pseudo_terminal ⇒ Boolean? (readonly)

Note:

Default: - false

When this parameter is true, a TTY is allocated.

This parameter maps to Tty in the "Create a container section" of the Docker Remote API and the --tty option to docker run.

Returns:

  • (Boolean, nil)

See Also:



318
319
320
 
# File 'ecs/firelens_log_router_props.rb', line 318

def pseudo_terminal
  @pseudo_terminal
end

#readonly_root_filesystem ⇒ Boolean? (readonly)

Note:

Default: false

When this parameter is true, the container is given read-only access to its root file system.

Returns:

  • (Boolean, nil) 


323
324
325
 
# File 'ecs/firelens_log_router_props.rb', line 323

def readonly_root_filesystem
  @readonly_root_filesystem
end

#restart_attempt_period ⇒ AWSCDK::Duration? (readonly)

Note:

Default: - Duration.seconds(300) if enableRestartPolicy is true, otherwise no period.

A period of time that the container must run for before a restart can be attempted.

A container can be restarted only once every restart_attempt_period seconds. If a container isn't able to run for this time period and exits early, it will not be restarted.

This property can't be used if enable_restart_policy is set to false.

You can set a minimum restart_attempt_period of 60 seconds and a maximum restart_attempt_period of 1800 seconds.

Returns:



336
337
338
 
# File 'ecs/firelens_log_router_props.rb', line 336

def restart_attempt_period
  @restart_attempt_period
end

#restart_ignored_exit_codes ⇒ Array<Numeric>? (readonly)

Note:

Default: - No exit codes are ignored.

A list of exit codes that Amazon ECS will ignore and not attempt a restart on.

This property can't be used if enable_restart_policy is set to false.

You can specify a maximum of 50 container exit codes.

Returns:

  • (Array<Numeric>, nil) 


345
346
347
 
# File 'ecs/firelens_log_router_props.rb', line 345

def restart_ignored_exit_codes
  @restart_ignored_exit_codes
end

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

Note:

Default: - No secret environment variables.

The secret environment variables to pass to the container.

Returns:



350
351
352
 
# File 'ecs/firelens_log_router_props.rb', line 350

def secrets
  @secrets
end

#start_timeout ⇒ AWSCDK::Duration? (readonly)

Note:

Default: - none

Time duration (in seconds) to wait before giving up on resolving dependencies for a container.

Returns:



355
356
357
 
# File 'ecs/firelens_log_router_props.rb', line 355

def start_timeout
  @start_timeout
end

#stop_timeout ⇒ AWSCDK::Duration? (readonly)

Note:

Default: - none

Time duration (in seconds) to wait before the container is forcefully killed if it doesn't exit normally on its own.

Returns:



360
361
362
 
# File 'ecs/firelens_log_router_props.rb', line 360

def stop_timeout
  @stop_timeout
end

#system_controls ⇒ Array<AWSCDK::ECS::SystemControl>? (readonly)

Note:

Default: - No system controls are set.

A list of namespaced kernel parameters to set in the container.

Returns:

See Also:



366
367
368
 
# File 'ecs/firelens_log_router_props.rb', line 366

def system_controls
  @system_controls
end

#task_definition ⇒ AWSCDK::ECS::TaskDefinition (readonly)

The name of the task definition that includes this container definition.

[disable-awslint:ref-via-interface]

Returns:



399
400
401
 
# File 'ecs/firelens_log_router_props.rb', line 399

def task_definition
  @task_definition
end

#ulimits ⇒ Array<AWSCDK::ECS::Ulimit>? (readonly)

An array of ulimits to set in the container.

Returns:



370
371
372
 
# File 'ecs/firelens_log_router_props.rb', line 370

def ulimits
  @ulimits
end

#user ⇒ String? (readonly)

Note:

Default: root

The user to use inside the container.

This parameter maps to User in the Create a container section of the Docker Remote API and the --user option to docker run.

Returns:

  • (String, nil)

See Also:



378
379
380
 
# File 'ecs/firelens_log_router_props.rb', line 378

def user
  @user
end

#version_consistency ⇒ AWSCDK::ECS::VersionConsistency? (readonly)

Note:

Default: VersionConsistency.DISABLED if image is a CDK asset, VersionConsistency.ENABLED otherwise

Specifies whether Amazon ECS will resolve the container image tag provided in the container definition to an image digest.

If you set the value for a container as disabled, Amazon ECS will not resolve the provided container image tag to a digest and will use the original image URI specified in the container definition for deployment.

Returns:

See Also:



388
389
390
 
# File 'ecs/firelens_log_router_props.rb', line 388

def version_consistency
  @version_consistency
end

#working_directory ⇒ String? (readonly)

Note:

Default: /

The working directory in which to run commands inside the container.

Returns:

  • (String, nil) 


393
394
395
 
# File 'ecs/firelens_log_router_props.rb', line 393

def working_directory
  @working_directory
end

Class Method Details

.jsii_properties ⇒ Object 



405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
 
# File 'ecs/firelens_log_router_props.rb', line 405

def self.jsii_properties
  {
    :image => "image",
    :command => "command",
    :container_name => "containerName",
    :cpu => "cpu",
    :credential_specs => "credentialSpecs",
    :disable_networking => "disableNetworking",
    :dns_search_domains => "dnsSearchDomains",
    :dns_servers => "dnsServers",
    :docker_labels => "dockerLabels",
    :docker_security_options => "dockerSecurityOptions",
    :enable_restart_policy => "enableRestartPolicy",
    :entry_point => "entryPoint",
    :environment => "environment",
    :environment_files => "environmentFiles",
    :essential => "essential",
    :extra_hosts => "extraHosts",
    :gpu_count => "gpuCount",
    :health_check => "healthCheck",
    :hostname => "hostname",
    :inference_accelerator_resources => "inferenceAcceleratorResources",
    :interactive => "interactive",
    :linux_parameters => "linuxParameters",
    :logging => "logging",
    :memory_limit_mib => "memoryLimitMiB",
    :memory_reservation_mib => "memoryReservationMiB",
    :port_mappings => "portMappings",
    :privileged => "privileged",
    :pseudo_terminal => "pseudoTerminal",
    :readonly_root_filesystem => "readonlyRootFilesystem",
    :restart_attempt_period => "restartAttemptPeriod",
    :restart_ignored_exit_codes => "restartIgnoredExitCodes",
    :secrets => "secrets",
    :start_timeout => "startTimeout",
    :stop_timeout => "stopTimeout",
    :system_controls => "systemControls",
    :ulimits => "ulimits",
    :user => "user",
    :version_consistency => "versionConsistency",
    :working_directory => "workingDirectory",
    :task_definition => "taskDefinition",
    :firelens_config => "firelensConfig",
  }
end

Instance Method Details

#to_jsii ⇒ Object 



451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
 
# File 'ecs/firelens_log_router_props.rb', line 451

def to_jsii
  result = {}
  result.merge!(super)
  result.merge!({
    "image" => @image,
    "command" => @command,
    "containerName" => @container_name,
    "cpu" => @cpu,
    "credentialSpecs" => @credential_specs,
    "disableNetworking" => @disable_networking,
    "dnsSearchDomains" => @dns_search_domains,
    "dnsServers" => @dns_servers,
    "dockerLabels" => @docker_labels,
    "dockerSecurityOptions" => @docker_security_options,
    "enableRestartPolicy" => @enable_restart_policy,
    "entryPoint" => @entry_point,
    "environment" => @environment,
    "environmentFiles" => @environment_files,
    "essential" => @essential,
    "extraHosts" => @extra_hosts,
    "gpuCount" => @gpu_count,
    "healthCheck" => @health_check,
    "hostname" => @hostname,
    "inferenceAcceleratorResources" => @inference_accelerator_resources,
    "interactive" => @interactive,
    "linuxParameters" => @linux_parameters,
    "logging" => @logging,
    "memoryLimitMiB" => @memory_limit_mib,
    "memoryReservationMiB" => @memory_reservation_mib,
    "portMappings" => @port_mappings,
    "privileged" => @privileged,
    "pseudoTerminal" => @pseudo_terminal,
    "readonlyRootFilesystem" => @readonly_root_filesystem,
    "restartAttemptPeriod" => @restart_attempt_period,
    "restartIgnoredExitCodes" => @restart_ignored_exit_codes,
    "secrets" => @secrets,
    "startTimeout" => @start_timeout,
    "stopTimeout" => @stop_timeout,
    "systemControls" => @system_controls,
    "ulimits" => @ulimits,
    "user" => @user,
    "versionConsistency" => @version_consistency,
    "workingDirectory" => @working_directory,
    "taskDefinition" => @task_definition,
    "firelensConfig" => @firelens_config,
  })
  result.compact
end