---
## Méta-données du document
title:      "Compte Rendu d'Audit"
subtitle:   "Intervention du FIXME 12 décembre 2018"
author:     "FIXME John Lennon"
reviewer:   "FIXME Paul McCartney"
date:       "FIXME 25 décembre 2018"
to:         "FIXME Ringo Starr"
customer:   "FIXME Le Sous-Marin Jaune"
reference:  "FIXME DLB-00072-032-CRI-001"
revision:   "1.0"
lang:       "fr"

## Variables substituées
pguser: 'postgres'
pgport: '5432'

---

<!--
Voir le Canva d'Audit pour la méthodologie des audits

https://gitlab.dalibo.info/outillage/outillage/-/blob/main/canvas_audit.md
-->

# Compte Rendu d'Intervention


FIXME

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas egestas quis
nisi ac elementum. Mauris rutrum maximus nisl, at placerat arcu dictum et.
Curabitur non rutrum nisi. Aenean eu odio libero. Nullam blandit neque at
quam facilisis hendrerit. Aliquam erat volutpat. Cras vulputate mattis erat,
vel lobortis ante mollis vel. Vestibulum fermentum suscipit sem sed venenatis.
Nulla tristique ante sit amet nisl facilisis varius. Aenean vel libero leo.

<!--
CECI EST UN COMMENTAIRE INTERNE
il n'apparaitrait pas dans le fichier final
-->



## Références du document

|                      |                  |
|----------------------|------------------|
| Référence            | {{reference}}    |
| Révision             | {{revision}}     |
| Date                 | {{date}}         |
| Auteur/Autrice       | {{author}}       |
| Relecteur/Relectrice | {{reviewer}}     |
| Destinataire         | {{to}}           |


## Licence

!include dalidoc/include/md/licence-cc-by-sa.md

# Présentation du projet

::: notes
Texte d'introduction du chapitre

La syntaxe des notes est totalement optionnelle. Elle permet simplement de
produire un export du rapport au format revealjs pour faire éventuellement
des slides de présentation pour le client.

Supprimez les tags `:::` si vous n'en n'avez pas besoin.
:::


## Notes / Admonitions



::: slide-content

* cette liste
* va apparaitre
* dans les slides

:::

::: notes

Ceci est une autre note (notes)
:::

::: info
Ceci est une info (info)
:::

::: tip
Ceci est une astuce (tip)
:::

::: warning
Ceci est une alerte (warning)
:::

<div class="warning">
Ceci est aussi une alerte
</div>

::: caution
Ceci est une mise en garde (caution)
:::

::: important
Ceci est une note importante (important)
:::

::: release
Ceci est une note de release (release)
:::

> et ceci est un bloc de citation, parfois utilisé pour mettre en
> avant des préco, avec du formatage des termes `technique` et
> autre listes :
>
> * possible
> * à l'`intérieur` sans `problème`

# Blablabla bla

## Information sur l'instance

|                         |                          |
|-------------------------|--------------------------|
| Superuser               | {{pguser}}               |
| Port                    | {{pgport}}               |

## Inclure un fichier SQL externe

```sql
!include dalidoc/include/sql/bloat.sql
```

## Analyse de code

```sql
ALTER TABLE matable SET (autovacuum_analyze_scale_factor = 0.05);
ALTER TABLE matable SET (autovacuum_vacuum_scale_factor = 0.1);
```

<!-- forcer un saut de page si besoin -->
\newpage

## Oh ! un arbre en ASCII !

Généralement cela provient d'une commande `tree`, `ps` ou `lsblock`

```
schema/
├── functions
│   ├── EMP_SAL_RANKING_function.sql
│   ├── function.sql
│   └── LAST_FIRST_NAME_function.sql
```


## Les blocs de codes


Un bloc de code sans langage défini

```default
[serveur]:5435 jeanpierre@postgres=# (standby) SELECT pi(), now(), null ;
╔═══════════════════╦═══════════════════════════════╦══════════╗
║        pi         ║              now              ║ ?column? ║
╠═══════════════════╬═══════════════════════════════╬══════════╣
║ 3.141592653589793 ║ 2022-01-07 16:08:39.925262+01 ║ ø        ║
╚═══════════════════╩═══════════════════════════════╩══════════╝
(1 ligne)
```

