From 624b5b4d741411960104793b56b744ec3702f9e3 Mon Sep 17 00:00:00 2001
From: sreejithgs <sreejith.gs@citrix.com>
Date: Fri, 9 Oct 2020 13:42:44 +0530
Subject: [PATCH] adding the multiport service support

---
 docs/configure/multi-port-services.md | 58 +++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 docs/configure/multi-port-services.md

diff --git a/docs/configure/multi-port-services.md b/docs/configure/multi-port-services.md
new file mode 100644
index 00000000..58d5928d
--- /dev/null
+++ b/docs/configure/multi-port-services.md
@@ -0,0 +1,58 @@
+# Multi-port services support
+
+There are situations where you need to expose more than one port for a service. The Citrix ingress controller supports configuring multiple port definitions on a service.
+You can provide a service port name (supported from the Citrix ingress controller version 1.9.20 onwards) or port number for a targeted back end service while configuring the Ingress rules.
+
+## Example: Multi-port service
+
+Following is an example for multi-port service definitions.
+
+**Ingress**
+
+```yml
+
+apiVersion: extensions/v1beta1
+kind: Ingress
+metadata:
+  name: servicemultiportname
+  annotations:
+    ingress.citrix.com/frontend-ip: "192.101.12.111"
+spec:
+  rules:
+    - host: app
+      http:
+        paths:
+        - path: /v1
+          backend:
+              serviceName: myservice
+              servicePort: insecure
+    - host: app
+      http:
+        paths:
+        - path: /v2
+          backend:
+              serviceName: my-service
+              servicePort: secure
+```                
+
+**Multi-port service**
+
+```yml
+
+apiVersion: v1
+kind: Service
+metadata:
+ name: myservice
+spec:
+ selector:
+    app: myapp
+ ports:
+    - name: insecure
+      protocol: TCP
+      port: 80
+      targetPort: 9376
+    - name: secure
+      protocol: TCP
+      port: 443
+      targetPort: 9377
+```