<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:"Arial Unicode MS";
panose-1:2 11 6 4 2 2 2 2 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:"\@Arial Unicode MS";
panose-1:2 11 6 4 2 2 2 2 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman",serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.gmail-
{mso-style-name:gmail-;}
span.gmail-hoenzb
{mso-style-name:gmail-hoenzb;}
span.gmail-im
{mso-style-name:gmail-im;}
span.EmailStyle20
{mso-style-type:personal-reply;
font-family:"Calibri",sans-serif;
color:#1F497D;}
.MsoChpDefault
{mso-style-type:export-only;
font-size:10.0pt;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">It seems the term COE is a valid term now. I am in favor of having “openstack coe cluster” or “openstack container cluster”.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Using the command “infra” is too generic and doesn’t relate to what Magnum is doing exactly.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Regards,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D">Madhuri<o:p></o:p></span></p>
<p class="MsoNormal"><a name="_MailEndCompose"><span style="font-size:11.0pt;font-family:"Calibri",sans-serif;color:#1F497D"><o:p> </o:p></span></a></p>
<p class="MsoNormal"><b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif">From:</span></b><span style="font-size:11.0pt;font-family:"Calibri",sans-serif"> Spyros Trigazis [mailto:strigazi@gmail.com]
<br>
<b>Sent:</b> Tuesday, March 21, 2017 7:25 PM<br>
<b>To:</b> OpenStack Development Mailing List (not for usage questions) <openstack-dev@lists.openstack.org><br>
<b>Subject:</b> Re: [openstack-dev] [magnum][osc] What name to use for magnum commands in osc?<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">IMO, coe is a little confusing. It is a term used by people related somehow<o:p></o:p></p>
<div>
<p class="MsoNormal">to the magnum community. When I describe to users how to use magnum,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">I spent a few moments explaining what we call coe.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">I prefer one of the following:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">* openstack magnum cluster create|delete|...<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">* openstack mcluster create|delete|...<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">* both the above<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">It is very intuitive for users because, they will be using an openstack cloud<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">and they will be wanting to use the magnum service. So, it only make sense<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">to type openstack magnum cluster or mcluster which is shorter.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On 21 March 2017 at 02:24, Qiming Teng <<a href="mailto:tengqim@linux.vnet.ibm.com" target="_blank">tengqim@linux.vnet.ibm.com</a>> wrote:<o:p></o:p></p>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal"><span class="gmail-">On Mon, Mar 20, 2017 at 03:35:18PM -0400, Jay Pipes wrote:</span><br>
<span class="gmail-">> On 03/20/2017 03:08 PM, Adrian Otto wrote:</span><br>
<span class="gmail-">> >Team,</span><br>
<span class="gmail-">> ></span><br>
<span class="gmail-">> >Stephen Watson has been working on an magnum feature to add magnum commands to the openstack client by implementing a plugin:</span><br>
<span class="gmail-">> ></span><br>
<span class="gmail-">> ></span><a href="https://review.openstack.org/#/q/status:open+project:openstack/python-magnumclient+osc" target="_blank">https://review.openstack.org/#/q/status:open+project:openstack/python-magnumclient+osc</a><br>
<span class="gmail-">> ></span><br>
<span class="gmail-">> >In review of this work, a question has resurfaced, as to what the client command name should be for magnum related commands. Naturally, we’d like to have the name “cluster” but that word is already in use by Senlin.</span><br>
<span class="gmail-">></span><br>
<span class="gmail-">> Unfortunately, the Senlin API uses a whole bunch of generic terms as</span><br>
<span class="gmail-">> top-level REST resources, including "cluster", "event", "action",</span><br>
<span class="gmail-">> "profile", "policy", and "node". :( I've warned before that use of</span><br>
<span class="gmail-">> these generic terms in OpenStack APIs without a central group</span><br>
<span class="gmail-">> responsible for curating the API would lead to problems like this.</span><br>
<span class="gmail-">> This is why, IMHO, we need the API working group to be ultimately</span><br>
<span class="gmail-">> responsible for preventing this type of thing from happening.</span><br>
<span class="gmail-">> Otherwise, there ends up being a whole bunch of duplication and same</span><br>
<span class="gmail-">> terms being used for entirely different things.</span><br>
<span class="gmail-">></span><br>
<br>
Well, I believe the name and namespaces used by Senlin is very clean.<br>
Please see the following outputs. All commands are contained in the<br>
cluster namespace to avoid any conflicts with any other projects.<br>
<br>
On the other hand, is there any document stating that Magnum is about<br>
providing clustering service? Why Magnum cares so much about the top<br>
level noun if it is not its business?<o:p></o:p></p>
</blockquote>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">From magnum's wiki page [1]:<br>
"<span style="font-size:10.5pt;font-family:"Arial Unicode MS",sans-serif;color:#333333">Magnum uses Heat to orchestrate an OS image which contains Docker</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.5pt;font-family:"Arial Unicode MS",sans-serif;color:#333333">and Kubernetes and runs that image in either virtual machines or bare</span><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><span style="font-size:10.5pt;font-family:"Arial Unicode MS",sans-serif;color:#333333">metal in a
<b>cluster</b> configuration.</span>"<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Many services may offer clusters indirectly. Clusters is NOT magnum's focus,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">but we can't refer to a collection of virtual machines or physical servers with<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">another name. Bay proven to be confusing to users. I don't think that magnum<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">should reserve the cluster noun, even if it was available.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">[1] <a href="https://wiki.openstack.org/wiki/Magnum">https://wiki.openstack.org/wiki/Magnum</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0in 0in 0in 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0in;margin-bottom:5.0pt">
<p class="MsoNormal" style="margin-bottom:12.0pt"><br>
<br>
$ openstack --help | grep cluster<br>
<br>
--os-clustering-api-version <clustering-api-version><br>
<br>
cluster action list List actions.<br>
cluster action show Show detailed info about the specified action.<br>
cluster build info Retrieve build information.<br>
cluster check Check the cluster(s).<br>
cluster collect Collect attributes across a cluster.<br>
cluster create Create the cluster.<br>
cluster delete Delete the cluster(s).<br>
cluster event list List events.<br>
cluster event show Describe the event.<br>
cluster expand Scale out a cluster by the specified number of nodes.<br>
cluster list List the user's clusters.<br>
cluster members add Add specified nodes to cluster.<br>
cluster members del Delete specified nodes from cluster.<br>
cluster members list List nodes from cluster.<br>
cluster members replace Replace the nodes in a cluster with<br>
specified nodes.<br>
cluster node check Check the node(s).<br>
cluster node create Create the node.<br>
cluster node delete Delete the node(s).<br>
cluster node list Show list of nodes.<br>
cluster node recover Recover the node(s).<br>
cluster node show Show detailed info about the specified node.<br>
cluster node update Update the node.<br>
cluster policy attach Attach policy to cluster.<br>
cluster policy binding list List policies from cluster.<br>
cluster policy binding show Show a specific policy that is bound to<br>
the specified cluster.<br>
cluster policy binding update Update a policy's properties on a<br>
cluster.<br>
cluster policy create Create a policy.<br>
cluster policy delete Delete policy(s).<br>
cluster policy detach Detach policy from cluster.<br>
cluster policy list List policies that meet the criteria.<br>
cluster policy show Show the policy details.<br>
cluster policy type list List the available policy types.<br>
cluster policy type show Get the details about a policy type.<br>
cluster policy update Update a policy.<br>
cluster policy validate Validate a policy.<br>
cluster profile create Create a profile.<br>
cluster profile delete Delete profile(s).<br>
cluster profile list List profiles that meet the criteria.<br>
cluster profile show Show profile details.<br>
cluster profile type list List the available profile types.<br>
cluster profile type show Show the details about a profile type.<br>
cluster profile update Update a profile.<br>
cluster profile validate Validate a profile.<br>
cluster receiver create Create a receiver.<br>
cluster receiver delete Delete receiver(s).<br>
cluster receiver list List receivers that meet the criteria.<br>
cluster receiver show Show the receiver details.<br>
cluster recover Recover the cluster(s).<br>
cluster resize Resize a cluster.<br>
cluster run Run scripts on cluster.<br>
cluster show Show details of the cluster.<br>
cluster shrink Scale in a cluster by the specified number of nodes.<br>
cluster template list List Cluster Templates.<br>
cluster update Update the cluster.<br>
<span style="color:#888888"><br>
<span class="gmail-hoenzb">- Qiming</span><br>
</span><br>
<span class="gmail-im">> >Stephen opened a discussion with Dean Troyer about this, and found</span><br>
<span class="gmail-im">> that “infra” might be a suitable name and began using that, and</span><br>
<span class="gmail-im">> multiple team members are not satisfied with it.</span><br>
<span class="gmail-im">></span><br>
<span class="gmail-im">> Yeah, not sure about "infra". That is both too generic and not an</span><br>
<span class="gmail-im">> actual "thing" that Magnum provides.</span><br>
<span class="gmail-im">></span><br>
<span class="gmail-im">> > The name “magnum” was excluded from consideration because OSC aims</span><br>
<span class="gmail-im">> to be project name agnostic. We know that no matter what word we</span><br>
<span class="gmail-im">> pick, it’s not going to be ideal. I’ve added an agenda on our</span><br>
<span class="gmail-im">> upcoming team meeting to judge community consensus about which</span><br>
<span class="gmail-im">> alternative we should select:</span><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> ></span><a href="https://wiki.openstack.org/wiki/Meetings/Containers#Agenda_for_2017-03-21_1600_UTC" target="_blank">https://wiki.openstack.org/wiki/Meetings/Containers#Agenda_for_2017-03-21_1600_UTC</a><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> >Current choices on the table are:</span><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> > * c_cluster (possible abbreviation alias for container_infra_cluster)</span><br>
<span class="gmail-im">> > * coe_cluster</span><br>
<span class="gmail-im">> > * mcluster</span><br>
<span class="gmail-im">> > * infra</span><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> >For example, our selected name would appear in “openstack …” commands. Such as:</span><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> >$ openstack c_cluster create …</span><br>
<span class="gmail-im">> ></span><br>
<span class="gmail-im">> >If you have input to share, I encourage you to reply to this thread, or come to the team meeting so we can consider your input before the team makes a selection.</span><br>
<span class="gmail-im">></span><br>
<br>
<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal">__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" target="_blank">
OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><o:p></o:p></p>
</div>
</div>
</blockquote>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</div>
</div>
</body>
</html>