ajout icones + cicd tuto

docs/divers/devops/cicd.md

@@ -0,0 +1,90 @@
+# Déployer son site web automatiquement sur les serveurs du Garage
+
+## Mise en ligne de son site
+
+1. Se rendre à l'adresse correspondant au type de projet :
+    - [https://git.legaragenumerique.fr/GARAGENUM/web-deploy](https://git.legaragenumerique.fr/GARAGENUM/web-deploy)
+    - [https://git.legaragenumerique.fr/GARAGENUM/hugo-deploy](https://git.legaragenumerique.fr/GARAGENUM/hugo-deploy)
+
+2. Cliquer sur `Utiliser ce modèle`.
+
+![illustration1](../../assets/divers/devops/cicd1.png)
+
+3. Choisir un nom de dépôt et, dans les `éléments du modèle`, cocher `Contenu Git (branche par défaut)`.
+
+![illustration1](../../assets/divers/devops/cicd2.png)
+
+:warning: Bien choisir le nom de votre dépôt, car celui-ci figurera dans le nom de domaine pour accéder au site déployé.
+
+4. Cliquer sur `Créer un dépôt`.
+
+5. Une fois le dépôt créé, le cloner sur votre machine locale :
+```bash
+git clone git@git.legaragenumerique.fr:gitea_username/nom_du_projet.git
+```
+
+> Le git clone via SSH nécessite d'ajouter sa clé SSH sur le serveur GIT, sinon on peux le cloner en utilisant le lien HTTPS
+
+6. Ajouter votre contenu en respectant les structure décrite ci-dessous:
+    - Pour un site web:
+    ```bash
+    ├── Dockerfile
+    ├── html
+    │   ├── content
+    │   │   ├── page1.html
+    │   │   ├── page2.html
+    │   │   └── page3.html
+    │   ├── css
+    │   │   └── styles.css
+    │   └── index.html
+    └── README.md
+    ```
+    - Pour un site hugo:
+    ```bash
+    ├── Dockerfile
+    ├── hugo
+    │   ├── content
+    │   │   ├── page1.html
+    │   │   ├── page2.html
+    │   │   └── page3.html
+    │   └── config.toml
+    └── README.md
+    ```
+
+7. créer la branch deploy et la pousser:
+```bash
+git checkout -b deploy
+git push -u origin deploy
+```
+
+- Le site est mis en ligne à l'adresse gitea_username-nom_du_projet.legaragenumerique.xyz
+
+## Mettre à jour son site
+
+- Une fois les modifications éffectuée sur vos fichiers, simplement pousser sur le serveur:
+```bash
+git add * 
+git commit -m "maj fichier example.html"
+git push
+```
+
+> S'assurer d'être bien sur la branche `deploy`
+
+## Retirer son site
+
+1. changer de branche (ne plus être sur la branche deploy):
+```bash
+git checkout main
+```
+
+2. supprimer la branch `deploy` locale:
+```bash
+git branch -d deploy
+```
+
+1. supprimer la branch `deploy` distante:
+```bash
+git push --delete origin deploy
+```
+
+- Le site n'est plus en ligne

docs/divers/devops/index.md

@@ -6,3 +6,4 @@
 - [Utiliser Dokku pour déployer des applis en mode PaaS](dokku.md)
 - [Utiliser l'API de Gitlab / Github avec Bash](git-api.md)
 - [Développer des modules pour Odoo](odoo/index.md)
+- [Déployer son site web / hugo via le garage CICD](cicd.md)

mkdocs.yml

@@ -27,6 +27,11 @@ plugins:
     #    arguments:
     #      theme: 'dark'
 markdown_extensions:
+    - attr_list
+    - pymdownx.emoji:
+        emoji_index: !!python/name:material.extensions.emoji.twemoji
+        emoji_generator: !!python/name:material.extensions.emoji.to_svg
+
     - admonition
     - pymdownx.tabbed:
         alternate_style: true
@@ -144,6 +149,7 @@ nav:
                 - divers/devops/odoo/index.md
                 - divers/devops/odoo/devenv.md
                 - divers/devops/odoo/devmodule.md
+            - "CICD du garage": divers/devops/cicd.md
         - "Les guides Internes":
             - "Imprimantes": divers/internal/install-printers.md
             - "Workadventure map": divers/internal/wa.md