Commande de poussée d'archive (archive-push)
archive-push.Accepte un segment WAL de PostgreSQL et l’archive dans chaque dépôt défini par l’option indexée repo-path (voir la section Repository
pour obtenir des informations sur la configuration des dépôts). Le segment WAL peut être envoyé immédiatement à l’archive ou stocké localement, selon la valeur de archive-async. En cas de configuration de plusieurs dépôts, archive-push tentera d’envoyer à autant de dépôts que possible.
Le archive-push est destiné à être configuré et appelé par PostgreSQL. Voir Configurer la sauvegarde d’archive
pour un exemple.
Options de commande
Option d’archivage asynchrone (--archive-async)
Envoyer/récupérer les segments WAL de manière asynchrone.
Active l’exécution asynchrone pour les commandes archive-push et archive-get.
L’opération asynchrone est plus efficace car elle permet de réutiliser les connexions et de tirer parti de la parallélisation. Consultez les options spool-path, archive-get-queue-max et archive-push-queue-max pour plus d’informations.
Option de vérification de l’archive (--archive-check)
Vérifiez que les segments WAL sont présents dans l’archive avant la fin de la sauvegarde.
Vérifie que tous les segments WAL nécessaires pour rendre la sauvegarde cohérente sont présents dans l’archive WAL. Il est recommandé de laisser cette option par défaut, sauf si vous utilisez une autre méthode d’archivage.
Cette option doit être activée si archive-copy est activé.
Vérifier l’option Mode archive (--archive-mode-check)
Vérifiez le paramètre PostgreSQL archive_mode.
Activé par défaut, cette option interdit PostgreSQL archive_mode=always.
Les segments WAL poussés depuis un serveur de secours peuvent être logiquement identiques aux segments WAL poussés depuis le principal, mais présenter des sommes de contrôle différentes. Il est recommandé de désactiver l’archivage depuis plusieurs sources afin d’éviter les conflits.
AVERTISSEMENT :
Si cette option est désactivée, il est essentiel de s’assurer qu’un seul archivage écrit dans le dépôt via la commande archive-push.
Option taille lot de poussée d’archive (--archive-push-batch-size)
Quantité maximale de WAL à transférer par exécution asynchrone.
En mode asynchrone, le processus archive-push transmet tous les segments WAL prêts en une seule exécution. Comme archive-push-queue-max n’est vérifié qu’au début de chaque exécution, une exécution traitant un très grand nombre de segments peut faire croître la file d’attente bien au-delà de la limite avant qu’elle ne soit à nouveau vérifiée.
Cette option limite la quantité de WAL traitée par exécution, afin que le processus se termine et soit relancé par le prochain archive-push, qui vérifie à nouveau la file d’attente. Des valeurs plus faibles entraînent une vérification plus fréquente de la file d’attente, au prix d’un démarrage plus fréquent du processus asynchrone. La valeur est arrondie vers le bas à un nombre entier de segments WAL, mais au moins un segment est toujours traité.
Taille maximale de la file d’attente d’archivage en écriture (--archive-push-queue-max)
Taille maximale de la file d’attente d’archive PostgreSQL.
Une fois la limite atteinte, les actions suivantes se produiront :
- pgBackRest notifiera PostgreSQL que le WAL a été correctement archivé, puis LE SUPPRIMERA.
- Un avertissement sera affiché dans le journal de PostgreSQL.
Si cela se produit, le flux des journaux d’archive sera interrompu et la restauration à un point précis (PITR) ne sera plus possible au-delà de ce point. Une nouvelle sauvegarde sera nécessaire pour rétablir la capacité de restauration complète.
En mode asynchrone, toute la file d’attente sera supprimée afin d’éviter que des segments de WAL ne passent avant que la limite de file ne soit à nouveau dépassée.
En mode asynchrone, cette limite n’est vérifiée qu’au démarrage de chaque exécution de archive-push, de sorte que la file d’attente puisse dépasser cette limite au cours d’une même exécution. Réduisez archive-push-batch-size afin de vérifier la file d’attente plus fréquemment.
Ce mécanisme a pour but d’éviter que le volume de journalisation ne soit saturé, ce qui fermerait complètement PostgreSQL. Il est préférable de perdre une sauvegarde que de faire tomber PostgreSQL.
Nom obsolète : archive-queue-max
Option délai d’archivage (--archive-timeout)
Délai d’attente de l’archive.
Définir le délai maximal, en secondes, d’attente pour chaque segment WAL afin qu’il atteigne le dépôt d’archive pgBackRest. Ce délai s’applique aux commandes check et backup lors de l’attente des segments WAL nécessaires à la cohérence de la sauvegarde.
Options générales
Autoriser l’exécution en tant qu’utilisateur root (--allow-root)
Permettre à la commande de s’exécuter en tant qu’utilisateur root.
Par défaut, seul la commande restore peut être exécutée en tant qu’utilisateur root, car elle est conçue pour gérer soigneusement les propriétés des fichiers. Exécuter d’autres commandes en tant que root risque de créer des fichiers (par exemple dans le dépôt) dont le propriétaire est root, rendant ces fichiers inaccessibles à l’utilisateur PostgreSQL, ce qui entraîne l’échec des commandes ultérieures.
Activez cette option pour exécuter une commande en tant qu’utilisateur root malgré tout. Toutefois, il est bien préférable d’exécuter pgBackRest en tant qu’utilisateur propriétaire du dépôt et du cluster PostgreSQL.
Option Taille tampon (--buffer-size)
Taille du tampon pour les opérations d’E/S.
Taille de tampon utilisée pour les opérations de copie, de compression, de chiffrement et autres. Le nombre de tampons utilisés dépend des options, et chaque opération peut utiliser une mémoire supplémentaire, par exemple, la compression gz peut utiliser jusqu’à 256KiB de mémoire supplémentaire.
Les valeurs autorisées sont 16KiB, 32KiB, 64KiB, 128KiB, 256KiB, 512KiB, 1MiB, 2MiB, 4MiB, 8MiB et 16MiB.
Option de commande pgBackRest (--cmd)
Commande pgBackRest.
pgBackRest peut générer une chaîne de commande, par exemple lorsque la commande restore génère le paramètre restore_command. Dans ce cas, la commande utilisée pour exécuter le processus pgBackRest sera employée, sauf si l’option cmd est fournie.
AVERTISSEMENT :
Envelopper la commande pgBackRest peut entraîner un comportement imprévisible et n’est pas recommandé.
Option de commande client SSH (--cmd-ssh)
Commande cliente SSH.
Utilisez une commande cliente SSH spécifique lorsque vous souhaitez utiliser une alternative ou que la commande ssh n’est pas disponible dans $PATH.
Option de compression (--compress)
Utilisez la compression des fichiers.
Les fichiers de sauvegarde sont compatibles avec les outils de compression en ligne de commande.
Cette option est désormais obsolète. L’option compress-type doit être utilisée à la place.
Option niveau de compression (--compress-level)
Niveau de compression du fichier.
Définit le niveau à utiliser pour la compression des fichiers lorsque compress-type est différent de none ou compress=y (obsolète).
Option niveau de compression réseau (--compress-level-network)
Niveau de compression du réseau.
Définit le niveau de compression réseau lorsque compress-type=none et la commande ne sont pas exécutées sur le même hôte que le dépôt. La compression est utilisée pour réduire le trafic réseau. Lorsque compress-type est différent de none, le paramètre compress-level-network est ignoré et compress-level est utilisé à la place, afin que le fichier ne soit compressé qu’une seule fois.
Option de type de compression (--compress-type)
Type de compression des fichiers.
Les types de compression suivants sont pris en charge :
none- pas de compressionbz2- format de compression bzip2gz- format de compression gziplz4- format de compression lz4 (non disponible sur toutes les plates-formes)zst- format de compression Zstandard (non disponible sur toutes les plates-formes)
Option de configuration (--config)
Fichier de configuration pgBackRest.
Utilisez cette option pour spécifier un fichier de configuration différent du fichier par défaut.
Option Chemin d’inclusion de configuration (--config-include-path)
Chemin vers les fichiers de configuration supplémentaires de pgBackRest.
Les fichiers de configuration se trouvant dans l’emplacement spécifié et ayant l’extension .conf seront concaténés au fichier de configuration de pgBackRest, ce qui donne un seul fichier de configuration.
Option de chemin de configuration (--config-path)
Chemin de base des fichiers de configuration de pgBackRest.
Ce paramètre est utilisé pour remplacer le chemin de base par défaut pour les options --config et --config-include-path, sauf si ces dernières sont explicitement définies en ligne de commande.
Par exemple, passer uniquement --config-path=/conf/pgbackrest fait que la valeur par défaut de --config est définie à /conf/pgbackrest/pgbackrest.conf et que la valeur par défaut de --config-include-path est définie à /conf/pgbackrest/conf.d.
Option d’expiration I/O (--io-timeout)
Délai d’attente d’E/S dépassé.
Délai d’attente, en secondes, utilisé pour les connexions et les opérations de lecture/écriture.
Notez que l’opération de lecture/écriture entière n’a pas besoin de se terminer dans ce délai d’attente, mais une certaine progression doit être réalisée, même si elle ne concerne qu’un seul octet.
Option Chemin verrou (--lock-path)
Chemin où les fichiers verrou sont stockés.
Le chemin de verrouillage fournit un emplacement où pgBackRest peut créer des fichiers de verrouillage afin d’empêcher l’exécution simultanée d’opérations en conflit.
Option de masque neutre (--neutral-umask)
Utilisez un umask neutre.
Définit le umask à 0000 afin que les modes du dépôt soient créés de manière cohérente. Le mode par défaut du répertoire est 0750 et le mode par défaut du fichier est 0640.
Pour utiliser le umask de l’utilisateur en cours, spécifiez neutral-umask=n dans le fichier de configuration ou --no-neutral-umask en ligne de commande.
Définir l’option de priorité du processus (--priority)
Définir la priorité du processus.
Définit la priorité (c’est-à-dire la valeur de niceness) accordée au processus par l’ordonnanceur du noyau. Les valeurs positives réduisent la priorité, tandis que les valeurs négatives l’augmentent. Dans la plupart des cas, les processus ne disposent pas des autorisations nécessaires pour augmenter leur priorité.
Option de processus maximum (--process-max)
Nombre maximal de processus à utiliser pour la compression ou le transfert.
Chaque processus effectuera une compression et un transfert afin d’accélérer l’exécution de la commande, mais ne définissez pas process-max trop élevé afin de ne pas affecter les performances de la base de données.
Option délai d’attente du protocole (--protocol-timeout)
Délai d’attente du protocole.
Définit le délai d’attente, en secondes, durant lequel le processus local ou distant attend qu’un nouveau message soit reçu au niveau du protocole. Cela empêche les processus de rester bloqués indéfiniment en attente d’un message.
NOTE : L’option
protocol-timeoutdoit être supérieure à l’optiondb-timeout.
Option Keep Alive (--sck-keep-alive)
Activation du keep-alive.
Active les messages keep-alive sur les connexions socket.
Option Chemin de répertoire d’attente (--spool-path)
Chemin où les données transitoires sont stockées.
Ce chemin est utilisé pour stocker les données de la commande asynchrone archive-push et archive-get.
La commande asynchrone archive-push écrit des accusés de réception dans le répertoire de spool après avoir correctement stocké le WAL dans l’archive, ou une erreur en cas d’échec, afin que le processus au premier plan puisse informer rapidement PostgreSQL. Ces fichiers sont très petits : vides en cas de succès et de quelques centaines d’octets en cas d’erreur.
La commande asynchrone archive-get met en file d’attente les fichiers WAL dans le répertoire de stockage provisoire afin de pouvoir les fournir très rapidement lorsque PostgreSQL les demande. Le déplacement des fichiers vers PostgreSQL est le plus efficace lorsque le répertoire de stockage provisoire se trouve sur le même système de fichiers que pg_xlog/pg_wal. Toutefois, il n’est pas recommandé de placer le répertoire de stockage provisoire à l’intérieur du répertoire pg_xlog/pg_wal, car cela pourrait entraîner des problèmes pour les utilitaires PostgreSQL tels que pg_rewind.
Les données stockées dans le chemin d’attente ne sont pas strictement temporaires, car elles peuvent et doivent survivre à un redémarrage. Toutefois, leur perte n’est pas problématique. pgBackRest vérifiera simplement chaque segment WAL afin de s’assurer qu’il est correctement archivé pour archive-push et reconstruira la file d’attente pour archive-get.
Le chemin d’attente doit être situé sur un système de fichiers local compatible Posix, et non sur un système de fichiers distant tel que NFS ou CIFS.
Option stanza (--stanza)
Définit la stanza.
Une stanza est la configuration d’un cluster de base de données PostgreSQL qui définit son emplacement, la manière dont il sera sauvegardé, les options d’archivage, etc. La plupart des serveurs de base de données n’ont qu’un seul cluster PostgreSQL et donc une seule stanza, tandis que les serveurs de sauvegarde ont une stanza pour chaque cluster de base de données à sauvegarder.
Il est tentant de nommer la stanza en fonction du cluster principal, mais un nom plus pertinent décrit les bases de données contenues dans le cluster. Étant donné que le nom de la stanza sera utilisé pour le principal et toutes les répliques, il est préférable de choisir un nom qui décrit la fonction réelle du cluster, par exemple app ou dw, plutôt que le nom local du cluster, comme main ou prod.
Option de nombre de connexions Keep Alive (--tcp-keep-alive-count)
Nombre de maintien de connexion.
Spécifie le nombre de messages TCP keep-alive pouvant être perdus avant que la connexion ne soit considérée comme inactive.
Cette option est disponible sur les systèmes qui prennent en charge l’option de socket TCP_KEEPCNT.
Option d’idle Keep Alive (--tcp-keep-alive-idle)
Délai d’inactivité pour la maintien de la connexion.
Spécifie la durée (en secondes) pendant laquelle aucune activité réseau ne se produit, après laquelle le système d’exploitation doit envoyer un message de maintien de connexion TCP.
Cette option est disponible sur les systèmes qui prennent en charge l’option de socket TCP_KEEPIDLE.
Option Intervalle Keep Alive (--tcp-keep-alive-interval)
Intervalle de temps pour la maintien de la connexion active.
Spécifie la durée (en secondes) après laquelle un message TCP keep-alive non reconnu doit être renvoyé.
Cette option est disponible sur les systèmes qui prennent en charge l’option de socket TCP_KEEPINTVL.
Suites de chiffrement TLSv1.2 Option (--tls-cipher-12)
Suites de chiffrement TLSv1.2 autorisées.
Toutes les connexions TLS entre le client pgBackRest et le serveur sont chiffrées. Par défaut, les connexions aux magasins d’objets (par exemple S3) sont également chiffrées.
NOTE : Le niveau de sécurité minimal absolu pour toute connexion de transport est TLSv1.2.
Les suites de chiffrement acceptées peuvent être ajustées si nécessaire. L’exemple proposé constitue un choix raisonnable sauf si des exigences de sécurité spécifiques s’appliquent. Si non définies (valeur par défaut), la valeur par défaut de la bibliothèque OpenSSL sous-jacente s’applique.
Suites de chiffrement TLSv1.3 Option (--tls-cipher-13)
Suites de chiffrement TLSv1.3 autorisées.
Toutes les connexions TLS entre le client pgBackRest et le serveur sont chiffrées. Par défaut, les connexions aux magasins d’objets (par exemple S3) sont également chiffrées.
NOTE : Le niveau de sécurité minimal absolu pour toute connexion de transport est TLSv1.2.
Les suites de chiffrement acceptées peuvent être ajustées si nécessaire. Si non définies (valeur par défaut), la valeur par défaut de la bibliothèque OpenSSL sous-jacente s’applique.
Options de journalisation
Niveau de journalisation de la console (--log-level-console)
Niveau de journalisation pour la console.
Les niveaux de journalisation suivants sont pris en charge :
off- Aucune journalisation (non recommandé)error- Journaliser uniquement les erreurswarn- Journaliser les avertissements et les erreursinfo- Journaliser les informations, les avertissements et les erreursdetail- Journaliser les détails, les informations, les avertissements et les erreursdebug- Journaliser le débogage, les détails, les informations, les avertissements et les erreurstrace- Journaliser les traces (débogage très détaillé), le débogage, les informations, les avertissements et les erreurs
Niveau de journalisation du fichier (--log-level-file)
Niveau de journalisation des fichiers.
Les niveaux de journalisation suivants sont pris en charge :
off- Aucune journalisation (non recommandé)error- Journaliser uniquement les erreurswarn- Journaliser les avertissements et les erreursinfo- Journaliser les informations, les avertissements et les erreursdetail- Journaliser les détails, les informations, les avertissements et les erreursdebug- Journaliser le débogage, les détails, les informations, les avertissements et les erreurstrace- Journaliser les traces (débogage très détaillé), le débogage, les informations, les avertissements et les erreurs
Niveau de journalisation des erreurs standard (--log-level-stderr)
Niveau de journalisation pour stderr.
Spécifie les niveaux de journalisation qui seront envoyés vers stderr plutôt que vers stdout (spécifié par log-level-console). L’horodatage et le processus ne seront pas envoyés vers stderr.
Les niveaux de journalisation suivants sont pris en charge :
off- Aucune journalisation (non recommandé)error- Journaliser uniquement les erreurswarn- Journaliser les avertissements et les erreursinfo- Journaliser les informations, les avertissements et les erreursdetail- Journaliser les détails, les informations, les avertissements et les erreursdebug- Journaliser le débogage, les détails, les informations, les avertissements et les erreurstrace- Journaliser les traces (débogage très détaillé), le débogage, les informations, les avertissements et les erreurs
Option Chemin Journal (--log-path)
Chemin où les fichiers de journalisation sont stockés.
Le chemin de journalisation fournit un emplacement où pgBackRest peut stocker les fichiers de journalisation. Notez que si log-level-file=off, aucun chemin de journalisation n’est requis.
Option de journalisation des sous-processus (--log-subprocess)
Activer la journalisation dans les sous-processus.
Activez la journalisation des fichiers pour tout sous-processus créé par ce processus, en utilisant le niveau de journalisation spécifié par log-level-file.
Option de timestamp de journal (--log-timestamp)
Activer les horodatages dans la journalisation.
Active l’horodatage dans la journalisation console et fichier. Cette option est désactivée dans des situations spéciales, telles que la génération de documentation.
Options du mainteneur
Option de vérification des en-têtes WAL (--archive-header-check)
Vérifier la version/id de PostgreSQL dans les en-têtes WAL.
Activé par défaut, cette option vérifie l’en-tête WAL contre la version de PostgreSQL et l’identifiant système afin de s’assurer que le WAL est copié dans la bonne stanza. Cela s’ajoute à la vérification de pg_control par rapport à la stanza et à la vérification que le WAL est copié à partir du même répertoire de données PostgreSQL où se trouve pg_control.
Par conséquent, désactiver cette vérification est relativement sûr, mais ne doit être effectué que lorsqu’il est nécessaire, par exemple si le WAL est chiffré.
Option de version PostgreSQL obligatoire (--pg-version-force)
Forcer la version de PostgreSQL.
La version de PostgreSQL spécifiée sera utilisée à la place de la version détectée automatiquement en lisant pg_control ou les en-têtes WAL. Cela est principalement utile pour les forks de PostgreSQL ou les versions de développement où ces valeurs diffèrent de la version de publication. La version rapportée par PostgreSQL via server_version_num doit correspondre à la version forcée.
AVERTISSEMENT :
Faites preuve de prudence en utilisant cette option, car pg_control et les en-têtes WAL seront toujours lus selon le format attendu pour la version spécifiée, c’est-à-dire le format issu de la version open-source officielle de PostgreSQL. Si la version fork ou développée modifie le format des champs sur lesquels pgBackRest dépend, cela entraînera un comportement imprévu. En général, cette option ne fonctionnera correctement que si le fork ajoute tous les membres de structure personnalisés après les membres standard de PostgreSQL.
Options du dépôt
Option de conteneur de dépôt Azure (--repo-azure-container)
Conteneur de dépôt Azure.
Conteneur Azure utilisé pour stocker le dépôt.
Les dépôts pgBackRest peuvent être stockés dans la racine du conteneur en définissant repo-path=/, mais il est généralement préférable de préciser un préfixe, tel que /repo, afin de pouvoir également stocker les journaux et d’autres contenus générés par Azure dans le conteneur.
Type de clé du dépôt Azure (--repo-azure-key-type)
Type de clé du dépôt Azure.
Les types suivants sont pris en charge pour l’autorisation :
shared- Clé partagéesas- Signature d’accès partagéauto- Autorisation automatique à l’aide d’identités managées Azure
Option de style d’URI de dépôt Azure (--repo-azure-uri-style)
Style URI Azure.
Les styles d’URI suivants sont pris en charge :
host- Se connecter à l’hôteaccount.endpoint.path- Se connecter à l’hôteendpointet préfixer le compte aux URI.
Type de chiffrement du dépôt (--repo-cipher-type)
Chiffrement utilisé pour chiffrer le dépôt.
Les types de chiffrement suivants sont pris en charge :
none- Le dépôt n’est pas chiffréaes-256-cbc- Advanced Encryption Standard avec une longueur de clé de 256 bits
Notez que le chiffrement est toujours effectué côté client, même si le type de dépôt (par exemple S3) prend en charge le chiffrement.
Option de bac de dépôt GCS (--repo-gcs-bucket)
Dépôt de bucket GCS.
Dépôt GCS utilisé pour stocker le dépôt.
Les dépôts pgBackRest peuvent être stockés à la racine du bucket en définissant repo-path=/, mais il est généralement préférable de préciser un préfixe, tel que /repo, afin de pouvoir également stocker les journaux et d’autres contenus générés par GCS dans le bucket.
Option de point de terminaison du dépôt GCS (--repo-gcs-endpoint)
Point de terminaison du dépôt GCS.
Point d’accès utilisé pour se connecter au service de stockage. Peut être mis à jour pour utiliser un serveur local GCS ou un point d’accès alternatif.
Type de clé du dépôt GCS (--repo-gcs-key-type)
Type de clé du dépôt GCS.
Les types suivants sont pris en charge pour l’autorisation :
auto- Autoriser à l’aide du compte de service de l’instance.service- Compte de service à partir d’une clé stockée localement.token- À utiliser pour les tests locaux, par exemplefakegcs.
Lorsque repo-gcs-key-type=service, les identifiants seront rechargés lorsque le jeton d’authentification sera renouvelé.
Option ID du projet du dépôt GCS (--repo-gcs-user-project)
Identifiant du projet GCS.
ID du projet GCS utilisé pour déterminer la facturation des requêtes.
Option hôte du dépôt (--repo-host)
Hôte du dépôt lors de l’opération à distance.
Lors de la sauvegarde et de l’archivage vers un système de fichiers monté localement, ce paramètre n’est pas requis.
Nom obsolète : backup-host
Option du fichier de l’autorité de certification hôte du dépôt (--repo-host-ca-file)
Fichier de l’autorité de certification du serveur de dépôt.
Utilisez un fichier CA autre que celui par défaut du système pour vous connecter à l’hôte du dépôt.
Option Chemin de l’autorité de certification du dépôt (--repo-host-ca-path)
Chemin de l’autorité de certification du serveur de dépôt.
Utilisez un chemin de certificat d’autorité (CA) autre que celui par défaut du système pour établir la connexion avec l’hôte du dépôt.
Option de fichier de certificat d’hôte du dépôt (--repo-host-cert-file)
Fichier de certificat d’hôte du dépôt.
Envoyé à l’hôte du dépôt pour prouver l’identité du client.
Option de commande hôte du dépôt (--repo-host-cmd)
Hôte du dépôt commande pgBackRest.
Requis uniquement si le chemin vers la commande pgBackRest est différent sur les hôtes local et de dépôt. Si non défini, la commande de dépôt sera définie de la même manière que celle de l’hôte local.
Nom obsolète : backup-cmd
Option de configuration de l’hôte du dépôt (--repo-host-config)
Fichier de configuration du serveur de dépôt pgBackRest.
Spécifie l’emplacement du fichier de configuration sur l’hôte du dépôt. Cette option est nécessaire uniquement si le fichier de configuration de l’hôte du dépôt se trouve dans un emplacement différent du fichier de configuration local.
Nom obsolète : sauvegarde-config
Option de chemin d’inclusion de configuration d’hôte de dépôt (--repo-host-config-include-path)
Configuration du serveur de dépôt pgBackRest incluant le chemin.
Définit l’emplacement du chemin d’inclusion de configuration sur l’hôte du dépôt. Cette option est nécessaire uniquement si le chemin d’inclusion de configuration de l’hôte du dépôt est différent du chemin d’inclusion de configuration local.
Chemin de configuration de l’hôte du dépôt (--repo-host-config-path)
Chemin de configuration du serveur de dépôt pgBackRest.
Définit l’emplacement du chemin de configuration sur l’hôte du dépôt. Cette option est nécessaire uniquement si le chemin de configuration de l’hôte du dépôt est différent du chemin de configuration local.
Option de fichier de clé hôte du dépôt (--repo-host-key-file)
Fichier de clé hôte du dépôt.
Vérifie que le certificat client a été envoyé par le propriétaire.
Option de port hôte du dépôt (--repo-host-port)
Port de l’hôte du dépôt lorsque repo-host est défini.
Utilisez cette option pour spécifier un port non par défaut pour le protocole du serveur du dépôt.
NOTE : Lorsque
repo-host-type=ssh, il n’existe pas de valeur par défaut pourrepo-host-port. Dans ce cas, le port sera celui configuré pour la commande spécifiée parcmd-ssh.
Nom obsolète : backup-ssh-port
Type de protocole d’hôte de dépôt (--repo-host-type)
Type de protocole d’hôte de dépôt.
Les types de protocole suivants sont pris en charge :
ssh- Shell sécurisé.tls- Serveur TLS pgBackRest.
Option d’utilisateur hôte de dépôt (--repo-host-user)
Utilisateur hôte du dépôt lorsque repo-host est défini.
Définit l’utilisateur utilisé pour les opérations sur l’hôte du dépôt. Il est préférable que ce ne soit pas l’utilisateur postgres, mais plutôt un autre utilisateur tel que pgbackrest. Si PostgreSQL s’exécute sur l’hôte du dépôt, l’utilisateur postgres peut être ajouté au groupe pgbackrest afin d’avoir des permissions de lecture sur le dépôt sans pouvoir accidentellement le modifier.
Nom obsolète : backup-user
Option Chemin du dépôt (--repo-path)
Chemin où les sauvegardes et l’archive sont stockées.
Le dépôt est l’emplacement où pgBackRest stocke les sauvegardes et les archives des segments WAL.
Il peut être difficile de prévoir à l’avance l’espace nécessaire. La meilleure approche consiste à effectuer quelques sauvegardes, puis à noter la taille des différents types de sauvegardes (pleines, incrémentielles, différentielles) et à mesurer la quantité de WAL générée par jour. Cela vous donnera une idée générale de l’espace requis, bien que les besoins évoluent probablement au fil du temps avec l’évolution de votre base de données.
Option de bac de dépôt S3 (--repo-s3-bucket)
Dépôt S3.
Dépôt S3 utilisé pour stocker le dépôt.
Les dépôts pgBackRest peuvent être stockés à la racine du bucket en définissant repo-path=/, mais il est généralement préférable de préciser un préfixe, tel que /repo, afin de pouvoir également stocker les journaux et d’autres contenus générés par AWS dans le bucket.
Option de point de terminaison du dépôt S3 (--repo-s3-endpoint)
Point de terminaison du dépôt S3.
Le point de terminaison AWS doit être valide pour la région sélectionnée.
Pour les configurations personnalisées ou les tests, les options repo-storage-ca-file, repo-storage-ca-path, repo-storage-host, repo-storage-port, et repo-storage-verify-tls peuvent être utiles.
Type de clé du dépôt S3 (--repo-s3-key-type)
Type de clé pour le dépôt S3.
Les types suivants sont pris en charge :
shared- Clés partagéesauto- Récupérer automatiquement les identifiants temporairesweb-id- Récupérer automatiquement les identifiants d’identité webpod-id- Récupérer automatiquement les identifiants d’identité de pod EKSprocess- Récupérer les identifiants en exécutant un processus
Option ID de clé KMS pour dépôt S3 (--repo-s3-kms-key-id)
Clé KMS du dépôt S3.
Active le chiffrement côté serveur S3 en utilisant la clé du service de gestion des clés AWS spécifiée.
Option de commande du processus d’authentification S3 (--repo-s3-process-cmd)
Commande du processus d’authentification S3.
Commande (et arguments facultatifs) à exécuter pour récupérer les identifiants temporaires S3. Le premier élément de la liste est la commande, les éléments suivants sont passés en tant que paramètres.
Le processus doit produire un JSON contenant les champs AccessKeyId, SecretAccessKey, SessionToken et Expiration. Les identifiants seront automatiquement actualisés avant l’expiration. Voir Process Credential Provider
pour les détails du format.
Option de région du dépôt S3 (--repo-s3-region)
Région du dépôt S3.
La région AWS où le bucket a été créé.
Option Requesteur Payant pour le dépôt S3 (--repo-s3-requester-pays)
Dépôt S3 payeur de la demande.
Active le paiement par le demandeur S3.
Option de rôle du dépôt S3 (--repo-s3-role)
Rôle du dépôt S3.
Le nom du rôle AWS (pas le nom ARN complet) utilisé pour récupérer les identifiants temporaires lorsque repo-s3-key-type=auto.
Option de service de dépôt S3 (--repo-s3-service)
Service de signature S3.
Le service de signature S3 utilisé dans l’authentification SigV4. La valeur par défaut est s3 pour les points d’accès S3 standards. À définir sur s3-outposts lors de l’utilisation d’un point d’accès S3 Outposts.
Option de point de terminaison STS du dépôt S3 (--repo-s3-sts-host)
Point de terminaison STS du dépôt S3.
Point de terminaison STS utilisé pour récupérer des identifiants temporaires lorsque repo-s3-key-type=web-id est configuré. Définissez-le sur un point de terminaison régional (par exemple sts.us-east-1.amazonaws.com) pour utiliser STS régional, ce qui peut être nécessaire pour les régions GovCloud, Chine, ou pour réduire la latence.
Option de style d’URI de dépôt S3 (--repo-s3-uri-style)
Style d’URI S3.
Les styles d’URI suivants sont pris en charge :
host- Se connecter à l’hôtebucket.endpoint.path- Se connecter à l’hôteendpointet préfixer les URI par le répertoire.
Option hôte du dépôt SFTP (--repo-sftp-host)
Hôte du dépôt SFTP.
Hôte SFTP contenant le dépôt.
Fingerprint de l’hôte du dépôt SFTP (--repo-sftp-host-fingerprint)
Empreinte du serveur hôte du dépôt SFTP.
La génération de l’empreinte d’hôte du dépôt SFTP doit correspondre à repo-sftp-host-key-hash-type. Générez l’empreinte via awk '{print $2}' ssh_host_xxx_key.pub | base64 -d | (md5sum or sha1sum) -b. Les clés d’hôte SSH se trouvent normalement dans le répertoire /etc/ssh.
Type d’option de vérification de la clé hôte SFTP (--repo-sftp-host-key-check-type)
Type de vérification de la clé hôte SFTP.
Les types de vérification de clé d’hôte SFTP suivants sont pris en charge :
strict- pgBackRest n’ajoutera jamais automatiquement les clés d’hôte au fichier ~/.ssh/known_hosts, et refusera de se connecter aux hôtes dont la clé d’hôte a changé ou n’est pas trouvée dans les fichiers known hosts. Cette option oblige l’utilisateur à ajouter manuellement tous les nouveaux hôtes.accept-new- pgBackRest ajoutera automatiquement les nouvelles clés d’hôte au fichier known hosts de l’utilisateur, mais n’autorisera pas les connexions aux hôtes dont la clé d’hôte a changé.fingerprint- pgBackRest vérifiera la clé d’hôte contre l’empreinte spécifiée par l’optionrepo-sftp-host-fingerprint.none- aucune vérification de clé d’hôte ne sera effectuée.
Type de hachage de la clé hôte du dépôt SFTP (--repo-sftp-host-key-hash-type)
Type de hachage de la clé d’hôte du dépôt SFTP.
Type de hachage de la clé hôte du dépôt SFTP. Déclare le type de hachage à utiliser pour calculer le hachage de la clé hôte du système distant au démarrage SSH. Les versions plus récentes de libssh2 prennent en charge sha256 en plus de md5 et sha1.
Option de port hôte du dépôt SFTP (--repo-sftp-host-port)
Port hôte du dépôt SFTP.
Port hôte du dépôt SFTP.
Option utilisateur hôte dépôt SFTP (--repo-sftp-host-user)
Utilisateur hôte du dépôt SFTP.
Utilisateur sur l’hôte utilisé pour stocker le dépôt.
Option fichier Hôtes SFTP connus (--repo-sftp-known-host)
Fichier d’hôtes SFTP connus.
Fichier known hosts à consulter pour rechercher une correspondance avec un hôte SFTP lors de l’authentification. Si non spécifié, pgBackRest recherchera par défaut dans ~/.ssh/known_hosts, ~/.ssh/known_hosts2, /etc/ssh/ssh_known_hosts et /etc/ssh/ssh_known_hosts2. Si configuré avec un ou plusieurs chemins de fichier, pgBackRest recherchera dans ces fichiers une correspondance. Les chemins de fichier doivent être complets ou commencer par un tilde. L’option repo-sftp-known-host peut être spécifiée plusieurs fois pour indiquer plusieurs fichiers known hosts à consulter. Pour utiliser la vérification du fichier known hosts, l’option repo-sftp-host-fingerprint ne doit pas être définie. Voir également l’option repo-sftp-host-check-type.
Option fichier de clé privée du dépôt SFTP (--repo-sftp-private-key-file)
Fichier de clé privée SFTP.
Fichier de clé privée SFTP utilisé pour l’authentification.
Option de fichier de clé publique du dépôt SFTP (--repo-sftp-public-key-file)
Fichier de clé publique SFTP.
Fichier de clé publique SFTP utilisé pour l’authentification. Facultatif si compilé contre OpenSSL, obligatoire si compilé contre une autre bibliothèque.
Option du fichier CA du dépôt de stockage (--repo-storage-ca-file)
Fichier de certificat d’autorité de certification pour le dépôt.
Utilisez un fichier CA autre que celui par défaut du système pour les certificats du stockage (par exemple, S3, Azure).
Noms obsolètes : repo-azure-ca-file, repo-s3-ca-file
Option de chemin du certificat CA TLS pour le dépôt (--repo-storage-ca-path)
Chemin du certificat d’autorité de certification du dépôt.
Utilisez un chemin de certificat d’autorité de certification (CA) autre que celui par défaut du système pour les certificats du stockage (par exemple, S3, Azure).
Noms obsolètes : repo-azure-ca-path, repo-s3-ca-path
Option hôte de stockage du dépôt (--repo-storage-host)
Hôte de stockage du dépôt.
Se connecter à un hôte autre que le point de terminaison de stockage (par exemple S3, Azure). Cela est généralement utilisé pour les tests.
Noms obsolètes : repo-azure-host, repo-s3-host
Option de port du stockage du dépôt (--repo-storage-port)
Port du stockage du dépôt.
Port à utiliser lors de la connexion au point de terminaison du stockage (par exemple S3, Azure) ou à l’hôte (le cas échéant).
Noms obsolètes : repo-azure-port, repo-s3-port
Option d’étiquette de stockage du dépôt (--repo-storage-tag)
Étiquette(s) de stockage du dépôt.
Spécifiez les balises à ajouter aux objets lorsque le dépôt est un magasin d’objets (par exemple, S3). L’option peut être répétée pour ajouter plusieurs balises.
Il n’existe aucune fonctionnalité dans pgBackRest permettant de modifier ces balises ; veillez donc à les définir correctement avant d’exécuter stanza-create afin d’assurer une cohérence des balises dans l’ensemble du dépôt.
Option de taille de morceau de chargement du dépôt (--repo-storage-upload-chunk-size)
Taille du morceau de chargement du dépôt.
Les magasins d’objets tels que S3 permettent de télécharger des fichiers par morceaux lorsque le fichier est trop volumineux pour être stocké en mémoire. Même si le fichier peut être stocké en mémoire, il est plus efficace en mémoire de limiter la quantité de mémoire utilisée pour les téléchargements.
Une taille de morceau plus élevée entraîne généralement de meilleures performances, car elle réduit le nombre de requêtes de téléchargement et permet de télécharger plus de fichiers en une seule requête plutôt qu’en morceaux. Le désavantage est que la consommation mémoire sera plus élevée, et comme la mémoire tampon de morceau doit être allouée par processus, des valeurs plus élevées de process-max entraînent une consommation mémoire globale plus importante.
Notez que les tailles de morceau valides varient selon le type de stockage et la plateforme. Par exemple, AWS S3 impose une taille minimale de morceau de 5MiB. La terminologie relative à la taille du morceau varie selon le type de stockage ; utilisez donc « part size » pour AWS S3, « chunk size » pour GCS et « block size » pour Azure lorsque vous recherchez les valeurs minimales ou maximales.
Si un fichier est plus grand que 1GiB (la taille maximale que PostgreSQL crée par défaut), la taille de tranche sera augmentée progressivement jusqu’à la valeur maximale autorisée afin de terminer le téléchargement du fichier.
Option de vérification du certificat de stockage du dépôt (--repo-storage-verify-tls)
Vérification du certificat du dépôt de stockage.
Cette option permet d’activer/désactiver la vérification du certificat TLS du serveur de stockage (par exemple, S3, Azure). La désactivation ne doit être utilisée que pour des tests ou d’autres scénarios où un certificat a été auto-signé.
Noms obsolètes : repo-azure-verify-tls, repo-s3-verify-ssl, repo-s3-verify-tls
Option de type de dépôt (--repo-type)
Type de stockage utilisé pour le dépôt.
Les types de dépôt suivants sont pris en charge :
azure- Service de stockage Blob Azurecifs- Commeposix, mais désactive les liens et les fsyncs de répertoiregcs- Google Cloud Storageposix- Systèmes de fichiers conformes à Posixs3- AWS Simple Storage Servicesftp- Protocole de transfert de fichiers sécurisé
Lorsqu’un montage NFS est utilisé comme dépôt posix, les mêmes règles s’appliquent à pgBackRest qu’indiquées dans la documentation PostgreSQL : Création d’un cluster de base de données - Systèmes de fichiers
.
Options de stanza
Option Chemin PostgreSQL (--pg-path)
Répertoire de données PostgreSQL.
Il doit être identique à la valeur data_directory rapportée par PostgreSQL. Même si cette valeur peut être lue à divers endroits, il est prudent de la définir afin de garantir sa disponibilité en cas de restauration ou de sauvegarde hors ligne.
L’option pg-path est vérifiée par rapport à la valeur rapportée par PostgreSQL à chaque sauvegarde en ligne, elle doit donc toujours être à jour.
Nom obsolète : db-path