CLI reference of networking commands should be generated from OSC

Bug #1675840 reported by Akihiro Motoki
16
This bug affects 3 people
Affects Status Importance Assigned to Milestone
neutron
Confirmed
Undecided
Unassigned
openstack-manuals
Won't Fix
Medium
fupingxie

Bug Description

Networking commands in CLI reference uses neutron CLI output.

neutron CLI is now deprecated in Ocata release.
OSC migration is almost completed and is expected to completed in Pike cycle.
The migration should happen in Pike cycle.

-----------------------------------
Release: 15.0.0 on 2017-03-24 13:52
SHA: bb9ac4d9554c8359a75a32974f52c228f4600831
Source: https://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/cli-reference/source/neutron.rst
URL: https://docs.openstack.org/cli-reference/neutron.html

yanxubin (yanxubin)
Changed in openstack-manuals:
assignee: nobody → yanxubin (yanxubin)
Lana (loquacity)
Changed in openstack-manuals:
status: New → Triaged
fupingxie (fpxie)
Changed in openstack-manuals:
assignee: yanxubin (yanxubin) → fupingxie (fpxie)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/449505
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=bb51fc3b98950be45c1218df4dd4ca648aaba757
Submitter: Jenkins
Branch: master

commit bb51fc3b98950be45c1218df4dd4ca648aaba757
Author: fpxie <email address hidden>
Date: Fri Mar 24 17:00:30 2017 +0800

    Use the OpenStackClient cmd instead of neutron cmd

    Try to use the OpenStackClient(OSC) command instead of all neutron
    command. If OSC command can not be found, then use neutron command. Up to
    now, the commad "neutron ext-show quotas" and "neutron quota-delete" can
    not be replaced with OSC command.

    Change-Id: I629573b5e41d2540cf7e263c88855c5496eb9ca6
    Implements: blueprint use-openstack-command
    Related-Bug: #1675840

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix proposed to openstack-manuals (master)

Related fix proposed to branch: master
Review: https://review.openstack.org/454584

fupingxie (fpxie)
Changed in openstack-manuals:
status: Triaged → Fix Released
Revision history for this message
Akihiro Motoki (amotoki) wrote :

My original intention is that openstack-manuals should mention that neutron CLI is deprecated and it is recommended to use OSC CLI.

This bug is marked as Fix Released but I don't see any clear guide in "Networking commands in CLI reference".

Changed in openstack-manuals:
status: Fix Released → Confirmed
status: Confirmed → New
Revision history for this message
Akihiro Motoki (amotoki) wrote :

Reset the score to New.

Revision history for this message
Akihiro Motoki (amotoki) wrote :

Hopefully the Networking commands in CLI reference will cover networking commands provided as OSC plugin via python-neutronclient.

python-neutronclient OSC plugin commands covers and will cover advanced networking services.
Commands support for all new features related to neutron stadium will be provided thru OSC and neutronclient OSC plugins.
I believe the CLI reference generation itself needs to be updated.

At now, Networking commands in CLI reference do not cover:
- neutron trunk
- FWaaS v2 (neutron-fwaas)
- neutron-dynamic-routing
and more commands will be added as OSC plugin.

Changed in openstack-manuals:
status: New → Confirmed
importance: Undecided → Medium
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Related fix merged to openstack-manuals (master)

Reviewed: https://review.openstack.org/454584
Committed: https://git.openstack.org/cgit/openstack/openstack-manuals/commit/?id=348c0c0e9aeeed861160150ad33b440c1c8c9df9
Submitter: Jenkins
Branch: master

commit 348c0c0e9aeeed861160150ad33b440c1c8c9df9
Author: chenxing <chen.xing@99cloud.net>
Date: Fri Apr 7 07:45:07 2017 +0000

    [admin-guide] Use the OpenStackClient(OSC) command

    Change-Id: Idbbe09db0450107c4372608aea918d134e224a91
    Implements: blueprint use-openstack-command
    Related-Bug: #1675840

Ben Silverman (tersian)
Changed in openstack-manuals:
status: Confirmed → Won't Fix
Revision history for this message
Boden R (boden) wrote :

We probably can keep this open to track the fact that we need to update CLI ref, but as we know we can't remove support for neutronclient without addressing our current gaps: http://lists.openstack.org/pipermail/openstack-dev/2017-October/123133.html

Changed in neutron:
status: New → Confirmed
tags: added: doc
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.