Foreman Remote Execution
A plugin bringing remote execution to the Foreman, completing the config management functionality with remote management functionality.
- Visualize remote execution job process live
- Schedule or run jobs on hosts
- Create templates to customize your jobs
Installation and usage
Check the Foreman manual remote execution section
|Foreman Version||Plugin Version|
|>= 3.1||~> 5.0.0|
|>= 3.2||>= 6.0.0|
There is an option to use an alternative
ScriptRunner implementation. Instead of doing ssh connections it discards any input its given and gives back fake output.
It is controlled by setting the following environment variables
REX_SIMULATE - setting to 1, yes or true enables the use of the fake runner
REX_SIMULATE_PATH - full path to a file which should be given back as output by the runner, currently one line per runner's refresh
REX_SIMULATE_FAIL_CHANCE - number from 0 to 100, each host has a
REX_SIMULATE_FAIL_CHANCE of exiting with
REX_SIMULATE_EXIT, useful for simulating random failures
REX_SIMULATE_EXIT - see the previous
Because it doesn't really open the outgoing connections, it doesn't need hosts with valid IP addresses as targets.
Fork and send a Pull Request. Thanks!
To run Rubocop use the rake task in foreman dir:
bundle exec rake foreman_remote_execution:rubocop
Auto correct can be executed directly too:
bundle exec rubocop ~/work/foreman_remote_execution -a
Pull Translations from Transifex
As part of the release process, localization must be synced from Transifex. See the wiki for more information.
Sync Job Templates from Community Templates
The community-templates repo is the source for our job templates. Prior to release, use the script/sync_templates.sh script to pull in any changes.
Copyright (c) 2015 The Foreman developers
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.