Tutoriel on PIG.CENTER

Guide utilisateur (Debian/Ubuntu)

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

Ce guide utilisateur est conçu pour être suivi séquentiellement, du début à la fin — chaque section dépend de la précédente. Par exemple, la section Restauration repose sur la configuration effectuée dans la section Démarrage rapide . Une fois pgBackRest en fonctionnement, il est possible de sauter des sections, mais il est recommandé de suivre le guide dans l’ordre lors de la première utilisation.

Bien que les exemples de ce guide soient destinés à Debian/Ubuntu et à PostgreSQL 17, il devrait être relativement facile de les appliquer à toute distribution Unix et toute version de PostgreSQL. Les seules commandes spécifiques au système d’exploitation sont celles permettant de créer, démarrer, arrêter et supprimer des clusters PostgreSQL. Les commandes pgBackRest seront identiques sur tout système Unix, bien que l’emplacement de l’exécutable puisse varier. Bien que pgBackRest cherche à fonctionner de manière cohérente sur les différentes versions de PostgreSQL, certaines différences subtiles entre versions de PostgreSQL peuvent apparaître dans ce guide lors de l’illustration de certains exemples, par exemple les chemins ou noms de fichiers de PostgreSQL, ainsi que les paramètres.

Installation

Mon, 01 Jan 0001 00:00:00 +0000

Prérequis pour Mac OS

Pour installer les prérequis sur un Mac, exécutez la commande suivante :

brew install postgresql etcd haproxy libyaml python

Psycopg

À compter de psycopg2-2.8 , la version binaire de psycopg2 ne sera plus installée par défaut. Son installation à partir du code source nécessite un compilateur C ainsi que les paquets de développement postgres+python. Étant donné qu’environnement Python ne permet pas de spécifier la dépendance comme psycopg2 OR psycopg2-binary, vous devrez déterminer vous-même la méthode d’installation.

Téléchargement et installation

Mon, 01 Jan 0001 00:00:00 +0000

Choisissez un canal de distribution

Channel	Utilisation	Emplacement
Version officielle	Archives sources et notes de version	GitHub Releases
Paquet RPM	Distributions Linux basées sur RPM	PostgreSQL Yum Repository
Paquet Debian/Ubuntu	Distributions Linux basées sur APT	PostgreSQL Apt Repository
Code source de développement	Code actuel non encore publié	darold/pgbadger

La version de documentation disponible sur ce site est basée sur l’arbre source 13.2. Vérifiez toujours la page de publication avant de télécharger : la version locale est intentionnellement figée, tandis que les versions upstream évoluent continuellement.

Guide utilisateur (RHEL)

Mon, 01 Jan 0001 00:00:00 +0000

Introduction

Bien que les exemples de ce guide soient destinés à RHEL et à PostgreSQL 14, il devrait être relativement facile de les appliquer à toute distribution Unix et toute version de PostgreSQL. Les seules commandes spécifiques au système d’exploitation sont celles permettant de créer, démarrer, arrêter et supprimer des clusters PostgreSQL. Les commandes pgBackRest seront identiques sur tout système Unix, bien que l’emplacement de l’exécutable puisse varier. Bien que pgBackRest cherche à fonctionner de manière cohérente sur les différentes versions de PostgreSQL, certaines différences subtiles entre versions de PostgreSQL peuvent apparaître dans ce guide lors de l’illustration de certains exemples, par exemple les chemins ou noms de fichiers de PostgreSQL, ainsi que les paramètres.

Compilation et installation de PgBouncer

Mon, 01 Jan 0001 00:00:00 +0000

Construction

PgBouncer dépend de quelques éléments pour être compilé :

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+ pour la prise en charge du TLS
(facultatif) c-ares en tant qu’alternative à evdns de Libevent
(facultatif) bibliothèques LDAP
(facultatif) bibliothèques PAM

Lorsque les dépendances sont installées, exécutez simplement :

$ ./configure --prefix=/usr/local
$ make
$ make install

Si vous compilez à partir de Git, ou si vous compilez pour Windows, veuillez consulter les instructions de compilation spécifiques ci-dessous.

Démarrage rapide

Mon, 01 Jan 0001 00:00:00 +0000

Suivez ces instructions pour installer, exécuter et tester localement un cluster à membre unique de etcd :

Installez etcd à partir de binaires précompilés ou du code source. Pour plus de détails, consultez Installation .

Avertissement

Important : Veillez à effectuer la dernière étape des instructions d’installation afin de vérifier que etcd est dans votre chemin.
Démarrer etcd :
```
$ etcd
{"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... }
⋮
```
Note

Remarque : La sortie produite par etcd est logs — des journaux de niveau info peuvent être ignorés.

Exemple

Mon, 01 Jan 0001 00:00:00 +0000

Cette série d’exemples illustre les procédures de base pour travailler avec un cluster etcd.

Auth

auth,user,role pour l’authentification :

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Mettre en place un cluster local

Mon, 01 Jan 0001 00:00:00 +0000

Pour les déploiements de test et de développement, la méthode la plus rapide et la plus simple consiste à configurer un cluster local. Pour un déploiement en production, reportez-vous à la section clustering .

Cluster autonome local

Démarrage d’un cluster

Exécutez la commande suivante pour déployer un cluster etcd en tant que cluster autonome :

$ ./etcd
...

Si le binaire etcd n’est pas présent dans le répertoire de travail courant, il se peut qu’il se trouve soit à $GOPATH/bin/etcd, soit à /usr/local/bin/etcd. Exécutez la commande en conséquence.