L7 capability extension implementation for lbaas v2

[OpenStack Infra]

https://review.openstack.org/148232
Dear bug triager. This bug was created since a commit was marked with DOCIMPACT.

commit 254190b3051453f823dbdf1826f1a6b984c57164
Author: Evgeny Fedoruk <email address hidden>
Date: Mon Jan 19 03:47:39 2015 -0800

    L7 capability extension implementation for lbaas v2

    Including extension modifications
    Including db model modifications
    Including alembic migration
    Including new driver managers for l7 rules and policies
    Inclufing logging_noop driver implementation
    Including unit testing
    Including Octavia driver updates

    DocImpact
    APIImpact
    Change-Id: I8f9535ebf28155adf43ebe046d2dbdfa86c4d81b
    Implements: blueprint lbaas-l7-rules
    Co-Authored-By: Evgeny Fedoruk <email address hidden>
    Co-Authored-By: Stephen Balukoff <email address hidden>

[Armando Migliaccio (armando-migliaccio)]

Is there any operator/user documentation to be provided?

[Stephen Balukoff (sbalukoff)]

Yep, we plan on it!

[Joseph Robinson (joseph-r-email)]

Appears to affect the developer docs glossary - http://docs.openstack.org/developer/octavia/main/glossary.html - The security guide on lbaas - http://docs.openstack.org/security-guide/networking/services.html - and the ops guide - http://docs.openstack.org/openstack-ops/content/scaling.html

[Chason Chan (chen-xing)]

@Joseph, can you give me more further information?

[Stephen Balukoff (sbalukoff)]

Xing-- are you going to work on updating this for the openstack manual then? If so, then as far as for more information:

The Octavia project also added this feature that works in essentially the same way (which makes sense given Octavia is the LBaaS v2 reference implementation). The updated API for Octavia describing all the L7 stuff is here: https://github.com/openstack/octavia/blob/master/doc/source/api/octaviaapi.rst

The Neutron API is exactly the same except for the fact that all the object interfaces are top-level interfaces in Neutron-LBaaS.

Further, for a description of how the L7 stuff is intended to work, there is this wiki page: https://wiki.openstack.org/wiki/Neutron/LBaaS/l7

I'm afraid as far as how to use the updated neutron CLI, we don't have any docs written-- your best bet here is to look at the following two files:
https://github.com/openstack/python-neutronclient/blob/master/neutronclient/neutron/v2_0/lb/v2/l7policy.py
https://github.com/openstack/python-neutronclient/blob/master/neutronclient/neutron/v2_0/lb/v2/l7rule.py

Please let me know whether you intend to write these docs, or whether I should do it (as a major contributor to the above code), eh!

[Chason Chan (chen-xing)]

 I find that I cannot complete these docs, Thanks, Stephen.

[Stephen Balukoff (sbalukoff)]

Xing-- I have the knowledge of the new feature, but I have no idea how I go about updating the documentation for this. When I look in the neutron CLI reference in openstack-manual, as well as the API reference, I see a big notice at the top of these files that they are auto-generated. Does that mean I don't have to take any action to update these on my own, that they'll be updated by some automated process?

Also, I was told we are trying to move stuff that's in the wiki (like this: https://wiki.openstack.org/wiki/Neutron/LBaaS/l7 ) into the "official" openstack documentation. I understand that what's on that wiki page is for the most part a user guide... and I know we have several end-user guides. But I have no idea where I should go about inserting this information, especially given the fact that I can't seem to find anything else that is practical on neutron-lbaas in there either.

So if you're not going to do it, could you give me some pointers as to where I should insert this stuff into our OpenStack documentation structure, and how I go about doing it? (I'm very familiar with the gerrit review process, but totally unfamiliar with whatever tools are used to generate this documentation.)

[Atsushi SAKAI (sakaia)]

The API-Ref is changed from doc to each project (neutron)

[Boden R (boden)]

Marking this as incomplete with the following reasoning:
- The openstack-manuals team marked it as invalid and thus don't plan to update the docs/manuals.
- Unless we have someone willing to create/drive the change into the openstack-manuals, I don't see how this will get done.

If we have someone to work on it, please feel free to restore out of invalid state.

[Boden R (boden)]

Actually won't fix seems more fitting.