diff --git a/_attributes/attributes-openshift-dedicated.adoc b/_attributes/attributes-openshift-dedicated.adoc index dd253f820c..5cf9d6a299 100644 --- a/_attributes/attributes-openshift-dedicated.adoc +++ b/_attributes/attributes-openshift-dedicated.adoc @@ -7,6 +7,7 @@ :OCP: OpenShift Container Platform :ocp-version: 4.14 :op-system-first: Red Hat Enterprise Linux CoreOS (RHCOS) +:oc-first: pass:quotes[OpenShift CLI (`oc`)] :cluster-manager-first: Red Hat OpenShift Cluster Manager :cluster-manager: OpenShift Cluster Manager :cluster-manager-url: link:https://console.redhat.com/openshift[OpenShift Cluster Manager] diff --git a/modules/nw-autoscaling-ingress-controller.adoc b/modules/nw-autoscaling-ingress-controller.adoc index e9327c9784..1257cb9518 100644 --- a/modules/nw-autoscaling-ingress-controller.adoc +++ b/modules/nw-autoscaling-ingress-controller.adoc @@ -1,18 +1,21 @@ // Module included in the following assemblies: // -// * networking/ingress-controller-configuration.adoc +// * networking/ingress-operator.adoc :_mod-docs-content-type: PROCEDURE [id="nw-autoscaling-ingress-controller_{context}"] = Autoscaling an Ingress Controller -Automatically scale an Ingress Controller to dynamically meet routing performance or availability requirements such as the requirement to increase throughput. The following procedure provides an example for scaling up the default `IngressController`. +You can automatically scale an Ingress Controller to dynamically meet routing performance or availability requirements, such as the requirement to increase throughput. + +The following procedure provides an example for scaling up the default Ingress Controller. .Prerequisites -. You have the OpenShift CLI (`oc`) installed. -. You have access to an {product-title} cluster as a user with the `cluster-admin` role. -. You have the Custom Metrics Autoscaler Operator installed. -. You are in the `openshift-ingress-operator` project namespace. + +* You have the {oc-first} installed. +* You have access to an {product-title} cluster as a user with the `cluster-admin` role. +* You installed the Custom Metrics Autoscaler Operator and an associated KEDA Controller. +** You can install the Operator by using OperatorHub on the web console. After you install the Operator, you can create an instance of `KedaController`. .Procedure @@ -20,7 +23,7 @@ Automatically scale an Ingress Controller to dynamically meet routing performanc + [source,terminal] ---- -$ oc create serviceaccount thanos && oc describe serviceaccount thanos +$ oc create -n openshift-ingress-operator serviceaccount thanos && oc describe -n openshift-ingress-operator serviceaccount thanos ---- + .Example output @@ -30,9 +33,9 @@ Name: thanos Namespace: openshift-ingress-operator Labels: Annotations: -Image pull secrets: thanos-dockercfg-b4l9s -Mountable secrets: thanos-dockercfg-b4l9s -Tokens: thanos-token-c422q +Image pull secrets: thanos-dockercfg-kfvf2 +Mountable secrets: thanos-dockercfg-kfvf2 +Tokens: Events: ---- @@ -50,43 +53,33 @@ apiVersion: v1 kind: Secret metadata: name: thanos-token + namespace: openshift-ingress-operator annotations: kubernetes.io/service-account.name: thanos - type: kubernetes.io/service-account-token +type: kubernetes.io/service-account-token EOF ---- -. Define a `TriggerAuthentication` object within the `openshift-ingress-operator` namespace using the service account's token. - -.. Define the variable `secret` that contains the secret by running the following command: -+ -[source,terminal] ----- -$ secret=$(oc get secret | grep thanos-token | head -n 1 | awk '{ print $1 }') ----- +. Define a `TriggerAuthentication` object within the `openshift-ingress-operator` namespace by using the service account's token. .. Create the `TriggerAuthentication` object and pass the value of the `secret` variable to the `TOKEN` parameter: + [source,terminal] ---- -$ oc process TOKEN="$secret" -f - < apiVersion: operator.openshift.io/v1 @@ -207,13 +202,13 @@ $ oc apply -f ingress-autoscaler.yaml + [source,terminal] ---- -$ oc get ingresscontroller/default -o yaml | grep replicas: +$ oc get -n openshift-ingress-operator ingresscontroller/default -o yaml | grep replicas: ---- + .Example output [source,terminal] ---- -replicas: 3 + replicas: 3 ---- ** Get the pods in the `openshift-ingress` project: diff --git a/networking/ingress-operator.adoc b/networking/ingress-operator.adoc index bbfc7a5cdc..e5d1d2c2fc 100644 --- a/networking/ingress-operator.adoc +++ b/networking/ingress-operator.adoc @@ -50,14 +50,16 @@ include::modules/nw-ingress-setting-a-custom-default-certificate.adoc[leveloffse include::modules/nw-ingress-custom-default-certificate-remove.adoc[leveloffset=+2] +// Autoscaling an Ingress Controller include::modules/nw-autoscaling-ingress-controller.adoc[leveloffset=+2] ifndef::openshift-rosa,openshift-dedicated[] [role="_additional-resources"] .Additional resources -* xref:../observability/monitoring/enabling-monitoring-for-user-defined-projects.adoc#enabling-monitoring-for-user-defined-projects_enabling-monitoring-for-user-defined-projects[Enabling monitoring for user-defined projects] -* xref:../nodes/cma/nodes-cma-autoscaling-custom-install.adoc#nodes-cma-autoscaling-custom-install[Installing the custom metrics autoscaler] +* xref:../nodes/cma/nodes-cma-autoscaling-custom-install.adoc#nodes-cma-autoscaling-custom-install_nodes-cma-autoscaling-custom-install[Installing the custom metrics autoscaler] + +* xref:../observability/monitoring/enabling-monitoring-for-user-defined-projects.adoc#enabling-monitoring-for-user-defined-projects_enabling-monitoring-for-user-defined-projects[Enabling monitoring for user-defined projects] * xref:../nodes/cma/nodes-cma-autoscaling-custom-trigger-auth.adoc#nodes-cma-autoscaling-custom-trigger-auth[Understanding custom metrics autoscaler trigger authentications]