softramsdocker/devops-toolset repository overview

⁠IaC devops Environment

In the devOps culture, we encourage all to develop and work on infrastructure and devOps toolsets. Often there are times where developers just dont have the knowledge to get all the tools setup correctly and use the correct versions. This project is our way of solving that issue. From within this project you will have a fully setup VSCode within your browser, that has terraform, terragrunt, and amplify frameworks, so non operations teams can work and learn to modify and run IaC.

While there are many options, we wanted to build a fully browser based environment that doesn't require any installation or needing to know how to work with Git to create branches, checkouts and pull requests. We wanted to bring a better flow that can work for even non-technical teams to colloborate.

This is our first step in that direction. This container will help teams to bring immutability to devops environments and manage a consistent environment across teams.

⁠Benefits using this container

• Immutable infrasturucture for building environments
• Everything needed to write and run tests with terraform/terragrunt or amplify are included
• No more it runs fine on my local for devops tools
• Manage consistency and versioning of your devops toolsets

⁠Included in the container

• Terraform
• Terraform-Docs
• Terragrunt
• Ansible
• Pre-commit
• Amplify
• Brew
• AWS CLI
• VSCode
• VSCode extension for Terraform

⁠Installation

⁠Docker

• If you are using linux, install docker: http://docs.docker.com/linux/step_one/⁠
• On mac and windows, install docker desktop: https://www.docker.com/products/docker-desktop⁠

⁠AWSCli

    # MacOS and Linux
    # Brew install
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

    # AWSCli Install
    # MacOS and Linux
    brew install awscli

    # Windows
    # Download the installer: https://awscli.amazonaws.com/AWSCLIV2.msi and install with admin rights

    # Configure AWSCli
    # MacOS and Linux: Open a terminal window
    aws configure # Use the credentials provided by your devOps team

    # Windows: Open a powershell window
    aws configure # Use the credentials provided by your devOps team

⁠Setting up

    # Clone this repo
    https://github.com/softrams/devops-toolset.git
    
    # Change directory into the cloned folder
    cd devops-toolset
    
    # Bring up the environment
    ## MacOS or Linux
    docker-compose up -d
    
    ## Windows 
    docker-compose up -d -f docker-compose.windows.yml

    # Access VSCode in browser
    open http://localhost:8080
    
    # to Shutdown the environment
    docker-compose down

⁠Mount Local Workspace

When container is launched, it creates a folder in user's home directory, called "devops-home". You can change this by modifying docker-compose to any folder of your choice.

• Container: /home/linuxbrew
• Host: ~/devops-home

Now, go ahead and clone your test devops repo to ~/devops-home or create symlinks to open from browser and start building.

⁠Thanks to these amazing projects

• Amplify Framework (https://docs.amplify.aws/⁠)
• VSCode (https://code.visualstudio.com/⁠)
• VSCode in browser (https://github.com/cdr/code-server⁠)
• Docker (https://www.docker.com/⁠)
• Terraform (https://www.terraform.io⁠)
• Terraform-docs (https://github.com/terraform-docs/terraform-docs⁠)
• Pre-commit-terraform (https://github.com/antonbabenko/pre-commit-terraform⁠)
• Terragrunt (https://www.terragrunt.io⁠)
• Brew (https://brew.sh/⁠)
• Ansible (https://www.ansible.com/⁠)

⁠Contributing

Welcome PRs with suggestions and improvements towards bringing full test environments to browser.