[openstack-dev] [magnum][osc] What name to use for magnum commands in osc?

Clint Byrum clint at fewbar.com
Mon Mar 20 22:02:28 UTC 2017


Excerpts from Adrian Otto's message of 2017-03-20 21:16:09 +0000:
> Jay,
> 
> On Mar 20, 2017, at 12:35 PM, Jay Pipes <jaypipes at gmail.com<mailto:jaypipes at gmail.com>> wrote:
> 
> On 03/20/2017 03:08 PM, Adrian Otto wrote:
> Team,
> 
> Stephen Watson has been working on an magnum feature to add magnum commands to the openstack client by implementing a plugin:
> 
> https://review.openstack.org/#/q/status:open+project:openstack/python-magnumclient+osc
> 
> 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.
> 
> Unfortunately, the Senlin API uses a whole bunch of generic terms as top-level REST resources, including "cluster", "event", "action", "profile", "policy", and "node". :( I've warned before that use of these generic terms in OpenStack APIs without a central group responsible for curating the API would lead to problems like this. This is why, IMHO, we need the API working group to be ultimately responsible for preventing this type of thing from happening. Otherwise, there ends up being a whole bunch of duplication and same terms being used for entirely different things.
> 
> >Stephen opened a discussion with Dean Troyer about this, and found that “infra” might be a suitable name and began using that, and multiple team members are not satisfied with it.
> 
> Yeah, not sure about "infra". That is both too generic and not an actual "thing" that Magnum provides.
> 
> > The name “magnum” was excluded from consideration because OSC aims to be project name agnostic. We know that no matter what word we pick, it’s not going to be ideal. I’ve added an agenda on our upcoming team meeting to judge community consensus about which alternative we should select:
> 
> https://wiki.openstack.org/wiki/Meetings/Containers#Agenda_for_2017-03-21_1600_UTC
> 
> Current choices on the table are:
> 
>  * c_cluster (possible abbreviation alias for container_infra_cluster)
>  * coe_cluster
>  * mcluster
>  * infra
> 
> For example, our selected name would appear in “openstack …” commands. Such as:
> 
> $ openstack c_cluster create …
> 
> 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.
> 
> What is Magnum's service-types-authority service_type?
> 
> I propose "coe-cluster” for that, but that should be discussed further, as it’s impossible for magnum to conform with all the requirements for service types because they fundamentally conflict with each other:
> 
> https://review.openstack.org/447694
> 
> In the past we referred to this type as a “bay” but found it burdensome for users and operators to use that term when literally bay == cluster. We just needed to call it what it is because there’s a prevailing name for that concept, and everyone expects that’s what it’s called.

I Think Jay was asking for Magnum's name in the catalog:

Which is 'container-infra' according to this:

https://github.com/openstack/python-magnumclient/blob/master/magnumclient/v1/client.py#L34



More information about the OpenStack-dev mailing list