Merge pull request #32673 from abrennan89/integratedreg

[srvls][SRVOCF-278] Add OpenShift registry docs

Author: abrennan89

_topic_map.yml

@@ -2963,10 +2963,10 @@ Topics:
 #  Topics:
 #  - Name: About OpenShift Serverless Functions
 #    File: serverless-functions-about
-#  - Name: Getting started
-#    File: serverless-functions-getting-started
 #  - Name: Setting up OpenShift Serverless Functions
 #    File: serverless-functions-setup
+#  - Name: Getting started with functions
+#    File: serverless-functions-getting-started
 #  - Name: Developing Node.js functions
 #    File: serverless-developing-nodejs-functions
 #  - Name: Developing Golang functions

modules/serverless-functions-using-integrated-registry.adoc

@@ -0,0 +1,24 @@
+// Module included in the following assemblies:
+//
+// * serverless/serverless-functions-setup.adoc
+
+[id="serverless-functions-using-integrated-registry_{context}"]
+= Building and deploying functions with OpenShift Container Registry
+
+When building and deploying functions, the resulting container image is stored in an image registry. Usually this will be a public registry, such as Quay. However, you can use the integrated OpenShift Container Registry instead if it has been exposed by a cluster administrator.
+
+.Procedure
+
+* Run the `kn func build` command, or the `kn func deploy` command, with the OpenShift Container Registry specified for the `-r` parameter:
++
+.Example build command
+[source,terminal]
+----
+$ kn func build -r $(oc get route -n openshift-image-registry)
+----
++
+.Example deploy command
+[source,terminal]
+----
+$ kn func deploy -r $(oc get route -n openshift-image-registry)
+----

serverless/functions/serverless-functions-about.adoc

@@ -28,4 +28,4 @@ The `kn func` CLI is provided as a plug-in for the Knative `kn` CLI. {FunctionsP
 [id="next-steps_serverless-functions-about"]
 == Next steps
 
-* See xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-functions-getting-started[Getting started].
+* See xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-functions-getting-started[Getting started with functions].

serverless/functions/serverless-functions-getting-started.adoc

@@ -1,6 +1,6 @@
 include::modules/serverless-document-attributes.adoc[]
 [id="serverless-functions-getting-started"]
-= Getting started
+= Getting started with functions
 :context: serverless-functions-getting-started
 include::modules/common-attributes.adoc[]
 
@@ -20,3 +20,4 @@ Before you can complete the following procedures, you must ensure that you have
 include::modules/serverless-create-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-build-func-kn.adoc[leveloffset=+1]
 include::modules/serverless-deploy-func-kn.adoc[leveloffset=+1]
+include::modules/serverless-functions-using-integrated-registry.adoc[leveloffset=+1]

serverless/functions/serverless-functions-setup.adoc

@@ -20,12 +20,13 @@ To enable the use of {FunctionsProductName} on your cluster, you must complete t
 * The xref:../../cli_reference/openshift_cli/getting-started-cli.adoc#cli-getting-started[`oc` CLI] is installed on your cluster.
 * The xref:../../serverless/installing-kn.adoc#installing-kn[Knative (`kn`) CLI] is installed on your cluster. Installing the `kn` CLI enables the use of `kn func` commands which you can use to create and manage functions.
 * You have installed Docker Container Engine or podman, and have access to an available image registry.
-* If you are using https://quay.io/[Quay.io] as the image registry, you must ensure that either the repository is not private, or that you have followed the {product-title} documentation on xref:../../openshift_images/managing_images/using-image-pull-secrets.adoc#images-allow-pods-to-reference-images-from-secure-registries_using-image-pull-secrets[Allowing pods to reference images from other secured registries].
+* If you are using link:https://quay.io/[Quay.io] as the image registry, you must ensure that either the repository is not private, or that you have followed the {product-title} documentation on xref:../../openshift_images/managing_images/using-image-pull-secrets.adoc#images-allow-pods-to-reference-images-from-secure-registries_using-image-pull-secrets[Allowing pods to reference images from other secured registries].
+* If you are using the OpenShift Container Registry, a cluster administrator must xref:../../registry/securing-exposing-registry.adoc#securing-exposing-registry[expose the registry].
 
 include::modules/serverless-functions-podman.adoc[leveloffset=+1]
 
 [id="next-steps_serverless-functions-setup"]
 == Next steps
 
 * For more information about Docker Container Engine or podman, see xref:../../architecture/understanding-development.adoc#container-build-tool-options[Container build tool options].
-* See xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-functions-getting-started[Getting started with {FunctionsProductName}].
+* See xref:../../serverless/functions/serverless-functions-getting-started.adoc#serverless-functions-getting-started[Getting started with functions].