Corrections Ansible

2024-02-12 20:44:27 +01:00
parent 640fbddfff
commit 5e2abed3ff
8 changed files with 129 additions and 25 deletions
--- a/docs/Ansible/2023-10-01-nextcloud-docker-update-from-ansible.md
+++ b/docs/Ansible/2023-10-01-nextcloud-docker-update-from-ansible.md
@@ -40,14 +40,11 @@ date: 2023-10-01
        project_src: "/volume1/nextcloud"
        recreate: smart

-    - name: Pause de 30 secondes
+   - name: Pause en attendant la remontée des conteneurs
      ansible.builtin.pause:
+        #minutes: 2
        seconds: 30

-    - name: Pause en attendant la remontée des conteneurs
-      ansible.builtin.pause:
-        minutes: 2
-
    - name: "Mise à jour de la base de données"
      community.docker.docker_container_exec:
        container: nextcloud_app_1
@@ -58,6 +55,12 @@ date: 2023-10-01
        - "php occ db:add-missing-columns"
        - "php occ db:add-missing-indices"
        - "php occ db:add-missing-primary-keys"
+        - "occ config:system:set maintenance_window_start --type=integer --value=1"
+
+    - name: Pause de 1 minute
+      ansible.builtin.pause:
+        minutes: 1
+#        seconds: 30

    - name: Modification du fichier .htaccess pour Mac
      tags: caldav
--- a/docs/Ansible/2023-11-14-savanewiki-plubication.md
+++ b/docs/Ansible/2023-11-14-savanewiki-plubication.md
@@ -1,15 +1,65 @@
 ---
 title: "Publication de Savanewiki"
-summary: "brief decription to sum up"
+summary: "Description"
 author:
  - JF
 date: 2023-11-13
 ---
 # Publication du build mkdocs de Savanewiki via Ansible
+
+### Utilisation de mkdocs
+
+#### Pour démarrer le serveur mkdocs
+Positionner le terminal à la racine du dossier du site mkdocs.
+```bash
+mkdocs serve
+```
+La mise à jour est dynamique, elle suit la mise à jour des pages.
+
+#### Création d'une page.
+```bash
+vi ./docs/rubrique/$(date '+%Y-%m-%d')-nouvelle_page.md
+```
+
+#### Référencement de la page dans l'arborescence du site
+Ajouter le nom de la page dans le fichier.
+```bash
+vi mkdocs.yml
+```
+```markdown
+site_name: Savanewiki
+site_url: https://docs.savaneprod.fr
+nav:
+  - Home: index.md
+  - Rubrique:
+    - "Rubrique/index.md"
+    - "Rubrique/$(date '+%Y-%m-%d')-nouvelle_page.md"
+  - About: about.md
+theme: readthedocs
+```
+
+Contenu minimal de la page :
+```markdown
+---
+title: "Nouvelle page"
+summary: "Description brève"
+author:
+  - JF
+date: $(date '+%Y-%m-%d')
+---
+
+```
+
+#### Compilation du site
+```bash
+mkdocs build --clean
+```
+
+
+### Le playbook ansible
 Rsync étant compliqué à utilser avec Synology. Utiliser Gitea pour télécharger les fichiers au bon endroit, un peu tordu. J'ai décidé d'utiliser Ansible pour publier les builds de Savanewiki.
 Toujours parce que rsync n'est pas standard avec Synology, je n'ai pas cherché à utiliser le module `ansible.posix.synchronize`. Ce n'est pas très efficace d'un point de vue du mécanisme, mais ça l'est d'un point de vue simplicité et temps de mise en place.

