From 29241f55e46374254f32e45fd8c1252dc57a017d Mon Sep 17 00:00:00 2001 From: Manuel Sopena Ballesteros Date: Sun, 16 Jun 2024 21:38:14 +0200 Subject: [PATCH] update docs --- docs/qa.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/qa.md b/docs/qa.md index a9b9244..a48aa58 100644 --- a/docs/qa.md +++ b/docs/qa.md @@ -36,6 +36,32 @@ Select the site which auth token needs to be deleted (eg prealps_auth) Manta will ask the user to authenticate upon the next operation against `prealps`, if authentication is successful, then the user should receive a new token with the new list of cluster he has access to this site/system +Q: My sessions are failing due to an erro while running ansible playbook. How can Iinteractively run my ansible outside the management plane? + +A: You can start an `ephemeral session`, ephemeral sessions tries to replicate the host targeting the ansible playbook started by the session. To start an ephemeral environment run the following command + +``` +manta apply ephemeral-environment --image-id 4bf91021-8d99-4adf-945f-46de2ff50a3d +1eff1535-c13c-4d21-ba3f-0c852abd713b.ims.cmn.alps.cscs.ch +``` + +> Note: the `` should be the same base image used by the session + +The command will return a hostname (`1eff1535-c13c-4d21-ba3f-0c852abd713b.ims.cmn.alps.cscs.ch`) based on the image id provided, after this, wait a few minutes for the environment to be ready and then create an ansible inventory with this hostname. With this, you should be able to run your ansible scripts locally if you need to troubleshoot your playbook. + +To test the ephemeral environment + +```bash +ssh root@1eff1535-c13c-4d21-ba3f-0c852abd713b.ims.cmn.alps.cscs.ch +The authenticity of host '1eff1535-c13c-4d21-ba3f-0c852abd713b.ims.cmn.alps.cscs.ch (148.187.109.148)' can't be established. +ED25519 key fingerprint is SHA256:/np4nEZWYztGbG/6cDI6vTsLU/9uWEXZQ9Msd/DJGNY. +This key is not known by any other names +Are you sure you want to continue connecting (yes/no/[fingerprint])? yes +Warning: Permanently added '1eff1535-c13c-4d21-ba3f-0c852abd713b.ims.cmn.alps.cscs.ch' (ED25519) to the list of known hosts. +Have a lot of fun... +cray-ims-1eff1535-c13c-4d21-ba3f-0c852abd713b-customize-xxl7f:/root # +``` + Q: I have clusters in different sites/systems/locations. How can I `manta` to be aware of this? ??? info "**WIP**"