# 05. Deploy demo app with persistence volume and publish app via ingress controller
## **Overview**
*Step-by-step guide on how to deploy demo application on HI GIO Kubernetes*
* *Install nginx ingress controller to your Kubernetes cluster. Installing the nginx ingress controller will auto-create 2 Virtual services (80, 443) in HI GIO LB.*
* *Deploy demo app with persistence volume into the Kubernetes cluster and publish app via ingress nginx*
## **Procedure**
**1. Pre-requisites:**
* Helm (v3 or higher)
* Make sure there is at least 1 available public IP
* Have a default Storage Class
* Permission for access to your Kubernetes cluster
**2. Procedure:**
{% stepper %}
{% step %}
**Step 1:** Install nginx ingress controller to your Kubernetes cluster
```
#Add repo ingress-nginx
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update ingress-nginx
```
```
#Install ingress nginx
helm install ingress-nginx ingress-nginx/ingress-nginx \
--namespace ingress-nginx \
--set controller.service.appProtocol=false \
--create-namespace
```
* Verify pod status is `Running` and service `ingress-nginx-controller` successfully obtained an `EXTERNAL IP`
```
kubectl get all -n ingress-nginx
```
{% hint style="warning" %}
CNI driver on Kubernetes automatically creates Virtual services on HI GIO LB and 2 DNAT rules (80, 443) on vCD.
Please modify the VPC firewall to allow access to the ingress virtual services. This provides access to your application published via the nginx ingress
***Ref*** [*Using Edge Gateway firewall*](/network/1.-working-with-network/using-edge-gateway-firewall.md)
{% endhint %}
{% endstep %}
{% step %}
**Step 2: Deploy demo app with persistence volume into the Kubernetes cluster and publish app via ingress nginx**
* Demo app folder structure
```
demoapp
├── 01-demoapp-namespace.yaml
├── 02-demoapp-pvc.yaml
├── 03-demoapp-deployment.yaml
├── 04-demoapp-service.yaml
└── 05-demoapp-ingress.yaml
```
* Create file `01-demoapp-namespace.yaml` to create demoapp namespace
```
apiVersion: v1
kind: Namespace
metadata:
name: demoapp
```
* Create file `02-demoapp-pvc.yaml` to create a Persistence Volume Claim
```
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: demoapp-pvc
namespace: demoapp
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 1Gi
storageClassName: default-storage-class-1 #adjust to use your storage class
```
* Create file `03-demoapp-deployment.yaml` to create the demoapp deployment
```
apiVersion: apps/v1
kind: Deployment
metadata:
name: demoapp
namespace: demoapp
spec:
replicas: 3
selector:
matchLabels:
app: demoapp
template:
metadata:
labels:
app: demoapp
spec:
containers:
- name: demoapp
image: paulbouwer/hello-kubernetes:1.8
ports:
- containerPort: 8080
volumeMounts:
- mountPath: /data
name: demoapp-storage
volumes:
- name: demoapp-storage
persistentVolumeClaim:
claimName: demoapp-pvc
```
* Create file `04-demoapp-service.yaml` to create demoapp service
```
apiVersion: v1
kind: Service
metadata:
name: demoapp
namespace: demoapp
spec:
type: ClusterIP
ports:
- port: 80
targetPort: 8080
selector:
app: demoapp
```
* Create file `05-demoapp-ingress.yaml` to create demoapp ingress
```
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: demoapp-ingress
namespace: demoapp
spec:
ingressClassName: nginx
rules:
- host: demoapp.cloud.net.vn #adjust to use your domain
http:
paths:
- backend:
service:
name: demoapp
port:
number: 80
path: /
pathType: Prefix
```
* Apply all manifests
```
cd demoapp
kubectl apply -f .
```
* Create a DNS record for demoapp
```
Name:
Address: 42.113.xx.xx (EXTERNAL-IP of ingress nginx)
```
* If all the configuration is correct, you can access your app with the domain `http://`
{% endstep %}
{% endstepper %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.higiocloud.vn/hi-gio-kubernetes/05.-deploy-demo-app-with-persistence-volume-and-publish-app-via-ingress-controller.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.