Rôle Ansible : Outil en ligne de commande Flyway (lrk.flyway)

Un rôle Ansible qui installe l'outil en ligne de commande Flyway.

Systèmes d'exploitation pris en charge

Ce rôle a été testé sur les systèmes d'exploitation suivants :

• EL - 7
• Ubuntu - Bionic / Xenial
• Debian - Buster / Stretch / Jessie

Exigences

Ce rôle n'a pas d'exigences, mais Flyway nécessite JAVA pour fonctionner.

Variables du rôle

Les variables disponibles avec leurs valeurs par défaut sont listées ci-dessous (voir defaults/main.yml)

---

  # Version de Flyway
  flyway_version: 6.0.1

  # Édition de Flyway
  # si la version est antérieure à 5.2.0, cette valeur est ignorée
  flyway_edition: community

  # Chemin d'installation racine de Flyway
  flyway_install_root: /opt/flyway

  # Lien du dépôt à partir duquel Flyway est téléchargé (facultatif)
  # Par défaut : https://repo1.maven.org/maven2
  flyway_repo_url: None

  # Nom d'utilisateur du dépôt pour l'authentification
  # Par défaut : None
  flyway_repo_username: None

  # Mot de passe du dépôt pour l'authentification
  # Par défaut : None
  flyway_repo_password: None

  # Devons-nous supprimer les pilotes par défaut ?
  flyway_remove_default_drivers: false

  # Configurer les pilotes supplémentaires à télécharger via maven
  # Par défaut : vide
  flyway_additional_mvn_drivers: []

  # Configuration de Flyway
  # voir https://flywaydb.org/documentation/configfiles

  # URL JDBC pour se connecter à la base de données
  flyway_url: null

  # Nom de classe entièrement qualifié du pilote JDBC (détecté automatiquement par défaut)
  flyway_driver: null

  # Utilisateur pour se connecter à la base de données. Flyway vous demandera de le entrer si non spécifié.
  flyway_user: null

  # Mot de passe pour se connecter à la base de données. Flyway vous demandera de le entrer si non spécifié.
  flyway_password: null

  # Nombre maximum de tentatives lors de la connexion à la base de données.
  flyway_connect_retries: 0

  # Requêtes SQL à exécuter pour initialiser une nouvelle connexion à la base de données.
  flyway_init_sql: null

  # Liste des schémas gérés par Flyway. Ces noms de schémas sont sensibles à la casse.
  flyway_schemas: []

  # Nom de la table d'historique du schéma de Flyway
  flyway_table: 'flyway_schema_history'

  # Tablespace où créer la table d'historique du schéma utilisée par Flyway.
  flyway_tablespace: null

  # Liste des emplacements à scanner de manière récursive pour les migrations.
  flyway_locations: []

  # Liste des classes de résolveurs de migration personnalisés.
  flyway_resolvers: []

  # S'il est défini sur true, les résolveurs par défaut sont ignorés.
  flyway_skip_default_resolvers: false

  # Liste des répertoires contenant des pilotes JDBC et des migrations basées sur Java.
  flyway_jar_dirs: []

  # Préfixe de nom de fichier pour les migrations SQL versionnées.
  flyway_sql_migration_prefix: "V"

  # Préfixe de nom de fichier pour les migrations SQL annulables.
  flyway_undo_sql_migration_prefix: "U"

  # Préfixe de nom de fichier pour les migrations SQL répétables.
  flyway_repeatable_sql_migration_prefix: "R"

  # Séparateur de nom de fichier pour les migrations SQL.
  flyway_sql_migration_separator: "__"

  # Liste des suffixes de nom de fichier pour les migrations SQL.
  flyway_sql_migration_suffixes: []

  # Encodage des migrations SQL
  flyway_encoding: "UTF-8"

  # Que les espaces réservés doivent-ils être remplacés.
  flyway_placeholder_replacement: true

  # Préfixe de chaque espace réservé
  flyway_placeholder_prefix: "${"

  # Suffixe de chaque espace réservé
  flyway_placeholder_suffix: "}"

  # Version cible jusqu'à laquelle Flyway doit considérer les migrations.
  flyway_target: null

  # Que Flyway doit-il automatiquement valider ou non lors de l'exécution de la migration.
  flyway_validate_on_migrate: true

  # Que Flyway doit-il automatiquement appeler clean ou non lors d'une erreur de validation.
  flyway_clean_on_validation_error: false

  # Que nettoyer soit désactivé.
  flyway_clean_disabled: false

  # La version pour taguer un schéma existant lors de l'exécution de la baseline.
  flyway_baseline_version: 1

  # La description pour taguer un schéma existant lors de l'exécution de la baseline.
  flyway_baseline_description: "Flyway Baseline"

  # Permettre aux migrations d'être exécutées "hors service".
  flyway_out_of_order: false

  # Si Flyway doit afficher une table avec les résultats des requêtes lors de l'exécution des migrations.
  flyway_output_query_results: true

  # Liste des classes personnalisées et logique à lier aux notifications du cycle de vie de Flyway.
  flyway_callbacks: []

  # Ignore les migrations manquantes lors de la lecture de la table d'historique du schéma.
  flyway_ignore_missing_migrations: false

  # Ignore les migrations en attente lors de la lecture de la table d'historique du schéma.
  flyway_ignore_pending_migrations: false

  # Ignore les futures migrations lors de la lecture de la table d'historique du schéma.
  flyway_ignore_future_migrations: true

Dépendances

Aucune

Exemple de Playbook

    - hosts: servers
      roles:
         - lrk.flyway

Licence

Licence Apache Version 2.0

Références

• Flyway

Informations sur l'auteur

Ce rôle a été créé par Lrk.