A dockerfile is a script which contains a collection of dockerfile commands and operating system commands [ex: Linux commands]. Before we create our first dockerfile, you should become familiar with the dockerfile command.

Below are some dockerfile commands you must know:

FROM

The base image for building a new image. This command must be on top of the dockerfile.

MAINTAINER

Optional, it contains the name of the maintainer of the image.

RUN

Used to execute a command during the build process of the docker image.

ADD

Copy a file from the host machine to the new docker image. There is an option to use a URL for the file, docker will then download that file to the destination directory.

ENV

Define an environment variable.

CMD

Used for executing commands when we build a new container from the docker image.

ENTRYPOINT

Define the default command that will be executed when the container is running.

WORKDIR

This is directive for CMD command to be executed.

USER

Set the user or UID for the container created with the image.

VOLUME

Enable access/linked directory between the container and the host machine.

Now let's start to create our first dockerfile.

Step 1 - Installing Docker

Login to your server and update the software repository.

ssh [email protected] apt-get update

Install docker.io with this apt command:

apt-get install docker.io

When the installation is finished, start the docker service and enable it to start at boot time:

systemctl start docker systemctl enable docker

Docker has been installed and is running on the system.

Step 2 - Create Dockerfile

In this step, we will create a new directory for the dockerfile and define what we want to do with that dockerfile.

Create a new directory and a new and empty dockerfile inside that directory.

mkdir ~/myimages cd myimages/ touch Dockerfile

Next, define what we want to do with our new custom image. In this tutorial, I will install Nginx and PHP-FPM 7 using an Ubuntu 16.04 docker image. Additionally, we need Supervisord, so we can start Nginx and PHP-FPM 7 both in one command.

Edit the 'Dockerfile' with vim:

nano Dockerfile

On the top of the file, add a line with the base image [Ubuntu 16.04] that we want to use.

Download base image ubuntu 16.04

FROM ubuntu:16.04

Update the Ubuntu software repository inside the dockerfile with the 'RUN' command.

Update Ubuntu Software repository

RUN apt-get update

Then install the applications that we need for the custom image. Install Nginx, PHP-FPM and Supervisord from the Ubuntu repository with apt. Add the RUN commands for Nginx and PHP-FPM installation.

Install nginx, php-fpm and supervisord from ubuntu repository

RUN apt-get install -y nginx php7.0-fpm supervisor && \     rm -rf /var/lib/apt/lists/*

At this stage, all applications are installed and we need to configure them. We will configure Nginx for handling PHP applications by editing the default virtual host configuration. We can replace it our new configuration file, or we can edit the existing configuration file with the 'sed' command.

In this tutorial, we will replace the default virtual host configuration with a new configuration by using the 'COPY' dockerfile command.

Define the ENV variable

ENV nginx_vhost /etc/nginx/sites-available/default ENV php_conf /etc/php/7.0/fpm/php.ini ENV nginx_conf /etc/nginx/nginx.conf ENV supervisor_conf /etc/supervisor/supervisord.conf

Enable php-fpm on nginx virtualhost configuration

COPY default ${nginx_vhost} RUN sed -i -e 's/;cgi.fix_pathinfo=1/cgi.fix_pathinfo=0/g' ${php_conf} && \     echo "\ndaemon off;" >> ${nginx_conf}

Next, configure Supervisord for Nginx and PHP-FPM. We will replace the default Supervisord configuration with a new configuration by using the 'COPY' command.

Copy supervisor configuration

COPY supervisord.conf ${supervisor_conf}

Now create a new directory for the php-fpm sock file and change the owner of the /var/www/html directory and PHP directory to www-data.

apt-get install docker.io

0

Next, define the volume so we can mount the directories listed below to the host machine.

apt-get install docker.io

1

Finally, setup the default container command 'CMD' and open the port for HTTP and HTTPS. We will create a new start.sh file for default 'CMD' command when container is starting. The file contains the 'supervisord' command, and we will copy the file to the new image with the 'COPY' dockerfile command.

apt-get install docker.io

2

Save the file and exit.

Here is the complete Dockerfile in one piece:

apt-get install docker.io

3

Now inside our 'Dockerfile' directory, create a new configuration file for the virtual host named 'default', a supervisord configuration file 'supervisord.conf' and a service configuration script 'start.sh'.

apt-get install docker.io

4

Paste default virtual host configuration below:

apt-get install docker.io

5

Supervisord configuration file:

apt-get install docker.io

6

Paste configuration below:

apt-get install docker.io

7

Start.sh file.

apt-get install docker.io

8

Paste configuration below:

apt-get install docker.io

9

Save and exit

Make start.sh executable with chmod command:

systemctl start docker systemctl enable docker

0

Save the file and exit.

Step 3 - Build New Docker Image and Create New Container Based on it

The Dockerfile and all required config files have been created, now we can build a new docker image based on Ubuntu 16.04 and our dockerfile with the docker command below:

systemctl start docker systemctl enable docker

1

When the command completed successfully, we can check the new image 'nginx_image' with the docker command below:

systemctl start docker systemctl enable docker

2

Then we can try to create a new container based on nginx_images. And before create new container, we can create new directory on the host machine for the webroot data.

systemctl start docker systemctl enable docker

3

Now run the new container with the command below:

systemctl start docker systemctl enable docker

4

Then we can check that the new container with name hakase based on 'nginx_image' is running:

systemctl start docker systemctl enable docker

5

Note:

• --name hakase nginx_image = We create a new container with the name 'hakase', based on docker image 'nginx_images'.
• -p 80:80 = hakase container running on port 80 on the host machine.
• -v /webroot:/var/www/html = /webroot directory on the host machine rewrite the /var/www/html directory on the container.

The new container based on the nginx_image is running without error.

Step 4 - Testing Nginx and PHP-FPM in the Container

Try to create a new index.html file in the /webroot directory with echo:

systemctl start docker systemctl enable docker

6

Testing with curl command by accessing the host machine ip address.

systemctl start docker systemctl enable docker

7

We will see the results below.

Next, test that PHP-FPM 7.0 is running by creating a new phpinfo file in the /webroot directory on the host machine.

systemctl start docker systemctl enable docker

8

Open the web browser and type the host machine IP address:

//192.168.1.248/info.php

Now you can see the output of the phpinfo file.

the new docker image 'nginx_image' has been successfully created, now we can create more containers based on that image.