Merge pull request #63779 from stevsmit/OCPBUGS-12892

Updates procedure for manually configuring storage for GCP and Swift

Author: stevsmit

modules/registry-configuring-storage-gcp-user-infra.adoc

@@ -4,10 +4,9 @@
 
 :_content-type: PROCEDURE
 [id="registry-configuring-storage-gcp-user-infra_{context}"]
-= Registry storage for GCP with user-provisioned infrastructure
+= Configuring the registry storage for GCP with user-provisioned infrastructure
 
-You must set up the storage medium manually and configure the settings in the
-registry custom resource (CR).
+If the Registry Operator cannot create a Google Cloud Platform (GCP) bucket, you must set up the storage medium manually and configure the settings in the registry custom resource (CR).
 
 .Prerequisites
 
@@ -18,9 +17,30 @@ cloud credentials.
 contents of a credentials file provided by GCP:
 ** `REGISTRY_STORAGE_GCS_KEYFILE`
 
-
 .Procedure
 
-////
-Stub for procedure to manually set storage medium.
-////
+. Set up an link:https://cloud.google.com/storage/docs/lifecycle[Object Lifecycle Management policy] to abort incomplete multipart uploads that are one day old.
+
+. Fill in the storage configuration in `configs.imageregistry.operator.openshift.io/cluster`:
++
+[source,terminal]
+----
+$ oc edit configs.imageregistry.operator.openshift.io/cluster
+----
++
+.Example configuration
+[source,yaml]
+----
+# ...
+storage:
+  gcs:
+    bucket: <bucket-name>
+    projectID: <project-id>
+    region: <region-name>
+# ...
+----
+
+[WARNING]
+====
+You can secure your registry images that use a Google Cloud Storage bucket by setting link:https://cloud.google.com/storage/docs/using-public-access-prevention[public access prevention].
+====

modules/registry-configuring-storage-openstack-user-infra.adoc

@@ -5,8 +5,7 @@
 [id="registry-configuring-storage-openstack-user-infra_{context}"]
 = Registry storage for {rh-openstack} with user-provisioned infrastructure
 
-You must set up the storage medium manually and configure the settings in the
-registry custom resource (CR).
+If the Registry Operator cannot create a Swift bucket, you must set up the storage medium manually and configure the settings in the registry custom resource (CR).
 
 .Prerequisites
 
@@ -17,3 +16,22 @@ cloud credentials.
 
 ** `REGISTRY_STORAGE_SWIFT_USER`
 ** `REGISTRY_STORAGE_SWIFT_PASSWORD`
+
+.Procedure
+
+* Fill in the storage configuration in `configs.imageregistry.operator.openshift.io/cluster`:
++
+[source,terminal]
+----
+$ oc edit configs.imageregistry.operator.openshift.io/cluster
+----
++
+.Example configuration
+[source,yaml]
+----
+# ...
+storage: 
+  swift:
+    container: <container-id>
+# ...
+----