Citrix ADC ingress controller

Getting started

This guide helps you to quickly evaluate Citrix ADC ingress controller for Kubernetes if you are new to Citrix ingress controller. If you are an advanced user, see What is Next.

Before you begin

Ensure that you have installed and set up a Minikube cluster.

Getting started with Citrix ADC ingress controller

In this procedure you perform the following steps:

  • Deploy Citrix ADC CPX (a containerized version of Citrix ADC) along with ingress controller
  • Deploy Guestbook, a sample application
  • Deploy Ingress rules to route traffic to the Guestbook application
  • Send some traffic to the application and verify

Deploy Citrix ADC CPX with Citrix ADC ingress controller

Perform the following to deploy Citrix ADC CPX with Citrix ADC ingress controller.

  1. Deploy Citrix ADC CPX as an Ingress proxy in the Minikube cluster.

      kubectl create -f https://raw.githubusercontent.com/citrix/cloud-native-getting-started/master/beginners-guide/manifest/cpx.yaml
    
  2. Verify the installation using the following command.

      kubectl get pods -l app=cpx-ingress
    

Deploy a sample application

In this step, you deploy Guestbook which is a multi-tier PHP-based web application that uses Redis.

  1. Deploy the Guestbook application in Minikube.

    kubectl create -f https://raw.githubusercontent.com/citrix/cloud-native-getting-started/master/beginners-guide/manifest/guestbook-app.yaml
    
  2. Verify the installation using the following:

    kubectl get pods -l 'app in (guestbook, redis)'
    

Deploy an Ingress for the sample application

To deploy ingress rules for the sample application and verify the functionality, perform the following steps.

  1. Deploy an Ingress rule that sends traffic to the Guestbook application(http://www.guestbook.com).

    kubectl create -f https://raw.githubusercontent.com/citrix/cloud-native-getting-started/master/beginners-guide/manifest/guestbook-ingress.yaml
    
  2. Get the Ingress IP address using the following command.

    kubectl get ingress
    kubectl get svc cpx-service
    
  3. Send traffic to the Guestbook microservice application and verify that traffic to this URL gets the Guestbook page:

    curl -s -H "Host: www.guestbook.com" http://<MiniKube IP:<NodePort> | grep Guestbook
    

Expected output:

   <title>Guestbook</title>
      <h2>Guestbook</h2>

What is next

The getting started section helps a beginner to evaluate Citrix ADC ingress controller quickly and the installation covers only the basic functionality. You can see the following topics for compreshensive information on deploying Citrix ADC ingress controller and customize your installation accordingly.

  • Deployment topologies: Provides information on various topologies supported by Citrix ADC ingress controller.
  • Supported platforms: Provides information about the different platforms supported including bare metal and cloud platforms.
  • Deploy Citrix ingress controller: Provides information on how to deploy Citrix ADC ingress controller for different flavors of Citrix ADC like Citrix ADC CPX, VPX, and MPX.
Getting started