Keptn v1 reached EOL December 22, 2023. For more information see https://bit.ly/keptn

Deploying Services

After creating a project, Keptn allows creating a service into Keptn.

Service name restrictions

  • Service name must be a valid unix directory name (Note: for each service a directory with the corresponding name is created in the upstream git repository)
  • Keptn Version >= 0.8.3: Service name must be less than 43 characters (Note: template was reduced to ${SERVICE}-generated to allow longer service names)

Create a service

  • To create a service, use the keptn create service command and provide the service and project name (--project flag/):
keptn create service SERVICENAME --project=PROJECTNAME

Requirements for the Helm Chart to deploy

After creating a service, you need to provide a Helm Chart where the service deploys. For Keptn, the Helm Chart has the following requirements:

  1. The Helm chart must contain exactly one deployment. The properties spec.selector.matchLabels.app and spec.template.metadata.labels.app must be set in this deployment.

  2. The Helm chart must contain exactly one service. The property spec.selector.app must be set in this service.

  3. The Helm chart must contain a values.yaml file with at least the image and replicaCount parameter for the deployment. These image and replicaCount parameters must be used in the deployment. An example is shown below:

image: docker.io/keptnexamples/carts:0.13.1
replicaCount: 1
--- 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: your_deployment
spec:
  replicas: {{ .Values.replicaCount }}
  selector:
    matchLabels:
      app: your_service
  template:
    metadata: 
      labels:
        app: your_service
    spec:
      containers:
      - name: your_service
        image: "{{ .Values.image }}"

Note: If you are using custom configurations and you would like to have the environment variables KEPTN_PROJECT, KEPTN_STAGE, and KEPTN_SERVICE within your service, add the following environment variables to your deployment configuration.

env:
...
- name: KEPTN_PROJECT
  value: "{{ .Chart.Name }}"
- name: KEPTN_STAGE
  valueFrom:
    fieldRef:
      fieldPath: "metadata.namespace"
- name: KEPTN_SERVICE
  value: "{{ .Values.SERVICE_PLACEHOLDER_C.service.name }}"
  • Finally, upload the Helm Chart to your service:
keptn add-resource --project=PROJECTNAME --service=SERVICENAME --all-stages --resource=HELM_CHART.tgz --resourceUri=helm/SERVICENAME.tgz