Updating Enterprise Cloud Databases doc part #1

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

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

@@ -5,40 +5,52 @@ 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 de lecture 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 supprimez 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.
+Vous serez amené à choisir le nombre de réplicas que vous souhaitez supprimer au travers d'une boîte de dialogue dédiée.
 
 > [!primary]
 > Aucun remboursement n'est applicable si vous supprimez un nœud avant la fin de votre période d'engagement.
@@ -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>

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

@@ -5,29 +5,59 @@ 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 tiers, 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é.
 
-Les groupes de sécurité sont présentés sous forme de listes depuis la rubrique `Settings`{.action}.
+## 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.
+
+
+## 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.
+Ces groupes et règles de filtrage viennent en complément d'autres mécanismes, 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 groupe 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.
 
-Utilisez ces groupes pour ajouter / supprimer une ou plusieurs adresses IPs.
 
 > [!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.
+
+

pages/cloud/entreprise-cloud-databases/configure-superuser/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écessaires à 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
+
+OVHcloud 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 > Information`{.action} et, au niveau des identifiants, cliquez sur le bouton `...`{.action} puis sur `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
+>
+```