School of Information Technology and Electrical Engineering

INFS3208 – Cloud Computing Programming Assignment Task I (10 Marks)

Task description:

Your team manager needs a container-based website to swiftly deploy PHP-based webpages of your company using Nginx (webserver) and PHP (server-side script) in one container. As a developer, you would write a dockerfile to containerise these applications in a container and share with the PHP programmers who are working on the PHP website. Your colleagues should be able to upload their PHP websites to the remote directory in the container and immediately test the web without any problems. There are some technical requirements in your dockerfile as follows:

1. You cannot directly pull the existing docker images from Dockerhub.com (e.g. webdevops/php-nginx). You are only allowed to use Ubuntu 18.04 (Long Term Support) (e.g. ubuntu:18.04) as the base image and build the image upon it.

2. (1 mark) In order to contact the creator of the docker images for your colleagues, you need to leave the maintainer’s information including your name and email with the learned dockerfile instruction. You also need to define a variable of PHP version (e.g. PHPVER = 7.4) and the time zone. With different values, the dockerfile can install a specified version of PHP.

3. (1 mark) Nginx can deal with static web pages (e.g. html) but it cannot directly process PHP pages. Thus, it needs FastCGI Process Manager (FPM or PHP-FPM) to process PHP pages. You need to install Nginx, and PHP-FPM with a specified version to work for PHP websites.

4. (1 mark) To communicate between Nginx and PHP-FPM, the settings of Nginx are key to make Nginx support PHP-FPM. In your dockerfile, you should be able to copy the modified Nginx setting file to replace the default one in the container by using a dockerfile instruction.

