Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/42yerevanprojects/ft_server

This is a System Administration project which uses Docker and sets up a web server.
https://github.com/42yerevanprojects/ft_server

42-school docker https nginx server webserver

Last synced: about 1 year ago
JSON representation

This is a System Administration project which uses Docker and sets up a web server.

Awesome Lists containing this project

README 

          
# ft_server - @42born2code




## Table of Contents:

1. [What is ft_server](https://github.com/vvarodi/ft_server#what-is-ft_server-) ❔

    * [Description for newbies](https://github.com/vvarodi/ft_server#description-for-newbies-) 💡

2. [Resources / Research](https://github.com/vvarodi/ft_server#resourcesresearch-) 🔍



# What is ft_server ❔



> [SUBJECT](ft_server.pdf)



The goal of ft_server is to create a web server with ```Nginx``` capable of running a ```WordPress``` website, ```phpMyAdmin```, and a ```MySQL``` database. This server will run in only one Docker container, under Debian Buster.



|Services    |Path|

|:----------:|:-------:|

|WordPress   |```http:localhost/wordpress```|

|phpMyAdmin  |```http:localhost/phpmyadmin```|



## Description for newbies: 💡

When you type in the search bar "Google.com" a web server stores the files constituting the website (images, etc.). To obtain the page, your browser makes a request for a web page to the server which then sends the files (if the server doesn't find the requested document, it returns a 404 response instead).



There are different types of web servers: static or dynamic. In our case, we will create a dynamic web server. 



From a software point of view, the components of a dynamic web server are:

* An OS (ex: Windows or Linux)

* An HTTP server = software that supports client-server requests for the HTTP protocol (ex: Apache or Nginx)

* A database (ex: mySQL, Oracle)

* A script language = allows to interpret customer requests and translate them into html (ex: PHP, Python, Java)

---------------

* Our OS = Debian Buster 

* Our HTTP server = Nginx

* Our Database = Maria DB. 

* Our scripting language = PHP. 

> Plus we will install and configure phpMyAdmin and WordPress



We are going to do all of this in a Docker container. Why in a Docker container? 🐳



⚠️ The problem: Often we end up with applications that have tons of dependencies: need magic to convert images, need a particular database, need nginx or apache etc. When working with a third-party web host it is a bit hell. The system administrator will have to install the correct versions on a number of machines etc., puzzle. 💢



💯 The solution: Docker makes it possible to package an application in a virtual container. It's a sort of box that is completely isolated from our operating system. In which we can install all the libraries that our application needs to function. And we also install our application there. And so we can send this box all over the place, and it's going to work no matter what operating system.✔️



The Docker image would include:

* Nginx

* PHP 

* MariaDB SQL database

* PhpMyAdmin

* Wordpress

------------------



## Resources/Research: 🔍

* **Docker**

  * [Get started with Docker](https://docs.docker.com/get-started/)

  * [Docker curriculum](https://docker-curriculum.com/)

  * [The Docker Handbook](https://www.freecodecamp.org/news/the-docker-handbook/)



* **Dockerfile:** a text file that contains all commands, in order, needed to build a given image.

  * [Dockerfile-best-practice](https://docs.docker.com/develop/develop-images/dockerfile_best-practices/)

  * [Dockerfile-reference](https://docs.docker.com/engine/reference/builder/)

  * [ARG-ENV](https://vsupalov.com/docker-arg-env-variable-guide/) Build-time configuration with ARG && Run-time Environment Replacement using ENV 



* **Web Server:** a web server stores and delivers the content for a website – such as text, images, video, and application data – to clients that request it.

  * [What is a web server?](https://developer.mozilla.org/en-US/docs/Learn/Common_questions/What_is_a_web_server#:~:text=A%20static%20web%20server%2C%20or,application%20server%20and%20a%20database.)

  * [Linux Web Server Guides](https://www.tecmint.com/linux-web-server-guides/amp/)

  * [How To Install Linux, Nginx, MariaDB, PHP (LEMP stack) on Debian 10](https://www.digitalocean.com/community/tutorials/how-to-install-linux-nginx-mariadb-php-lemp-stack-on-debian-10)

   LEMP stack means: Linux, Nginx, MySQL, PHP.



* **Debian**

  * [About Debian](https://www.debian.org/intro/about)

  * [Debian Directory Structure](https://wiki.debian.org/Nginx/DirectoryStructure)

  * [wget](https://www.gnu.org/software/wget/) use it to retrieve content and files from various web servers

  * [How to Use sed to Find and Replace String in Files](https://linuxize.com/post/how-to-use-sed-to-find-and-replace-string-in-files/) (autoindex on/off)



* **Nginx**

  * [Default nginx configuration](img/default)

  * [Nginx 502 Bad Gateway Error](https://ibcomputing.com/nginx-502-bad-gateway-error/)



* **MariaDB** (database system) installed to store and manage data for your site

  * [mysql_secure_installation](https://mariadb.com/kb/en/mysql_secure_installation/) a shell script available on Unix systems, and enables you to improve the security of your MariaDB installation

  * [MariaDB vs MySQL](https://www.guru99.com/mariadb-vs-mysql.html)

* **PHP**

  * [PHP Manual](https://www.php.net/manual/es/index.php)

* **phpMyAdmin** phpMyAdmin is a free software tool written in PHP, intended to handle the administration of MySQL over the Web.

  * [phpMyAdmin Documentation](https://docs.phpmyadmin.net/en/latest/)

  * [phpMyAdmin Configuration](https://docs.phpmyadmin.net/en/latest/config.html#)

  * [config.inc.php](https://docs.phpmyadmin.net/en/latest/config.html#config-examples)



* **WordPress**  

  * [How to install](https://wordpress.org/support/article/how-to-install-wordpress/)

  * [wp-config.php](https://wordpress.org/support/article/editing-wp-config-php/)



* **SSL**

  * [Types of ssl certificates](https://phoenixnap.com/kb/types-of-ssl-certificates)

  * [mkcert](https://github.com/FiloSottile/mkcert/)

  * [Creating a Self-Signed SSL Certificate](https://linuxize.com/post/creating-a-self-signed-ssl-certificate/)

  * [openssl tutorial](https://phoenixnap.com/kb/openssl-tutorial-ssl-certificates-private-keys-csrs)

  * [Testing Encryption](https://www.digitalocean.com/community/tutorials/how-to-create-a-self-signed-ssl-certificate-for-nginx-on-debian-10#step-5-%E2%80%94-testing-encryption)

  * [HTTPS for localhost](https://www.freecodecamp.org/news/how-to-get-https-working-on-your-local-development-environment-in-5-minutes-7af615770eec/)