From da4194b4f46a29197f7660dc1baa90614b97a57b Mon Sep 17 00:00:00 2001 From: Rafael Guterres Jeffman Date: Mon, 17 Mar 2025 15:39:07 -0300 Subject: [PATCH] collection: Allow playbooks to be executed using collection When available in a collection 'playbooks' directory, playbooks can be directly accessed as roles and modules: 'namespace.collection.playbook'. This allows, for example the deployment roles to be executed with the provided ansible-freeipa playbooks requiring minimal effort from the user part. In order to be accessible, though, the playbooks must not use dash ("-") on the file names, as they are replaced by underscorse ("_") during Ansible processing and then, the files are not found. By renaming the playbooks that, currently, do not set any variable as an usage example, replacing "-" by "_", we allow the FreeIPA collection playbooks to be executed without the user having to search for the correct file, like: $ ansible-playbook -i inventory freeipa.ansible_freeipa.install_server --- playbooks/{backup-server.yml => backup_server.yml} | 0 ...p-server-to-controller.yml => backup_server_to_controller.yml} | 0 ...l-backups-from-server.yml => copy_all_backups_from_server.yml} | 0 playbooks/{install-client.yml => install_client.yml} | 0 playbooks/{install-cluster.yml => install_cluster.yml} | 0 playbooks/{install-replica.yml => install_replica.yml} | 0 playbooks/{install-server.yml => install_server.yml} | 0 ...nstall-smartcard-clients.yml => install_smartcard_clients.yml} | 0 ...tall-smartcard-replicas.yml => install_smartcard_replicas.yml} | 0 ...{install-smartcard-server.yml => install_smartcard_server.yml} | 0 ...nstall-smartcard-servers.yml => install_smartcard_servers.yml} | 0 ...backups-from-server.yml => remove_all_backups_from_server.yml} | 0 playbooks/{uninstall-client.yml => uninstall_client.yml} | 0 playbooks/{uninstall-cluster.yml => uninstall_cluster.yml} | 0 playbooks/{uninstall-replica.yml => uninstall_replica.yml} | 0 playbooks/{uninstall-server.yml => uninstall_server.yml} | 0 16 files changed, 0 insertions(+), 0 deletions(-) rename playbooks/{backup-server.yml => backup_server.yml} (100%) rename playbooks/{backup-server-to-controller.yml => backup_server_to_controller.yml} (100%) rename playbooks/{copy-all-backups-from-server.yml => copy_all_backups_from_server.yml} (100%) rename playbooks/{install-client.yml => install_client.yml} (100%) rename playbooks/{install-cluster.yml => install_cluster.yml} (100%) rename playbooks/{install-replica.yml => install_replica.yml} (100%) rename playbooks/{install-server.yml => install_server.yml} (100%) rename playbooks/{install-smartcard-clients.yml => install_smartcard_clients.yml} (100%) rename playbooks/{install-smartcard-replicas.yml => install_smartcard_replicas.yml} (100%) rename playbooks/{install-smartcard-server.yml => install_smartcard_server.yml} (100%) rename playbooks/{install-smartcard-servers.yml => install_smartcard_servers.yml} (100%) rename playbooks/{remove-all-backups-from-server.yml => remove_all_backups_from_server.yml} (100%) rename playbooks/{uninstall-client.yml => uninstall_client.yml} (100%) rename playbooks/{uninstall-cluster.yml => uninstall_cluster.yml} (100%) rename playbooks/{uninstall-replica.yml => uninstall_replica.yml} (100%) rename playbooks/{uninstall-server.yml => uninstall_server.yml} (100%) diff --git a/playbooks/backup-server.yml b/playbooks/backup_server.yml similarity index 100% rename from playbooks/backup-server.yml rename to playbooks/backup_server.yml diff --git a/playbooks/backup-server-to-controller.yml b/playbooks/backup_server_to_controller.yml similarity index 100% rename from playbooks/backup-server-to-controller.yml rename to playbooks/backup_server_to_controller.yml diff --git a/playbooks/copy-all-backups-from-server.yml b/playbooks/copy_all_backups_from_server.yml similarity index 100% rename from playbooks/copy-all-backups-from-server.yml rename to playbooks/copy_all_backups_from_server.yml diff --git a/playbooks/install-client.yml b/playbooks/install_client.yml similarity index 100% rename from playbooks/install-client.yml rename to playbooks/install_client.yml diff --git a/playbooks/install-cluster.yml b/playbooks/install_cluster.yml similarity index 100% rename from playbooks/install-cluster.yml rename to playbooks/install_cluster.yml diff --git a/playbooks/install-replica.yml b/playbooks/install_replica.yml similarity index 100% rename from playbooks/install-replica.yml rename to playbooks/install_replica.yml diff --git a/playbooks/install-server.yml b/playbooks/install_server.yml similarity index 100% rename from playbooks/install-server.yml rename to playbooks/install_server.yml diff --git a/playbooks/install-smartcard-clients.yml b/playbooks/install_smartcard_clients.yml similarity index 100% rename from playbooks/install-smartcard-clients.yml rename to playbooks/install_smartcard_clients.yml diff --git a/playbooks/install-smartcard-replicas.yml b/playbooks/install_smartcard_replicas.yml similarity index 100% rename from playbooks/install-smartcard-replicas.yml rename to playbooks/install_smartcard_replicas.yml diff --git a/playbooks/install-smartcard-server.yml b/playbooks/install_smartcard_server.yml similarity index 100% rename from playbooks/install-smartcard-server.yml rename to playbooks/install_smartcard_server.yml diff --git a/playbooks/install-smartcard-servers.yml b/playbooks/install_smartcard_servers.yml similarity index 100% rename from playbooks/install-smartcard-servers.yml rename to playbooks/install_smartcard_servers.yml diff --git a/playbooks/remove-all-backups-from-server.yml b/playbooks/remove_all_backups_from_server.yml similarity index 100% rename from playbooks/remove-all-backups-from-server.yml rename to playbooks/remove_all_backups_from_server.yml diff --git a/playbooks/uninstall-client.yml b/playbooks/uninstall_client.yml similarity index 100% rename from playbooks/uninstall-client.yml rename to playbooks/uninstall_client.yml diff --git a/playbooks/uninstall-cluster.yml b/playbooks/uninstall_cluster.yml similarity index 100% rename from playbooks/uninstall-cluster.yml rename to playbooks/uninstall_cluster.yml diff --git a/playbooks/uninstall-replica.yml b/playbooks/uninstall_replica.yml similarity index 100% rename from playbooks/uninstall-replica.yml rename to playbooks/uninstall_replica.yml diff --git a/playbooks/uninstall-server.yml b/playbooks/uninstall_server.yml similarity index 100% rename from playbooks/uninstall-server.yml rename to playbooks/uninstall_server.yml