[openstack-dev] [all][tc][cinder][mistral][manila] A path forward to shiny consistent service types

Monty Taylor mordred at inaugust.com
Fri Apr 28 23:19:10 UTC 2017


On 04/28/2017 06:07 PM, Adrian Turjak wrote:
>
> This sounds like a fantastic​ path forward as the version in the service
> ​ type is a source​ of frustration in some ways. I personally love the
> version​less discoverability of Keystone as an API model.

++ ... I'll follow up on Monday with an email about consumption of 
version discovery.

> I'm also assuming this is related to this repo here:
> https://github.com/openstack/service-types-authority
 >
> Are there plans to actually fill that repo out and start building the
> full 'official' catalog of service types? Because right now that repo is
> missing many services but appears to actually be a good place to list
> what all the various service types are already in use.

Yes, absolutely. If we can get this particular party moving I'd like to 
use that as a little motivation to chug through and get that repo 
completed. (It's not super hard - but without an answer to what to do 
about the old names, the conversations stall out a bit)

> I know that trying to choose a good new service type for a project is
> hard because finding a list for the ones already in use isn't that easy.
> I was sad to find that repo, although ideal, was lacking.

++ totally agree.

>
> On 29 Apr. 2017 10:26 am, Monty Taylor <mordred at inaugust.com> wrote:
>
>     Hey everybody!
>
>     Yay! (I'm sure you're all saying this, given the topic. I'll let you
>     collect yourself from your exuberant celebration)
>
>     == Background ==
>
>     As I'm sure you all know, we've been trying to make some hearway for a
>     while on getting service-types that are registered in the keystone
>     service catalog to be consistent. The reason for this is so that API
>     Consumers can know how to request a service from the catalog. That
>     might
>     sound like a really easy task - but uh-hoh, you'd be so so wrong. :)
>
>     The problem is that we have some services that went down the path of
>     suggesting people register a new service in the catalog with a version
>     appended. This pattern was actually started by nova for the v3 api but
>     which we walked back from - with "computev3". The pattern was picked up
>     by at least cinder (volumev2, volumev3) and mistral (workflowv2) that I
>     am aware of. We're also suggesting in the service-types-authority that
>     manila go by "shared-file-system" instead of "share".
>
>     (Incidentally, this is related to a much larger topic of version
>     discovery, which I will not bore you with in this email, but about
>     which
>     I have a giant pile of words just waiting for you in a little bit. Get
>     excited about that!)
>
>     == Proposed Solution ==
>
>     As a follow up to the consuming version discovery spec, which you
>     should
>     absolutely run away from and never read, I wrote these:
>
>     https://review.openstack.org/#/c/460654/ (Consuming historical aliases)
>     and
>     https://review.openstack.org/#/c/460539/ (Listing historical aliases)
>
>     It's not a particularly clever proposal - but it breaks down like this:
>
>     * Make a list of the known historical aliases we're aware of - in a
>     place that isn't just in one of our python libraries (460539)
>     * Write down a process for using them as part of finding a service from
>     the catalog so that there is a clear method that can be implemented by
>     anyone doing libraries or REST interactions. (460654)
>     * Get agreement on that process as the "recommended" way to look up
>     services by service-type in the catalog.
>     * Implement it in the base libraries OpenStack ships.
>     * Contact the authors of as many OpenStack API libraries that we can
>     find.
>     * Add tempest tests to verify the mappings in both directions.
>     * Change things in devstack/deployer guides.
>
>     The process as described is backwards compatible. That is, once
>     implemented it means that a user can request "volumev2" or
>     "block-storage" with version=2 - and both will return the endpoint the
>     user expects. It also means that we're NOT asking existing clouds to
>     run
>     out and break their users. New cloud deployments can do the new thing -
>     but the old values are handled in both directions.
>
>     There is a hole, which is that people who are not using the base libs
>     OpenStack ships may find themselves with a new cloud that has a
>     different service-type in the catalog than they have used before. It's
>     not idea, to be sure. BUT - hopefully active outreach to the community
>     libraries coupled with documentation will keep the issues to a minimum.
>
>     If we can agree on the matching and fallback model, I am
>     volunteering to
>     do the work to implement in every client library in which it needs
>     to be
>     implemented across OpenStack and to add the tempest tests. (it's
>     actually mostly a patch to keystoneauth, so that's actually not _that_
>     impressive of a volunteer) I will also reach out to as many of the
>     OpenStack API client library authors as I can find, point them at the
>     docs and suggest they add the support.
>
>     Thoughts? Anyone violently opposed?
>
>     Thanks for reading...
>
>     Monty
>
>     __________________________________________________________________________
>     OpenStack Development Mailing List (not for usage questions)
>     Unsubscribe:
>     OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
>     http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>
>
>
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
>




More information about the OpenStack-dev mailing list