RemotesRun/README.md

39 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2022-01-08 13:07:34 +00:00
# RemotesRun
---
*Run several scripts on remote servers automatically.*
This script allows you to execute common sequencially scripts on various servers. It can be use to quickly run maintainance scripts on several servers while having proper feedback when things go wrong.
2022-01-08 13:38:55 +00:00
## Dependencies:
This script has several dependencies:
- bash
- awk
- sshpass
- docker on remote server if it does not have it.
2022-01-08 13:07:34 +00:00
## How to use
### Creating scripts
First of all, you will need create the scripts that will be executed on the remote servers.
1. Head to the `remotes` directory
2. Create a new directory named using the `user`@`host` pattern for the remote host and the user on it you want to execute the script on. (e.g: `root@example.org`) if it does not exist.
2023-03-22 12:24:58 +00:00
3. Create a file `port` with the SSH port number.
4. Create a new script (the file name will be used as script name when it's executed at runtime).
5. (optional) You can import common libraries by adding a comment on line two following this pattern : `# Requires: libraries/<path/to/library>.sh`. You can import several libraries by separating them by a space. You can see the various default included libraries in the `libraries` directory.
2022-01-08 13:07:34 +00:00
**Note**: The libraries/common.sh library will always be imported into the server so you don't need to reference it there.
You can see an example in `remotes/root@example.org/Update.sh`.
### Run all scripts
To run all of thoses scripts, it's fairly simple: just execute the `run_all.sh` script.
It will prompt you for the various passwords of the various hosts, or the passphrases if you have ssh keys setup, and then execute the scripts sequencially.
**Note**: If you enter skip in the password field, the current host will be skipped.
If you want to use another directory for your remotes scripts, you can set the `REMOTES` environement variable before launching the `run_all.sh` script like this:
```bash
REMOTES=/path/to/remotes ./run_all.sh
```