update or first part doc Enterprise DB

- applied OVH guidelines
- removed useless guide

Author: Bastien V

Diff for: docs-guideline/markdown-custom.md

@@ -11,11 +11,11 @@
 > [!alert]
 >
 > this is an alert!
-> 
+>
 ```
 
 ```html
-<!-- generated html --> 
+<!-- generated html -->
 
 <div class="callout alert">
   <p>this is an alert!</p>
@@ -34,7 +34,7 @@
 > [!primary]
 >
 > this is a primary notice!
-> 
+>
 ```
 
 ![alert notice](images/notice-primary.png)
@@ -47,7 +47,7 @@
 > [!warning]
 >
 > this is a warning!
-> 
+>
 ```
 
 ![alert notice](images/notice-warning.png)
@@ -60,7 +60,7 @@
 > [!info]
 >
 > this is a simple notice!
-> 
+>
 ```
 
 ![alert notice](images/notice-simple.png)
@@ -76,7 +76,7 @@
 > - ![caption of image 1](images/01.jpg)
 > - ![caption of image 2](images/02.jpg)
 > - ![caption of image 3](images/03.jpg)
-> 
+>
 ```
 
 ```html

Diff for: pages/cloud/entreprise-cloud-databases/add-delete-cluster-node/guide.fr-fr.md

@@ -5,38 +5,50 @@ excerpt: 'Apprenez comment ajouter ou supprimer un nœud à votre cluster'
 section: 'Démarrer avec votre cluster PostgreSQL'
 ---
 
-## Architecture d'un cluster
+**Dernière mise à jour le 20/12/2019**
 
-Cette offre se compose par défaut de 3 nœuds, assurant le bon fonctionnement de la haute disponibilité du service. Il s'agit du minimum nécessaire au fonctionnement du cluster.
+## Objectif
+Les offres Enterprise Cloud Databases proposent des instances de bases de données composées de plusieurs nœuds physiques.
+Composé au minimum de 3 nœuds, chaque cluster sait assurer une mise à l'échelle horizontale, pour gagner en performance et en résilience.
+Ce guide vous explique comment ajouter et supprimer des nœuds supplémentaires sur votre cluster.
 
-## Croissance horizontale et résilience
 
-Lorsque la charge de votre applicatif augmente, l'offre d'OVHcloud vous permet d'y faire face en vous donnant la possibilité d'ajouter (et de réduire dans un second temps) des nœuds en lecture seule à votre cluster.
+## Pré-requis
+- Disposer d'un cluster Enterprise Cloud Databases.
+- Disposer d'un accès à l'espace client ou à l'API avec des droits suffisants (administrateur ou technique).
 
-Ajoutez de la puissance de calcul à votre cluster en fonction de vos besoins.
+
+## En pratique
+
+### Étape 1 : comprendre les bénéfices d'une mise à l'échelle
+Lorsque la charge de votre applicatif augmente, votre base de données est souvent davantage sollicitée en lecture et en écriture. Plus d'informations à traiter, toujours aussi rapidement. Enterprise Cloud Databases vous permet de répartir ces requêtes sur plusieurs nœuds.
+
+Chaque nœud supplémentaire vous permet d'augmenter votre capacité à accepter des requêtes en lecture, et améliore également la résilience de votre cluster.
+
+Ajoutez ou suppirmez de la puissance de calcul à votre cluster en fonction de vos besoins.
 
 > [!primary]
 >
 > Nous recommandons de garder un nombre impair de nœuds à l’intérieur de votre cluster afin de respecter le quorum lié à la gestion de la haute disponibilité.
 >
 
-## Ajout d'un nœud
 
+### Étape 2 : ajout d'un nœud
 Vous pouvez ajouter un maximum de 8 nœuds supplémentaires, pour un total de 10 nœuds de lecture seule (réplicas) au sein du cluster.
 
-Utilisez votre espace client pour ajouter une ou plusieurs ressources additionnelles. Cliquez sur `Cluster Nodes`{.action} puis `Actions`{.action} et `Add replica`{.action}.
+Utilisez votre espace client pour ajouter une ou plusieurs ressources additionnelles. Cliquez sur `Nœuds du cluster`{.action} puis `Actions`{.action} et `Ajouter un réplica`{.action}.
 
 Vous serez amenés à choisir le nombre de réplicas que vous souhaitez ajouter au travers d'une boîte de dialogue dédiée.
 
 > [!primary]
 > Le nouveau nœud s'inscrit dans le quorum de haute disponibilité et peut ainsi devenir primaire (et donc porter les écritures) au cours de la vie du cluster.
 >
 
-## Suppression d'un nœud
 
+## Étape 3 : suppression d'un nœud
 Utilisez l'interface de votre espace client pour supprimer un nœud ajouté.
 
-Consultez la page `Cluster Nodes`{.action} puis cliquez sur le bouton `...`{.action} puis `remove`{.action} pour supprimer une ressource. 
+Consultez la page `Nœuds du cluster`{.action} puis cliquez sur le bouton `...`{.action} puis `supprimer`{.action} pour supprimer une ressource. 
 
 Vous serez amenés à choisir le nombre de réplicas que vous souhaitez supprimer au travers d'une boîte de dialogue dédiée.
 
@@ -47,3 +59,9 @@ Vous serez amenés à choisir le nombre de réplicas que vous souhaitez supprime
 > [!primary]
 > Attention, la suppression d'un nœud peut entraîner une courte période d’indisponibilité si l'action provoque la promotion d'un nouveau nœud.
 >
+
+## Aller plus loin
+
+Apprenez à gérer votre cluster PostgreSQL en consultant la [documentation technique d'OVHcloud](../enterprise-cloud-databases/){.external} pour davantage d'informations sur le fonctionnement technique de votre offre managée.
+
+Échangez avec notre communauté d'utilisateurs sur <https://community.ovh.com>

Diff for: pages/cloud/entreprise-cloud-databases/backup-principles/guide.en-gb.md

@@ -5,29 +5,58 @@ excerpt: 'Protéger l''accès à votre cluster au travers de filtres d''accès'
 section: 'Démarrer avec votre cluster PostgreSQL'
 ---
 
-## Fonctionnement des groupes de sécurité
-Votre cluster est un service exposé sur le réseau public. Pour des questions de sécurité, OVH vous impose la création de filtres pour vous laisser accéder à votre cluster.
+**Dernière mise à jour le 20/12/2019**
 
-Ces filtres sont réalisés au travers des groupes de sécurité. Par défaut, tout le trafic entrant est bloqué sur votre cluster. Seules les IPs publiques contenues dans ces groupes seront autorisées à accéder au cluster.
+## Objectif
+Les offres Enterprise Cloud Databases sont compatibles avec n'importe quel service joignable par le réseau public (Internet), tel que l'ensemble des produits cloud OVHcloud, mais également des fournisseurs de cloud tierces, ou encore votre propre architecture.
 
-Les filtres sont appliqués sur les instances restaurées et le répartiteur de charge, une brique d'infrastructure de votre cluster situé en amont de vos nœuds. Consultez [la documentation OVH](https://docs.ovh.com/fr/load-balancer/){.external} pour plus d'informations sur les répartiteurs de charges.
+Afin de sécuriser les accès, il est nécessaire d'autoriser des IPs à ce connecter sur votre cluster.
+Ce guide vous explique comment gérer vos groupes et règles de sécurité.
 
 
-## Règles de sécurité
-Utilisez votre espace client pour interagir avec vos groupes de sécurité.
+## Pré-requis
+- Disposer d'un cluster Enterprise Cloud Databases.
+- Disposer d'un accès à l'espace client ou à l'API avec des droits suffisants (administrateur ou technique).
+- Disposer d'une IPv4 ou plage IPv4 à autoriser.
 
-Les groupes de sécurité sont présentés sous forme de listes depuis la rubrique `Settings`{.action}.
 
-Utilisez ces groupes pour ajouter / supprimer une ou plusieurs adresses IPs.
+## En pratique
+
+### Étape 1 : comprendre les mécansimes de sécurité
+Votre cluster est un service exposé sur le réseau public,  n'autorisant par défaut aucune connexion extérieure.
+Pour des questions de sécurité, OVHcloud vous impose la création de groupes et règles de sécurité pour vous connecter à votre cluster.
+Cette liste blanche vient en compléments d'autre mécanisme, tels que des flux sécurisés via TLS ou du chiffrement de vos données.
+
+
+### Étape 2 : crée ou supprimer un groupe de sécurité
+Un groupe de sécurité peut contenir de multiples règles de sécurité. Ils vous permettent de ranger et trier vos règles de sécurité plus facilement.
+Pour créer un groupe, rendez-vous dans votre espace client, puis cliquez sur `Paramètres`{.action} puis `Groupes de sécurité`{.action} et enfin `Créer un groupe`{.action}.
+Un nom pour votre groupe vous sera demandé.
+
+Une fois créé, vous verrez apparaître votre groupe de sécurité sur cette même page, dans laquel il est possible de modifier le nom de votre gorupe ou le supprimer
+
+
+### Étape 3: créer ou supprimer une règle de sécurité
+Une fois votre groupe de sécurité créé, cliquez sur `...`{.action} puis `Ajouter une règle`{.action}.
+Renseignez la règle de sécurité désirée puis validez.
+
 
 > [!primary]
-> Les adresses IP que vous renseignez doivent respecter certaintes règles :
+> Les adresses IP que vous renseignez doivent respecter certaines règles :
 >
 > - être une IP valide
-> - ne pas doit pas commencer par 0.0.0.0
-> - ne pas être une IP privée ("10.0.0.0/8", "172.16.0.0/12" ou "192.168.0.0/16") 
+> - ne pas commencer par 0.0.0.0
+> - ne pas être une IP privée ("10.0.0.0/8", "172.16.0.0/12" ou "192.168.0.0/16")
 >
 
+
 > [!primary]
 > Attention : vous devez conserver un groupe de sécurité actif contenant au moins une adresse IP valide pour pouvoir accéder à votre cluster.
 >
+
+
+## Aller plus loin
+
+Apprenez à gérer votre cluster PostgreSQL en consultant la [documentation technique d'OVHcloud](../enterprise-cloud-databases/){.external} pour davantage d'informations sur le fonctionnement technique de votre offre managée.
+
+

Diff for: pages/cloud/entreprise-cloud-databases/backup-principles/guide.fr-fr.md

@@ -6,13 +6,31 @@ section: 'Démarrer avec votre cluster PostgreSQL'
 order: 3
 ---
 
-## Configurer le mot de passe de votre utilisateur adminstrateur
+**Dernière mise à jour le 20/12/2019**
 
-OVH vous fournit un compte administrateur pour votre instance de base de données. Cet utilisateur **postgres** peut réaliser toutes les opérations techniques de type "administration".
+## Objectif
+
+Chaque cluster Enterprise Cloud Databases est configuré nativement avec un utilisateur administrateur.
+Ce guide va vous présenter les étapes nécessaire à son utilisation.
+
+
+## Pré-requis
+- Disposer d'un cluster Enterprise Cloud Databases.
+- Disposer d'un accès à l'espace client ou à l'API avec des droits suffisants (administrateur ou technique).
+
+
+## En pratique
+
+### Étape 1 : comprendre les rôles superuser
+
+OVH vous fournit un compte administrateur pour votre instance de base de données. Cet utilisateur **postgres** peut réaliser toutes les opérations techniques de type "administration". il dispose des droits superuser.
 
 Reportez-vous à la [documentation officielle de PostgreSQL](https://www.postgresql.org/docs/current/role-attributes.html){.external} pour connaître ces privilèges.
 
-Ce mot de passe est modifiable à tout instant. Pour ce faire, rendez-vous sur votre espace client dans l'onglet `Overview > Informations`{.action} et cliquez sur le bouton `...`{.action} puis `Update Password`{.action}.
+
+### Étape 2 : configuration via espace client
+
+Le mot de passe de l'utilisateur administrateur **postgres** est modifiable à tout instant. Pour ce faire, rendez-vous sur votre espace client dans l'onglet `Accueil > Informations`{.action} et au niveau des identifiants cliquez sur le bouton `...`{.action} puis `Mettre à jour le mot de passe`{.action}.
 
 > [!primary]
 > Pour des raisons de sécurité, le mot de passe doit respecter certaines règles de complexité :
@@ -22,3 +40,16 @@ Ce mot de passe est modifiable à tout instant. Pour ce faire, rendez-vous sur v
 > - doit contenir au moins deux chiffres
 > - faire entre 12 et 32 caractères
 >
+
+
+### Étape 2 bis : configuration via API
+
+La route API suivante vous permet de mettre à jour votre mot de passe administrateur.
+Veillez à respecter les règles de complexité définies à l'étape 2.
+
+
+> [!api]
+>
+> @api {POST} /cloudDB/enterprise/cluster/{clusterId}/user
+>
+```

