Merge pull request #42307 from abrennan89/OSD3

SRVCOM-1451: Add serving, security, support, additional admin docs for OSD

Author: abrennan89

_topic_maps/_topic_map_osd.yml

@@ -207,105 +207,133 @@ Topics:
 - Name: Update life cycle
   File: osd-life-cycle
 # serverless commented out til 1.21.0 release
-#---
-#Name: Serverless
-#Dir: serverless
-#Distros: openshift-dedicated
-#Topics:
-#- Name: Release notes
-#  File: serverless-release-notes
-#- Name: Discover
-#  Dir: discover
-#  Topics:
-#  - Name: About OpenShift Serverless
-#    File: about-serverless
-#  - Name: About OpenShift Serverless Functions
-#    File: serverless-functions-about
-#  - Name: Event sources
-#    File: knative-event-sources
-#  - Name: Channels and subscriptions
-#    File: serverless-channels
-#- Name: Install
-#  Dir: install
-#  Topics:
-#  - Name: Installing the OpenShift Serverless Operator
-#    File: install-serverless-operator
-#  - Name: Installing Knative Serving
-#    File: installing-knative-serving
-#  - Name: Installing Knative Eventing
-#    File: installing-knative-eventing
-#  - Name: Removing OpenShift Serverless
-#    File: removing-openshift-serverless
-#- Name: Develop
-#  Dir: develop
-#  Topics:
-#  - Name: Event sinks
-#    File: serverless-event-sinks
-#  - Name: Event delivery
-#    File: serverless-event-delivery
-#  - Name: Creating an API server source
-#    File: serverless-apiserversource
-#  - Name: Creating a ping source
-#    File: serverless-pingsource
-#  - File: serverless-custom-event-sources
-#    Name: Custom event sources
-#  - Name: Creating channels
-#    File: serverless-creating-channels
-#  - Name: Creating subscriptions
-#    File: serverless-subs
-# Brokers
-#  - Name: Brokers
-#    File: serverless-using-brokers
-# Triggers
-#  - Name: Triggers
-#    File: serverless-triggers
-#  - Name: Knative Kafka
-#    File: serverless-kafka-developer
-# Admin guide
-#- Name: Administer
-#  Dir: admin_guide
-#  Topics:
-#  - Name: Configuring Knative Eventing defaults
-#    File: serverless-configuring-eventing-defaults
-#  - Name: Knative Kafka
-#    File: serverless-kafka-admin
-#  - Name: High availability on OpenShift Serverless
-#    File: serverless-ha
-# Functions
-#- Name: Functions
-#  Dir: functions
-#  Topics:
-#  - 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 TypeScript functions
-#    File: serverless-developing-typescript-functions
-#  - Name: Developing Golang functions
-#    File: serverless-developing-go-functions
-#  - Name: Developing Python functions
-#    File: serverless-developing-python-functions
-#  - Name: Developing Quarkus functions
-#    File: serverless-developing-quarkus-functions
-#  - Name: Using functions with Knative Eventing
-#    File: serverless-functions-eventing
-#  - Name: Function project configuration in func.yaml
-#    File: serverless-functions-yaml
-#  - Name: Accessing secrets and config maps from functions
-#    File: serverless-functions-accessing-secrets-configmaps
-#  - Name: Adding annotations to functions
-#    File: serverless-functions-annotations
-#  - Name: Functions development reference guide
-#    File: serverless-functions-reference-guide
-#- Name: CLI tools
-#  Dir: cli_tools
-#  Topics:
-#  - Name: Installing the Knative CLI
-#    File: installing-kn
-#  - Name: Knative CLI advanced configuration
-#    File: advanced-kn-config
+# ---
+# Name: Serverless
+# Dir: serverless
+# Distros: openshift-dedicated
+# Topics:
+# - Name: Release notes
+#   File: serverless-release-notes
+# - Name: Discover
+#   Dir: discover
+#   Topics:
+#   - Name: About OpenShift Serverless
+#     File: about-serverless
+#   - Name: About OpenShift Serverless Functions
+#     File: serverless-functions-about
+#   - Name: Event sources
+#     File: knative-event-sources
+#   - Name: Channels and subscriptions
+#     File: serverless-channels
+# - Name: Install
+#   Dir: install
+#   Topics:
+#   - Name: Installing the OpenShift Serverless Operator
+#     File: install-serverless-operator
+#   - Name: Installing Knative Serving
+#     File: installing-knative-serving
+#   - Name: Installing Knative Eventing
+#     File: installing-knative-eventing
+#   - Name: Removing OpenShift Serverless
+#     File: removing-openshift-serverless
+# - Name: Develop
+#   Dir: develop
+#   Topics:
+#   - Name: Serverless applications
+#     File: serverless-applications
+#   - Name: Autoscaling
+#     File: serverless-autoscaling-developer
+#   - Name: Traffic management
+#     File: serverless-traffic-management
+#   - Name: Routing
+#     File: serverless-configuring-routes
+#   - Name: Event sinks
+#     File: serverless-event-sinks
+#   - Name: Event delivery
+#     File: serverless-event-delivery
+#   - Name: Creating an API server source
+#     File: serverless-apiserversource
+#   - Name: Creating a ping source
+#     File: serverless-pingsource
+#   - File: serverless-custom-event-sources
+#     Name: Custom event sources
+#   - Name: Creating channels
+#     File: serverless-creating-channels
+#   - Name: Creating subscriptions
+#     File: serverless-subs
+#   - Name: Brokers
+#     File: serverless-using-brokers
+#   - Name: Triggers
+#     File: serverless-triggers
+#   - Name: Knative Kafka
+#     File: serverless-kafka-developer
+# # Admin guide
+# - Name: Administer
+#   Dir: admin_guide
+#   Topics:
+#   - Name: Configuring OpenShift Serverless
+#     File: serverless-configuration
+#   - Name: Configuring Knative Eventing defaults
+#     File: serverless-configuring-eventing-defaults
+#   - Name: Knative Kafka
+#     File: serverless-kafka-admin
+#   - Name: Creating Knative Eventing components in the Administrator perspective
+#     File: serverless-cluster-admin-eventing
+#   - Name: Creating Knative Serving components in the Administrator perspective
+#     File: serverless-cluster-admin-serving
+#   - Name: Configuring the Knative Serving custom resource
+#     File: knative-serving-CR-config
+#   - Name: Autoscaling
+#     File: serverless-admin-autoscaling
+#   - Name: High availability on OpenShift Serverless
+#     File: serverless-ha
+# - Name: Support
+#   File: serverless-support
+# - Name: Security
+#   Dir: security
+#   Topics:
+#   - Name: Configuring JSON Web Token authentication for Knative services
+#     File: serverless-ossm-with-kourier-jwt
+#   - Name: Configuring a custom domain for a Knative service
+#     File: serverless-custom-domains
+#   - Name: Using a custom TLS certificate for domain mapping
+#     File: serverless-custom-tls-cert-domain-mapping
+#   - Name: Security configuration for Knative Kafka
+#     File: serverless-kafka-security
+# - Name: Functions
+#   Dir: functions
+#   Topics:
+#   - 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 TypeScript functions
+#     File: serverless-developing-typescript-functions
+#   - Name: Developing Golang functions
+#     File: serverless-developing-go-functions
+#   - Name: Developing Python functions
+#     File: serverless-developing-python-functions
+#   - Name: Developing Quarkus functions
+#     File: serverless-developing-quarkus-functions
+#   - Name: Using functions with Knative Eventing
+#     File: serverless-functions-eventing
+#   - Name: Function project configuration in func.yaml
+#     File: serverless-functions-yaml
+#   - Name: Accessing secrets and config maps from functions
+#     File: serverless-functions-accessing-secrets-configmaps
+#   - Name: Adding annotations to functions
+#     File: serverless-functions-annotations
+#   - Name: Functions development reference guide
+#     File: serverless-functions-reference-guide
+# - Name: CLI tools
+#   Dir: cli_tools
+#   Topics:
+#   - Name: Installing the Knative CLI
+#     File: installing-kn
+#   - Name: Knative CLI advanced configuration
+#     File: advanced-kn-config
 ---
 Name: Support
 Dir: support

