Merge pull request #423 from baaastijn/develop

Updating Enterprise Cloud Databases doc part #1

Author: OVH-Team-Guides

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,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>

Diff for: pages/cloud/entreprise-cloud-databases/backup-principles/guide.en-gb.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.
+
+

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é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
+>
+```

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 a 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éférez-vous à la documentation officielle 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.

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

@@ -5,12 +5,49 @@ excerpt: 'Accédez aux logs de votre cluster'
 section: 'Démarrer avec votre cluster PostgreSQL'
 ---
 
-## Journaux d'evenements
 
-OVHcloud stocke l'intégralité de vos journaux d'évènements (logs) pendants 3 mois glissants, sur notre plateforme OVH Logs Data Platform.
+**Dernière mise à jour le 20/12/2019**
 
-Pour accéder à ces journaux, vous devrez activer gratuitement un compte Logs Data Platform.
+## Objectif
 
-## Gérez l'accès de votre compte LDP aux logs de votre cluster
+Chaque cluster Enterprise Cloud Databases collecte et stocke les journaux d'évènements (logs) de manière centralisée et automatisée, durant 3 mois glissants.
+Ce guide va vous présenter les étapes nécessaire pour y accèder.
 
-Une fois votre compte LDP créé, utilisez votre espace client à la rubrique `Logs`{.action} pour lui donner les droits de consultation des logs de votre cluster. 
+
+## Pré-requis
+- Disposer d'un cluster Enterprise Cloud Databases.
+
+
+## En pratique
+
+### Étape 1 : activation d'un compte OVHcloud Logs
+
+Les journaux d'évènements sont collectés et stockés dans le produit tiers OVHcloud LogsData Platform. Leur stockage est inclus dans notre offre.
+Pour accéder à vos logs, vous devez disposez d'un compte gratuit OVHcloud Logs que vous pouvez créer [sur la page officielle](https://www.ovh.com/fr/data-platforms/logs/){.external}.
+
+Une fois créé, votre service OVHcloud Logs apparaît dans votre espace client. Récupérez votre nom d'utilisateur se trouvant dans `Accueil > Configuration`{.action} :
+
+![Main interface](images/manager_start.png){.thumbnail}
+
+
+
+### Étape 2 : accorder l'accès à OVHcloud Logs
+
+Une fois votre compte créé, dirigez vous dans votre espace client Enterprise Cloud Databases dans `Logs`{.action} puis `Accorder l'accès au compte OVH Logs`{.action}.
+Une fenêtre vous demande votre nom d'utilisateur OVHcloud Logs. Renseignez-le et acceptez.
+
+
+### Étape 3 : utilisation de Graylog
+
+Nous vous proposons le logiciel Graylog pour visualiser vos logs de manière simple et interactive. Graylog vous permet de créer des dashboards de toutes sortes et de naviguer dans vos journaux d'évènements.
+[La documentation officielle de OVHcloud Logs](../../platform/logs-data-platform/){.external} détaille toutes les étapes de configuration qui vous permettront de créer les dashboards nécessaires à votre usage, et plus encore.
+
+Exemple de dashboard :
+
+![Main interface](images/graylog-stream.png){.thumbnail}
+
+
+
+## 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/create-database-user/guide.fr-fr.md

@@ -1,54 +1,87 @@
 ---
-title: 'Gérer les sauvegardes'
+title: 'Sauvegardes et restaurations'
 slug: gerer-sauvegardes
-excerpt: 'Gérez l''ensemble de vos sauvegardes et gardez le contrôle sur vos données avec l''interface client'
+excerpt: 'Gérez l''ensemble de vos sauvegardes et restaurations'
 section: 'Démarrer avec votre cluster PostgreSQL'
 ---
 
-## Sauvegardes incluses à l'offre
-Votre cluster PostgreSQL est sauvegardé de manière journalière par OVHcloud.
+**Dernière mise à jour le 26/12/2019**
 
-Par défaut, nous conservons ces sauvegardes sur 3 mois glissants.
+## Objectif
 
