diff --git a/installing/installing_vsphere/installing-restricted-networks-vsphere.adoc b/installing/installing_vsphere/installing-restricted-networks-vsphere.adoc index 855c44946ac6..c329520922d9 100644 --- a/installing/installing_vsphere/installing-restricted-networks-vsphere.adoc +++ b/installing/installing_vsphere/installing-restricted-networks-vsphere.adoc @@ -80,6 +80,8 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3] include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3] +For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere]. + include::modules/installation-complete-user-infra.adoc[leveloffset=+1] diff --git a/installing/installing_vsphere/installing-vsphere-network-customizations.adoc b/installing/installing_vsphere/installing-vsphere-network-customizations.adoc index 69a9e7f43b76..46769226fb5b 100644 --- a/installing/installing_vsphere/installing-vsphere-network-customizations.adoc +++ b/installing/installing_vsphere/installing-vsphere-network-customizations.adoc @@ -71,6 +71,8 @@ include::modules/registry-removed.adoc[leveloffset=+2] include::modules/installation-registry-storage-config.adoc[leveloffset=+2] +For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere]. + include::modules/installation-complete-user-infra.adoc[leveloffset=+1] diff --git a/installing/installing_vsphere/installing-vsphere.adoc b/installing/installing_vsphere/installing-vsphere.adoc index 59dbf1039bbd..3c4efb4182e1 100644 --- a/installing/installing_vsphere/installing-vsphere.adoc +++ b/installing/installing_vsphere/installing-vsphere.adoc @@ -73,6 +73,10 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+3] include::modules/installation-registry-storage-non-production.adoc[leveloffset=+3] +include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+3] + +For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere]. + include::modules/installation-complete-user-infra.adoc[leveloffset=+1] diff --git a/modules/installation-registry-storage-block-recreate-rollout.adoc b/modules/installation-registry-storage-block-recreate-rollout.adoc new file mode 100644 index 000000000000..9c34c8fe2046 --- /dev/null +++ b/modules/installation-registry-storage-block-recreate-rollout.adoc @@ -0,0 +1,23 @@ +// Module included in the following assemblies: +// +// * installing/installing_vsphere/installing-restricted-networks-vsphere.adoc +// * installing/installing_vsphere/installing-vsphere-network-customizations.adoc +// * installing/installing_vsphere/installing-vsphere.adoc +// * registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc + +[id="installation-registry-storage-block-recreate-rollout_{context}"] += Configuring block registry storage for VMware vSphere + +To allow the image registry to use block storage types such as vSphere Virtual Machine Disk (VMDK) during upgrades as a cluster administrator, you can use the `Recreate` rollout strategy. + +.Procedure + +. To set the image registry storage as a block storage type, patch the registry so that it uses the `Recreate` rollout strategy and runs with only `1` replica: ++ +---- +$ oc patch config.imageregistry.operator.openshift.io/cluster --type=merge -p '{"spec":{"rolloutStrategy":"Recreate","replicas":1}}' +---- ++ +. Provision the PV for the block storage device, and create a PVC for that volume. The requested block volume uses the ReadWriteOnce (RWO) access mode. ++ +. Edit the registry configuration so that it references the correct PVC. diff --git a/registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc b/registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc index 340bf96d5765..0ad97db60f01 100644 --- a/registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc +++ b/registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc @@ -14,6 +14,10 @@ include::modules/registry-configuring-storage-vsphere.adoc[leveloffset=+1] include::modules/installation-registry-storage-non-production.adoc[leveloffset=+1] +include::modules/installation-registry-storage-block-recreate-rollout.adoc[leveloffset=+1] + +For instructions about configuring registry storage so that it references the correct PVC, see xref:../../registry/configuring_registry_storage/configuring-registry-storage-vsphere.adoc#configuring-registry-storage-vsphere[Configuring the registry for vSphere]. + [id="configuring-registry-storage-vsphere-addtl-resources"] == Additional resources