modules/serverless-creating-broker-admin-web-console.adoc

@@ -6,12 +6,25 @@
 [id="serverless-creating-broker-admin-web-console_{context}"]
 = Creating a broker by using the Administrator perspective
 
-If you have cluster administrator permissions, you can create a broker by using the Administrator perspective in the web console.
+ifdef::openshift-enterprise[]
+If you have cluster administrator permissions, you can create a broker by using the *Administrator* perspective in the web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions, you can create a broker by using the *Administrator* perspective in the web console.
+endif::[]
 
 .Prerequisites
 
 * The {ServerlessOperatorName} and Knative Eventing are installed on your {product-title} cluster.
+
+ifdef::openshift-enterprise[]
 * You have cluster administrator permissions for {product-title}.
+endif::[]
+
+ifdef::openshift-dedicated[]
+* You have cluster or dedicated administrator permissions for {product-title}.
+endif::[]
 
 .Procedure
 

modules/serverless-creating-channel-admin-web-console.adoc

@@ -6,12 +6,25 @@
 [id="serverless-creating-channel-admin-web-console_{context}"]
 = Creating a channel by using the Administrator perspective
 
-If you have cluster administrator permissions, you can create a channel by using the Administrator perspective in the web console.
+ifdef::openshift-enterprise[]
+If you have cluster administrator permissions, you can create a channel by using the *Administrator* perspective in the web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions, you can create a channel by using the *Administrator* perspective in the web console.
+endif::[]
 
 .Prerequisites
 
 * The {ServerlessOperatorName} and Knative Eventing are installed on your {product-title} cluster.
