Docker is an open platform for developing, shipping, and running applications. Docker enables you to separate your applications from your infrastructure so you can deliver software quickly. With Docker, you can manage your infrastructure in the same ways you manage your applications.<\/em><\/strong><\/p><\/blockquote>\n <\/p>\n Docker engine is a client-server application which has basically three components,<\/p>\n <\/p>\n <\/p>\n The CLI uses REST API to control or interact with \u00a0Docker daemon through CLI commands. Docker engine architecture from Docker docs itself is shown below:<\/p>\n <\/p>\n <\/p>\n Docker packages and runs an application in a loosely isolated environment called a container. Unlike VMs, containers do not bundle a full operating system. They wrap up only libraries and settings required to make software work.\u00a0Containers get launched from docker image(s). Docker container image is a light-weight, standalone, executable package of a piece of software that is code, system tools, system libraries, settings etc. They are constructed from filesystem layers and share common files.<\/p>\n Containers running on single machine share that machine’s operating system kernel. That is why they start instantly and use less compute and RAM. Containers also share OS kernel with other containers as well. They are abstraction at the application layer that package code and dependencies together. A layered architecture of docker (taken from www.slideshare.net) is shown below:<\/p>\n <\/p>\n <\/p>\n Images can either be created by launching containers from some base image followed by some installations\/alterations and then committing the container to a new image, or it can be created from Dockerfile. For creating an image, writing Dockerfile happens to be a good practice \u00a0as it is light-weight \u00a0and image built from Dockerfile consume less storage space.<\/p>\n Dockerfile allows to create image either from some base image (ex: ubuntu os image) or directly from scratch where we define all the packages that would be needed in our image. For best practices for writing Dockerfile, refer link\u00a0https:\/\/docs.docker.com\/engine\/userguide\/eng-image\/dockerfile_best-practices\/\u00a0<\/a>.<\/p>\n <\/p>\n <\/p>\n Docker is an open-source project that can be integrated with almost all the applications allowing scope of isolation and flexibility. It can be integrated with Magento-2.x as well.\u00a0Magento\u00a0is an e-commerce platform written in PHP and based on zend framework available under\u00a0both open-source and commercial licenses. In this blog, we will run magento2.x within the architecture of docker on Ubuntu 16.04.<\/p>\n Generally, “each container should have only one concern” i.e. there should be single process running per containers. Then all the running containers should be linked with each other. But in the architecture we will be defining in this blog, we will use supervisor as our main process that will run apache server and mysql server together within a single container. Hence we won’t need container linking.<\/p>\n Also, supervisor is a client-server system that monitors and controls a number of processes. In our later blogs, we will explore architectures built on multiple containers and their linking mechanism.<\/p>\n Presuming the fact that Docker is already installed on your ubuntu server, we will dive into server setup. If Docker is not installed on your server, please install the docker beforehand<\/a>. Moving forward to our architecture setup, we will create a Dockerfile that will hold the installation of LAMP server and other necessary packages.<\/p>\n To begin with, we will be using Ubuntu 16.04 base image, apache2 server, mysql-server-5.7 and PHP version will be passed as an argument as per your choice (php7.0, php7.1) along its extensions<\/a>\u00a0as per Magento 2.x requirements. <\/strong><\/em><\/p>\n Whole server architecture will be wrapped up in one Docker image and Magento-2.x files will be placed on our host. It is a good practice to keep application on host so that it will not be lost if containers or images get accidentally removed. These magento files will be mapped from host to docker containers<\/strong>.<\/em> We will also install supervisor for controlling apache and mysql server.<\/p>\n Dockerfile is shown below:<\/p>\n <\/p>\n <\/p>\n Take a note that Dockerfile just install packages as it is instructed to do by the commands and build the image.<\/p>\n Consider image as rest package where no services or processes are running. That is why we cannot perform any operation from Dockerfile that requires a particular service to be running. As with case of database, we cannot create database from Dockerfile as mysql service is not running. For database and its user creation, we will create a bash script that will run whenever a container will launch, hence creating mentioned database and its user.<\/strong> <\/em><\/p>\n We are using “mysql.sh” as the bash script as mentioned in Dockerfile. Bash script “msyql.sh” resides on our host parallel to Dockerfile.<\/p>\n Contents of mysql.sh is shown below:<\/p>\n <\/p>\n <\/p>\n Apart from mysql.sh file, we are copying supervisord.conf file from host to docker image that holds that instructions to run apache2 server, mysql server, mysql.sh script and certain ownership command. This file should be placed to Dockerfile and mysql.sh script.<\/p>\n Contents of supervisord.conf file is shown below:<\/p>\n <\/p>\n <\/p>\n Our parent directory will have following files\/directories:<\/p>\n <\/p>\n <\/p>\n Now when Dockerfile, mysql.sh, supervisord.conf, 000-default.conf and magento2 directory are placed parallel to each other, we are ready to build our image. Go to your docker project directory and run:<\/p>\n After image build up, you can check your built images by command:<\/p>\n As mentioned earlier, we will keeping Magento server files on host. So create a directory naming magento2 parallel to Dockerfile. Download the latest Magento-2.x from\u00a0https:\/\/magento.com\/tech-resources\/download<\/a>\u00a0and place the unarchived files within magento2 directory and change its ownership as www-data.<\/p>\n Now for running containers from this image, first ensure you have port 80 and 3306 is available then run the command:<\/p>\n In above command, “-v” is used to mount or map volumes. In our case it is mapping magento2 directory with \/var\/www\/html\/. \u00a0After running above command, check the running containers by command:<\/p>\n Now hit the URL or IP on your browser and you will see the magento-2.x installation page.<\/p>\n So far, we have setup Magento-2.x within the Docker architecture with running single container for web server & database server and mapping Magento-2.x files from host to docker container. In our next blog, we will build docker architecture for Magento-2.x by container linking approach.<\/p>\n <\/p>\n IN CASE OF ANY QUERY,CONTACT US<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"Understanding Docker Architecture:<\/strong><\/h2>\n
\n
![\"\"](\"https:\/\/cloudkul.com\/blog\/wp-content\/uploads\/2017\/09\/engine-components-flow.png\")
<\/a><\/p>\n<\/a><\/p>\nMagento 2 With Docker:<\/h2>\n
FROM ubuntu:16.04\r\n \r\nLABEL maintainer=\"Alankrit Srivastava <alankrit.srivastava256@webkul.com>\"\r\n\r\n## Mysql root password and PHP version to be passed as arguments while building image\r\nARG mysql_password\r\nARG phpV\r\nENV MYSQL_ROOT_PASSWORD {mysql_password}\r\n\r\n## Update Server and Install LAMP\r\n \r\nRUN apt-get update \\\r\n && apt-get -y install apache2 \\\r\n && a2enmod rewrite \\\r\n && a2enmod headers \\\r\n && export LANG=en_US.UTF-8 \\\r\n && apt-get update \\\r\n && apt-get install -y software-properties-common \\\r\n && apt-get install -y language-pack-en-base \\\r\n && LC_ALL=en_US.UTF-8 add-apt-repository ppa:ondrej\/php \\\r\n && apt-get update \\\r\n && apt-get -y install php${phpV} php${phpV}-curl php${phpV}-intl php${phpV}-gd php${phpV}-dom \\\r\n php${phpV}-mcrypt php${phpV}-iconv php${phpV}-xsl php${phpV}-mbstring php${phpV}-ctype php${phpV}-zip \\\r\n php${phpV}-pdo php${phpV}-xml php${phpV}-bz2 php${phpV}-calendar php${phpV}-exif php${phpV}-fileinfo php${phpV}-json \\\r\n php${phpV}-mysqli php${phpV}-mysql php${phpV}-posix php${phpV}-tokenizer php${phpV}-xmlwriter php${phpV}-xmlreader \\\r\n php${phpV}-phar php${phpV}-soap php${phpV}-mysql php${phpV}-fpm php${phpV}-bcmath libapache2-mod-php${phpV} \\\r\n && sed -i -e\"s\/^memory_limit\\s*=\\s*128M\/memory_limit = 512M\/\" \/etc\/php\/${phpV}\/apache2\/php.ini \\\r\n && rm \/var\/www\/html\/* \\\r\n && sed -i \"s\/None\/all\/g\" \/etc\/apache2\/apache2.conf \\\r\n && apt-get -y install debconf-utils \\\r\n && echo \"mysql-server-5.7 mysql-server\/root_password password ${mysql_password}\" | debconf-set-selections \\\r\n && echo \"mysql-server-5.7 mysql-server\/root_password_again password ${mysql_password}\" | debconf-set-selections \\\r\n && DEBIAN_FRONTEND=noninteractive apt-get -y install mysql-server-5.7 && \\\r\n mkdir -p \/var\/lib\/mysql && \\\r\n mkdir -p \/var\/run\/mysqld && \\\r\n mkdir -p \/var\/log\/mysql && \\\r\n touch \/var\/run\/mysqld\/mysqld.sock && \\\r\n touch \/var\/run\/mysqld\/mysqld.pid && \\\r\n chown -R mysql:mysql \/var\/lib\/mysql && \\\r\n chown -R mysql:mysql \/var\/run\/mysqld && \\\r\n chown -R mysql:mysql \/var\/log\/mysql &&\\\r\n chmod -R 777 \/var\/run\/mysqld\/ \\\r\n && sed -i -e\"s\/^bind-address\\s*=\\s*127.0.0.1\/bind-address = 0.0.0.0\/\" \/etc\/mysql\/mysql.conf.d\/mysqld.cnf \\\r\n##install supervisor and setup supervisord.conf file\r\n && apt-get install -y supervisor \\\r\n && mkdir -p \/var\/log\/supervisor\r\nENV APACHE_RUN_USER www-data\r\nENV APACHE_RUN_GROUP www-data\r\nENV APACHE_PID_FILE \/var\/run\/apache2.pid\r\nENV APACHE_RUN_DIR \/var\/run\/apache2\r\nENV APACHE_LOCK_DIR \/var\/lock\/apache2\r\nENV APACHE_LOG_DIR \/var\/log\/apache2\r\nENV LANG C\r\nWORKDIR \/var\/www\/html\r\nCOPY supervisord.conf \/etc\/supervisor\/conf.d\/supervisord.conf\r\n## Copy one time database creation script from host to docker.\r\nCOPY mysql.sh \/etc\/mysql.sh\r\nRUN chmod a+x \/etc\/mysql.sh\r\n## Expose ports for web server and database server.\r\nEXPOSE 3306 80\r\nCMD [\"\/usr\/bin\/supervisord\"]<\/pre>\n#!\/bin\/bash\r\n\r\nset -u\r\nsleep 4\r\ndatabase_connectivity_check=no\r\nvar=1\r\nwhile [ \"$database_connectivity_check\" != \"mysql\" ]; do\r\n\/etc\/init.d\/mysql start\r\nsleep 2\r\ndatabase_connectivity_check=`mysqlshow --user=root --password=$MYSQL_ROOT_PASSWORD | grep -o mysql`\r\nif [ $var -ge 4 ]; then\r\nexit 1\r\nfi\r\nvar=$((var+1))\r\ndone\r\n\r\n\r\ndatabase_availability_check=`mysqlshow --user=root --password=$MYSQL_ROOT_PASSWORD | grep -ow \"$MYSQL_DATABASE\"`\r\n\r\nif [ \"$database_availability_check\" == \"$MYSQL_DATABASE\" ]; then\r\nexit 1\r\nelse\r\nmysql -u root -p$MYSQL_ROOT_PASSWORD -e \"grant all on *.* to 'root'@'%' identified by '$MYSQL_ROOT_PASSWORD';\"\r\nmysql -u root -p$MYSQL_ROOT_PASSWORD -e \"create database $MYSQL_DATABASE;\"\r\nmysql -u root -p$MYSQL_ROOT_PASSWORD -e \"grant all on $MYSQL_DATABASE.* to 'root'@'%' identified by '$MYSQL_ROOT_PASSWORD';\"\r\nsupervisorctl stop database_creation && supervisorctl remove database_creation\r\necho \"Database $MYSQL_DATABASE created\"\r\nfi\r\n<\/pre>\n
[supervisord]\r\nnodaemon=true\r\n \r\n[program:mysql]\r\ncommand=\/bin\/bash -c \"touch \/var\/run\/mysqld\/mysqld.sock;touch \/var\/run\/mysqld\/mysqld.pid;chown -R mysql:mysql \/var\/lib\/mysql;chown -R mysql:mysql \/var\/run\/mysqld;chown -R mysql:mysql \/var\/log\/mysql;chmod -R 777 \/var\/run\/mysqld\/;\/etc\/init.d\/mysql restart\"\r\n \r\n[program:apache2]\r\ncommand=\/bin\/bash -c \"source \/etc\/apache2\/envvars && exec \/usr\/sbin\/apache2 -DFOREGROUND\"\r\n \r\n[program:command_for_user_permission]\r\ncommand=\/bin\/bash -c \"chown -R www-data: \/var\/www\/\"\r\n\r\n[program:database_creation]\r\ncommand=\/bin\/bash -c \"\/etc\/mysql.sh\"\r\n<\/pre>\n
\n
docker build --build-arg mysql_password=mention_mysql_password \\\r\n--build-arg phpV=mention_php_version -t image_name:image_tag .<\/pre>\n
docker images<\/pre>\n
\u00a0docker run -d -p 80:80 -p 3306:3306 -e MYSQL_ROOT_PASSWORD=mention_mysql_password \\\r\n -e MYSQL_DATABASE=mention_database -v `pwd`\/magento2:\/var\/www\/html\/ --name container_name \\\r\n image_name:image_tag<\/pre>\n
docker ps<\/pre>\n