Deployment to Kubernetes

Prerequisites

• Install kubectl https://kubernetes.io/docs/tasks/tools/

• Install kustomize https://kubectl.docs.kubernetes.io/installation/kustomize/

Frontend

Staging

You may trigger staging release at any point of time from the master branch by:

cd podkrepi.bg/frontend
kubectl apply -k manifests/overlays/development

This will update the deployment using ghcr.io/podkrepi-bg/frontend:master image

Production

Create new release

The following command will:

• Bump the version in package.json

• Tag the latest master branch

• [postversion] Push local tags to the remote origin

• Update the image newTag version in frontend/manifests/overlays/production/kustomization.yaml

• Commit and push the manifest update

cd podkrepi.bg/frontend
kubectl apply -k manifests/overlays/production

Apply manifests

Once the image has been built by the GitHub Actions and is present in the Docker image repository you may trigger the actual deployment to the cluster.

https://github.com/orgs/podkrepi-bg/packages/container/package/frontend

cd podkrepi.bg/frontend
kubectl apply -k manifests/overlays/production

Backend

Staging

You may trigger staging release at any point of time from the master branch by:

cd podkrepi.bg/backend
kubectl apply -k manifests/overlays/development

This will update the deployment using ghcr.io/podkrepi-bg/api:master image

Production

Create new release

The following command will:

• Bump the version in package.json

• Tag the latest master branch

• [postversion] Push local tags to the remote origin

• Update the image newTag version in backend/manifests/overlays/production/kustomization.yaml

• Commit and push the manifest update

cd podkrepi.bg/backend
kubectl apply -k manifests/overlays/production

Apply manifests

Once the image has been built by the GitHub Actions and is present in the Docker image repository you may trigger the actual deployment to the cluster.

https://github.com/orgs/podkrepi-bg/packages/container/package/api

cd podkrepi.bg/backend
kubectl apply -k manifests/overlays/production

Manual deployment

If you want to set a specific version for the deployment image you can do that by editing backend/manifests/overlays/production/kustomization.yaml

images:
- name: ghcr.io/podkrepi-bg/api/migrations
  newTag: v0.3.3
- name: ghcr.io/podkrepi-bg/api
  newTag: v0.3.3