Networking service in neutron - install guide says to configure nova with [neutron]/url which is deprecated

[Matt Riedemann]

- [x] This doc is inaccurate in this way:

The [neutron]/url option https://docs.openstack.org/nova/latest/configuration/config.html#neutron.url in nova has been deprecated since the Queens release and is being removed in Train. The neutron/compute config guide in the neutron install guides still says to use the url option though. Since Queens when nova started using KSA adapters for working with neutron config:

https://review.opendev.org/#/c/509892/

I think we want to avoid configuring the [neutron] section in nova.conf with url or endpoint_override but install rely on KSA to use the service types authority to find the endpoint to use based on service name/type and interface, in other words things should just work without needing to explicitly define an endpoint url to use for nova talking to neutron - nova can go through KSA and the service catalog to get the endpoint it needs.

-----------------------------------
Release: 14.1.0.dev665 on 2017-06-30 05:58:47
SHA: 490471ebd3ac56d0cee164b9c1c1211687e49437
Source: https://opendev.org/openstack/neutron/src/doc/source/install/index.rst
URL: https://docs.openstack.org/neutron/latest/install/

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.opendev.org/677810

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/677810
Committed: https://git.openstack.org/cgit/openstack/neutron/commit/?id=e8653f28dee5044b943c4ca1ee0329e0bd7b34d2
Submitter: Zuul
Branch: master

commit e8653f28dee5044b943c4ca1ee0329e0bd7b34d2
Author: Matt Riedemann <email address hidden>
Date: Wed Aug 21 16:09:09 2019 -0400

    doc: remove deprecated [neutron]/url from compute install guide

    The nova [neutron]/url config option was deprecated in Queens [1]
    and is being removed in Train [2]. The neutron install guide
    sections about configuring compute to work with neutron were still
    using the url option so this change removes them. There are a few
    things to note here:

    1. The url option functionality is replaced with the endpoint_override
       option from keystoneauth1 but we don't really want users using that
       unless there is a real need. One of the main reasons for moving the
       nova configuration to use keystoneauth1 was so that the network
       service endpoint can be looked up via KSA dynamically based on the
       configurable interfaces (public, internal, private) and service types
       authority so the endpoint URL will just be pulled from the service
       catalog. That means not having to hard-code the endpoint URL in nova
       config which makes deployment and config management simpler. As such,
       the url option removed in the install guide here is not replaced with
       the endpoint_override option.

    2. Following on #1, the install guide portion about the nova/neutron config
       is updated with a link back to the nova config guide for the full set
       of options in case an operator needs to tweak the config, e.g. to set
       valid_interfaces or endpoint_override because the KSA defaults don't work
       for their deployment.

    3. With the old url option, if region_name was not specified, nova would
       default to 'RegionOne'. That is not the case if not using the url option
       so we leave the region_one config in the install guide example, otherwise
       region_name would default to None.

    [1] I41724a612a5f3eabd504f3eaa9d2f9d141ca3f69
    [2] I6c068a84c4c0bd88f088f9328d7897bfc1f843f1

    Change-Id: I30445edeb8509330571db28c7d61dd63886e9e61
    Closes-Bug: #1840930

[OpenStack Infra (hudson-openstack)]

This issue was fixed in the openstack/neutron 15.0.0.0b1 development milestone.