+
+ifdef::openshift-enterprise[]
 * You have cluster administrator permissions for {product-title}.
+endif::[]
+
+ifdef::openshift-dedicated[]
+* You have cluster or dedicated administrator permissions for {product-title}.
+endif::[]
 
 .Procedure
 

modules/serverless-creating-event-source-admin-web-console.adoc

@@ -6,12 +6,25 @@
 [id="serverless-creating-event-source-admin-web-console_{context}"]
 = Creating an event source by using the Administrator perspective
 
-If you have cluster administrator permissions, you can create an event source by using the Administrator perspective in the web console.
+ifdef::openshift-enterprise[]
+If you have cluster administrator permissions, you can create an event source by using the *Administrator* perspective in the web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions, you can create an event source by using the *Administrator* perspective in the web console.
+endif::[]
 
 .Prerequisites
 
 * The {ServerlessOperatorName} and Knative Eventing are installed on your {product-title} cluster.
+
+ifdef::openshift-enterprise[]
 * You have cluster administrator permissions for {product-title}.
+endif::[]
+
+ifdef::openshift-dedicated[]
+* You have cluster or dedicated administrator permissions for {product-title}.
+endif::[]
 
 .Procedure
 

modules/serverless-creating-subscription-admin-web-console.adoc

@@ -6,12 +6,26 @@
 [id="serverless-creating-subscription-admin-web-console_{context}"]
 = Creating a subscription by using the Administrator perspective
 
-If you have cluster administrator permissions and have created a channel, you can create a subscription to connect your broker to a subscriber by using the Administrator perspective in the web console.
+ifdef::openshift-enterprise[]
+If you have cluster administrator permissions and have created a channel, you can create a subscription to connect your broker to a subscriber by using the *Administrator* perspective in the web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions and have created a channel, you can create a subscription to connect your broker to a subscriber by using the *Administrator* perspective in the web console.
+endif::[]
 
 .Prerequisites
 
 * The {ServerlessOperatorName} and Knative Eventing are installed on your {product-title} cluster.
+
+ifdef::openshift-enterprise[]
 * You have cluster administrator permissions for {product-title}.
+endif::[]
+
+ifdef::openshift-dedicated[]
+* You have cluster or dedicated administrator permissions for {product-title}.
+endif::[]
+
 * You have created a channel.
 * You have created a Knative service to use as a subscriber.
 

modules/serverless-creating-trigger-admin-web-console.adoc

@@ -6,12 +6,26 @@
 [id="serverless-creating-trigger-admin-web-console_{context}"]
 = Creating a trigger by using the Administrator perspective
 
-If you have cluster administrator permissions and have created a broker, you can create a trigger to connect your broker to a subscriber by using the Administrator perspective in the web console.
+ifdef::openshift-enterprise[]
+If you have cluster administrator permissions and have created a broker, you can create a trigger to connect your broker to a subscriber by using the *Administrator* perspective in the web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions and have created a broker, you can create a trigger to connect your broker to a subscriber by using the *Administrator* perspective in the web console.
+endif::[]
 
 .Prerequisites
 
 * The {ServerlessOperatorName} and Knative Eventing are installed on your {product-title} cluster.
+
+ifdef::openshift-enterprise[]
 * You have cluster administrator permissions for {product-title}.
+endif::[]
+
+ifdef::openshift-dedicated[]
+* You have cluster or dedicated administrator permissions for {product-title}.
+endif::[]
+
 * You have created a broker.
 * You have created a Knative service to use as a subscriber.
 

modules/serverless-domain-mapping-odc-admin.adoc

@@ -6,7 +6,13 @@
 [id="serverless-domain-mapping-odc-admin_{context}"]
 = Mapping a custom domain to a service by using the Administrator perspective
 
+ifdef::openshift-enterprise[]
 If you have cluster administrator permissions, you can create a `DomainMapping` custom resource (CR) by using the *Administrator* perspective in the {product-title} web console.
+endif::[]
+
+ifdef::openshift-dedicated[]
+If you have cluster or dedicated administrator permissions, you can create a `DomainMapping` custom resource (CR) by using the *Administrator* perspective in the {product-title} web console.
+endif::[]
 
 .Prerequisites