AlloyDB Omni 버전 15.5.2 이하에서 최신 버전으로 마이그레이션

AlloyDB Omni 15.5.4부터는 일반적인 패키지 관리 도구로 AlloyDB Omni를 제어할 수 있습니다.

기존에 AlloyDB Omni를 설치한 경우 이 페이지의 안내에 따라 새 단일 이미지 설치로 이전하세요.

기본 요건

AlloyDB Omni 최신 버전으로 업그레이드를 시작하려면 아직 완료하지 않은 경우 다음 기본 요건을 완료하세요.

AlloyDB Omni 15.5.2로 업그레이드

AlloyDB Omni CLI를 지원하는 최신 AlloyDB Omni 버전은 15.5.2입니다. AlloyDB Omni 버전을 확인하려면 다음 명령어를 실행합니다.

sudo alloydb version

결과는 다음과 유사합니다.

AlloyDB Omni CLI version: 1.6
AlloyDB Omni database server version: 15.5.2

출력에 15.5.2보다 이전 버전의 데이터베이스가 표시되면 다음 명령어를 실행하여 업그레이드합니다.

sudo alloydb database-server upgrade

기존 설치에 관한 정보 수집

다음 명령어를 실행합니다.
```
cat /var/alloydb/config/dataplane.conf
```
cat 명령어의 출력에서 다음 변수의 값을 참고로 기록합니다.
- DATADIR_PATH: 예: /var/alloydb/main
- ENABLE_ALLOYDB_AI: 예: FALSE
- PGPORT: 예: 5432
- INSTANCE_TYPE: 예: PRIMARY/READ_REPLICA

인플레이스(In-Place) 업그레이드 수행

기존 데이터베이스를 중지합니다.
```
sudo alloydb database-server stop
```
새 단일 이미지 AlloyDB Omni를 시작하여 이전의 기존 데이터 디렉터리를 마운트합니다.
```
docker run --name CONTAINER_NAME \
    -e POSTGRES_PASSWORD=PASSWORD \
    -e PGDATA=/var/lib/postgresql/data \
    -v /var/alloydb/main/data:/var/lib/postgresql/data \
    -v /dev/shm:/dev/shm \
    -p PGPORT:5432 \
    --network=host \
    --ulimit=nice=-20:-20 \
    --ulimit=core=-1:-1 \
    --log-driver=journald \
    -d google/alloydbomni:15.5.4
```
다음을 바꿉니다.
- CONTAINER_NAME: 호스트 머신의 컨테이너 레지스트리에 이 새 AlloyDB Omni 컨테이너를 할당할 이름입니다(예: my-omni).
- PASSWORD: 새 컨테이너가 생성된 후 새 컨테이너의 postgres 사용자에게 할당된 비밀번호입니다.
- PGPORT: AlloyDB Omni가 실행되는 포트의 IP 주소입니다. 이 값은 기존 설치에 대한 정보 수집의 2단계에서 기록한 값입니다.
docker run의 인수는 이전 버전의 AlloyDB Omni에서 사용된 인수이지만 추가로 맞춤설정할 수 있습니다. 자세한 내용은 AlloyDB Omni 설치 맞춤설정을 참고하세요.

데이터베이스 인스턴스 유형이 PRIMARY인 경우 다음 명령어를 실행하여 다음 사용자를 만듭니다. 현재는 사용되지 않지만 향후 확장을 위해 예약된 사용자 이름입니다.

for name in alloydbagent alloydbexport alloydbiamgroupuser alloydbiamuser alloydbimportexport alloydbobservability alloydbsqllogical alloydbsuperuser; do
  echo docker exec -it CONTAINER_NAME psql -h localhost -U postgres alloydbadmin \
    -c "CREATE ROLE ${name} NOLOGIN;" \
    -c "CREATE TABLE ${name}_table();" \
    -c "ALTER TABLE ${name}_table OWNER TO ${name};"
done

ENABLE_ALLOYDB_AI가 TRUE로 설정된 경우 AlloyDB AI로 AlloyDB Omni 설치의 안내에 따라 AlloyDB AI를 설정하세요.
데이터베이스에 연결하여 데이터가 변경되지 않았는지 확인합니다.
```
docker exec -it CONTAINER_NAME psql -h localhost -U postgres
```
AlloyDB Omni CLI를 제거합니다.
```
sudo alloydb database-server uninstall
```
AlloyDB Omni CLI를 제거해도 AlloyDB Omni에 저장된 데이터에는 영향을 미치지 않습니다.