From d576f5d727793133c7d4f80610788ed25b62491b Mon Sep 17 00:00:00 2001 From: James Nesbitt Date: Wed, 5 Aug 2026 17:41:32 +0300 Subject: [PATCH] docs: fix ansible-playbook invocation to load ansible.cfg The documented step 4 command ran ansible-playbook from the checkout root with a path to the playbook inside ansible/. Ansible only auto-loads ansible.cfg from the current working directory (or $ANSIBLE_CONFIG / home dir), never from the playbook's own directory, so ansible/ansible.cfg (host_key_checking = false, etc.) was silently skipped. Against a fresh host with no known_hosts entry and no TTY to prompt interactively, this produced a hard, non-interactive failure (ssh_askpass / Host key verification failed) on the very first task. Reproduced deterministically on 3 fresh EC2 managers. Change the documented command to cd into ansible/ first so ansible.cfg loads as intended, and call out that the inventory path must now be absolute or relative to ansible/. Written by AI: claude-sonnet-5 --- docs/installation-guide/install-bootc-mke3.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/installation-guide/install-bootc-mke3.md b/docs/installation-guide/install-bootc-mke3.md index 7650d14..c8fe207 100644 --- a/docs/installation-guide/install-bootc-mke3.md +++ b/docs/installation-guide/install-bootc-mke3.md @@ -16,7 +16,7 @@ By default, admin user credentials for MKE UI are `admin/password`. If you want 1. Ensure expected ansible inventory exists. See [inventory description document](ansible-inventory-input.md) for more details. 2. To override any default values, specify the desired values in the `vars/common-vars.yml` and `vars/mke-creds.yml` files 3. Optionally: You can set the MCR and MKE licenses via the `mcr_license` and `mke_license` variables respectively. -4. Run ansible: `ansible-playbook -i ansible/mke-install-playbook.yml` +4. Run ansible from the `ansible/` directory: `cd ansible && ansible-playbook -i mke-install-playbook.yml`. Ansible only auto-loads `ansible.cfg` (which sets `host_key_checking = false`, among other defaults) from the current working directory, so running the playbook from the checkout root instead silently skips it and the first SSH connection to a fresh host fails with a non-interactive host key verification error. Use an absolute path for `` (or one relative to `ansible/`) since the working directory has changed. ## Expected Results