This document describes the different properties a typical NAIS application should have.
When running on NAIS (or Kubernetes, actually) your application must be able to handle being shut down at any given time. This is because the platform might have to reboot the node your application is running on (e.g. because of a OS patch requiring restart), and in that case will reschedule your application on a different node.
To best be able to handle this in your application, it helps to be aware of the relevant parts of the termination lifecycle.
Application (pod) gets status
TERMINATING, and grace period starts (default 30s)
(simultaneous with 1) If the pod has a
preStop hook defined, this is invoked
(simultaneous with 1) The pod is removed from the list of endpoints i.e. taken out of load balancing
(simultaneous with 1, but after
preStop if defined) Container receives
SIGTERM, and should prepare for shutdown
Grace period ends, and container receives
Pod disappears from the API, and is no longer visible for the client.
The platform will automatically add a
preStop-hook that pauses the termination sufficiently that e.g. the ingress controller has time to update it's list of endpoints (thus avoid sending traffic to a application while terminating).
The application should emit
json-formatted logs by writing directly to standard output. This will make it easier to index, view and search the logs later. See more details in the logs documentation.
readiness-probe is used by Kubernetes to determine if the application should receive traffic, while the
liveness-probe lets Kubernetes know if your application is alive. If it's dead, Kubernetes will remove the pod and bring up a new one.
Useful resources on the topic:
These environment variables will be injected into your application container
metadata.name from nais.yaml
metadata.namespace from nais.yaml
spec.image from nais.yaml
naiserator runtime context