Added MULTI_ROLE support to the upgrades documentation. Review: https://reviews.apache.org/r/58061
Project: http://git-wip-us.apache.org/repos/asf/mesos/repo Commit: http://git-wip-us.apache.org/repos/asf/mesos/commit/0d4e08ce Tree: http://git-wip-us.apache.org/repos/asf/mesos/tree/0d4e08ce Diff: http://git-wip-us.apache.org/repos/asf/mesos/diff/0d4e08ce Branch: refs/heads/master Commit: 0d4e08ce3725cf3c0b91acbe27870bc41c430429 Parents: b1eb571 Author: Benjamin Mahler <[email protected]> Authored: Wed Mar 29 18:36:40 2017 -0700 Committer: Benjamin Mahler <[email protected]> Committed: Fri Mar 31 17:13:38 2017 -0700 ---------------------------------------------------------------------- docs/upgrades.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/mesos/blob/0d4e08ce/docs/upgrades.md ---------------------------------------------------------------------- diff --git a/docs/upgrades.md b/docs/upgrades.md index 249e844..a12e6ea 100644 --- a/docs/upgrades.md +++ b/docs/upgrades.md @@ -53,10 +53,20 @@ We categorize the changes as follows: </ul> </td> <td style="word-wrap: break-word; overflow-wrap: break-word;"><!--Framework API--> + <ul style="padding-left:10px;"> + <li>A <a href="#1-3-x-multi-role-support">MULTI_ROLE support</a></li> + <li>D <a href="#1-3-x-framework-info-role">FrameworkInfo.roles deprecates FrameworkInfo.role</a></li> + </ul> </td> <td style="word-wrap: break-word; overflow-wrap: break-word;"><!--Module API--> + <ul style="padding-left:10px;"> + <li>C <a href="#1-3-x-allocator-interface-change">Allocator MULTI_ROLE interface changes</a></li> + </ul> </td> <td style="word-wrap: break-word; overflow-wrap: break-word;"><!--Endpoints--> + <ul style="padding-left:10px;"> + <li>D <a href="#1-3-x-endpoints-roles">MULTI_ROLE deprecates 'role' field in endpoints</a></li> + </ul> </td> </tr> <tr> @@ -261,6 +271,15 @@ We categorize the changes as follows: <a name="1-3-x-setquota-removequota-acl"></a> * Support for deprecated ACLs `set_quotas` and `remove_quotas` has been removed from the local authorizer. Before upgrading the Mesos binaries, consolidate the ACLs used under `set_quotas` and `remove_quotes` under their replacemente ACL `update_quotas`. After consolidation of the ACLs, the binaries could be safely replaced. +<a name="1-3-x-framework-info-role"></a> +* Support for multi-role frameworks deprecates the `FrameworkInfo.role` field in favor of `FrameworkInfo.roles` and the `MULTI_ROLE` capability. Frameworks using the new field can continue to use a single role. + +<a name="1-3-x-endpoints-roles"></a> +* Support for multi-role frameworks means that the framework `role` field in the master and agent endpoints is deprecated in favor of `roles`. Any tooling parsing endpoint information and relying on the role field needs to be updated before multi-role frameworks can be safely run in the cluster. + +<a name="1-3-x-allocator-interface-change"></a> +* Implementors of allocator modules have to provide new implementation functionality to satisfy the `MULTI_ROLE` framework capability. Also, the interface has changed. + ## Upgrading from 1.1.x to 1.2.x ## <a name="1-2-x-heartbeat-flag"></a>
