{"id":18258935,"url":"https://github.com/pottava/dockerized-aws-x-ray","last_synced_at":"2025-04-04T19:32:29.520Z","repository":{"id":24635466,"uuid":"102103141","full_name":"pottava/dockerized-aws-x-ray","owner":"pottava","description":"The most light-weighted dockerized AWS X-Ray daemon with Alpine Linux.","archived":false,"fork":false,"pushed_at":"2022-11-02T04:21:25.000Z","size":102,"stargazers_count":3,"open_issues_count":59,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-03-25T19:19:47.049Z","etag":null,"topics":["aws","docker","ecs","golang","x-ray"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/pottava/xray/","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pottava.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-01T10:40:15.000Z","updated_at":"2022-02-17T02:37:42.000Z","dependencies_parsed_at":"2023-01-14T01:20:10.950Z","dependency_job_id":null,"html_url":"https://github.com/pottava/dockerized-aws-x-ray","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottava%2Fdockerized-aws-x-ray","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottava%2Fdockerized-aws-x-ray/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottava%2Fdockerized-aws-x-ray/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottava%2Fdockerized-aws-x-ray/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pottava","download_url":"https://codeload.github.com/pottava/dockerized-aws-x-ray/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223154892,"owners_count":17096833,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","docker","ecs","golang","x-ray"],"created_at":"2024-11-05T10:35:29.931Z","updated_at":"2024-11-05T10:35:30.980Z","avatar_url":"https://github.com/pottava.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dockerized AWS X-Ray Daemon\n\n[![pottava/xray](http://dockeri.co/image/pottava/xray)](https://hub.docker.com/r/pottava/xray/)\n\nSupported tags and respective `Dockerfile` links:\n\n・latest ([versions/3.2/amd/Dockerfile](https://github.com/pottava/dockerized-aws-x-ray/blob/master/versions/3.2/amd/Dockerfile))  \n・3.2 ([versions/3.2/amd/Dockerfile](https://github.com/pottava/dockerized-aws-x-ray/blob/master/versions/3.2/amd/Dockerfile))  \n・3.2-arm ([versions/3.2/arm/Dockerfile](https://github.com/pottava/dockerized-aws-x-ray/blob/master/versions/3.2/arm/Dockerfile))  \n・2.1 ([versions/2.1/Dockerfile](https://github.com/pottava/dockerized-aws-x-ray/blob/master/versions/2.1/Dockerfile))  \n\n## Usage\n\n```sh\n$ docker run --rm pottava/xray:3.2 --version\nAWS X-Ray daemon version: 3.2.0\n$ docker run --rm pottava/xray:3.2 --help\nUsage: X-Ray [options]\n  -a --resource-arn Amazon Resource Name (ARN) of the AWS resource running the daemon.\n  ..\n```\n\n### Local\n\n```sh\n$ docker run --name xray -d \\\n    -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY \\\n    -p 2000:2000/udp -p 2000:2000/tcp \\\n    pottava/xray:3.2 --region ${AWS_REGION} --local-mode\n```\n\n* with Docker-Compose:\n\n```yaml\nversion: \"2.4\"\nservices:\n  app:\n    image: \u003cyour-some-application\u003e\n    ports:\n      - 80:80\n    environment:\n      - AWS_XRAY_DAEMON_ADDRESS=xray:2000\n    container_name: app\n  xray:\n    image: pottava/xray:3.2\n    command: --region ${AWS_REGION} --local-mode\n    environment:\n      - AWS_ACCESS_KEY_ID\n      - AWS_SECRET_ACCESS_KEY\n    container_name: xray\n```\n\n### ECS\n\n* with AWS CloudFormation:\n\n```yaml\nTaskDef:\n  Type: AWS::ECS::TaskDefinition\n  Properties:\n    ContainerDefinitions:\n      - Name: app\n        Image: \u003cyour-some-application\u003e\n        PortMappings:\n          - ContainerPort: 80\n            HostPort: 0\n        Environment:\n          - Name: AWS_XRAY_DAEMON_ADDRESS\n            Value: xray:2000\n        Links:\n          - xray-daemon:xray\n        Cpu: 10\n        Memory: 100\n        MemoryReservation: 32\n        Essential: true\n      - Name: xray-daemon\n        Image: pottava/xray:3.2\n        Cpu: 10\n        Memory: 100\n        MemoryReservation: 32\n    Family: xxxx\n    TaskRoleArn: xxxx\n```\n\n* with AWS-CLI (JSON format for register-task-definition)\n\n```json\n[\n  {\n    \"name\": \"app\",\n    \"image\": \"\u003cyour-some-application\u003e\",\n    \"portMappings\": [\n      {\n        \"protocol\": \"tcp\",\n        \"containerPort\": 80,\n        \"hostPort\": 0\n      }\n    ],\n    \"environment\": [\n      {\"name\": \"AWS_XRAY_DAEMON_ADDRESS\", \"value\": \"xray:2000\"}\n    ],\n    \"links\": [\n      \"xray-daemon:xray\"\n    ],\n    \"cpu\": 10,\n    \"memory\": 100,\n    \"memoryReservation\": 32,\n    \"essential\": true\n  },\n  {\n    \"name\": \"xray-daemon\",\n    \"image\": \"pottava/xray:3.2\",\n    \"cpu\": 10,\n    \"memory\": 100,\n    \"memoryReservation\": 32,\n    \"essential\": false\n  }\n]\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpottava%2Fdockerized-aws-x-ray","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpottava%2Fdockerized-aws-x-ray","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpottava%2Fdockerized-aws-x-ray/lists"}