Dockerized AWS X-Ray Daemon

Supported tags and respective Dockerfile links:

・latest (versions/3.2/amd/Dockerfile)
・3.2 (versions/3.2/amd/Dockerfile)
・3.2-arm (versions/3.2/arm/Dockerfile)
・2.1 (versions/2.1/Dockerfile)

Usage

$ docker run --rm pottava/xray:3.2 --version
AWS X-Ray daemon version: 3.2.0
$ docker run --rm pottava/xray:3.2 --help
Usage: X-Ray [options]
  -a --resource-arn Amazon Resource Name (ARN) of the AWS resource running the daemon.
  ..

Local

$ docker run --name xray -d \
    -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY \
    -p 2000:2000/udp -p 2000:2000/tcp \
    pottava/xray:3.2 --region ${AWS_REGION} --local-mode

with Docker-Compose:

version: "2.4"
services:
  app:
    image: <your-some-application>
    ports:
      - 80:80
    environment:
      - AWS_XRAY_DAEMON_ADDRESS=xray:2000
    container_name: app
  xray:
    image: pottava/xray:3.2
    command: --region ${AWS_REGION} --local-mode
    environment:
      - AWS_ACCESS_KEY_ID
      - AWS_SECRET_ACCESS_KEY
    container_name: xray

ECS

with AWS CloudFormation:

TaskDef:
  Type: AWS::ECS::TaskDefinition
  Properties:
    ContainerDefinitions:
      - Name: app
        Image: <your-some-application>
        PortMappings:
          - ContainerPort: 80
            HostPort: 0
        Environment:
          - Name: AWS_XRAY_DAEMON_ADDRESS
            Value: xray:2000
        Links:
          - xray-daemon:xray
        Cpu: 10
        Memory: 100
        MemoryReservation: 32
        Essential: true
      - Name: xray-daemon
        Image: pottava/xray:3.2
        Cpu: 10
        Memory: 100
        MemoryReservation: 32
    Family: xxxx
    TaskRoleArn: xxxx

with AWS-CLI (JSON format for register-task-definition)

[
  {
    "name": "app",
    "image": "<your-some-application>",
    "portMappings": [
      {
        "protocol": "tcp",
        "containerPort": 80,
        "hostPort": 0
      }
    ],
    "environment": [
      {"name": "AWS_XRAY_DAEMON_ADDRESS", "value": "xray:2000"}
    ],
    "links": [
      "xray-daemon:xray"
    ],
    "cpu": 10,
    "memory": 100,
    "memoryReservation": 32,
    "essential": true
  },
  {
    "name": "xray-daemon",
    "image": "pottava/xray:3.2",
    "cpu": 10,
    "memory": 100,
    "memoryReservation": 32,
    "essential": false
  }
]

pottava/dockerized-aws-x-ray

Dockerized AWS X-Ray Daemon

Usage

Local

ECS