`boundary database migrate` — 데이터베이스 마이그레이션

boundary database migrate — 데이터베이스 마이그레이션

database migrate 명령어는 상위 스코프 또는 자원 안의 Boundary 데이터베이스를 마이그레이션할 때 사용해요. 바이너리를 업그레이드한 뒤 데이터베이스 스키마를 최신 상태로 맞출 때 필요하죠.

출처: HashiCorp Boundary docs

본문

예시

아래 예시는 컨트롤러 구성 파일에 지정된 데이터베이스 URL로 Boundary 데이터베이스를 마이그레이션해요.

$ boundary database migrate -config=/etc/boundary.d/controller.hcl

사용법

$ boundary database migrate [options]

명령어 옵션 (Command options)

  • -config (string: "") — 구성 파일의 경로.
  • -config-kms (string: "") — config 용도로 표시된 kms 블록이 들어 있는 구성 파일의 경로. KMS 블록은 기본 구성 파일의 암호 해독을 수행해요. kms 블록을 설정하지 않으면 Boundary는 기본 구성 파일에서 그런 블록을 찾는데, 몇 가지 단점이 있어요. 자세한 내용은 boundary config encrypt -h의 도움말 출력을 참고하세요.
  • -log-format (string: "") — 로그 형식. 지원 값은 standard와 json이에요.
  • -log-level (string: "") — 로그 상세 수준. 지원 값은 상세한 것부터 간단한 것 순서로 trace, debug, info, warn, err이에요. BOUNDARY_LOG_LEVEL 환경 변수로도 로그 수준을 지정할 수 있어요.

마이그레이션(Migration) 옵션

  • -migration-url (string: "") — 설정하면 구성 파일에 설정된 마이그레이션 URL을 덮어쓰고, 마이그레이션을 위해 데이터베이스에 연결하는 데 사용할 URL을 지정해요. 이 옵션을 구성하면 초기화 또는 마이그레이션을 실행하는 사용자와 표준 작업을 실행하는 사용자의 권한을 다르게 줄 수 있어요. 이 값은 직접 데이터베이스 URL을 가리키거나, Boundary가 URL을 읽어 오는 디스크 파일(file://) 또는 환경 변수(env://)를 가리킬 수 있어요.
  • -repair (string: "") — 설정하면 제공된 마이그레이션 버전에 대한 복구 함수를 실행해요.

CLI 옵션 — 이 명령어 고유 옵션 외에도 모든 CLI 명령어·하위 명령어에 공통으로 적용되는 옵션들이 있어요. 연결(Connection) 옵션, 클라이언트(Client) 옵션, 출력(Output) 옵션, 환경 변수(Environment variables)를 참고하세요.