Docker box for Magento local development - It is based on Smartosc Div01 local development box: https://git02.smartosc.com/khanhnt/div01-local-environment.
https://confluence.smartosc.com/display/DEV/Overview
Or you can refer to documents folder.
This setup assumes you are running Docker on a computer with at least 4GB of allocated RAM, a dual-core, and an SSD hard drive.
If you do not setup any Docker software before, you can run the script shared/docker.sh, it will automatically install & config for you. If you installed docker you can ignore this step and continue to next one.
Please note that if you already setup development environment on your real machine (Ex: LAMP stack) then you need to stop the equivalent services to avoid port conflict.
- Nginx (Apache) on port 80, 443
- Mysql on port 3306
- RabbitMQ on port 5672
- Elastic Search on port 9200, 9300
- Redis no port 6379
- Mail Hog on port 1025, 8025
You need to create the .env file in the root folder. You can look at the .env.sample.
This configuration has been tested on Linux. Windows is supported through the use of Docker on WSL.
1st you need to give the execution permission for all command in bin folder
sudo chmod +x bin/*First you need to download database backup from https://drive.google.com/drive/u/1/folders/1QSO3MhtOnxyhaC0_1PFSz9v-anpjqR4U . Then put it on mysql folder (create new if it does not exist) and extract. Next, create the .env file in the root folder. You can look at the .env.sample.. Then run
bin/setup-projectThen the command will prompt you to input some information as below:
- Git Url: git url of your project. Ex: git@git02.smartosc.com:khanhnt/lg-internal.git
- Branch: git branch you want to use. Ex: master.
- Master Database: The backup database file. You can download the database, create new mysql folder and put it there then specify the path as input. Ex: mysql/lg.sql.
- GERP Database: The backup database file. You can download the database, create new mysql folder and put it there then specify the path as input. Ex: mysql/gerp.sql.
- ENV File: Since we will not run the setup from the beginning, we need to provide the env.php file. Prepare the file then specify the path as input. Ex: env/env.php
- Base Url: The base url you want to use on your local. The command will help to input to hosts file and setup the ssl self-certificate. Ex: local.lg.com. For this project you should keep this domain for sso.
#bin/setup type version base_url
bin/setup ee 2.4.2 magento2.testThe default admin user/password are admin/admin123. If you want to change to something else, go and check bin/setup file. It also contains other default configurations for other services such as redis, elasticsearch & rabbitMQ. The Magento source code is located at src folder. After the installation finish, you can install sample data if you want
There are lots of commands you can use in bin folder. But in this section I will list down those I think important and may use everyday
bin/status: check the status of all containers.bin/start: start the containers.bin/stop: stop the containers.bin/restart: restart the containers.bin/removeall: remove all docker related things: containers, networks, volumes, and images.bin/composer: Run the composer binary. Ex.bin/composer installbin/grunt: Run the grunt binary. Ex.bin/grunt execbin/magento: Run the Magento CLI. Ex:bin/magento cache:flushbin/setup-grunt: Install and configure Grunt JavaScript task runner to compile .less filesbin/xdebug: enable/disable xdebug. For detail instruction, refer to documentation.bin/dev-urn-catalog-generate: Generate URN's for PHPStorm and remap paths to local host. Restart PHPStorm after running this command.bin/redis: access redis.bin/mysql: access to mysql container.bin/mysql-export: export database.bin/mysql-import: import database.bin/bash: Drop into the bash prompt of your phpfpm Docker container. Thephpfpmcontainer should be mainly used to access the filesystem within Docker.bin/cli: Run any CLI command without going into the bash prompt. Ex.bin/cli lsbin/clinotty: Run any CLI command with no TTY. Ex.bin/clinotty chmod u+x bin/magentobin/fixowns: This will fix filesystem ownerships within the container.bin/fixperms: This will fix filesystem permissions within the container.
First setup Magento Marketplace authentication (details in the DevDocs).
When you do the setup, system will ask you to input the key then it will automatically save to disk. Incase, you want to do it manually, copy src/auth.json.sample to src/auth.json. Then, update the username and password values with your Magento public and private keys, respectively. Finally, copy the file to the container by running bin/copytocontainer auth.json.
View emails sent locally through Mailhog by visiting http://{yourdomain}:8025
Redis is now the default cache and session storage engine, and is automatically configured & enabled when running bin/setup on new installs.
In magento 2.4, elastic search will be default search engine and mysql search engine will be removed. So I recommend any new projects to use elastic search engine by default. You can access elastic search index via: http://localhost:9200/.
The RabbitMQ box is already shipped with management plugin. You can access via: http://localhost:15672 . Default user/pass: guest/guest.
Running Docker on Linux should be pretty straight-forward. Note that you need to run some post install commands as well as installing Docker Compose. These steps are taken care of automatically with Docker Desktop, but not on Linux.
You may have to increase a virtual memory map count on the host system. It is required by Elasticsearch.
Add following line to /etc/sysctl.conf:
vm.max_map_count=262144
These docker images have built-in support for Blackfire.io. To use it, first register your server ID and token with the Blackfire agent:
bin/root blackfire-agent --register --server-id={YOUR_SERVER_ID} --server-token={YOUR_SERVER_TOKEN}
Next, open up the bin/start helper script and uncomment the line:
#bin/root /etc/init.d/blackfire-agent start
Finally, restart the containers with bin/restart. After doing so, everything is now configured and you can use a browser extension to profile your Magento store with Blackfire.