Add Helm chart usage instructions and update image tags in deployment templates

Author: giovanninocco

README.md

@@ -568,6 +568,15 @@ make build
 ```
 
 
+### How to use Helm chart
+
+Inside the folder **./src/apps/k8s/helm** you can find the Helm chart to deploy the application on Kubernetes.
+
+``` bash
+cd ./src/apps/k8s/helm
+microk8s helm install genocs ./gnxchart
+```
+
 
 ### Deploy in a cloud instance
 

src/apps/k8s/helm/gnxchart/Chart.yaml

@@ -15,10 +15,10 @@ type: application
 # This is the chart version. This version number should be incremented each time you make changes
 # to the chart and its templates, including the app version.
 # Versions are expected to follow Semantic Versioning (https://semver.org/)
-version: 1.0.0
+version: 0.0.1
 
 # This is the version number of the application being deployed. This version number should be
 # incremented each time you make changes to the application. Versions are not expected to
 # follow Semantic Versioning. They should reflect the version the application is using.
 # It is recommended to use it with quotes.
-appVersion: "1.0.0"
+appVersion: "1.16.0"

src/apps/k8s/helm/gnxchart/templates/_helpers.tpl renamed to src/apps/k8s/helm/gnxchart/_helpers.tpl

@@ -1,22 +1,8 @@
-1. Get the application URL by running these commands:
-{{- if .Values.ingress.enabled }}
-{{- range $host := .Values.ingress.hosts }}
-  {{- range .paths }}
-  http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
-  {{- end }}
-{{- end }}
-{{- else if contains "NodePort" .Values.service.type }}
-  export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "gnxchart.fullname" . }})
-  export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
-  echo http://$NODE_IP:$NODE_PORT
-{{- else if contains "LoadBalancer" .Values.service.type }}
-     NOTE: It may take a few minutes for the LoadBalancer IP to be available.
-           You can watch the status of by running 'kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "gnxchart.fullname" . }}'
-  export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "gnxchart.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
-  echo http://$SERVICE_IP:{{ .Values.service.port }}
-{{- else if contains "ClusterIP" .Values.service.type }}
-  export POD_NAME=$(kubectl get pods --namespace {{ .Release.Namespace }} -l "app.kubernetes.io/name={{ include "gnxchart.name" . }},app.kubernetes.io/instance={{ .Release.Name }}" -o jsonpath="{.items[0].metadata.name}")
-  export CONTAINER_PORT=$(kubectl get pod --namespace {{ .Release.Namespace }} $POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}")
-  echo "Visit http://127.0.0.1:8080 to use your application"
-  kubectl --namespace {{ .Release.Namespace }} port-forward $POD_NAME 8080:$CONTAINER_PORT
-{{- end }}
+Thank you for installing {{ .Chart.Name }}.
+
+Your release is named {{ .Release.Name }}.
+
+To learn more about the release, try:
+
+  $ helm status {{ .Release.Name }}
+  $ helm get all {{ .Release.Name }}

src/apps/k8s/helm/gnxchart/templates/NOTES.txt

@@ -16,7 +16,7 @@ spec:
     spec:
       containers:
         - name: apigateway-container
-          image: genocs/apigateway:1.0.4 # Replace with your image
+          image: "genocs/apigateway:{{ .Values.imageTag.apigateway }}"
           env:
             - name: ASPNETCORE_ENVIRONMENT
               value: "Development"

src/apps/k8s/helm/gnxchart/templates/apigateway-deployment.yaml

@@ -16,7 +16,7 @@ spec:
     spec:
       containers:
         - name: identities-container
-          image: genocs/identities-webapi:1.0.4 # Replace with your image
+          image: "genocs/identities-webapi:{{ .Values.imageTag.identities }}"
           env:
             - name: ASPNETCORE_ENVIRONMENT
               value: "Development"

src/apps/k8s/helm/gnxchart/templates/identities-deployment.yaml

@@ -16,7 +16,7 @@ spec:
     spec:
       containers:
         - name: notifications-container
-          image: genocs/notifications-webapi:1.0.4 # Replace with your image
+          image: "genocs/notifications-webapi:{{ .Values.imageTag.notifications }}"
           env:
             - name: ASPNETCORE_ENVIRONMENT
               value: "Development"

src/apps/k8s/helm/gnxchart/templates/notifications-deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: orders-container
-          image: genocs/orders-webapi:1.0.4 # Replace with your image
+          image: "genocs/orders-webapi:{{ .Values.imageTag.orders }}"
           env:
             - name: ASPNETCORE_ENVIRONMENT
               value: "Development"

src/apps/k8s/helm/gnxchart/templates/orders-deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: products-container
-          image: genocs/products-webapi:1.0.4 # Replace with your image
+          image: "genocs/products-webapi:{{ .Values.imageTag.products }}"
           env:
             - name: ASPNETCORE_ENVIRONMENT
               value: "Development"

src/apps/k8s/helm/gnxchart/templates/products-deployment.yaml

@@ -105,3 +105,11 @@ nodeSelector: {}
 tolerations: []
 
 affinity: {}
+
+# imageTag is a map of image tags for each of the services
+imageTag:  
+  apigateway: "1.0.4"
+  identities: "1.0.4"
+  products: "1.0.4"
+  orders: "1.0.4"
+  notifications: "1.0.4"