Skip to content

Latest commit

 

History

History
93 lines (59 loc) · 3.05 KB

K8S-README.md

File metadata and controls

93 lines (59 loc) · 3.05 KB

JHipster-generated Kubernetes configuration

Preparation

You will need to push your image to a registry. If you have not done so, use the following commands to tag and push the images:

$ docker image tag baby stting/baby
$ docker push stting/baby
$ docker image tag gateway stting/gateway
$ docker push stting/gateway

Deployment

You can deploy all your apps by running the below bash command:

./kubectl-apply.sh -f (default option)  [or] ./kubectl-apply.sh -k (kustomize option) [or] ./kubectl-apply.sh -s (skaffold run)

If you want to apply kustomize manifest directly using kubectl, then run

kubectl apply -k ./

If you want to deploy using skaffold binary, then run

skaffold run [or] skaffold deploy

Exploring your services

Use these commands to find your application's IP addresses:

$ kubectl get svc gateway -n mamazinha

Scaling your deployments

You can scale your apps using

$ kubectl scale deployment <app-name> --replicas <replica-count> -n mamazinha

zero-downtime deployments

The default way to update a running app in kubernetes, is to deploy a new image tag to your docker registry and then deploy it using

$ kubectl set image deployment/<app-name>-app <app-name>=<new-image>  -n mamazinha

Using livenessProbes and readinessProbe allow you to tell Kubernetes about the state of your applications, in order to ensure availablity of your services. You will need minimum 2 replicas for every application deployment if you want to have zero-downtime deployed. This is because the rolling upgrade strategy first stops a running replica in order to place a new. Running only one replica, will cause a short downtime during upgrades.

JHipster registry

The registry is deployed using a headless service in kubernetes, so the primary service has no IP address, and cannot get a node port. You can create a secondary service for any type, using:

$ kubectl expose service jhipster-registry --type=NodePort --name=exposed-registry -n mamazinha

and explore the details using

$ kubectl get svc exposed-registry -n mamazinha

For scaling the JHipster registry, use

$ kubectl scale statefulset jhipster-registry --replicas 3 -n mamazinha

Troubleshooting

my apps doesn't get pulled, because of 'imagePullBackof'

Check the docker registry your Kubernetes cluster is accessing. If you are using a private registry, you should add it to your namespace by kubectl create secret docker-registry (check the docs for more info)

my applications are stopped, before they can boot up

This can occur if your cluster has low resource (e.g. Minikube). Increase the initialDelaySeconds value of livenessProbe of your deployments

my applications are starting very slow, despite I have a cluster with many resources

The default setting are optimized for middle-scale clusters. You are free to increase the JAVA_OPTS environment variable, and resource requests and limits to improve the performance. Be careful!