saltstack / salt

Software to automate the management and configuration of any infrastructure or application at scale. Install Salt from the Salt package repositories here:
https://docs.saltproject.io/salt/install-guide/en/latest/
Apache License 2.0
14.22k stars 5.49k forks source link

Message Busses Unclear; more docs needed #48059

Open AstraLuma opened 6 years ago

AstraLuma commented 6 years ago

As a Salt user getting into deeper module writing, I've found the various message busses to be very confusing.

When an event is published, it can go (as far as I know):

I have little idea about how these busses interact, or how they interact with more complex configurations (syndics? Round-robin masters?)

It was also entirely unclear when I got started on these deeper topics that these various busses even existed.

gtmanfred commented 6 years ago

No events get published to the publish bus.

The minion bus and the master bus are just event busses, for state.event or any fire_event stuff. They are used by the reactor, as well as interprocess communication, so that we can do stuff like refresh grains asyncronously.

The publish bus is where the master puts the jobs, it publishes jobs and this is where minions pick up jobs to run.

The syndic is just a means of copying from bus to bus. So the it redistributes published jobs to the publish bus of the master that it lives on. and then any return events that get sent to that master, or any events at all sent to that master, get republished to the event bus of the master of masters.

If you have masters in failover, the only event bus used it the one on the active master, but if you have active-active masters, it gets sent to both masters, or is allowed to pull jobs from both masters.

I am going to mark this as a documentation issue.

stale[bot] commented 5 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.

AstraLuma commented 5 years ago

afaik, this is still largely undocumented.

stale[bot] commented 5 years ago

Thank you for updating this issue. It is no longer marked as stale.

stale[bot] commented 4 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.

AstraLuma commented 4 years ago

afaik, this is still not well-documented.

stale[bot] commented 4 years ago

Thank you for updating this issue. It is no longer marked as stale.

stale[bot] commented 4 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.

AstraLuma commented 4 years ago

shoosh stalebot

stale[bot] commented 4 years ago

Thank you for updating this issue. It is no longer marked as stale.

stale[bot] commented 4 years ago

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

If this issue is closed prematurely, please leave a comment and we will gladly reopen the issue.

AstraLuma commented 4 years ago

still not explained, afaik

stale[bot] commented 4 years ago

Thank you for updating this issue. It is no longer marked as stale.

sagetherage commented 4 years ago

ok those labels should help it not get attacked by stale bot @saltstack/docs-working-group