Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Comment utiliser les scripts
Voici un exemple simple d'exécution du script :
python3 influx_migration.py --src-host <source host> --src-bucket <source bucket> --dest-host <destination host>
Qui fait migrer un seul bucket.
Toutes les options peuvent être consultées en exécutant :
python3 influx_migration.py -h
Utilisation
shell influx_migration.py [-h] [--src-bucket SRC_BUCKET] [--dest-bucket DEST_BUCKET] [--src-host SRC_HOST] --dest-host DEST_HOST [--full] [--confirm-full] [--src-org SRC_ORG] [--dest-org DEST_ORG] [--csv] [--retry-restore-dir RETRY_RESTORE_DIR] [--dir-name DIR_NAME] [--log-level LOG_LEVEL] [--skip-verify] [--s3-bucket S3_BUCKET]
Options
-confirm-full (facultatif) : l'utilisation de
--full
without--csv
remplacera tous les jetons, utilisateurs, compartiments, tableaux de bord et toute autre donnée clé-valeur de la base de données de destination par les jetons, utilisateurs, compartiments, tableaux de bord et toute autre donnée clé-valeur de la base de données source.--full
avec migre--csv
uniquement toutes les métadonnées du bucket et du bucket, y compris les organisations du bucket. Cette option (--confirm-full
) confirmera une migration complète et se poursuivra sans intervention de l'utilisateur. Si cette option n'est pas fournie,--full
qu'elle a été fournie et--csv
non fournie, le script s'interrompt pour s'exécuter et attend la confirmation de l'utilisateur. Il s'agit d'une action critique, procédez avec prudence. La valeur par défaut est false.-csv (facultatif) : s'il faut utiliser des fichiers csv pour la sauvegarde et la restauration. S'il
--full
est également adopté, tous les compartiments définis par l'utilisateur de toutes les organisations seront migrés, et non les compartiments système, les utilisateurs, les jetons ou les tableaux de bord. Si une organisation unique est souhaitée pour tous les compartiments du serveur de destination au lieu de leurs organisations source existantes, utilisez.--dest-org
-dest-bucket DEST _ BUCKET (facultatif) : le nom du bucket InfluxDB sur le serveur de destination ne doit pas être un bucket déjà existant. La valeur par défaut est la valeur de
--src-bucket
ouNone
si elle--src-bucket
n'est pas fournie.-dest-host DEST _ HOST : L'hôte du serveur de destination. Exemple : http://localhost:8086.
-dest-org DEST _ ORG (facultatif) : nom de l'organisation vers laquelle restaurer les buckets sur le serveur de destination. Si cette option est omise, tous les buckets migrés depuis le serveur source conserveront leur organisation d'origine et les buckets migrés risquent de ne pas être visibles sur le serveur de destination sans création ou changement d'organisation. Cette valeur sera utilisée dans toutes les formes de restauration, qu'il s'agisse d'un bucket unique, d'une migration complète ou de toute migration utilisant des fichiers CSV pour la sauvegarde et la restauration.
-dir-name DIR _ NAME (facultatif) : nom du répertoire de sauvegarde à créer. La valeur par défaut est
influxdb-backup-<timestamp>
. Il ne doit pas déjà exister.-full (facultatif) : s'il faut effectuer une restauration complète, en remplaçant toutes les données du serveur de destination par toutes les données du serveur source de toutes les organisations, y compris toutes les données clé-valeur telles que les jetons, les tableaux de bord, les utilisateurs, etc. Dérogations
--src-bucket
et.--dest-bucket
S'il est utilisé avec--csv
, migre uniquement les données et les métadonnées des buckets. La valeur par défaut est false.h, --help : affiche le message d'aide et sort.
-log-level LOG _ LEVEL (facultatif) : niveau de journalisation à utiliser lors de l'exécution. Les options sont debug, error et info. La valeur par défaut est info.
- retry-restore-dir RETRY _ RESTORE _ DIR (facultatif) : répertoire à utiliser pour la restauration en cas d'échec d'une restauration précédente, ignorera la sauvegarde et la création de répertoire, échouera si le répertoire n'existe pas, peut être un répertoire dans un compartiment S3. Si une restauration échoue, le chemin du répertoire de sauvegarde qui peut être utilisé pour la restauration sera indiqué par rapport au répertoire en cours. Les compartiments S3 seront sous la forme
influxdb-backups/<s3 bucket>/<backup directory>
. Le nom du répertoire de sauvegarde par défaut estinfluxdb-backup-<timestamp>
.-s3-bucket S3_ BUCKET (facultatif) : nom du compartiment S3 à utiliser pour stocker les fichiers de sauvegarde. Sous Linux, il s'agit simplement du nom du compartiment S3, par exemple
my-bucket
, donnéAWS_ACCESS_KEY_ID
et les variables d'AWS_SECRET_ACCESS_KEY
environnement ont été définies ou${HOME}/.aws/credentials
existent. Sous Windows, il s'agit de la télécommande et du nom du bucketrclone
configurés, par exemplemy-remote:my-bucket
. Tous les fichiers de sauvegarde seront conservés dans le compartiment S3 après la migration dans uninfluxdb-backups-<timestamp>
répertoire créé. Un répertoire de montage temporaire nomméinflux-backups
sera créé dans le répertoire à partir duquel ce script est exécuté. S'ils ne sont pas fournis, tous les fichiers de sauvegarde seront stockés localement dans uninfluxdb-backups-<timestamp>
répertoire créé à partir duquel ce script est exécuté.-skip-verify (facultatif) : ignore TLS la vérification du certificat.
-src-bucket SRC _ BUCKET (facultatif) : nom du bucket InfluxDB sur le serveur source. Si ce n'est pas le cas, il
--full
doit être fourni.-src-host SRC _ HOST (facultatif) : hôte du serveur source. La valeur par défaut est http://localhost:8086.
Comme indiqué précédemment, mountpoint-s3
rclone
elles sont nécessaires si --s3-bucket
elles doivent être utilisées, mais peuvent être ignorées si l'utilisateur ne fournit pas de valeur pour--s3-bucket
, auquel cas les fichiers de sauvegarde seront stockés localement dans un répertoire unique.