-Cette fonctionnalité est incluse à votre offre et ne présente aucun coût additionnel.
+Votre cluster Enterprise Cloud Databases est sauvegardé de manière journalière par OVHcloud.
+Par défaut, nous conservons ces sauvegardes sur 3 mois glissants, sans aucun coût additionnel.
+Ce guide vous détaille comment interagir avec ces sauvegardes et comment les restaurer.
 
-Vous pouvez activer ou désactiver cette option depuis votre espace client dans la rubrique `Settings`{.action}.
 
-## Sauvegardes manuelles
+## Pré-requis
+- Disposer d'un compte client OVHcloud.
+- Pouvoir établir une connexion depuis le réseau public (Internet).
+- Avoir un client PostgreSQL installé sur le poste depuis lequel vous souhaitez vous connecter à votre base de données.
 
-En complément des sauvegardes automatiques intégrées à votre offre, vous pouvez en réaliser manuellement et à tout moment.
 
-Ces sauvegardes manuelles ne sont pas incluses dans le prix de votre cluster. Leur tarif est indiqué lors de la création.
+## Présentation des sauvegardes
 
+**Sauvegarde complète**
 
-## Interagir avec vos sauvegardes
-L'ensemble de vos sauvegardes peut être géré de manière centralisée. Pour cela, rendez-vous dans l'onglet `Backups`{.action} de votre espace client.
+Afin de ne pas perturber vos applicatifs en production, OVHcloud utilise un nœud de sauvegarde isolé (sans trafic client) et procède sur celui-ci à un snapshot ZFS à froid (service PostgreSQL arrêté).
+Ce procédé permet d'obtenir des performances constantes sur votre cluster en production, cela même lors des sauvegardes.
+
+Les snapshots sont ensuite envoyés pour archivage sur un ensemble de serveurs de stockage.
+
+
+**Sauvegarde incrémentale**
+
+La sauvegarde incrémentale se base sur le Write-Ahead Logging (fichiers de WAL) de PostgreSQL. Découvrez davantage d'informations sur la page de [documentation WAL PostgreSQL](https://docs.postgresql.fr/current/wal-intro.html){.external}.
+
+Ces fichiers de WAL contiennent l'ensemble des changements apportés aux données. OVHcloud assure l'archivage des fichiers de WAL pour une durée de 3 mois glissants.
+
+Les fichiers de WAL sont utilisés pour réaliser du Point In Time Recovery (PITR). Ils se réfèrent toujours à une sauvegarde complète.
+
+PostgreSQL, grâce à son système d'archivage automatique, permet à OVHcloud de chiffrer et d'envoyer ces fichiers vers un container Public Cloud Storage lié à votre cluster.
+
+
+## En pratique
+
+### Étape 1 : activer ou désactiver les sauvegardes automatiques
+Par défaut, votre cluster est automatiquement sauvegardé, cela chaque jour sur 3 mois glissants (snapshot ZFS).
+Vous pouvez activer ou désactiver cette option depuis votre espace client dans la rubrique `Paramètres > Sauvegardes automatiques journalières`{.action}.
+
+
+### Étape 2 : lister et interagir avec ses sauvegardes
+L'ensemble de vos sauvegardes est géré de manière centralisée. Pour cela, rendez-vous dans l'onglet `Sauvegardes`{.action} dans votre espace client.
 
 Vous y trouverez toutes vos sauvegardes :
 
-- celles automatiquement réalisées par OVHcloud.
-- celles faites à la demande.
+- celles automatiquement réalisées par OVHcloud, journalièrement. 
+- celles réalisées manuellement.
 
-Utilisez le bouton `Actions`{.action} pour :
+Chacune des sauvegardes dispose d'une date de création et d'une date d'expiration. Via le bouton `Actions`{.action} il est possible de :
 
 - lancer une sauvegarde manuelle.
-- lancer une restauration à un temps donné.
+- lancer une restauration à un temps donné (PITR).
 
+Il n'est pas possible de les télécharger depuis l'espace client.
 
