Skip to content

Commit

Permalink
docs: Add old release notes
Browse files Browse the repository at this point in the history
These release notes used to live on the mailing list at:
https://listman.redhat.com/archives/mgmtconfig-list/ until Red Hat
killed off this excellent service recently.

I'm adding them all here for reference.

Before 0.0.9 there were no release notes.
  • Loading branch information
purpleidea committed Mar 26, 2024
1 parent 89784e8 commit 46b2fe0
Show file tree
Hide file tree
Showing 16 changed files with 1,707 additions and 0 deletions.
51 changes: 51 additions & 0 deletions docs/release-notes/0.0.10
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
I've just released version 0.0.10 of mgmt!

NEWS

57 files changed, 1991 insertions(+), 752 deletions(-)

* There's a new resource called `KV`. Short examples exist, but I
haven't yet published a whole integration showing the usefulness.

* A major race was fixed. The issue of what to do with BackPokes during
start/pause was never previously solved. I had this as an open issue on
my whiteboard for a while, and I finally got some time to work through
it. The answer wasn't that difficult, but I think it was shrouded in
some tunnel vision. See the commit messages and source comments for the
details.

* The GAPI grew four new associated World API methods: StrWatch,
StrGet, StrSet, StrDel, and the associated etcd backed implementations.
These are quite useful when combined with the KV resource.

* There are now P/V style counting semaphores available as metaparams.
This is particularly cool because the implementation is (AFAIK,
assuming no bugs) dead-lock free! This is mentioned in my recent blog
post.

* See the git log for more NEWS, and sorry for anything notable I left
out!

BUGS

* There's a `concurrent map write` bug in the semaphore implementation
which is fixed in git master. Since it was a race, it was only caught
after this release was made. I should also figure out if the sema check
should go after the BackPoke or not.

MISC

We're still looking for new contributors, and there are easy, medium
and hard issues available! You're also welcome to suggest your own!
Please join us in #mgmtconfig on Freenode IRC, or ping this list if
you'd like help getting started!

THANKS

Thanks (alphabetically) to everyone who contributed to the latest
release:
James Shubin, Julien Pivotto, Michael Borden.
We had 3 unique committers since 0.0.9, and have had 30 overall.

Happy hacking,
James
59 changes: 59 additions & 0 deletions docs/release-notes/0.0.11
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
I've just released version 0.0.11 of mgmt!

NEWS

20 files changed, 579 insertions(+), 126 deletions(-)

* Added a missing mutex around the semaphore map which prevents
occasional panics

* Removed exec pollint param which is not needed because of the poll
metaparam

* Fixed a state rechecking bug in exec resource (things are faster now)

* Fixed the major annoyance of exec resources receiving main's signals.
If we would ^C the main mgmt, the child processes would receive this
too which was incorrect.

* Fixed the deadlock on resource errors. This meant that previously if
a resource failed, we would deadlock the graph from shutting down. This
was bad and I'm glad it's now fixed. Sorry about that!

* Improved the backpoke logic to not require semaphores since we used
to take the lock even when we were going to backpoke which was
unnecessary.

* Added fast pausing to the graph. This means that a ^C or a pause
transition used to wait for the whole graph to roll through, but it now
finishes after the currently running resources finish executing. Read
the commit messages for more background here including the discussion
about a possible Interrupt() addition to the resource API.

* Prometheus support has been updated!

* See the git log for more NEWS, and sorry for anything notable I left
out!

BUGS

* We're in pretty good shape now. There are some small issues, but
nothing major that I don't know about.

MISC

We're still looking for new contributors, and there are easy, medium
and hard issues available! You're also welcome to suggest your own!
Please join us in #mgmtconfig on Freenode IRC, or ping this list if
you'd like help getting started!

THANKS

Thanks (alphabetically) to everyone who contributed to the latest
release:
James Shubin, Julien Pivotto
We had 2 unique committers since 0.0.10, and have had 30 overall.

Happy hacking,
James
@purpleidea
87 changes: 87 additions & 0 deletions docs/release-notes/0.0.12
Original file line number Diff line number Diff line change
@@ -0,0 +1,87 @@
I've just released version 0.0.12 of mgmt!

