glance CLI documentation doesn't include v2 commands

Bug #1367430 reported by Travis Tripp
12
This bug affects 1 person
Affects Status Importance Assigned to Milestone
openstack-manuals
Fix Released
Medium
Andreas Jaeger

Bug Description

In, "OpenStack Command-Line Interface Reference", it says it is automatically generated from python-glanceclient help.

The commands are based on the v1 api. If you do

glance --os-image-api-version 2 help

Then you get the additional v2 commands available.

See:

ttripp@ubuntu:~$ glance --os-image-api-version 2 help

Command-line interface to the OpenStack Images API.

Positional arguments:
  <subcommand>
    explain Describe a specific model.
    image-create Create a new image.
    image-delete Delete specified image.
    image-download Download a specific image.
    image-list List images you can access.
    image-show Describe a specific image.
    image-tag-delete Delete the tag associated with the given image.
    image-tag-update Update an image with the given tag.
    image-update Update an existing image.
    image-upload Upload data for a specific image.
    location-add Add a location (and related metadata) to an image.
    location-delete Remove locations (and related metadata) from an image.
    location-update Update metadata of an image's location.
    md-namespace-create
                        Create a new metadata definitions namespace.
    md-namespace-delete
                        Delete specified metadata definitions namespace with
                        its contents.
    md-namespace-import
                        Import a metadata definitions namespace from file or
                        standard input.
    md-namespace-list List metadata definitions namespaces.
    md-namespace-objects-delete
                        Delete all metadata definitions objects inside a
                        specific namespace.
    md-namespace-properties-delete
                        Delete all metadata definitions property inside a
                        specific namespace.
    md-namespace-resource-type-list
                        List resource types associated to specific namespace.
    md-namespace-show Describe a specific metadata definitions namespace.
    md-namespace-update
                        Update an existing metadata definitions namespace.
    md-object-create Create a new metadata definitions object inside a
                        namespace.
    md-object-delete Delete a specific metadata definitions object inside a
                        namespace.
    md-object-list List metadata definitions objects inside a specific
                        namespace.
    md-object-property-show
                        Describe a specific metadata definitions property
                        inside an object.
    md-object-show Describe a specific metadata definitions object inside
                        a namespace.
    md-object-update Update metadata definitions object inside a namespace.
    md-property-create Create a new metadata definitions property inside a
                        namespace.
    md-property-delete Delete a specific metadata definitions property inside
                        a namespace.
    md-property-list List metadata definitions properties inside a specific
                        namespace.
    md-property-show Describe a specific metadata definitions property
                        inside a namespace.
    md-property-update Update metadata definitions property inside a
                        namespace.
    md-resource-type-associate
                        Associate resource type with a metadata definitions
                        namespace.
    md-resource-type-deassociate
                        Deassociate resource type with a metadata definitions
                        namespace.
    md-resource-type-list
                        List available resource type names.
    member-create Create member for a given image.
    member-delete Delete image member.
    member-list Describe sharing permissions by image.
    member-update Update the status of a member for a given image.
    help Display help about this program or one of its
                        subcommands.

Revision history for this message
Andreas Jaeger (jaegerandi) wrote :

Our tool needs to be enhanced to generate the v2 information as well.

Changed in openstack-manuals:
importance: Undecided → Medium
status: New → Confirmed
Changed in openstack-manuals:
assignee: nobody → Andreas Jaeger (jaegerandi)
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-doc-tools (master)

Fix proposed to branch: master
Review: https://review.openstack.org/120248

Changed in openstack-manuals:
status: Confirmed → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to openstack-manuals (master)

Fix proposed to branch: master
Review: https://review.openstack.org/120249

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-manuals (master)

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

commit b5e80646a0ae749b4d4e6263c936344e700eee69
Author: Andreas Jaeger <email address hidden>
Date: Tue Sep 9 23:39:13 2014 +0200

    CLI Reference: Regenerate glance commands (incl. v2)

    Regenerate with fixed openstack-auto-commands to document also v2
    commands. Now v1 and v2 are in two different sections.

    Change-Id: I378b3c8a9fd8691c504e85cd8b850672a6ee09b0
    Partial-Bug: #1367430

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to openstack-doc-tools (master)

Reviewed: https://review.openstack.org/120248
Committed: https://git.openstack.org/cgit/openstack/openstack-doc-tools/commit/?id=a2824e109c89831360b5b35245c6c5a656f3dd59
Submitter: Jenkins
Branch: master

commit a2824e109c89831360b5b35245c6c5a656f3dd59
Author: Andreas Jaeger <email address hidden>
Date: Tue Sep 9 23:36:41 2014 +0200

    Document glance v2 commands

    The glance v2 commands need to be called as:
    glance -os-image-api-version 2 CMD

    Implement logic for this and enhance output.
    Closes-Bug: #1367430

    Change-Id: Ibc81d49494a203c9c8f469a2a0f93e4c1786af7e

Changed in openstack-manuals:
status: In Progress → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

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