Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add runner upload docs #1652

Closed
wants to merge 3 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion plugins/foreman_salt/13.0/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -377,7 +377,24 @@ When running `state.highstate`, you can have Foreman process the results and sho

![](/static/images/plugins/foreman_salt/reports.gif)

Uploading the salt reports is done by `/usr/sbin/upload-salt-reports` and is scheduled by a cron job running on the smart proxy. By default, reports are uploaded to Foreman once every 10 minutes from the Salt master's job cache. You may modify the smart_proxy_salt cron job to customize this by editing `/etc/cron.d/smart_proxy_salt`.
There are two ways to upload the highstate reports to foreman:

Either use the script `/usr/sbin/upload-salt-reports` scheduled by a cron job running on the smart proxy. By default, reports are uploaded to Foreman once every 10 minutes from the Salt master's job cache. You may modify the smart_proxy_salt cron job to customize this by editing `/etc/cron.d/smart_proxy_salt`.

The other way is to use the report upload reactor/runner.

An example configuration may look like this, but please note that configuration may differ in your environment (ie. if you are already using reactors or have runner_dirs defined).

`/etc/salt/master.d/upload-salt-reports.conf`:

```
runner_dirs:
- /usr/share/foreman-salt/runner

reactor:
- 'salt/job/*/ret/*':
- /usr/share/foreman-salt/reactor/foreman_report_upload.sls
```

<b>Why not use a returner?</b>

Expand Down