-### Le playbook ansible
 ```yaml
 ---
 - name: Déploiement de SavaneWiki
--- a/site/Ansible/2023-10-01-nextcloud-docker-update-from-ansible/index.html
+++ b/site/Ansible/2023-10-01-nextcloud-docker-update-from-ansible/index.html
@@ -134,14 +134,11 @@
        project_src: &quot;/volume1/nextcloud&quot;
        recreate: smart

-    - name: Pause de 30 secondes
+   - name: Pause en attendant la remontée des conteneurs
      ansible.builtin.pause:
+        #minutes: 2
        seconds: 30

-    - name: Pause en attendant la remontée des conteneurs
-      ansible.builtin.pause:
-        minutes: 2
-
    - name: &quot;Mise à jour de la base de données&quot;
      community.docker.docker_container_exec:
        container: nextcloud_app_1
@@ -152,6 +149,12 @@
        - &quot;php occ db:add-missing-columns&quot;
        - &quot;php occ db:add-missing-indices&quot;
        - &quot;php occ db:add-missing-primary-keys&quot;
+        - &quot;occ config:system:set maintenance_window_start --type=integer --value=1&quot;
+
+    - name: Pause de 1 minute
+      ansible.builtin.pause:
+        minutes: 1
+#        seconds: 30

    - name: Modification du fichier .htaccess pour Mac
      tags: caldav
--- a/site/Ansible/2023-11-14-savanewiki-plubication/index.html
+++ b/site/Ansible/2023-11-14-savanewiki-plubication/index.html
@@ -62,6 +62,18 @@
                  </li>
                  <li class="toctree-l1 current"><a class="reference internal current" href="./">Publication de Savanewiki</a>
    <ul class="current">
+    <li class="toctree-l2"><a class="reference internal" href="#utilisation-de-mkdocs">Utilisation de mkdocs</a>
+        <ul>
+    <li class="toctree-l3"><a class="reference internal" href="#pour-demarrer-le-serveur-mkdocs">Pour démarrer le serveur mkdocs</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#creation-dune-page">Création d'une page.</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#referencement-de-la-page-dans-larborescence-du-site">Référencement de la page dans l'arborescence du site</a>
+    </li>
+    <li class="toctree-l3"><a class="reference internal" href="#compilation-du-site">Compilation du site</a>
+    </li>
+        </ul>
+    </li>
    <li class="toctree-l2"><a class="reference internal" href="#le-playbook-ansible">Le playbook ansible</a>
    </li>
    </ul>
@@ -101,9 +113,45 @@
            <div class="section" itemprop="articleBody">
              
                <h1 id="publication-du-build-mkdocs-de-savanewiki-via-ansible">Publication du build mkdocs de Savanewiki via Ansible</h1>
+<h3 id="utilisation-de-mkdocs">Utilisation de mkdocs</h3>
+<h4 id="pour-demarrer-le-serveur-mkdocs">Pour démarrer le serveur mkdocs</h4>
+<p>Positionner le terminal à la racine du dossier du site mkdocs.</p>
+<pre><code class="language-bash">mkdocs serve
+</code></pre>
+<p>La mise à jour est dynamique, elle suit la mise à jour des pages.</p>
+<h4 id="creation-dune-page">Création d'une page.</h4>
+<pre><code class="language-bash">vi ./docs/rubrique/$(date '+%Y-%m-%d')-nouvelle_page.md
+</code></pre>
+<h4 id="referencement-de-la-page-dans-larborescence-du-site">Référencement de la page dans l'arborescence du site</h4>
+<p>Ajouter le nom de la page dans le fichier.</p>
+<pre><code class="language-bash">vi mkdocs.yml
+</code></pre>
+<pre><code class="language-markdown">site_name: Savanewiki
+site_url: https://docs.savaneprod.fr
+nav:
+  - Home: index.md
+  - Rubrique:
+    - &quot;Rubrique/index.md&quot;
+    - &quot;Rubrique/$(date '+%Y-%m-%d')-nouvelle_page.md&quot;
+  - About: about.md
+theme: readthedocs
+</code></pre>
+<p>Contenu minimal de la page :</p>
+<pre><code class="language-markdown">---
+title: &quot;Nouvelle page&quot;
+summary: &quot;Description brève&quot;
+author:
+  - JF
+date: $(date '+%Y-%m-%d')
+---
+
+</code></pre>
+<h4 id="compilation-du-site">Compilation du site</h4>
+<pre><code class="language-bash">mkdocs build --clean
+</code></pre>
+<h3 id="le-playbook-ansible">Le playbook ansible</h3>
 <p>Rsync étant compliqué à utilser avec Synology. Utiliser Gitea pour télécharger les fichiers au bon endroit, un peu tordu. J'ai décidé d'utiliser Ansible pour publier les builds de Savanewiki.
 Toujours parce que rsync n'est pas standard avec Synology, je n'ai pas cherché à utiliser le module <code>ansible.posix.synchronize</code>. Ce n'est pas très efficace d'un point de vue du mécanisme, mais ça l'est d'un point de vue simplicité et temps de mise en place.</p>
-<h3 id="le-playbook-ansible">Le playbook ansible</h3>
 <pre><code class="language-yaml">---
 - name: Déploiement de SavaneWiki
  hosts: savaneprod.fr
--- a/site/index.html
+++ b/site/index.html
@@ -156,5 +156,5 @@

 <!--
 MkDocs version : 1.5.3
-Build Date UTC : 2023-11-14 08:15:12.919559+00:00
+Build Date UTC : 2024-02-12 12:14:50.157086+00:00
 -->
--- a/site/search/search_index.json
+++ b/site/search/search_index.json
--- a/site/sitemap.xml
+++ b/site/sitemap.xml
@@ -2,52 +2,52 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <url>
         <loc>https://docs.savaneprod.fr/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/about/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Ansible/2023-10-01-nextcloud-docker-update-from-ansible/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Ansible/2023-11-14-savanewiki-plubication/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Linux/2019-07-09-manipulations-LVM/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Synology/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Synology/2019-09-01-access-synology-with-ssh-asymetrical-key/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Synology/2019-12-16-wildcard-lets-encrypt-certificate/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Synology/2020-12-04-borg-backup/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
    <url>
         <loc>https://docs.savaneprod.fr/Synology/2021-02-06-restore-time-machine-backup/</loc>
-         <lastmod>2023-11-14</lastmod>
+         <lastmod>2024-02-12</lastmod>
         <changefreq>daily</changefreq>
    </url>
 </urlset>
--- a/site/sitemap.xml.gz
+++ b/site/sitemap.xml.gz