This guide helps you to quickly evaluate NetScaler Ingress Controller for Kubernetes if you are new to NetScaler 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 NetScaler Ingress Controller
In this procedure you perform the following steps:
- Deploy NetScaler CPX (a containerized version of NetScaler) along with ingress controller
Guestbook, a sample application
- Deploy Ingress rules to route traffic to the
- Send some traffic to the application and verify
Perform the following to deploy NetScaler CPX with NetScaler Ingress Controller.
Deploy NetScaler 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
Verify the installation using the following command.
kubectl get pods -l app=cpx-ingress
In this step, you deploy
Guestbook which is a multi-tier PHP-based web application that uses Redis.
Guestbookapplication in Minikube.
kubectl create -f https://raw.githubusercontent.com/citrix/cloud-native-getting-started/master/beginners-guide/manifest/guestbook-app.yaml
Verify the installation using the following:
kubectl get pods -l 'app in (guestbook, redis)'
To deploy ingress rules for the sample application and verify the functionality, perform the following steps.
Deploy an Ingress rule that sends traffic to the
kubectl create -f https://raw.githubusercontent.com/citrix/cloud-native-getting-started/master/beginners-guide/manifest/guestbook-ingress.yaml
Verify the Ingress deployment using the following command.
kubectl get ingress
Display information about the service using the following command.
kubectl get svc cpx-service # kubectl get service cpx-service NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE cpx-service NodePort 10.106.123.144 <none> 80:30592/TCP,443:31338/TCP 43m
You can get the NodePort information from this example, 30592 and 31338 are NodePorts.
Send traffic to the
Guestbookmicroservice application and verify that traffic to this URL gets the
curl -s -H \"Host: www.guestbook.com\" http://<MiniKube-IP-address>:<NodePort> | grep Guestbook
You can get the Minikube IP address using the
minikube ipcommand. You can also use the
minikube service cpx-service --urlcommand to directly get the URL used in the cURL command.
What is next
The getting started section helps a beginner to evaluate NetScaler Ingress Controller quickly and the installation covers only the basic functionality. You can see the following topics for comprehensive information on deploying NetScaler Ingress Controller and customize your installation accordingly.
- Deployment topologies: Provides information on various topologies supported by NetScaler Ingress Controller.
- Supported platforms: Provides information about the different platforms supported including bare metal and cloud platforms.
- Deploy NetScaler Ingress Controller: Provides information on how to deploy NetScaler Ingress Controller for different flavors of NetScaler like NetScaler CPX, VPX, and MPX.