Sorry if I've been more quiet than usual, I've had to focus a lot of my
time on GlusterFS related features ($dayjob official directives) and
work there.

One goal is to try and use libmgmt to either wholly or partially re-
implement glusterd. As a result, a lot of my upstream focus has been
re-prioritized to features needed for that effort.

I wrote a PoC called gd3: https://github.com/purpleidea/gd3
(It has now bit-rotted compared to upstream mgmt, but is easy to fix.)
The initial scope looks like it will be much smaller, but hopefully
this is interesting to you too. Ping me if you'd like to help.

We desperately need your contributions if we're going to get mgmt
standalone into a MVP. To motivate you, there's some great new stuff
that landed since 0.0.11, including:

* a great new YAML parser from contributor Mildred

* a huge pgraph refactor (to remove internal deps and cycles)

* a great amount of new tests and testing

and so much more...

NEWS

76 files changed, 7549 insertions(+), 4269 deletions(-)

* The svc resource now also supports user services

* There's a fabulous new yaml parser that fixes a longstanding issue in
my original code. Try it with --yaml2. I'll remove the old one
eventually. Thanks to contributor Mildred for this great work!

* Refactored the lib/ etcd usage into the GAPI's for a cleaner main

* World API grew some new methods for libmgmt users

* pgraph refactor and cleanup, now it's a fairly clean standalone pkg

* pgraph functions to flatten/merge in subgraphs along with examples

* Giant resource refactor to hopefully make things more logical, and to
simplify the resource API. This also introduces the mgraph struct to
add the higher level graph knowledge outside of pgraph.

* A partial implementation of a "Graph" (recursive subgraph?) resource!
See the code for details, as help is wanted to finish this. This should
help elucidate what the most elegant design for the mgmt core should
be.

* Send/Recv support for the exec resource as output, stdout, and stderr

* GAPI improvements to support exit requests and fast pausing

* AutoEdge API improvements including a fix+test for a regression

* A possible fix for the possible etcd server startup race

* A fun amount of new tests all over including for gometalinter

* See the git log for more NEWS, and for anything notable I left out!

BUGS

* We fixed a bunch of stuff, and added more tests!

MISC

We're still looking for new contributors, and there are easy, medium
and hard issues available! You're also welcome to suggest your own!
Please join us in #mgmtconfig on Freenode IRC, or ping this list if
you'd like help getting started!

THANKS

Thanks (alphabetically) to everyone who contributed to the latest
release:
James Shubin, Julien Pivotto, Mildred Ki'Lya
We had 3 unique committers since 0.0.11, and have had 30 overall.

Happy hacking,
James
@purpleidea
89 changes: 89 additions & 0 deletions docs/release-notes/0.0.13
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
I've just released version 0.0.13 of mgmt!

I guess this is an appropriate number for a scary October release.

We recently re-licensed to the more permissive GPL. I put a lot of
thought into it, and also wrote up a short blog post about some of the
reasoning. It's here:

https://ttboj.wordpress.com/2017/10/17/copyleft-is-dead-long-live-copyl
eft/

If you read to the end you'll also see that Red Hat is not funding my
mgmt work anymore. This is too bad, and means I'll only have small
amounts of personal time available to work on this. If you'd like to
help fund my work, or know someone who'd like to, please let me know!

Having said that, there's some great new stuff that landed since
0.0.12, including:

* new resources from new contributor Jonathan Gold (aws, group, user)

* an HCL frontend from new contributor Chris McKenzie

* polish in a number of places including in the nspawn resource

and so much more... If you'd prefer to have releases more often, then
please let me know! Lastly, the language and a number of associated
parts are on its way. I hope to push this monster patch to git master
before February.

It's also worth mentioning that we have 17 resources now! wow.

NEWS

140 files changed, 3921 insertions(+), 848 deletions(-)

* Many improvements to tests, testing and small fixes to avoid false-
failures on travis.

* golint now reports 0 issues.

* An HCL frontend if you'd prefer that to the YAML. Also a great
example of how to plug in a new frontend.

* An update to golang 1.8 as the minimum version required.

* Bump the etcd version to 3.2.6+ -- Looking forward to a 3.3 release
which should probably include some patches we upstreamed.

* Addition of new user and group resources. These also include a bunch
of automatic edges.

