[doc] Allow configuring availability_zones in share types

Bug #1816486 reported by OpenStack Infra on 2019-02-18
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Shared File Systems Service (Manila)
Medium
Goutham Pacha Ravi

Bug Description

https://review.openstack.org/633155
Dear bug triager. This bug was created since a commit was marked with DOCIMPACT.
Your project "openstack/manila" is set up so that we directly report the documentation bugs against it. If this needs changing, the docimpact-group option needs to be added for the project. You can ask the OpenStack infra team (#openstack-infra on freenode) for help if you need to.

commit 4249e94c6bb7f5efb1a2095c925398277046936d
Author: Goutham Pacha Ravi <email address hidden>
Date: Tue Jan 15 15:44:40 2019 -0800

    Allow configuring availability_zones in share types

    Administrators configure share types and make them
    available to projects within an OpenStack cloud.
    These share types will define capabilities to match
    back-end storage pools that manila provisions shares
    within. Administrators may want to limit share types
    to specific Availability zones, given they may have
    different classes of storage in different availability
    zones in the cloud. A major use case of this is edge
    computing, where, provisioning can be driven to specific
    edge locations with the help of share types.

    This commit will:

    - Introduce 'availability_zones' as a new common share type
      extra spec that is user visible when configured.
    - In and beyond microversion 2.48, validate that the AZ
      chosen in the POST /shares API is supported by the configured
      availability zones for the share type being used.
    - Share types can be filtered by AZs through extra-specs:

      $ manila type-list --extra-specs availability_zone=nova

      now gives you all types that explicitly (and implicitly)
      are supported within the AZ 'nova'.

    - Improve experimental APIs:
      - Add validation of AZ to POST /share-replicas
      - Add validation of AZ to POST /share-groups
      - Add validation of AZ to
        POST /shares/id {'action': 'migration_start'}

    - Also fix old unit tests by using a helper method to
      generate appropriate mock values.

    DocImpact
    Change-Id: Idf274cd73e3b1b33f49668fca768ae676ca30164
    Implements: bp share-type-supported-azs

summary: - Allow configuring availability_zones in share types
+ [doc] Allow configuring availability_zones in share types
Changed in manila:
assignee: nobody → Goutham Pacha Ravi (gouthamr)
Jason Grosso (jgrosso) on 2019-03-22
Changed in manila:
status: New → Incomplete
status: Incomplete → Triaged
importance: Undecided → Medium
Changed in manila:
milestone: none → victoria-3
Changed in manila:
status: Triaged → In Progress
Goutham Pacha Ravi (gouthamr) wrote :

Partial Bug fix proposed: https://review.opendev.org/745234/

Reviewed: https://review.opendev.org/745250
Committed: https://git.openstack.org/cgit/openstack/manila/commit/?id=271214a0511d345a11947531ac4fb41305ba325f
Submitter: Zuul
Branch: master

commit 271214a0511d345a11947531ac4fb41305ba325f
Author: Goutham Pacha Ravi <email address hidden>
Date: Thu Aug 6 17:06:21 2020 -0700

    Update Share types api-ref

    Was missing a query parameter (is_public)
    and some information on an existing query
    parameter (extra-specs)

    Change-Id: Ib70e08c963cf1f583ab6d5fbae6a69aa3593980a
    Closes-Bug: #1816486

Changed in manila:
status: In Progress → Fix Released

Reviewed: https://review.opendev.org/745234
Committed: https://git.openstack.org/cgit/openstack/manila/commit/?id=36a7ec422bf2ff41aeeeff777c81ab83576ce207
Submitter: Zuul
Branch: master

commit 36a7ec422bf2ff41aeeeff777c81ab83576ce207
Author: Goutham Pacha Ravi <email address hidden>
Date: Thu Aug 6 14:23:56 2020 -0700

    Fix documentation for types and extra specs

    Some content in the admin docs was incomplete,
    and irrelevant to administrators.

    Also add notes on a couple of missing common
    capabilities:
    - mount_snapshot_support
    - availability_zones

    Partial-Bug: #1816486
    Change-Id: Ie55fd5bf80ca2ebacdb652c701aa9c213f758963
    Signed-off-by: Goutham Pacha Ravi <email address hidden>

Reviewed: https://review.opendev.org/747504
Committed: https://git.openstack.org/cgit/openstack/manila/commit/?id=b780ef9ef36e7e4bce3fdba8895e445f8d7eb88b
Submitter: Zuul
Branch: stable/ussuri

commit b780ef9ef36e7e4bce3fdba8895e445f8d7eb88b
Author: Goutham Pacha Ravi <email address hidden>
Date: Thu Aug 6 14:23:56 2020 -0700

    Fix documentation for types and extra specs

    Some content in the admin docs was incomplete,
    and irrelevant to administrators.

    Also add notes on a couple of missing common
    capabilities:
    - mount_snapshot_support
    - availability_zones

    Partial-Bug: #1816486
    Change-Id: Ie55fd5bf80ca2ebacdb652c701aa9c213f758963
    Signed-off-by: Goutham Pacha Ravi <email address hidden>
    (cherry picked from commit 36a7ec422bf2ff41aeeeff777c81ab83576ce207)

tags: added: in-stable-ussuri

Reviewed: https://review.opendev.org/747505
Committed: https://git.openstack.org/cgit/openstack/manila/commit/?id=e13af0882e3f133c0c5a8737e61980d34e07f0d1
Submitter: Zuul
Branch: stable/train

commit e13af0882e3f133c0c5a8737e61980d34e07f0d1
Author: Goutham Pacha Ravi <email address hidden>
Date: Thu Aug 6 14:23:56 2020 -0700

    Fix documentation for types and extra specs

    Some content in the admin docs was incomplete,
    and irrelevant to administrators.

    Also add notes on a couple of missing common
    capabilities:
    - mount_snapshot_support
    - availability_zones

    Partial-Bug: #1816486
    Change-Id: Ie55fd5bf80ca2ebacdb652c701aa9c213f758963
    Signed-off-by: Goutham Pacha Ravi <email address hidden>
    (cherry picked from commit 36a7ec422bf2ff41aeeeff777c81ab83576ce207)
    (cherry picked from commit b780ef9ef36e7e4bce3fdba8895e445f8d7eb88b)

tags: added: in-stable-train

Reviewed: https://review.opendev.org/747773
Committed: https://git.openstack.org/cgit/openstack/manila/commit/?id=7ed8f7fac41d5c77ff85265e30b5cf39f048104a
Submitter: Zuul
Branch: stable/stein

commit 7ed8f7fac41d5c77ff85265e30b5cf39f048104a
Author: Goutham Pacha Ravi <email address hidden>
Date: Thu Aug 6 14:23:56 2020 -0700

    Fix documentation for types and extra specs

    Some content in the admin docs was incomplete,
    and irrelevant to administrators.

    Also add notes on a couple of missing common
    capabilities:
    - mount_snapshot_support
    - availability_zones

    Partial-Bug: #1816486
    Change-Id: Ie55fd5bf80ca2ebacdb652c701aa9c213f758963
    Signed-off-by: Goutham Pacha Ravi <email address hidden>
    (cherry picked from commit 36a7ec422bf2ff41aeeeff777c81ab83576ce207)
    (cherry picked from commit b780ef9ef36e7e4bce3fdba8895e445f8d7eb88b)

tags: added: in-stable-stein
To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers