OpenReplay 배포를 최신 버전으로 업그레이드하려면 백엔드(인스턴스)와 트래커를 모두 업데이트해야 합니다.

1. 최신 CLI를 다운로드합니다.

# Download the latest CLI
sudo wget https://raw.githubusercontent.com/openreplay/openreplay/main/scripts/helmcharts/openreplay-cli -O /bin/openreplay 
sudo chmod +x /bin/openreplay
export PATH=/var/lib/openreplay:$PATH

1. Kubernetes 클러스터 버전을 확인하고, 1.31보다 낮으면 업그레이드합니다(필수).

# Check Kubernetes version
kubectl version --short 2>/dev/null | grep -i server | awk '{print $NF}'

# Update Kubernetes
k3s-killall.sh
curl -sL https://get.k3s.io | sudo K3S_KUBECONFIG_MODE="644" INSTALL_K3S_VERSION='v1.31.5+k3s1' INSTALL_K3S_EXEC="--disable=traefik" sh -
	
# Restart Kubernetes cluster
sudo systemctl restart k3s.service

# Update Kubernetes deprecated apis
helm plugin install https://github.com/helm/helm-mapkubeapis
helm mapkubeapis -n app openreplay

3. OpenReplay를 업그레이드합니다.

RELEASE_UPGRADE=1 openreplay --upgrade

참고: 업데이트된 OpenReplay 구성 파일은 /var/lib/openreplay/vars.yaml에 저장됩니다.

git clone https://github.com/openreplay/openreplay --depth 1
cd openreplay/scripts/docker-compose
bash upgrade.sh /path/to/old/common.env
eg: bash upgrade.sh ~/openreplay-docker-compose/common.env

참고: 업데이트된 OpenReplay 구성 파일은 docker-compose 파일과 함께 common.env에 저장됩니다.

아래 호환성 표를 확인하여 트래커(그리고 Assist 플러그인을 사용하는 경우 tracker-assist 플러그인)가 새 백엔드 버전과 호환되는지 확인하세요.

업그레이드 과정에서 문제가 발생하면 Slack에서 커뮤니티의 도움을 받으세요.