Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/awslabs/aws-terraform-dev-container

A VSCode Dev Container with tools to help you build and manage AWS infrastructure with Terraform
https://github.com/awslabs/aws-terraform-dev-container

aws container devcontainer development environment terraform vscode

Last synced: about 2 months ago
JSON representation

A VSCode Dev Container with tools to help you build and manage AWS infrastructure with Terraform

Awesome Lists containing this project

README 

        



![logo][logo]



# AWS Terraform Dev Container



A VSCode Dev Container with [tools][tools] to help you build and manage AWS infrastructure with Terraform



| ![screenshot-1](doc/images/screenshot-1.gif) |

|:--:|

| *Develop your project in a Docker container* |



| ![screenshot-2](doc/images/screenshot-2.gif) |

|:--:|

| *Increase productivity with well-defined `Make` commands* |



| ![screenshot-3](doc/images/screenshot-3.gif) |

|:--:|

| *Ensure every team member has all the tools on their correct versions* |



| ![screenshot-4](doc/images/screenshot-4.png) |

|:--:|

| *Extensions already installed for you* |



## Table of Contents



- [Getting Started](#getting-started)



- [Prerequisites](#prerequisites)



- [Usage](#usage)



## Getting Started



1. On a terminal, inside your Terraform project, execute the following on Mac, Linux or [WSL][wsl]:

```bash

curl -sL https://raw.githubusercontent.com/awslabs/aws-terraform-dev-container/main/scripts/init.sh | bash

````

2. Open the folder with VSCode

3. Reopen in Container



To reopen in container manually, open the [command pallete](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) on VS Code and select `Rebuild and Reopen in Container`



## Prerequisites

  A list of things you need, or how to install them.



- [Docker](https://www.docker.com/products/docker-desktop/) - The fastest way to containerize applications

- [Visual Studio Code](https://code.visualstudio.com/) - Visual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications.

- [VSCode Remote Development Extension Pack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) - An extension pack that lets you open any folder in a container, on a remote machine, or in WSL and take advantage of VS Code's full feature set.



## Usage

```bash

make [tab][tab]

```

For example, if you want to explore the most common [terraform][terraform] commands:

```bash

make terraform/[tab]

apply     clean     destroy   fmt       init      init/     plan      validate  version

```



To display all available commands:

```bash

make help

```

For more information about each [Make targets available](Makefile.md).



## References

- [Terraform by HashiCorp](https://www.terraform.io) - Terraform is an open-source infrastructure as code software tool that enables you to safely and predictably create, change, and improve infrastructure.

- [Changelog](CHANGELOG.md) - All notable changes.

- [Code Of Conduct](CODE_OF_CONDUCT.md) - Amazon Open Source Code of Conduct

- [Contributing](CONTRIBUTING.md) - Learn how to contribute

- [License](LICENSE) - MIT No Attribution

- [GNU Make](https://www.gnu.org/software/make/manual/make.html) - If you are new to make, or are looking for a general introduction.



## License

This project is licensed under the MIT-0 License. See the [LICENSE](LICENSE) file.



## Copyright

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.



[repo]: https://gitlab.aws.dev/proserve-labs/aws-terraform-dev-container

[logo]: doc/logo.png



[docker]: https://www.docker.com/products/docker-desktop/

[vscode-dev-container]: https://code.visualstudio.com/docs/remote/containers

[terraform]: https://www.terraform.io

[license]: LICENSE

[tools]: TOOLS

[wsl]: https://learn.microsoft.com/en-us/windows/wsl/install