Docker is an Open source tool designed to make it easier to create, build and run applications using containers. Docker containers act as a runtime and possess all the required dependencies and libraries so that the same applications can run in other OS also.
Nowadays containers based applications are being widely used.
To save time and effort, to run hassle-free applications in all the OS platforms, Docker containers are widely adopted.
Nginx is a fast, open-source, and more reliable web server that is used for server-side application development. Nginx server application support to run on many different operating systems. Nginx is very useful for development tasks. Therefore, the Docker container provides support for the Nginx server.
Here at LinuxAPT, as part of our Server Management Services, we regularly help our Customers to perform Nginx and Docker related queries.
In this context, we shall look into how to install Docker in Ubuntu 20.04 and Run Nginx container.
To begin, ensure that the the user account have Sudo privileges in order to install packages. Also, We need to update the Docker repository in Ubuntu, get the GPG key, and install docker packages and dependencies. You can install the latest version of Docker using the official docker repository in Ubuntu 20.04.
For this, you need to add the GPG key for the official Docker repository to your system and add the repository configuration to the APT source.
To make this procedure clearer, let's break this into steps.
Run the following command to add GPG key:
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Add and configure the official docker repository in your system:
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
Now, update the APT package to include new Docker packages using the following command:
$ sudo apt update
Now you can install docker packages using the following command:
$ sudo apt install docker-ce
During the docker packages installation, the installer package triggers systemd to automatically enable and start the docker server.
Use the following command to check docker service status.
To check docker service is active or not, run the following command:
$ sudo systemctl is-active docker
To check if the docker service is enabled or not, run the following command:
$ sudo systemctl is-enabled docker
To check the docker service status, run the following command:
$ sudo systemctl status docker
There are other systemctl commands available to control the docker services which are as follows:
$ sudo systemctl stop docker # stop docker service
$ sudo systemctl start docker # start docker service
$ sudo systemctl restart docker # restart docker service
To check the version of docker run the following command:
$ docker version
Running Nginx in docker containers is very simple and easy. You just need to pull an Nginx image from the docker hub and create an Nginx container that serves as a web server for static files.
To pull the latest Nginx image, run the following command:
$ sudo docker pull nginx
To list the docker images, run the command:
$ sudo docker images
To run a container from a pulled image, run the following command:
$ sudo docker run -d --name nginx-server -p 80:80 nginx
where,
d=run the container in detached mode
name= name of the container to be created
p= port the container will be mapped with host
You will have output similar as :
$ 4ef30a6599d0a7f9618883441fdd2a683e7205287d09f92dcd3b63f4892551e8
The output shows the container id created using the Nginx image.
To list out the running container, run the command:
$ sudo docker ps -a
You can find containers with status in your terminal with the above command.
Nginx is running in docker containers with port 80.
You can verify Nginx installation by navigating to the URL http://your-server-ip in your browser.
The containers we have just created are wrapping all the Nginx configuration and static files in the container itself. If we need to change anything or replace files, we need to access docker containers every time. Similarly in case if we delete the container, all the files and configuration files also get removed.
To mitigate this issue, we need to create a docker volume in the host and map it with a container to protect configuration and web files.
Here, we have taken nginx-data as a volume name. You can have your own assumption.
To create a docker volume run the following command:
$ sudo docker volume create nginx-data
Get the docker volume information by running the command:
$ sudo docker volume inspect nginx-data
For easy access, you can create a symlink of the docker volume directory.
To create symlink run the following command:
$ ln -s /var/lib/docker/volumes/nginx-data/_data /nginx
Now start the Nginx container with persistent data storage:
$ sudo docker run -d --name nginx-server -p 80:80 -v nginx-data:/usr/share/nginx/html nginx
Where,
d= run container in detached mode
name= name of the container to be created
p= port to be mapped with host
v= name of docker volume
Container has been started with persistent data storage. You will get container id as output as:
$ 9067684b1133a2c7e36381574ea9af3ebbb79dd2504f63ae3569bb059b74d901
Now verify the contents available in the data persistent directory:
$ ls /var/lib/docker/volumes/nginx-data/_Data
Let's change the content of index.html file located at /var/lib/docker/volumes/nginx-data/_data:
$ sudo vi /var/lib/docker/volumes/nginx-data/_data/index.html
Change some HTML code and save the file. Navigate the URL in your browser and you will find your Nginx contents changed.
This article covers how to install docker, pull docker images from docker hub and run an application in a container. Also, you will learn how to create persistent data storage and map with docker containers.
The open-source Docker platform contains a docker engine, a runtime environment that is used to execute, builds, and orchestrates containers.
Facts about Docker Compose configurations file:
1. version: Compose file version which is compatible with the Docker Engine. You can check compatibility here.
2. image: We use latest Nginx and Certbot images available in Docker hub.
volumes:
3. public: we have configured this directory to be synced with the directory we wish to use as the web root inside the container.
4. conf.d: here we will place the Nginx configuration file to be synced with the default Nginx conf.d folder inside the container.
5. certbot/conf: this is where we will receive the SSL certificate and this will be synced with the folder we wish to inside the container.
6. ports: configure the container to listen upon the listed ports.
7. command: the command used to receive the SSL certificate.
To Start Docker Containers:
You need to pass the -d flag which starts the container in background and leaves them running.
$ docker-compose up -d