Bug 1277029 - Steps for creating a PV and PVS not mentioned while having a registry use a persistent storage like NFS
Summary: Steps for creating a PV and PVS not mentioned while having a registry use a p...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 3.0.0
Hardware: Unspecified
OS: Unspecified
urgent
medium
Target Milestone: ---
: ---
Assignee: brice
QA Contact: Vikram Goyal
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-11-02 06:07 UTC by Miheer Salunke
Modified: 2019-09-12 09:12 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-12-14 00:43:21 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Miheer Salunke 2015-11-02 06:07:13 UTC
Document URL: https://docs.openshift.com/enterprise/3.0/install_config/install/docker_registry.html#storage-for-the-registry

Section Number and Name: Storage for the Registry

Describe the issue: 

https://docs.openshift.com/enterprise/3.0/install_config/install/docker_registry.html#storage-for-the-registry

The preceding paragraph to the command([1] : $ oc volume deploymentconfigs/docker-registry \ --add --overwrite --name=registry-storage --mount-path=/registry \ --source='{"nfs": { "server": "<fqdn>", "path": "/path/to/export"}}') says:

---
For production use, you should attach a remote volume or use persistent storage using PersistentVolume and PersistentVolumeClaim objects for storage for the registry. For example, to attach an existing NFS volume to the registry once it has been defined:
---

But then the command does not show using a PV/PVC. 


Suggestions for improvement: 
You need to mention steps for pv and pvc.
https://github.com/openshift/training/blob/master/07-Registry-and-Storage.md

Additional information:

Comment 2 brice 2015-11-30 05:45:12 UTC
Miheer, I have created a PR for this BZ:

https://github.com/openshift/openshift-docs/pull/1273

In your opinion, does this PR satisfy this BZ? Thanks.

Comment 3 Alex Dellapenta 2015-11-30 17:04:28 UTC
I believe the issue is mainly with the "oc volume" command using --source (a JSON string) instead of --claim-name (a PVC). See:

https://github.com/openshift/training/blob/master/07-Registry-and-Storage.md#attach-the-volume-to-the-registry

oc volume usage: 
https://docs.openshift.com/enterprise/latest/dev_guide/volumes.html

Discusses creating PVCs: 
https://docs.openshift.com/enterprise/latest/dev_guide/persistent_volumes.html

Comment 4 brice 2015-12-02 04:55:17 UTC
Alex, ok. I think I get it. 

Miheer, I've added an example for adding pvcs as well:

https://github.com/bfallonf/openshift-docs/blob/BZ1277029/install_config/install/docker_registry.adoc#storage-for-the-registry

Miheer, is this closer to what you asked for?

Comment 5 Miheer Salunke 2015-12-02 07:06:55 UTC
Hi Brice,

Yes it looks good.

Thanks and regards,
Miheer Salunke

Comment 6 brice 2015-12-03 05:11:31 UTC
Miheer,

Thanks for that. PR is onto peer review.

B

Comment 7 openshift-github-bot 2015-12-07 01:00:30 UTC
Commit pushed to master at https://github.com/openshift/openshift-docs

https://github.com/openshift/openshift-docs/commit/f281a5afa0096d50b57ea12458d0d20e6c1b022e
Merge pull request #1273 from bfallonf/BZ1277029

[peer review] Bug 1277029: edit link to storage options


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