From f63f73511abb8033353ec71d305d2f564ac5e0f9 Mon Sep 17 00:00:00 2001
From: Julien Bouquillon <julien.bouquillon@sg.social.gouv.fr>
Date: Sun, 26 Nov 2023 13:39:53 +0100
Subject: [PATCH] docs: wip cnpg

---
 docs/faq.md | 29 ++++++++++++++++++++---------
 1 file changed, 20 insertions(+), 9 deletions(-)

diff --git a/docs/faq.md b/docs/faq.md
index 5f40173d..0eeb618b 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -130,19 +130,28 @@ Voir l'implémentation de [template](https://github.com/SocialGouv/template)
 
 ## Bases de données
 
-### Bases de données  PostgreSQL CNPG
+### Bases de données PostgreSQL CNPG
 
-Vous aurez besoin de `kubectl` installé avec votre `KUBECONFIG` récupéré depuis [rancher](https://rancher.fabrique.social.gouv.fr).
+Vous aurez besoin de `kubectl` installé avec les bons `KUBECONFIG` récupérés depuis [rancher](https://rancher.fabrique.social.gouv.fr).
 
-#### Se connecter à la base via psql
+:warning: Attention à bien utiliser [le bon contexte](https://enix.io/fr/blog/kubectl-commands/#kubectl-config-et-fichier-kubeconfig) lorsque vous utilisez `kubectl`.
 
- - avec kubectl : `kubectl exec -ti -n [NAMESPACE] [POD] psql`
- - avec un client Postgres:
-   - récupérer le secret `pg-app` dans le namespace de la base de données
-   - ouvrir un port-forward : `kubectl port-forward -n [NAMESPACE] [POD] 5435:5432`
-   - se connecter à `postgres://[USER]:[PASS]@127.0.0.1:5435/app?sslmode=disable`
+Identifiez vos noeuds PostgreSQL : `kubectl -n[NAMESPACE] get po --selector=cnpg.io/podRole=instance -o=custom-columns="NAME:.metadata.name,ROLE:.metadata.labels.role"`.
+
+Pour de la lecture seule, choisissez un `replica`, et `primary` si besoin d'écrire.
+
+ > :bulb: CNPG utilise des certificats SSL self-signés, il faut désactiver le SSL selon les clients
+
+#### Se connecter avec un client PostgreSQL
+
+  - récupérer le secret `pg-app` dans le namespace de la base de données : `kubectl -n[NAMESPACE] get secret pg-app -o jsonpath='{.data.DATABASE_URL}' | base64 -d`
+  - ouvrir un port-forward : `kubectl port-forward -n [NAMESPACE] [POD] 5435:5432`
+  - se connecter à `postgres://[USER]:[PASS]@127.0.0.1:5435/[DB]?sslmode=disable`
+
+##### Avec kubectl
+
+ On peut lancer un cli `psql` directement : `kubectl exec -ti -n [NAMESPACE] [POD] psql`. Ex: `kubectl exec -ti -n template pg-1 psql`. idem pour pg_dump & all.
 
- > CNPG utilise des certificats SSL self-signés, il faut désactiver le SSL selon les clients
 
 #### Récupération d'un dump
 
@@ -153,6 +162,8 @@ Voir aussi : https://cloudnative-pg.io/documentation/current/troubleshooting/#em
 
 ### Bases de données Azure Postgres
 
+:warning: Les PG azure sont en cours de remplacement par des instances CNPG (cf paragraphe précédent).
+
 #### `ERROR: cannot execute xxx in a read-only transaction`
 
 Si le serveur est trop plein, il se met automatiquement en "read-only". Pour pouvoir faire le ménage, executer `SET SESSION CHARACTERISTICS AS TRANSACTION READ WRITE;` pour reactiver la mode "writeable".