{"id":19336784,"url":"https://github.com/samrocketman/docker-aws-tools","last_synced_at":"2025-06-27T18:04:19.996Z","repository":{"id":145441911,"uuid":"252334806","full_name":"samrocketman/docker-aws-tools","owner":"samrocketman","description":"A quick start for AWS infrastructure development in a Dockerized dev environment.","archived":false,"fork":false,"pushed_at":"2020-10-18T07:11:58.000Z","size":224,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-24T08:13:36.465Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/samrocketman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-02T02:21:37.000Z","updated_at":"2024-03-24T21:38:45.000Z","dependencies_parsed_at":"2023-06-03T18:32:15.984Z","dependency_job_id":null,"html_url":"https://github.com/samrocketman/docker-aws-tools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/samrocketman/docker-aws-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samrocketman%2Fdocker-aws-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samrocketman%2Fdocker-aws-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samrocketman%2Fdocker-aws-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samrocketman%2Fdocker-aws-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samrocketman","download_url":"https://codeload.github.com/samrocketman/docker-aws-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samrocketman%2Fdocker-aws-tools/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262307403,"owners_count":23291070,"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":[],"created_at":"2024-11-10T03:12:26.802Z","updated_at":"2025-06-27T18:04:19.921Z","avatar_url":"https://github.com/samrocketman.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Common AWS Dev Tools [![Build Status][build-status]][build-url]\n\nThis provides a neat package for having AWS development utilities on your\ncomputer without having to install all of the heavy requirements directly.\n\nFeatures:\n\n* Get started with developing AWS infrastructure code quickly.\n* Integrates with your shell environment to be launched from any project.  (via\n  [cli alias](#aws-tools-command-alias))\n* Running VS Code IDE from inside of a docker container.\n* Fast cleanup, just delete the docker image via `make clean`.\n\n# Usage\n\nRunning `make` without arguments will give you the following usage.\n\n```\nThe following make commands are available\n    make cli   - shows a CLI.\n    make gui   - shows a VS Code editor (requires X11 or XQuartz on Mac).\n    make test  - runs infra tests against the aws-tools docker image.\n    make clean - Removes docker image created.\n```\n\n# Getting started\n\n* [CDK workshop](https://cdkworkshop.com/30-python/20-create-project/100-cdk-init.html)\n* [CDK examples](https://github.com/aws-samples/aws-cdk-examples)\n\n# What is available?\n\n[CentOS 8][cent] is the operating system provided with root access via sudo.\n\nSystem tools:\n\n* [Node JS][js] - dependency for CDK\n* [Python 3][py] - dependency for AWS CLI and cfn-init\n* [VS Code][code] - Microsoft VS Code for an IDE.\n* [X11][X] - To run VS Code inside of the container.  On Mac OS X, you need to\n  install [XQuartz][XQ] for this to work.\n* [dumb-init][Yelp] - lightweight /sbin/init process\n* [git][git]\n* [goss][goss] - infrastructure test utility\n* [jq][jq] - JSON parsing CLI utility\n* vim - A CLI editor.  Run `vimtutor` to learn more.\n\nAWS Tools Provided:\n\n| Latest version | Additional Information |\n| -------------- | ---------------------- |\n| ![CDK current version](https://img.shields.io/node/v/aws-cdk?label=aws-cdk)              | [AWS CDK][cdk] |\n| ![CLI current version](https://img.shields.io/pypi/v/awscli?label=awscli)                | [AWS CLI][cli] |\n| ![cfn-lint current version](https://img.shields.io/pypi/v/cfn-lint?label=cfn-lint)       | [cfn-lint][lint] - a CloudFormation stack linter. |\n| ![serverless current version](https://img.shields.io/node/v/serverless?label=serverless) | [serverless framework][serverless] |\n\n# aws-tools command alias\n\nYou can install this into your system for development as an `aws-tools` command.\nPlease note, the following commands are meant to be run from the root of this\nrepository so that it properly evaluates the path.\n\nOn Linux,\n\n    make build\n    echo \"alias aws-tools='make -f \\\"$PWD\\\"/Makefile.alternate'\" \u003e\u003e ~/.bashrc\n\nOn Mac OS X,\n\n    make build\n    echo \"alias aws-tools='make -f \\\"$PWD\\\"/Makefile.alternate'\" \u003e\u003e ~/.bash_profile\n\nThe next time you open your terminal you'll have the `aws-tools` command\navailable.\n\n    aws-tools cli\n    aws-tools gui\n\n# Screenshot\n\nRunning VS Code from a docker container on Pop! OS 18.04 GNU/Linux.\n\n![screenshot](screenshot.png)\n\n# Troubleshooting\n\nQ: Slowness of VS Code on Mac OS X when running `make gui` or `aws-tools gui`.\n\n* A: Not much I can do about that with XQuartz.  There's currently an [open\n  XQuartz issue][xquartz-slowness].  Consider X11 support for this\n  unstable/experimental.  Using a Linux distro or a Linux VM on Mac is best.\n\nQ: Can't connect to X session from Mac.\n\n* A: Go to XQuartz settings under security and enable `Authenticate sessions`\n  and enable `Allow connections from network clients`.\n\n[MIT Licensed](LICENSE.txt)\n\n[XQ]: https://www.xquartz.org/\n[X]: https://www.x.org/\n[Yelp]: https://github.com/Yelp/dumb-init\n[build-status]: https://travis-ci.com/samrocketman/docker-aws-tools.svg?branch=master\n[build-url]: https://travis-ci.com/samrocketman/docker-aws-tools\n[cdk]: https://aws.amazon.com/cdk/\n[cent]: https://www.centos.org/about/\n[cli]: https://aws.amazon.com/cli/\n[code]: https://code.visualstudio.com/\n[git]: https://git-scm.com/\n[goss]: https://github.com/aelsabbahy/goss\n[jq]: https://stedolan.github.io/jq/\n[js]: https://nodejs.org/\n[lint]: https://github.com/aws-cloudformation/cfn-python-lint\n[py]: https://www.python.org/\n[serverless]: https://www.serverless.com/framework/docs/\n[xquartz-slowness]: https://gitlab.freedesktop.org/xorg/xserver/-/issues/188\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamrocketman%2Fdocker-aws-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamrocketman%2Fdocker-aws-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamrocketman%2Fdocker-aws-tools/lists"}