Configuration avec le type `ini`:

``` ini
shared_buffers = 8GB
archive_command = '/bin/true'
```

Activité dans une console:

``` console
// ceci est un commentaire

// commande avec un simple utilisateur
$ echo blah
blah

// commande en tant que root
# echo BLAH
BLAH
```

Requête SQL de type postgresql (avec pandoc):

``` sqlpostgresql
ALTER TABLE matable SET (autovacuum_analyze_scale_factor = 0.05);
```

N'utilisez ce dernier style que dans les CRA produit par pandoc. Il n'est pas certain
qu'il soit disponible dans d'autres chaîne de production de document (comme le wiki,
la KB ou sur gitlab/github).


## Retour à la ligne dans les blocs de code

``` yaml
example: "ceci est une ligne beaucoup trop longue !!!! Malgré tout elle est affichée intégralement dans le bloc de code"
```

## Formules mathématiques

$$
Huge Pages = \frac{shared\_buffers (en Go) * 110\%}{(2 * 1024)}
$$


## Césures et Quotes Inversées

::: warning

Lorsque l'on utilise un terme technique ou des chemins de fichier très longs
dans des backquotes, dans les exports PDF il peut arriver que l'écartement
soit élargi automatiquement pour éviter une césure trop brutale du terme

:::

PAR EXEMPLE :

----

Il est alors intéressant de modifier le comportement de l'`autovacuum` pour la table
`communication_communicationsent` en modifiant spécifiquement
son paramètre `autovacuum_vacuum_scale_factor` avec cet ordre SQL :

Le logiciel _pglift_ se base sur le principe de configuration de site. Cette
configuration, consultable dans `/un/très/très/long/chemin/settings.yaml`,
définie les spécificités des instances à déployer et des compostants
satellites associés :

----

::: caution

On peut toutefois désactiver ponctuellement ce comportement avec la commande
latex `\fussy` et ensuite la réactiver avec `\sloppy`. Attention ! Dans ce
cas, il n'y aura plus de césure automatique et c'est à vous de gérer le bon
affichage du texte en insérant des sauts lignes ou en remplaçant les backquotes
par du gras...

:::

\fussy


PAR EXEMPLE :

----

Il est alors intéressant de modifier le comportement de l'`autovacuum` pour la table
`communication_communicationsent` en modifiant spécifiquement son
paramètre `autovacuum_vacuum_scale_factor` avec cet ordre SQL :

Le logiciel _pglift_ se base sur le principe de configuration de site. Cette
configuration, consultable dans `/un/très/très/long/chemin/settings.yaml`,
définie les spécificités des instances à déployer et des compostants
satellites associés :

----


\sloppy

## une image

![slonik](medias/DLB-00000-000-CRA-0000/slonik.png)


# Tableaux plus complexes

Le format [pipe_tables] permet de définir l'alignement des colonnes

| Fichier     | Description     |
| :------------- | :------------- |
| inventory.yml      | inventaire des machines    |
| setup.yml       | _playbook_ principal    |
| warmup.sh       | script d'amorçage    |
|        |     |
| exchange_ssh_keys.yml       | _playbook_ d'échange de clés _ssh_    |
| teardown.yml       | _playbook_ de destruction massive    |


[pipe_tables]: https://pandoc.org/chunkedhtml-demo/8.9-tables.html#extension-pipe_tables


# Conclusion

Maecenas suscipit eget mauris ut iaculis. Aliquam elementum neque lectus, sit
amet consequat magna volutpat in. Aenean volutpat magna metus, at tempus dolor
ornare ut. Nulla dolor arcu, eleifend eu congue vulputate, laoreet tristique sem.
Phasellus blandit tellus vitae maximus facilisis. Aenean at mi efficitur,
vestibulum erat id, egestas est. Proin at velit fermentum, placerat diam ut,
mollis arcu. Ut nulla nisl, luctus a orci eget, tempus tristique felis.