5. (1 mark) The testing html and php pages are available on Github (https://github.com/csenw/cca1), you need to download them, and copy them to the root folder (/var/www/html) of the website in the container with the learned instructions. They must be runnable after the container is running.

6. (2.5 marks) To be accessed from outside, you need to (1) expose and publish the port 80 for Nginx and (2) mount the website’s root folder of the website as a volume, (3) set the working directory to (/var/www/html), (4) start Nginx and PHP-FPM with the entrypoint command and make sure nginx running in the foreground. In this way, the php files in the website’s root folder can be synchronised immediately if there are changes to the php files in the mounting folder on the host. The PHP programmer need no extra efforts to interact with the container.

7. (2 marks) To build the image from the dockerfile and run the container correctly, you need to provide related docker commands with adopted options (e.g., docker build [options] and docker run [options]) in a separate text file. Tag the built image as ‘a1:’ and the container as ‘cca1_nginx_php’.

8. (1.5 marks) Last but not least, you need to follow the good practices of writing a dockerfile making the image as lean as possible.

  

Preparation:

In this individual coding assignment, you will apply your knowledge of docker commands, dockerfile instructions (in Lecture 4), and the related fields. Firstly, you should understand what the task is and what the technical requirements include. Secondly, you should practise Linux commands to install Nginx, PHP and PHP-FPM on a VM, which are described in the Appendix and Practical/Tutorial sessions. Lastly, you need to write the dockerfile by converting the Linux commands into dockerfile instructions to achieve the task. You can either practise on the GCP’s VM or your local machine (Oracle Virtualbox required) if you are unable to access GCP. Please read the example of writing a dockerfile below to have more details.

Assignment Submission:

§ You must compress the dockerfile and a text file that contains docker commands to properly build the image and run it.

§ The name of the compressed file should be named as “FirstName_LastName_StudentNo.zip”.

§ You must make an online submission to Blackboard before 1:00 PM on Friday, 02/09/2022.

§ Only one extension application could be approved due to medical conditions.

Main Steps:

Step 1:

Log in your VM and change to your home directory

Step 2:

git clone https://github.com/csenw/cca1.git && cd cca1

Run this command to download the required configuration files and testing webpages.

In this folder (cca1), please write your dockerfile.

Step 3:

Build your dockerfile and tag your image as a1:.

        

Step 4:

Run the image as a container ‘cca1_nginx_php’:

Step 5:

Test the container on your VM with the preloaded index.html and index.php. Static webpage test: http://public_ip/index.html

  PHP webpage test: http://public_ip/index.php

 

Appendix

Nginx (pronounced "engine X"), stylized as NGINX or Nginx or NginX, is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. The software was created by Igor Sysoev and publicly released in 2004. Nginx is free and open-source software, released under the terms of the 2-clause BSD license. A large fraction of web servers uses NGINX, often as a load balancer. Nginx can be deployed to serve dynamic HTTP content on the network using FastCGI, SCGI handlers for scripts, WSGI application servers, and it can serve as a software load balancer. Note that Nginx cannot directly deal with PHP but can serve PHP applications through the FastCGI protocol. Nginx employs PHP-FPM (FastCGI Process Manager) that is running in the background as a daemon and listening for CGI requests. Nginx uses an asynchronous event-driven approach, rather than threads, to handle requests. Nginx's modular event-driven architecture can provide more predictable performance under high loads. Nginx default configuration file is nginx.conf

PHP [2] is a general-purpose scripting language that is especially suited to web development. It was created by Danish-Canadian programmer Rasmus Lerdorf in 1994; the PHP reference implementation is now produced by The PHP Group. PHP originally stood for Personal Home Page, but it now stands for the recursive initialism PHP: Hypertext Preprocessor. PHP code is usually processed on a web server by a PHP interpreter implemented as a module, a daemon or as a Common Gateway Interface (CGI) executable. On a web server, the result of the interpreted and executed PHP code – which may be any type of data, such as generated HTML or binary image data – would form the whole or part of an HTTP response. Various web template systems, web content management systems, and web frameworks exist which can be employed to orchestrate or facilitate the generation of that response. Additionally, PHP can be used for many programming tasks outside of the web context, such as standalone graphical applications and robotic drone control. Arbitrary PHP code can also be interpreted and executed via the command-line interface (CLI).

PHP-FPM (FastCGI Process Manager) [2] is an alternative FastCGI implementation for PHP, bundled with the official PHP distribution since version 5.3.3. When compared to the older FastCGI implementation, it contains some additional features, mostly useful for heavily loaded web servers. Figure 1 shows how PHP-FPM helps Nginx process PHP pages.

Figure 1.

How PHP and Nginx work together (Image credit: DataDog)

[1] Nginx, https://en.wikipedia.org/wiki/Nginx [2] PHP, https://en.wikipedia.org/wiki/PHP

   

An example of installation steps on a Linux VM with the following configuration:

§ OS: Ubuntu 18.04,

§ Network: using dynamical IP and Port 80 § PHP-FPM version: 7.4

A1 How to install Nginx and PHP7.4-FPM

The installation steps of Nginx, PHP, and PHP-FPM on a VM will be described in this section. You can practise installing the entire framework on your VM. Afterwards, you need to convert installation steps on your VM into dockerfile instructions.

Step 1: Install build dependencies and libraries. sudo apt-get update

Run this command periodically to make sure your source list (/etc/apt/sources.list) is up-to-date. This is the equivalent of "Reload" in Synaptic or "Fetch updates" in Adept.

sudo apt-get install software-properties-common

Run this command to install build dependencies.

Step 2: Install Nginx, and PHP-FPM

sudo add-apt-repository ppa:ondrej/php && sudo apt-get update

Run this command to add the repository of php (https://launchpad.net/~ondrej/+archive/ubuntu/php), where can find the latest version of PHP, and update the package list.

sudo apt-get install nginx php7.4-fpm

Run this command to install Nginx and PHP-FPM 7.4.

Step 3: Setup Nginx

With SUDO, open /etc/nginx/sites-available/default, and make the following modifications

to enable php-fpm:

We have provided a sample configuration file in https://github.com/csenw/cca1/tree/master/src.

     

 

  Note that the

 highlighted contents

 are the configuration you need to modify.

 root /var/www/html;

# Add index.php to the list if you are using PHP

index index.php index.html index.htm index.nginx-debian.html;

 

 server_name _;

location / {

# First attempt to serve request as file, then

# as directory, then fall back to displaying a 404. try_files $uri $uri/ =404;

}

# pass PHP scripts to FastCGI server #

location ~ \.php$ {

include snippets/fastcgi-php.conf;

#

# # With php-fpm (or other unix sockets):

fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;

# # With php-cgi (or other tcp sockets): }

# deny access to .htaccess files, if Apache's document root

# concurs with nginx's one #

#location ~ /\.ht {

# deny all; #}

Step 5: Run PHP-FPM and Nginx

sudo service php7.4-fpm start

php7.4-fpm   php7.4-fpm

sudo service nginx restart

Step 6: Test static and dynamic webpages

cd /var/www/html

Run this command to change directory to the root of the website.

   Run this command to start

. Note that

will not automatically run as a system

 service after installation. To apply the new nginx configuration, you can restart nginx service with:

   

 With SUDO, add the following html code to a html file (index.html) with an editor (e.g. vim)

 

This is a test on NginX.

 Add the following php code to a php file (index.php) with an editor (e.g., vim)