6d45cd45d1
This adds new helper methods to the API such as the ability to query the set timeout, and to set the state change function after initialization. The first makes it easier to pass in the timeout value to functions and structs, because you don't need to pass it separately from the converger object. The second makes it easy to specify the state change functon when you don't know what it is at creation time. In addition, it is more powerful now, and tells you when we converge or un-converge in case we want to take different actions on each.
mgmt: This is: mgmt!
Community:
Come join us on IRC in #mgmtconfig on Freenode! You may like the #mgmtconfig hashtag if you're on Twitter.
Questions:
Please join the #mgmtconfig IRC community! If you have a well phrased question that might benefit others, consider asking it by sending a patch to the documentation FAQ section. I'll merge your question, and a patch with the answer!
Quick start:
- Clone the repository recursively, eg:
git clone --recursive https://github.com/purpleidea/mgmt/. - Get the remaining golang dependencies on your own, or run
make depsif you're comfortable with how we install them. - Run
make buildto get a freshly builtmgmtbinary. - Run
time ./mgmt run --file examples/graph0.yaml --converged-timeout=1to try out a very simple example! - To run continuously in the default mode of operation, omit the
--converged-timeoutoption. - Have fun hacking on our future technology!
Examples:
Please look in the examples/ folder for more examples!
Documentation:
Please see: DOCUMENTATION.md or PDF.
Roadmap:
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! 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!
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.
Dependencies:
-
golang 1.4 or higher (required, available in most distros)
-
golang libraries (required, available with
go get)go get github.com/coreos/etcd/client go get gopkg.in/yaml.v2 go get gopkg.in/fsnotify.v1 go get github.com/codegangsta/cli go get github.com/coreos/go-systemd/dbus go get github.com/coreos/go-systemd/util go get github.com/coreos/pkg/capnslog -
stringer (required for building), available as a package on some platforms, otherwise via
go getgo get golang.org/x/tools/cmd/stringer -
pandoc (optional, for building a pdf of the documentation)
-
graphviz (optional, for building a visual representation of the graph)
Patches:
We'd love to have your patches! Please send them by email, or as a pull request.
On the web:
- James Shubin; blog: Next generation configuration mgmt
- James Shubin; video: Introductory recording from DevConf.cz 2016
- James Shubin; video: Introductory recording from CfgMgmtCamp.eu 2016
- Julian Dunn; video: On mgmt at CfgMgmtCamp.eu 2016
- Walter Heck; slides: On mgmt at CfgMgmtCamp.eu 2016
- Marco Marongiu; blog: On mgmt
- Felix Frank; blog: From Catalog To Mgmt (on puppet to mgmt "transpiling")
- James Shubin; blog: Automatic edges in mgmt (...and the pkg resource)
- James Shubin; blog: Automatic grouping in mgmt
- John Arundel; tweet: “Puppet’s days are numbered.”
- Felix Frank; blog: Puppet, Meet Mgmt (on puppet to mgmt internals)
- Felix Frank; blog: Puppet Powered Mgmt (puppet to mgmt tl;dr)
- James Shubin; blog: Automatic clustering in mgmt
- James Shubin; video: Recording from CoreOSFest 2016
- James Shubin; video: Recording from DebConf16 (Slides)
Happy hacking!