CoolFace
Apppublic

dwrswr/inception-guide

sourceHugging Facemitupdated 28d agoView on Hugging Face
0likes
App README
Read it live: https://dwrswr-inception-guide.static.hf.space Everything below describes the files in this repository.

Inception — the complete guide

Open `index.html` in a browser. That is the whole thing: a from-zero tutorial for the 42 Inception project, written for somebody who has never used Docker.

There is an EN / العربية switch in the top corner (🌐). Arabic flips the page to right-to-left and is remembered between visits; code, terminal output and diagram labels stay in Latin script on purpose.

What is inside the guide

sectionwhat you get
00–02the mission, VM vs container, and the seven Docker words (image, container, Dockerfile, layer, volume, network, compose)
03every requirement of the subject decoded in a table: what it means, how we obey
04setting up the VM, installing Docker Engine, /etc/hosts, /home/login/data
05–06the exact project tree, .env vs docker secrets, and how people fail the project in one commit
07–09the three containers, every file line by line: Dockerfiles, 50-server.cnf, www.conf, nginx.conf, the three entrypoint scripts
10–11docker-compose.yml line by line (services, healthcheck, named volumes on /home/login/data, network, secrets) and the Makefile
12–13what make really does, second by second, and the full life of one HTTPS request
14PID 1, daemons, and exactly why tail -f is banned
15–18debug toolbox + the 8 classic errors, the bonus part, the required docs, and a defence Q&A

Four interactive widgets: a Docker layer/cache simulator, a spot-the-violation quiz, a request stepper, and a pre-defence checklist that saves your ticks in the browser.

reference/ — the project skeleton

Everything the guide shows, as real files ready to copy into your repository:

reference/
├── Makefile              .gitignore
├── secrets/              four *.txt.example files
└── srcs/
    ├── docker-compose.yml     .env.example
    └── requirements/{mariadb,wordpress,nginx}/{Dockerfile,conf/,tools/}

To use it:

bash
cp -r reference/* ~/inception/          # into your own git repo
cd ~/inception
cp srcs/.env.example srcs/.env          # then edit LOGIN, DOMAIN_NAME, users…
for f in db_password db_root_password wp_admin_password wp_user_password; do
    openssl rand -base64 24 > secrets/$f.txt
done
make

The compose file was validated with docker compose config (project name inception, images mariadb:inception / wordpress:inception / nginx:inception, volumes bound to /home/$LOGIN/data/…), the three shell scripts pass sh -n, the Makefile parses, and every file uses LF line endings — a single CRLF would break the shebang inside a Linux container.

The subject requires the project to run inside a virtual machine, so the images themselves have to be built there. reference/ is the source, not a build artifact.