Add --target-host parameter for multi-host management

First step toward multi-host management, allowing users to specify
which host to run against instead of the hardcoded 'quadlet' default.
Full multi-host workflows will additionally require per-host state
isolation (foremanctl#630).

Adds --target-host to all 8 production commands via a shared
_target_host metadata fragment. Playbooks fall back to 'quadlet'
when not specified. The value is persisted between runs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: jeremylenz

docs/user/parameters.md

@@ -7,6 +7,12 @@ This document covers installation parameters as presented to users, and includes
 * Using a single parameter when there are multiple variables that should have the same value
 * Aim for minimal configuration values for the user
 
+## Global Parameters
+
+| Parameter | Description | Applies to |
+| ----------| ----------- | ---------- |
+| `--target-host` | Target hostname or IP address for deployment. Defaults to `quadlet`. This value is persisted between runs. For remote hosts, the specified host must be present in the Ansible inventory. | All commands except `deploy-proxy` |
+
 ## Mapping
 
 Parameters are split into either mapped or unmapped groupings per category.

src/playbooks/_target_host/metadata.obsah.yaml

@@ -0,0 +1,5 @@
+---
+variables:
+  target_host:
+    help: Target hostname or IP address for deployment
+    action: store

src/playbooks/backup/backup.yaml

@@ -1,6 +1,6 @@
 ---
 - name: Backup databases and configuration
-  hosts: quadlet
+  hosts: "{{ target_host | default('quadlet') }}"
   become: true
   gather_facts: true
   vars_files:

src/playbooks/backup/metadata.obsah.yaml

@@ -18,3 +18,6 @@ variables:
     help: Wait for running tasks to complete instead of failing immediately
     action: store_true
     persist: false
+
+include:
+  - _target_host

src/playbooks/certificate-bundle/certificate-bundle.yaml

@@ -1,7 +1,6 @@
 ---
 - name: Generate a certificate bundle for a hostname
-  hosts:
-    - quadlet
+  hosts: "{{ target_host | default('quadlet') }}"
   become: true
   vars_files:
     - "../../vars/base.yaml"

src/playbooks/certificate-bundle/metadata.obsah.yaml

@@ -31,4 +31,5 @@ constraints:
     - ['certificates_source', 'default', ['certificates_custom_server_certificate', 'certificates_custom_server_key']]
 
 include:
+  - _target_host
   - _certificate_source

src/playbooks/checks/checks.yaml

@@ -1,6 +1,6 @@
 ---
 - name: Run preflight checks
-  hosts: quadlet
+  hosts: "{{ target_host | default('quadlet') }}"
   gather_facts: true
   vars_files:
     - "../../vars/defaults.yml"

src/playbooks/checks/metadata.obsah.yaml

@@ -3,6 +3,7 @@ help: |
   Run preflight checks before installing Foreman
 
 include:
+  - _target_host
   - _database_mode
   - _database_connection
   - _tuning

src/playbooks/deploy/deploy.yaml

@@ -1,7 +1,6 @@
 ---
 - name: Setup machine
-  hosts:
-    - quadlet
+  hosts: "{{ target_host | default('quadlet') }}"
   become: true
   vars_files:
     - "../../vars/defaults.yml"

src/playbooks/deploy/metadata.obsah.yaml

@@ -16,5 +16,6 @@ variables:
     help: Name of the PAM service to use for IPA authentication
 
 include:
+  - _target_host
   - _flavor_features
   - _flavors/katello