본문 바로가기
WIKI 기술 지식 베이스

lakeFS Community에서 lakeFS Enterprise로 마이그레이션

원문 보기 위키 갱신

lakeFS Community에서 lakeFS Enterprise로 마이그레이션하려면 아래 단계를 따르세요:

출처: 문서

본문

  • lakeFS Enterprise 접근 권한을 얻으려 문의하세요.

  • lakeFS Docker 이미지를 enterprise 버전으로 업데이트하세요. 구성에서 treeverse/lakefs를 treeverse/lakefs-enterprise로 교체하세요. enterprise 이미지는 lakeFS Enterprise 토큰으로 pull할 수 있어요.

  • 온전성 테스트(선택): 현재 프로덕션 구성을 옮기기 전에 새 테스트용 lakeFS Enterprise를 설치하세요. 구성 테스트 > 로그인 > 리포지토리 생성 등을 진행해요. 모든 것이 잘 동작하는 것을 확인하면 테스트 구성을 삭제·정리하고 마이그레이션 프로세스로 넘어가요.

  • lakeFS Enterprise를 올바르게 구성했는지 확인하세요. Enterprise 설치 가이드를 참고하세요

  • helm을 사용한다면 배포용 values.yaml 파일 등 기존 lakeFS 구성을 enterprise에 맞게 업데이트하세요

  • DB 마이그레이션: lakeFS Enterprise에도 동일한 데이터베이스를 사용할 거라서 데이터베이스 스키마를 마이그레이션해야 해요.

  • lakeFS 서버(업그레이드 전 구버전)에 SSH/exec로 접속하세요. 핵심은 마이그레이션 실행 시 동일한 lakeFS 설정 파일을 사용하는 것이에요.

  • lakefs 버전을 업그레이드한다면 이 단계를 수행하고, 아니면 다음 단계로 건너뛰세요: 새 lakeFS 바이너리를 설치하세요. 업그레이드하지 않는다면 기존 것(실행 중인 것)을 사용해요.

  • 명령 실행: LAKEFS_AUTH_UI_CONFIG_RBAC=internal lakefs migrate up (lakeFS 버전을 올린다면 새 바이너리를 사용하세요).

  • Migration completed successfully라는 로그 메시지가 표시될 거예요.

  • 이 짧은 DB 마이그레이션 동안에는 정책/RBAC 관련 변경을 하지 않도록 주의하세요.

  • 마이그레이션이 완료되면 - 수정된 values.yaml과 새 버전으로 helm 릴리스를 업그레이드하고 helm upgrade(원문의 helm ugprade는 오타)를 실행하세요.

  • 새 lakeFS 파드에 로그인: 다음 명령을 실행하세요. 적절한 자격 증명이 있는지 확인하거나, 새 자격 증명을 발급받으세요:

lakefs setup --user-name <admin> --access-key-id <key> --secret-access-key <secret> --no-check

Warning

새로 셋업된 lakeFS 인스턴스는 시스템에 확립된 자격 증명이 없어서 전체 셋업이 완료되기 전까지는 사용자에게 접근 불가 상태로 유지된다는 점을 유의하세요.

더 알아보기 (Learn more)

공식 문서의 Community→Enterprise 마이그레이션 페이지는 https://docs.lakefs.io/admin/install/migrate-from-community 에서 확인할 수 있어요.