# LinuxParameters

Linux-specific options that are applied to the container.

Extends: [Construct](https://docs.aws.amazon.com/cdk/api/v2/docs/constructs.Construct.html) › LinuxParameters
Implements: [IConstruct](https://docs.aws.amazon.com/cdk/api/v2/docs/constructs.IConstruct.html), [IDependable](https://docs.aws.amazon.com/cdk/api/v2/docs/constructs.IDependable.html)

- Source: [`aws-ecs/lib/linux-parameters.ts`](https://github.com/aws/aws-cdk/blob/v2.278.0/packages/aws-cdk-lib/aws-ecs/lib/linux-parameters.ts#L58)

## Example

TypeScript:

```ts
declare const taskDefinition: ecs.TaskDefinition;

taskDefinition.addContainer('container', {
  image: ecs.ContainerImage.fromRegistry("amazon/amazon-ecs-sample"),
  memoryLimitMiB: 1024,
  linuxParameters: new ecs.LinuxParameters(this, 'LinuxParameters', {
    initProcessEnabled: true,
    sharedMemorySize: 1024,
    maxSwap: Size.mebibytes(5000),
    swappiness: 90,
  }),
});
```

Python:

```python
# task_definition: ecs.TaskDefinition

task_definition.add_container("container",
    image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample"),
    memory_limit_mi_b=1024,
    linux_parameters=ecs.LinuxParameters(self, "LinuxParameters",
        init_process_enabled=True,
        shared_memory_size=1024,
        max_swap=Size.mebibytes(5000),
        swappiness=90
    )
)
```

Java:

```java
TaskDefinition taskDefinition;

taskDefinition.addContainer("container", ContainerDefinitionOptions.builder()
        .image(ContainerImage.fromRegistry("amazon/amazon-ecs-sample"))
        .memoryLimitMiB(1024)
        .linuxParameters(LinuxParameters.Builder.create(this, "LinuxParameters")
                .initProcessEnabled(true)
                .sharedMemorySize(1024)
                .maxSwap(Size.mebibytes(5000))
                .swappiness(90)
                .build())
        .build());
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
TaskDefinition taskDefinition;

taskDefinition.AddContainer("container", new ContainerDefinitionOptions {
    Image = ContainerImage.FromRegistry("amazon/amazon-ecs-sample"),
    MemoryLimitMiB = 1024,
    LinuxParameters = new LinuxParameters(this, "LinuxParameters", new LinuxParametersProps {
        InitProcessEnabled = true,
        SharedMemorySize = 1024,
        MaxSwap = Size.Mebibytes(5000),
        Swappiness = 90
    })
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
var taskDefinition TaskDefinition

taskDefinition.AddContainer(jsii.String("container"), &ContainerDefinitionOptions{
	Image: ecs.ContainerImage_FromRegistry(jsii.String("amazon/amazon-ecs-sample")),
	MemoryLimitMiB: jsii.Number(1024),
	LinuxParameters: ecs.NewLinuxParameters(this, jsii.String("LinuxParameters"), &LinuxParametersProps{
		InitProcessEnabled: jsii.Boolean(true),
		SharedMemorySize: jsii.Number(1024),
		MaxSwap: awscdk.Size_Mebibytes(jsii.Number(5000)),
		Swappiness: jsii.Number(90),
	}),
})
```

## Initializer

TypeScript:

```ts
new LinuxParameters(scope: Construct, id: string, props?: LinuxParametersProps)
```

Python:

```python
LinuxParameters(scope: Construct, id: str, props: typing.Optional[LinuxParametersProps] = None)
```

Java:

```java
new LinuxParameters(Construct scope, String id, LinuxParametersProps props)
```

C# / .NET:

```csharp
new LinuxParameters(Construct scope, string id, LinuxParametersProps? props = null)
```

Golang:

```go
NewLinuxParameters(Scope Construct, Id *string, Props LinuxParametersProps)
```

## Construct Props

- `initProcessEnabled`: boolean = false — Specifies whether to run an init process inside the container that forwards signals and reaps processes.

- `maxSwap`: [Size](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.Size.html) — The total amount of swap memory a container can use.

  **Default:** No swap.

  This parameter
  will be translated to the --memory-swap option to docker run.

  This parameter is only supported when you are using the EC2 launch type.
  Accepted values are positive integers.

- `sharedMemorySize`: number — The value for the size of the /dev/shm volume.

  **Default:** No shared memory.

- `swappiness`: number = 60 — This allows you to tune a container's memory swappiness behavior.

  This parameter
  maps to the --memory-swappiness option to docker run. The swappiness relates
  to the kernel's tendency to swap memory. A value of 0 will cause swapping to
  not happen unless absolutely necessary. A value of 100 will cause pages to
  be swapped very aggressively.

  This parameter is only supported when you are using the EC2 launch type.
  Accepted values are whole numbers between 0 and 100. If a value is not
  specified for maxSwap then this parameter is ignored.

## Properties

- `node`: [Node](https://docs.aws.amazon.com/cdk/api/v2/docs/constructs.Node.html) — The tree node.

## Methods

- `addCapabilities(...cap: Capability[]): void` — Adds one or more Linux capabilities to the Docker configuration of a container.

  Tasks launched on Fargate only support adding the 'SYS_PTRACE' kernel capability.

- `addDevices(...device: Device[]): void` — Adds one or more host devices to a container.

- `addTmpfs(...tmpfs: Tmpfs[]): void` — Specifies the container path, mount options, and size (in MiB) of the tmpfs mount for a container.

  Only works with EC2 launch type.

- `dropCapabilities(...cap: Capability[]): void` — Removes one or more Linux capabilities to the Docker configuration of a container.

- `isConstruct(x: any): boolean` (static) — Checks if `x` is a construct.

  Use this method instead of `instanceof` to properly detect `Construct`
  instances, even when the construct library is symlinked.

  Explanation: in JavaScript, multiple copies of the `constructs` library on
  disk are seen as independent, completely different libraries. As a
  consequence, the class `Construct` in each copy of the `constructs` library
  is seen as a different class, and an instance of one class will not test as
  `instanceof` the other class. `npm install` will not create installations
  like this, but users may manually symlink construct libraries together or
  use a monorepo tool: in those cases, multiple copies of the `constructs`
  library can be accidentally installed, and `instanceof` will behave
  unpredictably. It is safest to avoid using `instanceof`, and using
  this type-testing method instead.

  **Parameters**

  - `x` — Any object.

  **Returns:** true if `x` is an object created from a class which extends `Construct`.

- `renderLinuxParameters(): CfnTaskDefinition.LinuxParametersProperty` — Renders the Linux parameters to a CloudFormation object.

- `toString(): string` — Returns a string representation of this construct.

- `with(...mixins: IMixin[]): IConstruct` — Applies one or more mixins to this construct.

  Mixins are applied in order. The list of constructs is captured at the
  start of the call, so constructs added by a mixin will not be visited.
  Use multiple `with()` calls if subsequent mixins should apply to added
  constructs.

  **Parameters**

  - `mixins` — The mixins to apply.

  **Returns:** This construct for chaining
