[DOCKGENTO]

Introduction

Just another Docker environment generator for Magento.

The main idea behind this tool is to have an automatic way to generate Magento environments for development, but also for production. To support this, Traefik has been included to the tech stack, enabling SSL termination and simplifying the generation of SSL certificates for live sites.

It is worth mentioning that this tool was inspired by other excellent tools that achieve similar goals, including:

• Mark Shust's Docker Magento
• Warden

Note

Mark Shust's Docker Magento also provides great video tutorials on configuring your IDE to work seamlessly with Docker.

Prerequisites

Before using this tool, ensure that you have:

• User with sudo privileges. Learn more about why this is necessary here.

• Git installed on your system.

Installation

To install this tool, run the following command:

git clone https://github.com/d3p1/dockgento.git && \
chmod +x dockgento/src/bin/setup/installer.sh   && \
./dockgento/src/bin/setup/installer.sh          && \
source ~/.bash_profile                          && \
rm -rf dockgento/

Usage

Using this tool is straightforward:

1. Create a .dockgento_profile file. This file lets you configure environment variables that define how the project environment should be generated.

2. Execute dockgento init to generate the necessary Docker Compose files for the project.

3. Execute dockgento mage-install if you want to install a new Magento platform to work with the current generated environment. Or execute dockgento mage-configure if you want to configure an existing Magento project to work with the current environment.

4. Execute dockgento ide-configure to simplify the configuration of your IDE, allowing you to work with this generated environment efficiently and effectively.

Important

For now, dockgento ide-configure only installs startup scripts that are very useful for PHPStorm. However, automating the configuration of other important aspects and supporting additional IDEs is still pending. This ticket and this ticket will handle the completion of this requirement.

Note

To gain a deeper understanding of how this tool works under the hood, visit the wiki page.

Note

If you encounter issues while using this tool, refer to the troubleshooting page for guidance.

Important

Please note that as of now, this tool has only been tested on Debian 12 and requires an environment with bash to function correctly.

Changelog

Detailed changes for each release are documented in CHANGELOG.md.

License

This work is published under MIT License.

Author

Always happy to receive a greeting on:

• LinkedIn
• Web