Add --target-host parameter to production commands

Adds a --target-host argument to all 8 foremanctl production commands
(deploy, features, health, migrate, backup, pull-images,
certificate-bundle, checks) for feature parity with forge deploy-dev.

The parameter is defined once in a shared _target_host metadata
fragment and included by each command. Playbooks fall back to
'quadlet' when --target-host is 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