README
¶
mgmt: next generation config management!
Community:
Come join us in the mgmt community!
| Medium | Link |
|---|---|
| IRC | #mgmtconfig on Freenode |
| @mgmtconfig & #mgmtconfig | |
| Mailing list | mgmtconfig-list@redhat.com |
| Patreon | purpleidea on Patreon |
| Liberapay | purpleidea on Liberapay |
Status:
Mgmt is a next generation automation tool. It has similarities to other tools in the configuration management space, but has a fast, modern, distributed systems approach. The project contains an engine and a language. Please have a look at an introductory video or blog post.
Mgmt is a fairly new project. It is usable today, but not yet feature complete. With your help you'll be able to influence our design and get us to 1.0 sooner! Interested developers should read the quick start guide.
Documentation:
Please read, enjoy and help improve our documentation!
| Documentation | Additional Notes |
|---|---|
| quick start guide | for mgmt developers |
| frequently asked questions | for everyone |
| general documentation | for everyone |
| language guide | for everyone |
| function guide | for mgmt developers |
| resource guide | for mgmt developers |
| style guide | for mgmt developers |
| godoc API reference | for mgmt developers |
| prometheus guide | for everyone |
| puppet guide | for puppet sysadmins |
| development | for mgmt developers |
Questions:
Please ask in the community! If you have a well phrased question that might benefit others, consider asking it by sending a patch to the FAQ section. I'll merge your question, and a patch with the answer!
Roadmap:
Feel free to grab one of the straightforward #mgmtlove issues if you're a first time contributor to the project or if you're unsure about what to hack on! Please see: TODO.md for a list of upcoming work and TODO items. Please get involved by working on one of these items or by suggesting something else!
Bugs:
Please set the DEBUG constant in main.go
to true, and post the logs when you report the issue.
Bonus points if you provide a shell
or OMV reproducible
test case.
Feel free to read my article on debugging golang programs.
Patches:
We'd love to have your patches! Please send them by email, or as a pull request.
On the web:
Read what people are saying and publishing about mgmt!
Happy hacking!
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package converger is a facility for reporting the converged state.
|
Package converger is a facility for reporting the converged state. |
|
event
Package event provides some primitives that are used for message passing.
|
Package event provides some primitives that are used for message passing. |
|
resources/packagekit
Package packagekit provides an interface to interact with packagekit.
|
Package packagekit provides an interface to interact with packagekit. |
|
Package etcd implements the distributed key value store integration.
|
Package etcd implements the distributed key value store integration. |
|
event
Package event provides some primitives that are used for message passing.
|
Package event provides some primitives that are used for message passing. |
|
fs
Package fs implements a very simple and limited file system on top of etcd.
|
Package fs implements a very simple and limited file system on top of etcd. |
|
scheduler
Package scheduler implements a distributed consensus scheduler with etcd.
|
Package scheduler implements a distributed consensus scheduler with etcd. |
|
examples
|
|
|
lib
libmgmt example of send->recv libmgmt example of flattened subgraph libmgmt example of graph resource libmgmt example libmgmt example of send->recv
|
libmgmt example of send->recv libmgmt example of flattened subgraph libmgmt example of graph resource libmgmt example libmgmt example of send->recv |
|
longpoll
This is an example longpoll client.
|
This is an example longpoll client. |
|
Package gapi defines the interface that graph API generators must meet.
|
Package gapi defines the interface that graph API generators must meet. |
|
funcs
Package funcs provides a framework for functions that change over time.
|
Package funcs provides a framework for functions that change over time. |
|
funcs/facts
Package facts provides a framework for language values that change over time.
|
Package facts provides a framework for language values that change over time. |
|
types
Package types provides a framework for our language values and types.
|
Package types provides a framework for our language values and types. |
|
Package pgraph represents the internal "pointer graph" that we use.
|
Package pgraph represents the internal "pointer graph" that we use. |
|
Package prometheus provides functions that are useful to control and manage the built-in prometheus instance.
|
Package prometheus provides functions that are useful to control and manage the built-in prometheus instance. |
|
Package puppet provides the integration entrypoint for the puppet language.
|
Package puppet provides the integration entrypoint for the puppet language. |
|
Package recwatch provides recursive file watching events via fsnotify.
|
Package recwatch provides recursive file watching events via fsnotify. |
|
test
|
|
|
Package util contains a collection of miscellaneous utility functions.
|
Package util contains a collection of miscellaneous utility functions. |
|
semaphore
Package semaphore contains an implementation of a counting semaphore.
|
Package semaphore contains an implementation of a counting semaphore. |
|
Package yamlgraph provides the facilities for loading a graph from a yaml file.
|
Package yamlgraph provides the facilities for loading a graph from a yaml file. |