Mage2click toolset is a system-wide command-line tool for creating and managing simultaneously running Docker Magento projects with insanely easy installation and configuration. It includes plenty of configurable services and useful commands for developing and project orchestration right out of the box. On macOS systems, mutagen.io tool will be bundled in the toolset for high-performance files sync between host and Docker containers.
This setup assumes you are running Docker on a computer with at least 6GB of allocated RAM, a dual-core, and an SSD hard drive.
This configuration has been tested on macOS. Linux based systems still require testing. Any testing are welcomed!
To install Mage2click toolset to your system, simply run command below.
curl -sL raw.githubusercontent.com/mage2click/m2c/master/get | bashOr shortened version of above.
curl -sL get.m2c.run | bashAfter toolset is installed, you will have the next tools available locally:
Traefik - https://traefik.m2c.test
Traefik is an open-source reverse proxy and load balancer for HTTP and TCP-based applications that is easy, dynamic, automatic, fast, full-featured, production proven, provides metrics, and integrates with every major cluster technology. https://traefik.io
Portainer - https://portainer.m2c.test
Portainer is a lightweight management toolset that allows you to easily build, manage and maintain Docker environments. Created by experts, Portainer is an opinionated toolset that captures years of experience to allow you to reliably and quickly create, operate and trouble-shoot your Docker environments. https://portainer.io
Mailhog - https://mailhog.m2c.test
MailHog is an email testing tool for developers. Allows to view messages in the web UI, or retrieve them with the JSON API. Optionally allows to release messages to real SMTP servers for delivery. https://github.com/mailhog/MailHog
Dnsmasq - https://dnsmasq.m2c.test
Dnsmasq provides network infrastructure for small networks: DNS, DHCP, router advertisement and network boot. It is designed to be lightweight and have a small footprint, suitable for resource constrained routers and firewalls. http://www.thekelleys.org.uk/dnsmasq/doc.html
Toolset local homepage with links to all tools listed above - https://m2c.test
All Docker images with services listed above required to be active for toolset functioning.
These services are configured to start automatically and should not be stopped. Without active Traefik and Dnsmasq, m2c backed projects can't work properly.
If you don't want auto-start of these services, you can disable it with the command below.
m2c global autostart offMost of services are available with version on your choice.
All Docker Magento projects initialized with:
- Nginx
- PHP-FPM
- MariaDB
- Redis
- Xdebug
And optionally available:
- Varnish
- Elasticsearch
- phpMyadmin
- RabbitMQ
After toolset is installed on your system, you may use it to initialize new or existing magento projects.
To get a list of all commands and usage information, run command below.
m2c --helpTo initialize project, open the desired directory with terminal and run
m2c initThis command will launch project initialization in interactive mode. Simply follow the steps to configure the desired Docker Magento development environment.
If at least one command argument is defined, automated setup will be started. All undefined parameters will be set with default values.
m2c init [parameters...] [flags...]To get a list of all available parameters and flags for project configuration, run
m2c init --helpm2c add service <service> [--help]
m2c add domain <domain> [--help]
m2c add [--help]Adds optional service or extra domain to the project. Available optional services are: elasticsearch, phpmyadmin, rabbitmq and varnish. Run m2c add --help for command usage information.
m2c bash [--debug] [--root] ...Opens the bash prompt on the project's php Docker service. With --debug flag, the bash prompt will be opened on the project's xdebug Docker service. With --root flag, the root user will be used.
m2c cli [--debug] [--root] ...Runs any CLI command without going into the bash prompt of the project's php service. With --debug flag, the CLI command will run on the project's xdebug service. With --root flag, the root user will be used.
m2c composer <command> [options] [arguments]Runs Composer specific commands. Run m2c composer for command usage information.
m2c db [command] [--help]Database related commands. Import/Export database commands and MySQL CLI tool access. Available optional services are: export, import and mysql. Run m2c db --help for command usage information.
m2c downRemoves project Docker containers, volumes, and networks. Project sources on the host will be untouched. Don't forget to create a database backup before running this command.
m2c gruntThe grunt command-line interface. Runs grunt specific commands at projects Docker container. Run m2c grunt --help for command usage information.
m2c infoPrints project info and Docker containers status.
m2c initInitializes project in the current directory. Run m2c init --help for command usage information.
m2c mMagento command-line tool interface. Runs bin/magento specific commands at projects Docker container. Its is shortened alias of m2c magento command.
m2c mrN98-magerun command-line tool interface. Runs n98-magerun specific commands at projects Docker container. It is shortened alias of m2c magerun command. Run m2c mr --help for command usage information.
m2c node Node command-line tool interface. Runs node specific commands at projects Docker container. Run m2c node --help for command usage information.
m2c npmNPM command-line tool interface. Runs npm specific commands at projects Docker container. Run m2c npm --help for command usage information.
m2c redis [options] [cmd [arg [arg ...]]]Redis command-line tool interface. Runs redis-cli specific commands at projects Redis Docker container. Run m2c redis --help for command usage information.
m2c remove [service] [--help]Removes optional service from the project. Available optional services are: elasticsearch, phpmyadmin, rabbitmq and varnish. Run m2c remove --help for command usage information.
m2c restart [service [service ...]]Restarts running project Docker services and starts all stopped ones. If services explicitly specified, only those will be restarted.
m2c share [region] [--help]Starts sharing session over ngrok secure tunnels. Command accepts an optional parameter to specify a region. Ex. m2c share eu. Available regions are us, eu, ap, au, sa, jp, and in. By default, region is us. For proper functioning of this command, required dependencies will be installed. Please, visit https://github.com/shkoliar/magento-ngrok and https://github.com/shkoliar/docker-ngrok for more information. Run m2c share --help for command usage information.
Adding information about other CLI commands is in progress...
Project database can be easily accessed in a few ways - with help of optional phpMyAdmin service or with database managing applications by using a direct connection to the database via SSH tunnel.
Read the article at project's wiki page on how to connect to your project's database - Connecting to Database
Mage2click toolset supports Magento debugging with Xdebug out of the box. Only a few configuration steps are required.
Read the article at project's wiki page on how to use Xdebug with PHPStorm - Debugging with Xdebug
Zend Certified PHP Engineer, Magento2, Docker, PWA, Varnish, JS, HTML5, Mobile, iOS, Android
Github: @shkoliar
Twitter: @shkoliar
Website: shkoliar.com