Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Manuel Sopena Ballesteros committed Jun 16, 2024
1 parent 3abdb6e commit 29241f5
Showing 1 changed file with 26 additions and 0 deletions.
26 changes: 26 additions & 0 deletions docs/qa.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 `<image id>` 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**"
Expand Down

0 comments on commit 29241f5

Please sign in to comment.