Docker Compose collection of tech stack samples

About • Disclaimer • Getting Started • Download • How To Use • Samples • FAQ

Useful Tips • Changelog • Contributing • Security Vulnerabilities • Credits • Sponsor • License

About

This repository is a collection of Docker Compose files for tech stack samples, including frameworks, blog platforms, CMS, e-commerce, headless CMS, and "Hello, World!" examples for most common programming languages. The samples offer a simple approach to setting up their respective tech stacks for a local environment.

What is the purpose of the Playground collection?

The Playground collection provides a starting point for how to integrate different services and allows you to learn and experiment with tech stacks. By having the tech stack samples run in a Docker environment, you don't have to install additional dependencies before you can get started.

Disclaimer

Note : The Playground samples are intended for use in local development environments such as prototyping, tinkering with software stacks, etc. These samples MUST NOT be deployed in production environments.

Getting Started

You will need to make sure your system meets the following prerequisites:

• Docker Engine >= 20.10.00

This repository utilizes Docker to run the tech stack samples. So, before using any of the Playground samples, make sure you have Docker installed on your system.

Download

You can clone the latest version of Playground repository for macOS, Linux and Windows.

# Clone this repository.
$ git clone [email protected]:luisaveiro/playground.git --branch main --single-branch

All Playground samples can be found in samples directory.

# Navigate to the samples
$ cd playground/samples

How To Use

There are a few steps you need to follow before you have a Playground sample set up and running in a Docker container. I have outlined the included files you would need to take to get started.

1. DotEnv

You can override the variables in the Docker Compose file, e.g. container name, network name and port mapping. All Playground samples include a DotEnv example file (.env.example) that you can copy to create your DotEnv file and override the Docker Compose variables.

2. Dockerfile

Some tech stacks require additional dependencies, e.g. libraries and CLI tools. However, not all tech stacks offer an official Docker image. I have included a Dockerfile for Playground samples that need a Docker image with the necessary dependencies.

The Docker Compose file and Makefile automatically build the Docker image from the Dockerfile.

3. Makefile

The Makefile offers a developer-friendly approach to automate the set up of Playground samples. Some tech stacks CLI tools have a setup command that offers an initial starter app.

If the Playground sample has a Dockerfile, the Makefile will build the Docker image from the Dockerfile. The Makefile will execute the setup command in a Docker container. You will need to follow the CLI installation steps.

The Makefile will create and attach the CODE_DIR (default code directory) as a Docker volume. Your new Playground sample source code will be stored in the CODE_DIR.

In each Playground samples' Makefile I have included an example on how to execute the make command. You will need to execute the make command before you can have the Playground sample set up and running in a Docker container.

4. Docker Compose

Each Playground sample has its individual Docker Compose file. All samples' services will run in separate Docker containers. Playground sample source code will be stored in the CODE_DIR (default code directory) as a Docker volume.

Playground samples that do not have have a Makefile will automatically execute the setup command of their respective tech stacks.

To start a Playground sample, you can run the following command:

$ docker compose up

# or run container in detached mode
$ docker compose up -d

Samples

There are currently 63 samples included in the Playground repository. The Playground samples are categorised into one of the following tech stacks:

Programming Languages

• Bash
• C
• C++
• Dart
• Elixir
• Erlang
• Golang
• Java
• PHP (Apache)
• PHP (CLI)
• Python
• Ruby
• Rust
• Swift

Analytics Platforms

• Ackee

Blogs

• Ghost
• Jekyll

Content Management Systems (CMS)

• ApostropheCMS
• Drupal
• Joomla
• WordPress

CSS Frameworks

• Bootstrap
• Tailwind CSS

E-commerce

• PrestaShop

Frameworks

• Alpine.js
• Angular
• Django
• Egg
• Express
• Fastify
• Fiber
• Flask
• Fresh
• Gin
• Lit (Vite)
• NestJS
• Preact (Vite)
• React (Vite)
• Revel
• Rocket
• Solid
• Svelte (Vite)
• Vue (Vite)

Full Stack Frameworks (FSF)

• Blitz
• Copper
• Next.js
• Nuxt
• Redwood
• Remix
• Ruby on Rails
• SvelteKit

Headless CMS

• Directus
• Strapi
• Tina

JavaScript Runtimes

• Bun
• Deno
• Node

Slides

• Slidev

Static Site Generators (SSG)

• Astro
• Docusaurus
• Gatsby
• Hugo
• Lume
• VuePress

Web Servers

• Apache
• Caddy
• Nginx

FAQ

Q: Are you planning to add additional tech stack samples?
A: I do have a roadmap for adding additional tech stack samples to Playground. However, you can suggest a tech stack in the Discussion section and I will try to include the sample as part of Playground collection.

Q: Are you able to provide "beginner" guides for each sample?
A: I will be providing additional readme files for each Playground sample that will include how to get started and use the sample.

Q: Are you able to provide "How-to" guides to combine multiple samples?
A: Yes, I will be including additional guides to help developers that want to combine two or more Playground samples.

Useful Tips

Fig is a CLI tool that adds VSCode-style autocomplete to your existing Terminal. You can build autocomplete functionality for any CLI with javascript, not bash. You can share it with your team, or contribute to Fig open source specs for tools like git, aws, kubectl.

Localhost Databases is a collection of Docker Compose files for relational and NoSQL databases. Which aims to offer a simple approach to setting up databases for a local environment.

Docker Reverse Proxy offers a simple approach to having a Caddy Server as a local reverse proxy for your Docker containers.

Programiz let's you learn to code in Python, C/C++, Java, and other popular programming languages with their beginner-friendly tutorials and examples.

Kodekloud.com offer courses with real scenarios and practice labs to become a DevOps expert. They provide a learning path to guide you in your journey in DevOps from the basics concepts to in-depth advanced topics to help you prepare for your certifications.

Kodekloud has a free Docker For The Absolute Beginner course. The course will help you practice Docker commands and developing your own images using Dockerfiles and practice Docker Compose.

Please note: Most of the courses on Kodekloud.com require you to pay for a subscription to access the course content and materials.

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

I encourage you to contribute to Playground! Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

Please check out the contributing to Playground guide for guidelines about how to proceed.

Security Vulnerabilities

Trying to report a possible security vulnerability in Playground samples? Please check out our security policy for guidelines about how to proceed.

Credits

The illustration used in the project is from unDraw (created by Katerina Limpitsouni). All product names, logos, brands, trademarks and registered trademarks are property of their respective owners.

Sponsor

Do you like this project? Support it by donating.

License

The MIT License (MIT). Please see License File for more information.

---

GitHub • LinkedIn • Twitter