Bug 1327308 - [DOCS] Docs barely make reference to the ability to specify PV by name [NEEDINFO]
Summary: [DOCS] Docs barely make reference to the ability to specify PV by name
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.1.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: ---
Assignee: Adela
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
: 1276084 (view as bug list)
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2016-04-14 18:03 UTC by Eric Jones
Modified: 2019-10-10 11:52 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-08-23 18:13:18 UTC
Target Upstream Version:
tnguyen: needinfo? (bvincell)


Attachments (Terms of Use)

Description Eric Jones 2016-04-14 18:03:27 UTC
Document URL: 
[0] https://docs.openshift.com/enterprise/3.0/dev_guide/persistent_volumes.html
[1] https://docs.openshift.com/enterprise/3.1/rest_api/kubernetes_v1.html#v1-persistentvolumeclaimspec

Section Number and Name: 
[0] Using Persistent Volumes
[1] PersistentVolumeClaimSpec

Describe the issue: 
Doc [1] makes reference to all three of the variables you can use when making a PVC. [0] describes PVC and includes examples but only makes use of 2/3 of the variables. 

Suggestions for improvement: 
The only place to find the `volumeName` variable is in [1] when it should also be found in [0].

Comment 1 Brennan Vincello 2016-04-15 01:14:34 UTC
Pull requested a fix, Adds volumeName and fixes link #1907 https://github.com/openshift/openshift-docs/pull/1907

Comment 2 Brennan Vincello 2016-04-16 03:14:27 UTC
Duplicate fix for 3.1, Adds volumeName #1910 https://github.com/openshift/openshift-docs/pull/1910

Comment 3 Ryan Howe 2016-04-18 22:17:35 UTC
Defining pvc.Spec.VolumeName does not guarantee PVC get bound to PV. 
 
See bug 
    https://bugzilla.redhat.com/show_bug.cgi?id=1328278

Comment 4 Ashley Hardin 2016-06-02 14:50:13 UTC
*** Bug 1276084 has been marked as a duplicate of this bug. ***

Comment 6 Thien-Thi Nguyen 2016-06-02 16:07:47 UTC
Brennan,
Thanks for your patience on this BZ.  I think https://github.com/openshift/openshift-docs/pull/1907 is on the brink of merge (just a small nit to fix), but https://github.com/openshift/openshift-docs/pull/1910 needs to be closed and a new one open that targets branch 'master'.  WDYT?

Comment 7 Thien-Thi Nguyen 2016-08-02 16:05:41 UTC
This BZ is satisfied by two commits on branch ‘enterprise-3.0’:
3f38668132397e8bafdebdbd27744239660e41f9
71fb66d0ea55b5e023f9cb035ef7edd28ad0f341
and the PR on branch ‘master’ (to be cherry-picked to branches ‘enterprise-3.1’, ‘enterprise-3.2’, ‘dedicated-3.2’, ‘online’):
https://github.com/openshift/openshift-docs/pull/2597

The original PRs (1907, 1910) have been closed.

Moving status to RELEASE_PENDING.


Note You need to log in before you can comment on or make changes to this bug.