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

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

기존 설치에 관한 정보 수집

1. 다음 명령어를 실행합니다.

   cat /var/alloydb/config/dataplane.conf

2. cat 명령어의 출력에서 다음 변수의 값을 참고용으로 메모합니다.

   • DATADIR_PATH(예: /var/alloydb/main)
   • ENABLE_ALLOYDB_AI(예: FALSE)
   • PGPORT(예: 5432)
   • INSTANCE_TYPE(예: PRIMARY/READ_REPLICA)

인플레이스 업그레이드 수행

1. 기존 데이터베이스를 중지합니다.

   sudo alloydb database-server stop

2. 이전의 기존 데이터 디렉터리를 마운트하여 새 단일 이미지 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 설치 맞춤설정을 참고하세요.

3. 데이터베이스 인스턴스 유형이 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

4. ENABLE_ALLOYDB_AI이 TRUE로 설정된 경우 AlloyDB AI를 사용하여 AlloyDB Omni 설치의 안내에 따라 AlloyDB AI를 설정합니다.

5. 데이터베이스에 연결하여 데이터가 변경되지 않았는지 확인합니다.

   docker exec -it CONTAINER_NAME psql -h localhost -U postgres

6. AlloyDB Omni CLI를 제거합니다.

   sudo alloydb database-server uninstall

   AlloyDB Omni CLI를 제거해도 AlloyDB Omni에 저장된 데이터에는 영향을 미치지 않습니다.