Diff for: pages/cloud/entreprise-cloud-databases/configure-securitygroups/guide.fr-fr.md

@@ -5,52 +5,86 @@ excerpt: 'Comment créer vos bases et utilisateurs à l''intérieur de votre clu
 section: 'Démarrer avec votre cluster PostgreSQL'
 ---
 
-## Pour commencer
+**Dernière mise à jour le 26/12/2019**
 
-Cette documentation fournit les étapes à suivre afin de créer votre première base de données et votre premier utilisateur.
+## Objectif
 
-*Note : référez-vous à la [documentation technique de PostgreSQL](https://www.postgresql.org/docs/){.external} pour de plus amples informations.*
+Ce guide vous explique comment créer vos premières bases de données et utilisateurs dans votre cluster Enteprise Cloud Databases pour PostgreSQL.
+Pour une documentation exhaustive, référez-vous à la [documentation technique officielle de PostgreSQL](https://www.postgresql.org/docs/){.external}.
 
 
-## Interagir avec votre cluster en ligne de commandes
+## Pré-requis
+- Disposer d'un cluster Enterprise Cloud Databases pour PostgreSQL.
+- Avoir configuré le mot de passe de votre utilisateur administrateur.
+- Avoir configuré au moins une règle de sécurité.
 
-- **Étape 1 - Connectez-vous à votre cluster avec votre super-utilisateur**
 
-L'espace client vous affichera les informations utiles depuis la section `Overview`{.action} puis `Connection Information`{.action}
+## Rappel
+
+Vous possédez le compte administrateur PostgreSQL **postgres** qui à la possibilité de réaliser tous types d'opérations sur la base de données.
+
+> [!primary]
+> Il est impératif de ne pas modifier les configurations techniques mises en place par OVHcloud au risque de dégrader ou d’empêcher le bon fonctionnement de votre cluster.
+>
+
+
+## En pratique
+
+### Étape 1 : Installation d'un client PostgreSQL
+
+Sur un système d'exploitation Unix/Linux, il convient d'installer le paquet postgresql-client pour se connecter en ligne de commande. Réferrez-vous à la documentation officelle de votre système d'exploitation.
+
+Sur Microsoft Windows, il existe une multitude de solutions en lignes de commande ou interfaces visuelles (GUI). Elles sont référencées dans la [documentation wiki de PostgreSQL](https://wiki.postgresql.org/wiki/PostgreSQL_Clients){.external}. Choisissez celui qui vous convient le mieux.
+
+La suite des étapes détaille une procédure de connexion par lignes de commande.
+
 
-Exemples de chaînes de connexions :
+### Étape 2 : Connexion au cluster
+
+Dans votre espace client OVHcloud, retrouvez les informations utiles depuis la section `Accueil`{.action} puis `Informations de connexion`{.action}.
+
+Enterprise Cloud Databases vous propose des paramètres de connexion en lecture seule, et en lecture-écriture.
+Pour créer des bases de données et utilisateurs, il est nécessaire d'utiliser les paramètres de connexion en lecture-écriture.
+
+Exemples d'informations de connexion en lignes de commandes :
 
     read-write
-        postgresql://postgres:************@5f771a6d99ee4102980c2d.prm.clouddb.ovh.net:38697/postgres?sslmode-require
-        psql -U postgres -h 5f771a6d99ee4102980c2d.prm.clouddb.ovh.net -p 38697 -W --set=sslmode=require
+        psql -U postgres -h 123456d99ee4102980c2d.prm.clouddb.ovh.net -p 38697 -W --set=sslmode=require
 
     read-only
-        postgresql://postgres:************@5f771a6d99ee4102980c2d.prm.clouddb.ovh.net:6713/postgres?sslmode=require
-        psql -U postgres -h 5f771a6d99ee4102980c2d.prm.clouddb.ovh.net -p 6713 -W --set=sslmode=require
+        psql -U postgres -h 1234566d99ee4102980c2d.prm.clouddb.ovh.net -p 6713 -W --set=sslmode=require
 
 
-- **Étape 2 - Créez votre utilisateur**
+Copiez les informations de connexion dans votre interface de lignes de commande.
+Un mot de passe vous sera demandé, celui de votre administrateur `postgres` préalablement configuré.
 
-Depuis le shell PostgreSQL
 
-    postgres=# CREATE ROLE username NOINHERIT LOGIN PASSWORD 'password';
+### Étape 3 : Création d'utilisateurs
 
+Une fois connecté à votre cluster, vous avez la possibilité de réaliser une multitude d'opérations.
+[La documentation officielle de PostgreSQL](https://www.postgresql.org/docs/manuals/){.external} recense et détaille ces cas de figures, par version.
 
-- **Étape 3 - Créez votre base de données**
+PostgreSQL repose sur un sytème de rôles et d'utilisateurs. Un rôle peut contenir plusieurs utilisateurs et ses capacités peuvent être définies précisément : accès à une base spécifique, en lecture seule ou lecture-écriture, pendant une période limitée, capacité à créer des tables, des utilisateurs, ...
 
-Depuis le shell PostgreSQL
 
-    postgres=# CREATE DATABASE name OWNER username;
+En version 12, voici un exemple basique de ligne de commande créant l'utilisateur `martin` avec le mot de passe `password`.
 
-- **Étape 4 - Accédez à votre base de données avec votre nouvel utilisateur dédié**
 
-    psql -U username -h fqdn -p port -W --set=sslmode=require databasename
+    postgres=# CREATE ROLE martin NOINHERIT LOGIN PASSWORD 'password';
 
 
-## Rappel
+### Étape 4 : Création de bases de données
 
-Vous possédez le compte administrateur PostgreSQL **postgres** qui à la possibilité de réaliser tous types d'opérations sur la base de données.
+De la même manière, voici un exemple basique pour la création de la base de données `mydatabase`, avec l'utilisateur `martin` qui en sera le propriétaire.
 
-> [!primary]
-> Il est impératif de ne pas modifier les configurations techniques mises en place par OVHcloud au risque de dégrader ou d’empêcher le bon fonctionnement de votre cluster.
->
+    postgres=# CREATE DATABASE mydatabase OWNER username;
+
+
+Votre utilisateur `martin` pourra ainsi s'y connecter de la manière suivante :
+
+    psql -U martin -h fqdn -p port -W --set=sslmode=require mydatabase
+
+
+## Aller plus loin
+
+Apprenez à gérer votre cluster PostgreSQL en consultant la [documentation technique d'OVHcloud](../enterprise-cloud-databases/){.external} pour davantage d'informations sur le fonctionnement technique de votre offre managée.