Skip to content

Allow webhooks in containerized deployments - #5094

Open
adamruzicka wants to merge 2 commits into
theforeman:masterfrom
adamruzicka:webhooks
Open

Allow webhooks in containerized deployments#5094
adamruzicka wants to merge 2 commits into
theforeman:masterfrom
adamruzicka:webhooks

Conversation

@adamruzicka

Copy link
Copy Markdown
Contributor

https://redhat.atlassian.net/browse/SAT-47668

What changes are you introducing?

Once theforeman/foremanctl#694 goes in, webhooks (without shellhooks) will be available in containerized deployments. This change enables the relevant parts of documentation.

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

See above.

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

See the TODOs in the changes.

Contributor checklists

  • I am okay with my commits getting squashed when you merge this PR.
  • I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

  • Foreman 3.19/Katello 4.21
  • Foreman 3.18/Katello 4.20 (Satellite 6.19; orcharhino 7.9)
  • Foreman 3.17/Katello 4.19
  • Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6, 7.7, and 7.8)
  • Foreman 3.15/Katello 4.17
  • Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)
  • We do not accept PRs for Foreman older than 3.14.

@github-actions github-actions Bot added Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels Jul 22, 2026
@github-actions

github-actions Bot commented Jul 22, 2026

Copy link
Copy Markdown

@adamruzicka
adamruzicka force-pushed the webhooks branch 2 times, most recently from a7618cd to fb12e1e Compare July 22, 2026 18:33
When creating a webhook in the {ProjectWebUI}, you can customize events, payloads, HTTP authentication, content type, and headers.

TODO: Fact check - is this relevant in containers?
ifndef::foreman-deb,orcharhino[]

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

On a side note, why is this hidden for orcharhino? Doesn't orcharhino still run on selinux-enabled el*?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hid this in the past because in orcharhino downstream, we use a different installation guide -> I could not get the link to work. Thanks for the hint, I will look into this eventually. For now, it could stay as is.

[role="_abstract"]
When creating a webhook in the {ProjectWebUI}, you can customize events, payloads, HTTP authentication, content type, and headers.

TODO: Fact check - is this relevant in containers?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Checking on my instance, this doesn't seem to be needed.

A list of available types is provided in the following table.
Some events are marked as *custom*, in that case, the payload is an object object but a Ruby hash (key-value data structure) so syntax is different.

TODO: What to do with this, considering some plugins providing events are not containerized yet? Be diligent or just wait it out?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Opinions?

Comment thread guides/common/modules/ref_webhooks-available-events.adoc Outdated
@@ -10,6 +10,13 @@ Then, you can configure {ProjectServer} to send webhook requests.
.Procedure
. On your {ProjectServer}, install the webhooks plugin:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For containerized builds, this would result in a list with a single ordered item. -> Should be unordered for containerized and ordered for all others.

When creating a webhook in the {ProjectWebUI}, you can customize events, payloads, HTTP authentication, content type, and headers.

TODO: Fact check - is this relevant in containers?
ifndef::foreman-deb,orcharhino[]

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I hid this in the past because in orcharhino downstream, we use a different installation guide -> I could not get the link to work. Thanks for the hint, I will look into this eventually. For now, it could stay as is.

|Actions Remote Execution Run Host Job Katello Group Update Succeeded |Update package group using the Katello interface.|Actions::RemoteExecution::RunHostJob
|Actions Remote Execution Run Host Job Katello Package Update Succeeded |Update package using the Katello interface.|Actions::RemoteExecution::RunHostJob
endif::[]
ifndef::containerized[]

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note: openscap and ansible are not in yet

ifdef::katello,orcharhino,satellite[]
|Actions Remote Execution Run Host Job Katello Module Stream Action Succeeded |Perform a module stream action using the Katello interface.|Actions::RemoteExecution::RunHostJob
endif::[]
ifndef::containerized[]

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note: leapp is not in yet

@adamruzicka
adamruzicka marked this pull request as ready for review July 30, 2026 13:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs style review Requires a review from docs style/grammar perspective Needs tech review Requires a review from the technical perspective Needs testing Requires functional testing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants