<div dir="ltr">It appears that the patch related to this discussion were rushed through rather quickly, and without appropriate updates to the documentation. The documentation of the library no longer matches the actual functionality, and will need to be updated before we can release a new version of oslo_middleware. <div><br></div><div>Mehdi, if you would please update the documentation in oslo_middleware as quickly as possible? Some of us have features that we're trying to land in liberty, which we cannot do without a new release of this library.</div><div><br></div><div>To the rest of the Oslo team, I'd like to propose that if we do not have appropriate updated documentation by the end of this week, we revert Medhi's patches so that we can unblock the library.<br><div><br></div><div>In case you're curious, the related patch is here:</div><div><a href="https://review.openstack.org/#/c/209817/3">https://review.openstack.org/#/c/209817/3</a><br></div><div><br></div><div>Michael Krotscheck</div></div></div><br><div class="gmail_quote"><div dir="ltr">On Sun, Aug 9, 2015 at 7:58 PM Jamie Lennox <<a href="mailto:jamielennox@redhat.com">jamielennox@redhat.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><br>
<br>
----- Original Message -----<br>
> From: "Jamie Lennox" <<a href="mailto:jamielennox@redhat.com" target="_blank">jamielennox@redhat.com</a>><br>
> To: "OpenStack Development Mailing List (not for usage questions)" <<a href="mailto:openstack-dev@lists.openstack.org" target="_blank">openstack-dev@lists.openstack.org</a>><br>
> Sent: Monday, August 10, 2015 12:36:14 PM<br>
> Subject: Re: [openstack-dev] [oslo][keystone] oslo_config and wsgi middlewares<br>
><br>
><br>
><br>
> ----- Original Message -----<br>
> > From: "Mehdi Abaakouk" <<a href="mailto:sileht@sileht.net" target="_blank">sileht@sileht.net</a>><br>
> > To: <a href="mailto:openstack-dev@lists.openstack.org" target="_blank">openstack-dev@lists.openstack.org</a><br>
> > Sent: Friday, August 7, 2015 1:57:54 AM<br>
> > Subject: [openstack-dev] [oslo][keystone] oslo_config and wsgi middlewares<br>
> ><br>
> > Hi,<br>
> ><br>
> > I want to share with you some problems I have recently encountered with<br>
> > openstack middlewares and oslo.config.<br>
> ><br>
> > The issues<br>
> > ----------<br>
> ><br>
> > In project Gnocchi, I would use oslo.middleware.cors, I have expected to<br>
> > just put the name of the middleware to the wsgi pipeline, but I can't.<br>
> > The middlewares only works if you pass the oslo_config.cfg.ConfigOpts()<br>
> > object or via 'paste-deploy'... Gnocchi doesn't use paste-deploy, so<br>
> > I have to modify the code to load it...<br>
> > (For the keystonemiddleware, Gnocchi already have a special<br>
> > handling/hack to load it [1] and [2]).<br>
> > I don't want to write the same hack for each openstack middlewares.<br>
> ><br>
> ><br>
> > In project Aodh (ceilometer-alarm), we recently got an issue with<br>
> > keystonemiddleware since we remove the usage of the global object<br>
> > oslo_config.cfg.CONF. The middleware doesn't load its options from the<br>
> > config file of aodh anymore. Our authentication is broken.<br>
> > We can still pass them through paste-deploy configuration but this looks<br>
> > a method of the past. I still don't want to write a hack for each<br>
> > openstack middlewares.<br>
> ><br>
> ><br>
> > Then I have digged into other middlewares and applications to see how<br>
> > they handle their conf.<br>
> ><br>
> > oslo_middlewarre.sizelimit and oslo_middlewarre.ssl take options only<br>
> > via the global oslo_config.cfg.CONF. So they are unusable for application<br>
> > that doesn't use this global object.<br>
> ><br>
> > oslo_middleware.healthcheck take options as dict like any other python<br>
> > middleware. This is suitable for 'paste-deploy'. But doesn't allow<br>
> > configuration via oslo.config, doesn't have a strong config options<br>
> > type checking and co.<br>
> ><br>
> > Zaqar seems got same kind of issue about keystonemiddleware, and just<br>
> > write a hack to workaround the issue (monkeypatch the cfg.CONF of<br>
> > keystonemiddleware with their local version of the object [3] and then<br>
> > transform the loaded options into a dict to pass them via the legacy<br>
> > middleware dict options [4]) .<br>
> ><br>
> > Most applications, just still use the global object for the<br>
> > configuration and don't, yet, see those issues.<br>
> ><br>
> ><br>
> > All of that is really not consistent.<br>
> ><br>
> > This is confusing for developer to have some middlewares that need<br>
> > pre-setup,<br>
> > enforce them to rely on global python object, and some others not.<br>
> > This is confusing for deployer their can't do the configuration of<br>
> > middlewares in the same way for each middlewares and each projects.<br>
> ><br>
> > But keystonemiddleware, oslo.middleware.cors,... are supposed to be wsgi<br>
> > middlewares, something that is independant of the app.<br>
> > And this is not really the case.<br>
> ><br>
> > From my point of view and what wsgi looks like generally in python, the<br>
> > middleware object should be just MyMiddleware(app, options_as_dict),<br>
> > if the middleware want to rely to another configuration system it should<br>
> > do the setup/initialisation itself.<br>
> ><br>
> ><br>
> ><br>
> > So, how to solve that ?<br>
> > ------------------------<br>
> ><br>
> > Do you agree:<br>
> ><br>
> > * all openstack middlewares should load their options with oslo.config ?<br>
> >   this permits type checking and all other features it provides, it's cool<br>
> >   :)<br>
> >   configuration in paste-deploy conf is thing of past<br>
> ><br>
> > * we must support local AND global oslo.config object ?<br>
> >   This is an application choice not something enforced by middleware.<br>
> >   The deployer experience should be the same in both case.<br>
> ><br>
> > * the middleware must be responsible of the section name in the oslo.config<br>
> > ?<br>
> >   Gnocchi/Zaqar hack have to hardcode the section name in their code,<br>
> >   this doesn't looks good.<br>
> ><br>
> > * we must support legacy python signature for WSGI object,<br>
> >   MyMiddleware(app, options_as_dict) ? To be able to use paste for<br>
> >   application/deployer that want it and not break already deployed things.<br>
> ><br>
> ><br>
> > I really think all our middlewares should be consistent:<br>
> ><br>
> > * to be usable by all applications without enforcing them to write crap<br>
> > around them.<br>
> > * and to made the deployer life easier.<br>
> ><br>
> ><br>
> > Possible solution:<br>
> > ------------------<br>
> ><br>
> > I have already started to work on something that do all of that for all<br>
> > middlewares [5], [6]<br>
> ><br>
> > The idea is, the middleware should create a oslo_config.cfg.ConfigOpts()<br>
> > (instead of rely on the global one) and load the configuration file of the<br>
> > application in. oslo.config will discover the file location just with the<br>
> > name of application as usual.<br>
> ><br>
> > So the middleware can now be loaded like this:<br>
> ><br>
> > code example:<br>
> ><br>
> >    app = MyMiddleware(app, {"oslo_config_project": "aodh"})<br>
> ><br>
> > paste-deploy example:<br>
> ><br>
> >    [filter:foobar]<br>
> >    paste.filter_factory = foobar:MyMiddleware.filter_factory<br>
> >    oslo_config_project = aodh<br>
> ><br>
> > oslo_config.cfg.ConfigOpts() will easly find the /etc/aodh/aodh.conf,<br>
> > This cut the hidden links between middleware and the application<br>
> > (through the global object).<br>
> ><br>
> > And of course if oslo_config_project is not provided, the middleware<br>
> > fallback the global oslo.config object.<br>
> > The middleware options can still be passed via the legacy dict.<br>
> > The backward compatibility is conserved.<br>
> ><br>
> > I have already tested that in Gnocchi and Aodh, and that solves all of<br>
> > my issues. Remove all hacks, the application doesn't need special pre<br>
> > setup. All our middleware become normal middleware but still can use<br>
> > oslo.config.<br>
> ><br>
> ><br>
> > WDYT ?<br>
><br>
> So i agree on most of your points, the middlewares are certainly<br>
> inconsistent, i would like to make things easier for deployers and I don't<br>
> like global CONF objects (but i've now had that argument so many times i'm<br>
> done).<br>
><br>
> Also to support some of the newer services that don't use paste i think we<br>
> should absolutely make it so that the CONF object is passed to middleware<br>
> rather than sourced globally. I think gnochhi and zaqar both fit into this<br>
> case.<br>
><br>
> The problem i see with what you are saying is that it is mixing deployment<br>
> methodologies in a way that is unintended. Paste is designed to allow<br>
> deployers to add and remove middleware independent of configuring the<br>
> service. This means that at paste time there is no CONF object unless it's<br>
> globally registered and this is why most middlewares allow taking options<br>
> from paste.ini because if you don't have global CONF then it's the only way<br>
> to actually get options into the middleware.<br>
><br>
> The proposed solution is then to provide enough options (via paste) to load a<br>
> CONF object local to the middleware that will be an exact copy of what the<br>
> service will have already loaded. In your test so far this has only required<br>
> project_name which might be enough because i don't know how often services<br>
> specify their own default_config_files[1] and it looks like CONF will use<br>
> sys.argv[1:] by default [2] for parsing CLI arguments. This conf loading<br>
> code would then have to be replicated into all middleware that wants to use<br>
> oslo.config for its options.<br>
><br>
> Fixing this problem is always where i loose enthusiasm for removing global<br>
> CONF files.<br>
><br>
> From a developer perspective I feel the solution is for us to reconsider how<br>
> we deploy and configure middleware. If you are using paste those pieces of<br>
> middleware should each be able to be configured without any integration with<br>
> the service underneath it. Otherwise if your service needs a piece of<br>
> middleware like auth_token middleware to operate or relies on oslo.config<br>
> options like cors then that is not something that should be controlled by<br>
> paste.<br>
><br>
> From a deployer perspective there is no great answer i just want everything<br>
> to be in oslo.config.<br>
><br>
> Equally from a deployer perspective this wasn't an issue until aodh (et al)<br>
> decided to remove the global CONF object which developers from all the<br>
> projects hate but live with. I don't mean to imply we shouldn't look at<br>
> better ways to do things, but if you're main concern is deployers the<br>
> easiest thing we can do for consistency is add back the global CONF object<br>
> or remove paste from aodh. :)<br>
><br>
> Jamie<br>
<br>
On re-reading this i realize the :) doesn't prevent this coming acrross a bit snarky or aggressive. That's not my intent and i apologize.<br>
<br>
I would love to figure out ways we can make all this more consistent, but i'm not a fan of having to load and handle CONF objects in multiple places, especially once per middleware object.<br>
<br>
<br>
><br>
><br>
> [1]<br>
> <a href="https://git.openstack.org/cgit/openstack/oslo.config/tree/oslo_config/cfg.py#n1832" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/oslo.config/tree/oslo_config/cfg.py#n1832</a><br>
> [2]<br>
> <a href="https://git.openstack.org/cgit/openstack/oslo.config/tree/oslo_config/cfg.py#n1880" rel="noreferrer" target="_blank">https://git.openstack.org/cgit/openstack/oslo.config/tree/oslo_config/cfg.py#n1880</a><br>
><br>
> ><br>
> > Cheers,<br>
> ><br>
> > [1]<br>
> > <a href="https://github.com/openstack/gnocchi/blob/master/gnocchi/rest/app.py#L140" rel="noreferrer" target="_blank">https://github.com/openstack/gnocchi/blob/master/gnocchi/rest/app.py#L140</a><br>
> > [2]<br>
> > <a href="https://github.com/openstack/gnocchi/blob/master/gnocchi/service.py#L64-L73" rel="noreferrer" target="_blank">https://github.com/openstack/gnocchi/blob/master/gnocchi/service.py#L64-L73</a><br>
> > [3]<br>
> > <a href="https://github.com/openstack/zaqar/blob/87fd1aa93dafb64097f731dbd416c2eeb697d403/zaqar/transport/auth.py#L63" rel="noreferrer" target="_blank">https://github.com/openstack/zaqar/blob/87fd1aa93dafb64097f731dbd416c2eeb697d403/zaqar/transport/auth.py#L63</a><br>
> > [4]<br>
> > <a href="https://github.com/openstack/zaqar/blob/87fd1aa93dafb64097f731dbd416c2eeb697d403/zaqar/transport/auth.py#L70" rel="noreferrer" target="_blank">https://github.com/openstack/zaqar/blob/87fd1aa93dafb64097f731dbd416c2eeb697d403/zaqar/transport/auth.py#L70</a><br>
> > [5] <a href="https://review.openstack.org/#/c/208965/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/208965/</a><br>
> > [6] <a href="https://review.openstack.org/#/c/209817/" rel="noreferrer" target="_blank">https://review.openstack.org/#/c/209817/</a><br>
> ><br>
> ><br>
> > --<br>
> > Mehdi Abaakouk<br>
> > mail: <a href="mailto:sileht@sileht.net" target="_blank">sileht@sileht.net</a><br>
> > irc: sileht<br>
> ><br>
> > __________________________________________________________________________<br>
> > OpenStack Development Mailing List (not for usage questions)<br>
> > Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
> ><br>
><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
><br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div>