-- **Création d'une sauvegarde manuelle**
 
+### Étape 3 : créer une sauvegarde manuelle
 Depuis l'interface client, rendez-vous dans l'onglet `Sauvegardes`{.action} puis cliquez sur le bouton `Actions`{.action}.
 
 Vous pouvez donner un nom à vos sauvegardes manuelles pour en faciliter la gestion.
 
 > [!primary]
 >
-> Attention, les sauvegardes manuelles représentent un coût aditionnel détaillé dans l'espace client.
+> Attention, les sauvegardes manuelles représentent un coût additionnel détaillé dans l'espace client.
 >
 
-- **Restaurer une sauvegarde**
 
-Sélectionnez la sauvegarde qui vous intéresse dans la liste et cliquez sur le bouton `...`{.action} puis `restore`{.action}.
+### Étape 4 : restaurer une sauvegarde
+Une sauvegarde peut être restaurée depuis l'espace client, suivant deux méthodes.
+
+
+**Restaurer une sauvegarde précise**
+
+Sélectionnez la sauvegarde qui vous intéresse dans la liste et cliquez sur le bouton `...`{.action} puis `restaurer`{.action}.
 
 > [!primary]
 >
@@ -57,20 +90,25 @@ Sélectionnez la sauvegarde qui vous intéresse dans la liste et cliquez sur le
 > Cette instance vous sera facturée par heure et l'espace consommé par les données vous sera facturé par Go par heure.
 >
 
-- **Restauration à un instant précis (PITR, Point In Time Recovery)**
 
-Cette fonctionnalité de PostgreSQL vous permet de revenir dans le temps, à la transaction près. Vous trouverez davantages d'informations sur le fonctionnement en consultant [la documentation officielle](https://docs.postgresql.fr/10/continuous-archiving.html){.external} de PostgreSQL.
+**Restaurer à un instant précis (PITR, Point In Time Recovery)**
+
+Cette fonctionnalité de PostgreSQL vous permet de revenir dans le temps, à la minute près. Vous trouverez davantage d'informations sur le fonctionnement en consultant [la documentation officielle](https://docs.postgresql.fr/10/continuous-archiving.html){.external} de PostgreSQL.
 
-Cliquez sur le bouton `Actions`{.action} puis `Launch a point in time recovery`{.action}. Une fenêtre de dialogue vous demandera alors de rentrer la date et l'heure à laquelle vous souhaitez retrouver vos données.
+Cliquez sur le bouton `Actions`{.action} puis `Restauration à une date spécifiée`{.action}. Une fenêtre de dialogue vous demandera alors de rentrer la date et l'heure à laquelle vous souhaitez retrouver vos données.
 
 > [!primary]
 >
-> Pour ne pas pertuber le fonctionnement de votre cluster, les données restaurées sont mises à disposition sur une instance dédiée en lecture seule.
+> Pour ne pas perturber le fonctionnement de votre cluster, les données restaurées sont mises à disposition sur une instance dédiée en lecture seule.
 >
 > Cette instance vous sera facturée par heure et l'espace consommé par les données vous sera facturé par Go par heure.
 >
 
 
-- **Suppression**
+### Étape 5 : supprimer une sauvegarde
+Sélectionnez la sauvegarde qui vous intéresse dans la liste et cliquez sur le bouton `...`{.action} puis `supprimer`{.action}.
+
+
+## Aller plus loin
 
-Sélectionnez la sauvegarde qui vous intéresse dans la liste et cliquez sur le bouton `...`{.action} puis `delete`{.action}.
+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/log-management/guide.fr-fr.md

@@ -6,17 +6,17 @@ section: 'Démarrer avec votre cluster PostgreSQL'
 order: 2
 ---
 
-**Dernière mise à jour le 05/12/2019**
+**Dernière mise à jour le 20/12/2019**
 
 ## Objectif
 
