Bug 1826292 - Missing documentation of how to use ReadWriteOnce volume for internal Image Registry storage.
Summary: Missing documentation of how to use ReadWriteOnce volume for internal Image R...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Documentation
Version: 4.4
Hardware: Unspecified
OS: Unspecified
low
low
Target Milestone: ---
: 4.4.z
Assignee: Bob Furu
QA Contact: Wenjing Zheng
Vikram Goyal
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2020-04-21 11:32 UTC by Robert Bohne
Modified: 2023-12-15 17:44 UTC (History)
8 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2020-07-24 20:35:35 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Robert Bohne 2020-04-21 11:32:08 UTC
Document URL: 
 - https://docs.openshift.com/container-platform/4.4/release_notes/ocp-4-4-release-notes.html
 - https://docs.openshift.com/container-platform/4.4/installing/installing_vsphere/installing-vsphere.html
 Maybe much more...

Section Number and Name: Using ReadWriteOnce volume for internal Image Registry

Describe the issue: 

Since OpenShift 4.4 it is possible to use a ReadWriteOnce volume for internal image registry storage.

Tested in vSphere with:

```
oc create -f - <<EOF
kind: PersistentVolumeClaim
apiVersion: v1
metadata:
  name: image-registry-pvc
  namespace: openshift-image-registry
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 100Gi
  storageClassName: thin
EOF

oc patch configs.imageregistry.operator.openshift.io/cluster \
    --type='json' \
    --patch='[
        {"op": "replace", "path": "/spec/managementState", "value": "Managed"},
        {"op": "replace", "path": "/spec/rolloutStrategy", "value": "Recreate"},
        {"op": "replace", "path": "/spec/replicas", "value": 1},
        {"op": "replace", "path": "/spec/storage", "value": {"pvc":{"claim": "image-registry-pvc" }}}
    ]'

```

By using a ReadWriteOnce volume you have to
    - Change the Rollout Strategy from rolling to recreate and
    - its only supported to have exactly one replica.

That means, during a cluster or image-registry upgrade, your internal registry has downtime between stopping the old pod and starting the new pod!

Suggestions for improvement: 

Add a chapter and support status information. 

Additional information: 
    - https://issues.redhat.com/browse/RFE-489
    - https://issues.redhat.com/browse/DEVEXP-523
    - https://bugzilla.redhat.com/show_bug.cgi?id=1798759

Comment 1 Fatima 2020-06-29 03:26:27 UTC
Hi team,

Any updates here?

Thanks

Comment 2 Masaki Hatada 2020-07-16 11:10:12 UTC
Dear Red Hat,

OCP4.5 manual was already released but it is still not fixed.
When will it be fixed?

You guys are saying in the following doc that NFS should be avoided for image-registry .
https://docs.openshift.com/container-platform/4.5/scalability_and_performance/optimizing-storage.html#specific-application-storage-recommendations

But another page says that user should use NFS for image-registry...
So user will select a storage which Red Hat doesn't recommend actually and data corruption or other problems might occur due to that.
That's a big problem, isn't that?

Best Regards,
Masaki Hatada

Comment 5 Fatima 2020-07-21 10:38:23 UTC
Hi,

Any update here?

Thanks

Comment 6 Bob Furu 2020-07-22 21:35:22 UTC
I have created https://github.com/openshift/openshift-docs/pull/24043 to add the procedure that is outlined in an RFE comment by Adam K. here: https://issues.redhat.com/browse/RFE-489?focusedCommentId=14099892&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#comment-14099892

Moving to ON_QA. Jianwei Hou, PTAL, thanks.

Comment 7 Wenjing Zheng 2020-07-23 06:50:45 UTC
Verified after reviewing the doc.

Comment 8 Bob Furu 2020-07-24 20:35:35 UTC
This content has been reviewed and approved by Eng, QE, and Docs. Content has been merged/CP'ed to 4.4, 4.5, 4.6, and is published in 4.4+. For example: https://docs.openshift.com/container-platform/4.5/installing/installing_vsphere/installing-vsphere-network-customizations.html#installation-registry-storage-config_installing-vsphere-network-customizations

Closing BZ.


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