Citrix ADC ingress controller

Deploy Citrix API gateway using Red Hat OpenShift Operators

February 3, 2022

Contributed by:

OpenShift Operator is an open-source toolkit designed to package, deploy, and manage Kubernetes native applications in a more effective, automated, and scalable way.

An API gateway acts as the single entry point for your APIs and ensures secure and reliable access to multiple APIs and microservices in your system. Citrix provides an enterprise grade API gateway for North-South API traffic into the OpenShift cluster. The API gateway integrates with the OpenShift cluster through the Citrix ingress controller and the Citrix ADC (Citrix ADC MPX, VPX, or CPX) deployed as the Ingress Gateway for on-premises or cloud deployments.

This topic covers information on how to deploy the API gateway using OpenShift Operators.

The Citrix API gateway operator installs the CRDs required for the API Gateway functionality. Since this operator leverages the Citrix ingress controller, you need to create an instance of the API Gateway CRD, which is the Citrix ingress controller. If you already have a Citrix ingress controller instance in the cluster you need to install it again.

API gateway supports the following CRDs:

Auth CRD (authpolicies.citrix.com)

Authentication policies are used to enforce access restrictions to resources hosted by an application or an API server.
Content routing CRDs (httproutes.citrix.com and listeners.citrix.com)

Kubernetes native Ingress supports only basic host and path based routing. Using content routing CRDs, you can expose the advanced content routing abilities provided by Citrix ADC like routing based on header values or query strings.
Rate limit CRD (ratelimits.citrix.com) In a Kubernetes deployment, you can rate limit the requests to the resources on the back end server or services using the rate limiting feature provided by the ingress Citrix ADC.
Rewrite and responder CRD (rewritepolicies.citrix.com) In a Kubernetes environment, to deploy specific layer 7 policies (such as redirecting HTTP traffic to a specific URL) requires you to add appropriate libraries within the microservices and manually configure the policies. Instead, you can use the Rewrite and Responder features provided by the Ingress Citrix ADC device to deploy these policies.
VIP CRD (vips.citrix.com)

Citrix provides a VIP CRD for asynchronous communication between the IPAM controller and the Citrix ingress controller. The IPAM controller is provided by Citrix for IP address management.

Deploy Citrix API Gateway using OpenShift Operator

Perform the following steps to deploy the API gateway using the OpenShift Operator.

In the OperatorHub, search for Citrix API Gateway Operator.
Select the Citrix API Gateway Operator, and click Install.
Choose the namespace where you want the operator to be installed and click Subscribe.
Once the Citrix API gateway operator is installed, you can see it listed under the Installed Operators section on the left panel. At this point, all CRDs are installed in the cluster.
To create instances of each CRD, select the appropriate CRD and click Create Instance.
Once you create the instance you can see all your instances by selecting the All instances tab.

Update the CRD instance

To update any values of the created CRD instance, click the instance and go to the YAML tab and edit the YAML file and click Save.

OpenShift Operator Install

Upgrade CRD versions

For more information on upgrading CRD versions, see the OpenShift documentation.

Delete the instance and operator

To delete an instance of the CRD you have to delete the Citrix ingress controller instance from the user interface. Select the three vertical dots on the right side of the instance as shown in the following image and then click Delete CitrixIngressController.

OpenShift Operator Install

To delete the operator, click the Actions drop-down list and then click Uninstall operator.

Note:

Make sure that all instances are deleted manually before uninstalling the operator. The instances are not automatically deleted if you uninstall the operator.

OpenShift Operator Deletion

The official version of this content is in English. Some of the Citrix documentation content is machine translated for your convenience only. Citrix has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Citrix product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Citrix, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Citrix will not be held responsible for any damage or issues that may arise from using machine-translated content.

Deploy Citrix API gateway using Red Hat OpenShift Operators

February 3, 2022

Contributed by:

February 3, 2022

Contributed by:

Deploy Citrix API gateway using Red Hat OpenShift Operators

Deploy Citrix API Gateway using OpenShift Operator

Update the CRD instance

Upgrade CRD versions

Delete the instance and operator

In this article