-L'offre Enterprise Cloud Databases vous propose une instance PostgreSQL sur un cluster dédié.
+L'offre Enterprise Cloud Databases vous propose des moteurs de bases de données tels que PostgreSQL sur un cluster dédié.
 Le cluster est managé par OVHcloud mais vous avez le rôle **superuser** sur votre cluster.
 Ce guide va vous présenter toutes les étapes permettant de créer votre cluster PostgreSQL et de tester la connexion.
 
 ## Pré-requis
 - Disposer d'un compte client OVHcloud.
-- Pouvoir établir une connexion depuis une IP ajoutée dans les groupes de sécurité.
+- Pouvoir établir une connexion depuis le réseau public (Internet).
 - Avoir un client PostgreSQL installé sur le poste depuis lequel vous souhaitez vous connecter à votre base de données.
 
 ## Présentation
@@ -32,7 +32,7 @@ Consultez la [documentation d'architecture technique](https://www.postgresql.org
 
 ### Étape 1 : commander votre cluster
 
-Depuis votre espace client, rendez-vous dans successivement sur `Server`{.action} puis `Enterprise Cloud Databases`{.action} et enfin cliquez sur `Commander un cluster`{.action}.
+Depuis votre espace client, rendez-vous successivement sur `Server`{.action} puis `Enterprise Cloud Databases`{.action} et enfin cliquez sur `Commander un cluster`{.action}.
 
 Vous serez amenés à choisir différents paramètres pour créer votre cluster :
 
@@ -45,23 +45,29 @@ Vous serez amenés à choisir différents paramètres pour créer votre cluster
 
 ### Étape 2 : mettre à jour votre utilisateur
 
-Par défaut, OVHcloud vous crée un utilisateur avec les droits d'administration "**postgres**". Vous devez définir son mot de passe avant la première connexion.
+Une fois votre commande réalisée, votre cluster apparaitra dans votre espace client.
+Par défaut, OVHcloud vous crée un utilisateur avec les droits d'administration "**superuser**". Vous devez définir son mot de passe avant la première connexion.
 
 ### Étape 3 : configurer un groupe de sécurité
 
 L'accès à votre instance PostgreSQL étant exposé sur le réseau public, il est nécessaire de filtrer les accès par un groupe de sécurité. Celui-ci peut comprendre des IP seules ou des blocs d'adresses IP.
 
 Dans la vue de votre service sur l'espace client, allez dans l'onglet `Paramètres`{.action} puis dans la section `Groupe(s) de sécurité`{.action}. Cliquez sur `Créer un groupe`{.action}.
 
-Donnez un nom à votre groupe puis renseignez les adresses IP. 
+Donnez un nom à votre groupe puis renseignez une ou plusieurs adresses IP autorisées à se connecter au cluster.
 
 ```
 Exemple :
 181.36.14.xxx/32
 83.4.121.xxx/32
 ```
 
-### Étape 4 : vous connecter à votre instance
+### Étape 4 : vous connecter à votre cluter
+
+OVHcloud vous fournit deux points d'entrée uniques vers votre cluster, peu importe le nombre de nœuds :
+
+- point de connexion en lecture-écriture.
+- point de connexion en lecture seule.
 
 Les paramètres de connexion ainsi que les différentes méthodes disponibles pour vous connecter sont disponibles dans votre espace client.
 
@@ -83,11 +89,12 @@ psql -U postgres -h 5f771a6d99ee4102980c2d.prm.clouddb.ovh.net -p 6713 -W --set=
 
 ### Étape 5 : créer les bases et les utilisateurs
 
-Consultez à cet effet la [https://www.postgresql.org/docs/](documentation PostgreSQL){.external} documentation PostgreSQL pour la création de bases et d'utilisateurs.
+Une fois connecté sur votre cluster, vous pouvez y créer des bases et des utilisateurs supplémentaires.
+Consultez à cet effet la [https://www.postgresql.org/docs/](documentation PostgreSQL){.external} documentation PostgreSQL officielle pour la création de bases et d'utilisateurs.
 
 
 ## 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>
+Échangez avec notre communauté d'utilisateurs sur <https://community.ovh.com>