Boundary Enterprise 라이선싱

이 기능은 Boundary Enterprise가 필요해요. Boundary Enterprise 바이너리는 계약 조건에 따라 자격(entitlement)과 시간 제한을 적용하기 위해 라이선스 키가 필요합니다. 라이선스를 구매하면 HashiCorp 계정 팀이 환경을 활성화할 유효한 Boundary 라이선스를 보내줘요. 아직 계정 팀이 없어도 Boundary Enterprise에 관심이 있다면 영업(sales)에 연락할 수 있어요.

출처: HashiCorp Boundary docs

본문

Boundary Enterprise 활성화

유효한 Boundary 라이선스를 받으면 두 가지 방법으로 Boundary Enterprise를 활성화할 수 있어요:

환경 변수로 설정: BOUNDARY_LICENSE 환경 변수를 받은 라이선스 키 값으로 설정해요.

$ export BOUNDARY_LICENSE=02MV4UU43BK5...

또는 파일 경로로:

$ BOUNDARY_LICENSE=file:///folder_path/license.hclic

컨트롤러 구성에 지정: Boundary 컨트롤러 구성의 controller 블록에서 license 속성으로 엔터프라이즈 라이선스 키를 지정해요. 원시 라이선스 키나 라이선스 키가 든 파일 경로 중 하나를 지정할 수 있어요.

아래 샘플 구성을 참고하세요.

샘플 1 (파일 경로):

controller {
  name        = "controller"
  description = "controller"
  database {
    url = "postgresql://boundary:***@127.0.0.1:5432/boundary"
  }
  public_cluster_addr = "boundary.domain"
  license = "file:///folder_path/license.hclic"
}

샘플 2 (원시 키):

controller {
  name        = "controller"
  description = "controller"
  database {
    url = "postgresql://boundary:***@127.0.0.1:5432/boundary"
  }
  public_cluster_addr = "boundary.domain"
  license = "02MV4UU43BK5..."
}

컨트롤러 구성에 대한 자세한 내용은 컨트롤러 구성 문서를 참고하세요.

라이선스 만료

계정 팀이 새 Boundary Enterprise 라이선스를 생성하면 계약 조건에 따른 만료 날짜가 포함돼요. 라이선스 만료 전에 Boundary는 다음 간격으로 다섯 개의 시스템 이벤트 경고를 이벤트 스트림에 기록합니다:

경고	간격
첫 번째	라이선스 만료 30일 전
두 번째	라이선스 만료 7일 전
세 번째	라이선스 만료 24시간 전
네 번째	라이선스 만료 1시간 전
다섯 번째	라이선스 만료 1분 전

외부 모니터링 시스템을 쓴다면 "msg": "license warning"와 "op": "licensing.StartWatching"으로 알림을 만들 수 있어요. 로그에 경고가 나타나는 예시는 다음과 같습니다:

{
  "id": "ymFHcb1H1Z",
  "source": "https://hashicorp.com/boundary/nixos/controller+worker",
  "specversion": "1.0",
  "type": "system",
  "data": {
    "version": "v0.1",
    "op": "licensing.StartWatching",
    "data": {
      "expiration_time": "2025-09-08T11:14:33-07:00",
      "msg": "licensing warning",
      "time_left_seconds": 60
    }
  },
  "datacontentype": "text/plain",
  "time": "2025-09-08T11:14:03.457471753-07:00"
}

라이선스가 만료되면 다음과 같은 오류 메시지를 받게 돼요:

{
  "id": "SJkaNV09xP",
  "source": "https://hashicorp.com/boundary/nixos/controller+worker",
  "specversion": "1.0",
  "type": "error",
  "data": {
    "error": "error from licensing watcher: invalid license or license is expired",
    "error_fields": {},
    "id": "e_33IKa8BqB3",
    "version": "v0.1",
    "op": "licensing.StartWatching"
  },
  "datacontentype": "text/plain",
  "time": "2025-08-01T16:54:14.34408533-07:00"
}

==> Boundary dev environment self-terminating
==> Health is enabled, waiting 0s before shutdown
==> Boundary dev environment graceful shutdown triggered, interrupt again to enter shutdown

라이선스가 만료되면 Boundary는 그레이스풀 셧다운(graceful shutdown)을 수행해요. 그레이스풀 셧다운은 컨트롤러를 종료하기 전에 리스너와 서버를 닫아 Boundary 인스턴스로의 새 트래픽을 선제적으로 막습니다.

라이선스 키를 갱신하려면 "Boundary Enterprise 활성화"의 단계를 따르세요. 모범 사례로 라이선스 키를 갱신한 뒤에는 컨트롤러를 재시작하는 것을 권장해요.

IBM Passport Advantage Online 라이선스 키

Boundary Enterprise는 유효한 Boundary 자격을 포함하는 IBM Passport Advantage Online 라이선스 키를 지원해요. IBM Passport Advantage Online 라이선스 키를 사용하려면 controller 블록에 license 속성으로 추가하세요.

더 알아보기 (Learn more)

Boundary를 최신 버전으로 업그레이드하는 단계별 지침(데이터베이스 백업과 데이터 마이그레이션 포함)은 업그레이드 및 데이터베이스 마이그레이션 튜토리얼을 참고하세요. Boundary가 이벤트를 모니터링하도록 구성하는 방법은 Boundary 모니터링(Monitor Boundary)을 참고하세요.