ECS on EC2

Prerequisites

• ACCESS_KEY: The agent access key.

• COLLECTOR: Use the collector address for your region. For more information, see SaaS Regions and IP Ranges.

• TAGS: The list of tags for the host where the agent is installed. For example: role:webserver, location:europe, role:webserver (used with Sysdig Monitor)

Overview

To install the Sysdig agent on ECS, follow these steps:

1. Create an ECS task definition for the Sysdig agent.
2. Register the task definition in your AWS account.
3. Create a service with the previous task definition to run the Sysdig agent on each of the nodes of your ECS cluster.

Deployment

1. Create an ECS task definition.

   Use the values from the prerequisites to customize the JSON snippet below and save it as a file named sysdig-agent-ecs.json.

   Note that memory and cpu have both been set to 1024; depending on the size of your cluster you might want to tune those values.

     {
       "family": "sysdig-agent-ecs",
       "containerDefinitions": [
         {
           "name": "sysdig-agent",
           "image": "quay.io/sysdig/agent-slim",
           "cpu": 1024,
           "memory": 1024,
           "privileged": true,
           "environment": [
             {
               "name": "ACCESS_KEY",
               "value": "$ACCESS_KEY"
             },
             {
               "name": "COLLECTOR",
               "value": "$COLLECTOR"
             },
             {
               "name": "TAGS",
               "value": "$TAG1,TAG2"
             }
           ],
           "mountPoints": [
             {
               "readOnly": true,
               "containerPath": "/host/boot",
               "sourceVolume": "boot"
             },
             {
               "containerPath": "/host/dev",
               "sourceVolume": "dev"
             },
             {
               "readOnly": true,
               "containerPath": "/host/lib/modules",
               "sourceVolume": "modules"
             },
             {
               "readOnly": true,
               "containerPath": "/host/proc",
               "sourceVolume": "proc"
             },
             {
               "containerPath": "/host/var/run/docker.sock",
               "sourceVolume": "sock"
             },
             {
               "readOnly": true,
               "containerPath": "/host/usr",
               "sourceVolume": "usr"
             }
           ],
           "dependsOn": [
             {
               "containerName": "sysdig-agent-kmodule",
               "condition": "SUCCESS"
             }
           ]
         },
         {
           "name": "sysdig-agent-kmodule",
           "image": "quay.io/sysdig/agent-kmodule",
           "memory": 512,
           "privileged": true,
           "essential": false,
           "mountPoints": [
             {
               "readOnly": true,
               "containerPath": "/host/boot",
               "sourceVolume": "boot"
             },
             {
               "containerPath": "/host/dev",
               "sourceVolume": "dev"
             },
             {
               "readOnly": true,
               "containerPath": "/host/lib/modules",
               "sourceVolume": "modules"
             },
             {
               "readOnly": true,
               "containerPath": "/host/proc",
               "sourceVolume": "proc"
             },
             {
               "containerPath": "/host/var/run/docker.sock",
               "sourceVolume": "sock"
             },
             {
               "readOnly": true,
               "containerPath": "/host/usr",
               "sourceVolume": "usr"
             }
           ]
         }
       ],
       "pidMode": "host",
       "networkMode": "host",
       "volumes": [
         {
           "name": "sock",
           "host": {
             "sourcePath": "/var/run/docker.sock"
           }
         },
         {
           "name": "dev",
           "host": {
             "sourcePath": "/dev/"
           }
         },
         {
           "name": "proc",
           "host": {
             "sourcePath": "/proc/"
           }
         },
         {
           "name": "boot",
           "host": {
             "sourcePath": "/boot/"
           }
         },
         {
           "name": "modules",
           "host": {
             "sourcePath": "/lib/modules/"
           }
         },
         {
           "name": "usr",
           "host": {
             "sourcePath": "/usr/"
           }
         }
       ],
       "requiresCompatibilities": [
         "EC2"
       ]
     }
   

2. Register a task definition.

   Once your task definition is ready, ensure that you register it in your AWS account:

   aws ecs register-task-definition \
     --cli-input-json file://sysdig-agent-ecs.json
   

3. Run the agent as an ECS service.

   Using the ECS task definition you have created, create a service in the cluster where you want Sysdig monitor and perform threat detection.

   aws ecs create-service \
       --cluster $CLUSTER_NAME \
       --service-name sysdig-agent-svc \
       --launch-type EC2 \
       --task-definition sysdig-agent-ecs \
       --scheduling-strategy DAEMON
   

   With the agent installed, Sysdig will begin auto-discovering your containers and other resources of your ECS environment.