Migrating Crowd to Kubernetes

This document explains the process of migrating an existing Crowd installation to Kubernetes.

Pre-configured resources

• Rook ceph(Block, Filesystem)
• cert-manager
• Nginx ingress controller
• DB(PostgreSQL)

Helm Chart

Version: v3.17.3(GoVersion: go1.23.7)

Add the Helm chart repository

helm repo add atlassian-data-center \
  https://atlassian.github.io/data-center-helm-charts

Check Atlassian product version with chart version

helm search repo atlassian-data-center/crowd

Get values.yaml command

helm show values altassian-data-center/crowd --version 1.20.0 > values.yaml

Editing values.yaml

Modify according to your configuration.

Create namespace

kubectl create ns atlassian

Deploy helm chart

Crowd version: 5.3.0

helm install crowd \
 atlassian-data-center/crowd \
 -f values.yaml \
 -n atlassian \
 --version 1.20.0

Check deployment

Data Migration

Process for importing existing application data and using it in the existing environment

Migration strategy

1. Crowd deploy(replicas=1) with empty data(application-data, shared-home)
2. Get application-data directory from as-is crowd instance(Rsync in to-be crowd pod)
3. Get shared-home directory from as-is crowd instance(Rsync in to-be crowd pod)
4. Crowd pod delete for restart
5. Check crowd data
6. Scale the crowd pod from 1 to 2

Upgrade

Upgrade strategy

• Option.1 : 5.3.7 to 6.3.1
• Option.2 : 5.3.0 to 5.3.7

Option.1 Helm chart upgrade

1. replicas 0(shutdown all Crowd pod)
2. (Optional) Clear image.tag value
3. Helm chart upgrade
4. Crowd statefulset scaling(rolling upgrade not supported)
   1. replicas 1(for upgrade task)
   2. Switch to final replicas

Shutdown all Crowd pod

kubectl scale statefulset --replicas 0 -n atlassian crowd

(Optional) Clear image.tag value

If you previously set image.tag but the APP VERSION matches the version you want to upgrade to, proceed with this step.

image:

  # -- The Docker Crowd Docker image to use
  # https://hub.docker.com/r/atlassian/crowd
  #
  repository: atlassian/crowd

  # -- Image pull policy
  #
  pullPolicy: IfNotPresent

  # -- The docker image tag to be used. Defaults to appVersion in Chart.yaml
  #
  tag: ""

Helm chart

Crowd version: 5.3.7 → 6.3.1

helm upgrade crowd \
 atlassian-data-center/crowd \
 --version 2.0.2 \
 -f values.yaml \
 -n atlassian

Option 2: Change image.tag & upgrade the Helm chart

1. Edit image.tag in values.yaml (use 5.3.7 for minor version upgrade testing)
2. replicas 0(shutdown all Crowd pod)
3. Helm chart upgrade

Shutdown all Crowd pod

kubectl scale statefulset --replicas 0 -n atlassian crowd

Edit image.tag in values.yaml

image:

  # -- The Docker Crowd Docker image to use
  # https://hub.docker.com/r/atlassian/crowd
  #
  repository: atlassian/crowd

  # -- Image pull policy
  #
  pullPolicy: IfNotPresent

  # -- The docker image tag to be used. Defaults to appVersion in Chart.yaml
  #
  tag: "5.3.7"

Helm chart

Crowd version: 5.3.7 → 6.3.1

helm upgrade crowd \
 atlassian-data-center/crowd \
 --version 1.20.0 \
 -f values.yaml \
 -n atlassian

Reference

Products upgrade - Atlassian DC Helm Charts

logo