* Addition of an AWS resource! I've wanted this for a while, as it
demonstrates nicely how event based cloud resources can fit nicely into
our design. There's still a lot to do, and we have some suggestions for
Amazon too. If you have a contact there, please put me in touch!

* Our nspawn resource is more polished now.

* See the git log for more NEWS, and for anything notable I left out!

MISC

We're still looking for new contributors, and there are easy, medium
and hard issues available! You're also welcome to suggest your own!
Please join us in #mgmtconfig on Freenode IRC, or ping this list if
you'd like help getting started!

MENTORING

We offer mentoring for new golang/mgmt hackers who want to get
involved. This is free and friendly. You get to improve your skills,
and we get some patches in return. Ping me off-list for details.

THANKS

Thanks (alphabetically) to everyone who contributed to the latest
release:
AdnanLFC, Arthur Mello, ChrisMcKenzie, Dennis Kliban, Ismael Puerto,
James Shubin, Jonathan Gold, Juan Luis de Sousa-Valadas Castaño, Juan-
Luis de Sousa-Valadas Castaño (although I suspect the last two are the
same ;))

We had 9 unique committers since 0.0.12, and have had 38 overall.
Run 'git log 0.0.12..0.0.13' to see what has changed since 0.0.12

Happy hacking,
James
@purpleidea
81 changes: 81 additions & 0 deletions docs/release-notes/0.0.14
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
I've just released version 0.0.14 of mgmt!

> 118 files changed, 2688 insertions(+), 974 deletions(-)

There's some great new stuff that landed since
0.0.13, including:

* amazon AWS EC2 resource is now in git master.

* more automatic edges from new contributor Guillaume Herail (xiu)

* a move to golang 1.8 or higher

and so much more... This will probably be the last release before the
language lands in git master. It's a pretty giant patch coming :/

NEWS

* We're > 1k stars on GitHub now. It's a silly metric, but ¯\_(ツ)_/¯

* Jonathan Gold has done a lot of hard work on the AWS EC2 resource,
and it's now in git master. There are still many things we'd like to
do, but it's a great start on what is a *monster* resource, and
hopefully it will inspire others to get involved.

In particular, it was a great learning experience (for me in
particular!) about how bad the EC2 golang API is. There are some
notable design bugs we found, and if anyone from Amazon engineering
would like to reach out to us, we'd love to provide some constructive
ideas.

* Guillaume Herail (xiu) wrote some really nice patches, and picked up
on the autoedges API very quickly. Hopefully he'll have time to work on
even more!

* Paul Morgan sent us some nice shell fixups-- many more exist in an
open PR that didn't make it into this release. Hopefully we'll get
those merged by 0.0.15

* Felix Frank did a few Puppet compiler fix ups. I think he's been
refreshing his work with new resources recently...

* We're looking for help writing Google, DigitalOcean, Rackspace, etc
resources if anyone is interested, reach out to us. Particularly if
there is support from those organizations as well.

* See the git log for more NEWS, and for anything notable I left out!

EVENTS

There are a bunch of upcoming mgmt talks and events! Stay tuned for
details in the coming email, but TL;DR: Linux Conf Australia, FOSDEM, &
CfgMgmtCamp.eu -- from three different speakers, and including a
hackathon too!

MISC

We're still looking for new contributors, and there are easy, medium
and hard issues available! You're also welcome to suggest your own!
Please join us in #mgmtconfig on Freenode IRC, or ping this list if
you'd like help getting started! Expect many new tagged #mgmtlove
issues within the month.

MENTORING

We offer mentoring for new golang/mgmt hackers who want to get
involved. This is free and friendly. You get to improve your skills,
and we get some patches in return. Ping me off-list for details.

THANKS

Thanks (alphabetically) to everyone who contributed to the latest
release:
Felix Frank, Guillaume Herail, James Shubin, Jonathan Gold,
jonathangold, Julien Pivotto, Paul Morgan, Toshaan Bharvani
We had 8 unique committers since 0.0.13, and have had 41 overall.
run 'git log 0.0.13..0.0.14' to see what has changed since 0.0.13

Happy hacking,
James
@purpleidea

0 comments on commit 46b2fe0

Please sign in to comment.