plex_fr_discord_repo/README.md

115 lines
3.8 KiB
Markdown
Raw Normal View History

2021-02-25 20:14:47 +01:00
# Repo Officiel du Discord Plex FR
2021-02-26 00:25:52 +01:00
@Benj le tyrannique
2021-02-25 18:56:49 +01:00
2021-02-25 20:14:47 +01:00
Retrouvez-nous ici : https://discord.gg/ERpYMqS
2021-02-25 22:57:19 +01:00
![](https://i.imgur.com/RiGJ5pK.png)
## Table des matières
* [Comment utiliser Git](#wiki)
* [docker-compose](#docker-compose)
* [wiki](#wiki)
## Comment utiliser Git
Clonez le dépot sur votre machine `git clone https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo.git`
### Pour chaque modification, attention à bien suivre cette procédure si vous voulez éviter des conflits de versions
- Créez votre branche via la GUI Gitea (idéalement votre pseudo) ex : Benj
- Rapatriez les dernières modifications : `git pull`
- Faites vos modificatiosn (création de fichiers etc)
- Ajoutez les nouveaux fichiers : `git add .`
- Validez les modif : `git commit -m "ma super modif"`
- Balancez sur le serveur : `git push`
- Et ouvrez une pull request via la GUI
2021-02-26 00:19:55 +01:00
### petit reminder
- **ON NE TRAVAILLE JAMAIS SUR LE MASTER**
- **Un renommage de répertoire cause un conflit généralement, nécessite intervention manuelle**
- `git status` > donne la branche courante ainsi que l'état des fichiers modifiés
> git status
> Sur la branche master
> Votre branche est à jour avec 'origin/master'.
>
> Modifications qui ne seront pas validées :
> (utilisez "git add <fichier>..." pour mettre à jour ce qui sera validé)
> (utilisez "git checkout -- <fichier>..." pour annuler les modifications dans la copie de travail)
>
> modifié : README.md
>
> aucune modification n'a été ajoutée à la validation (utilisez "git add" ou "git commit -a")
- `git add toto.pouet` ou `git add .` > ajout les modifications sur toto.pouet ou sur tous les fichiers au prochain commit
- `git commit -m "mon super message"` > on pose le commit avec un message qui explique ce que l'on a fait (pratique pour retrouver ca plus tard si besoin)
- `git pull` > on récupère toutes les dernières modifs du serveur
- `git merge master` > (doit être fait après un `git pull`) on récupère toutes les dernières modifs du master pour les mettre sur la branche courante
### au secours
#### j'ai fait mes modif sur le master (sans commit)
- `git stash` > je sauvegarde mes modifs en local et rétablis le dernier commit
- `git pull` > je récupère des dernières modifs du serveur
- `git checkout mabranche` > je changement de branche
- `git merge master` > je récupère les dernières modifs du master sur ma branche
- `git stash apply` > j'applique ma sauvegarde local
- je poursuis mes modifs et je add/commit/push quand j'ai fini
2021-02-25 22:57:19 +01:00
## docker-compose
### fonctionnement
Le répertoire `docker-compose/` contient uniquement les docker-compose de chaque service/application.
L'arborescence doit être la suivante :
`docker-compose/<app>/docker-compose.yml`
- `<app>` : le nom de l'application ou service à rajouter
### Possibilité
Le bot pourrait appeler le contenu de chaque application selon cette commande
`.docker-compose <app>`
Il chercherait selon l'url suivant :
`https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/docker-compose/<app>/docker-compose.yml`
Si HTTP 200 alors on affiche le contenu retourné
Sinon HTTP 404 alors on affiche `la page n'existe pas`
Exemple ok:
> `.docker-compose plex`
> renvoie le contenu de
> https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/docker-compose/plex/docker-compose.yml
Exemple ko:
> `.docker-compose pouet`
> renvoie `La page que vous demandez n'existe pas`
**ZZ_Exemple sera supprimé à terme**
## wiki
fichiers au format md (markdown)
### Possibilité
Le bot pourrait appeler le contenu de chaque application selon cette commande
`.wiki <doc>`
Il chercherait selon l'url suivant :
`https://gitea.zoz-serv.org/Zoz/plex_fr_discord_repo/raw/branch/master/wiki/<doc>.md`
Si HTTP 200 alors on affiche le contenu retourné
Sinon HTTP 404 alors on affiche `la page n'existe pas`