docs: guide central de déploiement (docs/DEPLOIEMENT.md) - #19
Merged
Conversation
Regroupe la procédure de déploiement des challenges : - infra (VM, repo /srv, CTFd, plugin containers, images rootmeup/<code>) - convention de branches (repo complet + modifs ciblées ; jamais une branche "que le challenge" qui efface le reste au merge — cf incident 8a5a8c3) - flags & rotation via challenge.env gitignoré (dépôt public) - étapes build + câblage CTFd - tableau challenges / images / ports + pointeur depuis le README.
There was a problem hiding this comment.
Pull request overview
Ce PR ajoute un guide centralisé de déploiement afin de documenter la procédure serveur (infra, build d’images, gestion des flags via challenge.env, câblage CTFd) et de la rendre facilement accessible depuis le README.
Changes:
- Ajout d’un document unique
docs/DEPLOIEMENT.mdcouvrant infra, convention de branches, rotation des flags, build et configuration CTFd. - Ajout d’un pointeur depuis le README vers ce guide de déploiement.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| README.md | Ajoute un lien visible vers la procédure de déploiement centralisée. |
| docs/DEPLOIEMENT.md | Introduit un guide de déploiement (infra, flags/rotation, build images, configuration CTFd, tableau récapitulatif). |
Comments suppressed due to low confidence (2)
docs/DEPLOIEMENT.md:78
- Cette URL CTFd est une IP Tailscale interne en dur. Pour éviter d’exposer l’adresse exacte dans un dépôt public, remplacez-la par un placeholder/hostname (cohérent avec le README).
1. `http://100.118.132.76/` → login admin → **Admin Panel → Challenges → Create**.
docs/DEPLOIEMENT.md:81
- Placeholder incohérent :
rootmeup/<code>:1.0ici, mais la commande de build utiliserootmeup/<CODE>:1.0. Harmoniser la casse/placeholder évite les copier-coller incorrects.
- **Image** : `rootmeup/<code>:1.0`
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| |---|---| | ||
| | Serveur | VM `ctf-rootmeup` (Debian 13), accès **Tailscale** + SSH | | ||
| | Dépôt sur la VM | `/srv/ctf-challenges/RootMeUp` (propriétaire `ctfd` → utiliser `sudo git -C …`) | | ||
| | CTFd | venv Python + gunicorn sur `127.0.0.1:8000`, exposé par **Apache** sur `http://100.118.132.76/` (tailnet) | |
Comment on lines
+62
to
+63
| sudo cp "$CH/setup/challenge.env.example" "$CH/setup/challenge.env" # si absent | ||
| sudo nano "$CH/setup/challenge.env" # mettre le vrai flag |
| - Le build lit `challenge.env` et cuit le flag dans les artefacts ; le flag n'apparaît | ||
| jamais dans le dépôt. | ||
| - `challenge.env` **persiste** sur la VM (survit à `git pull`). ⚠️ `git clean -x` l'effacerait. | ||
| - Retrouver un flag à tout moment : `sudo cat …/setup/challenge.env`. |
| | CTFd | venv Python + gunicorn sur `127.0.0.1:8000`, exposé par **Apache** sur `http://100.118.132.76/` (tailnet) | | ||
| | Base CTFd | MySQL/MariaDB local (`ctfd`) | | ||
| | Instanciation | plugin **CTFdDockerContainersPlugin** : 1 conteneur par équipe/challenge | | ||
| | Images | nommées `rootmeup/<code>:1.0` | |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Regroupe la procédure de déploiement des challenges :
)