[DOCS] 3008.x - Master Cluster Configuration Requires Interface Setting
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 15.7k
- Forks
- 5.6k
- Avg merge
- 2d 44m
- Merged PRs (30d)
- 80
Description
Description
If the master configuration on a cluster peer does not have the interface IP set, the default of 0.0.0.0 will be used. This will cause raft communication to not function between peers and errors like this will show up in /var/log/salt/master:
2026-07-19 08:21:19,024 [salt.cluster.consensus.peer:327 ][WARNING ][2460] RaftDispatcher: no pusher for 0.0.0.0, dropping cluster/raft/pre-request-vote-reply reply
This comment confirms the configuration requirement:
Suggested Fix
Add documentation indicating that interface must be set in the master configuration for peer communication to work in a master cluster.
Type of documentation
Salt documentation
Location or format of documentation
Master Cluster Documentation
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the Master Cluster Documentation and the referenced salt/cluster/consensus/service.py lines 79-83 to confirm how the interface setting affects peer communication. Update the master cluster documentation to state that interface must be set in the master configuration, and verify that the requirement and its purpose are clear.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 78/100