hashicorp/boundary-enterprise

Boundary Enterprise

免责声明

本HashiCorp企业软件仅供已与HashiCorp或其授权经销商签订有效许可协议的客户使用。如您无有效许可使用本软件，不得下载或使用。本软件的所有使用均受您的许可协议条款约束，所有其他权利均明确保留。

协议

除非您的组织已签署单独协议管辖您对本处提供软件的使用，否则以下条款适用：

软件受许可条款或社区许可（即Mozilla公共许可证2.0或商业源代码许可证，如适用）约束，上述许可位于软件下载包中、IBM国际程序许可协议、IBM国际程序评估许可协议（用于评估用途）或IBM国际程序早期版本许可协议（alpha和beta版本）以及适用的许可信息中，其副本亦可在[***]

使用方法

开发模式

由于boundary dev运行和维护PostgreSQL Docker容器存在局限性，不建议在Docker内运行dev模式。如需运行，需具备https://hub.docker.com/_/docker%E7%9A%84%E8%BF%90%E8%A1%8C%E7%9F%A5%E8%AF%86%E5%8F%8A%E7%9B%B8%E5%85%B3%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9%E3%80%82

默认配置

Boundary Docker镜像的默认行为是运行boundary server -config /boundary/config.hcl。内置的config.hcl文件仅作示例用途，不适用于实际部署。文件内的注释包含更多信息；完整配置详情可参见Boundary文档网站。

PostgreSQL

本README中的使用说明假设您已拥有外部PostgreSQL数据库（12版或更高）以运行Boundary服务器。如想快速开始，可在Docker中启动本地PostgreSQL：

bash
docker run -it -p 5432:5432 -e POSTGRES_PASSWORD=postgres -e POSTGRES_USER=postgres postgres

PostgreSQL URL设置通过env://BOUNDARY_POSTGRES_URL定义，因此可在docker run时通过-e轻松设置：

bash
docker run \
    --network host \
    -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
    -e 'BOUNDARY_LICENSE=<license>' \
    boundary-enterprise

控制器

如将镜像用作Boundary控制器，或控制器与工作节点的组合，必须提供有效许可。许可可通过环境变量提供：

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -e 'BOUNDARY_LICENSE=<license>' \
  boundary-enterprise

或在自定义config.hcl中指定（假设config.hcl位于$(pwd)/config.hcl）：

config.hcl：

hcl
controller {
  // 省略其他字段
  // 也支持file://和env://以从单独文件或其他环境变量中包含许可
  license = "<license>"
}

// 省略其他配置

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -v "$(pwd)":/boundary/ \
  boundary-enterprise

数据库初始化

如使用全新未使用的PostgreSQL实例，可使用默认config.hcl初始化数据库：

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -e 'BOUNDARY_LICENSE=<license>' \
  boundary-enterprise database init -config /boundary/config.hcl

如需使用自定义config.hcl（假设位于$(pwd)/config.hcl）：

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -v "$(pwd)":/boundary/ \
  boundary-enterprise database init -config /boundary/config.hcl

数据库迁移

如将Boundary更新至新版本，且数据库实例是使用旧版本初始化的，需应用数据库迁移：

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -e 'BOUNDARY_LICENSE=<license>' \
  boundary-enterprise database migrate -config /boundary/config.hcl

如需使用自定义config.hcl（假设位于$(pwd)/config.hcl）：

bash
docker run \
  --network host \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -v "$(pwd)":/boundary/ \
  boundary-enterprise database migrate -config /boundary/config.hcl

服务器启动

使用默认config.hcl启动Boundary服务器：

bash
docker run \
  --network host \
  -p 9200:9200 \
  -p 9201:9201 \
  -p 9202:9202 \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  -e 'BOUNDARY_LICENSE=<license>' \
  boundary-enterprise

使用自定义config.hcl启动Boundary服务器（假设位于$(pwd)/config.hcl）：

bash
docker run \
  --network host \
  -p 9200:9200 \
  -p 9201:9201 \
  -p 9202:9202 \
  -v "$(pwd)":/boundary/ \
  -e 'BOUNDARY_POSTGRES_URL=postgresql://postgres:postgres@0.0.0.0:5432/postgres?sslmode=disable' \
  boundary-enterprise

工作节点

如将此镜像用作工作节点（连接至Boundary企业版控制器的工作节点，或作为HCP Boundary的自管理工作节点），无需通过环境变量或配置提供许可，但工作节点必须连接至已许可的控制器。

假设config.hcl位于$(pwd)/config.hcl：

config.hcl：

hcl
// 如使用HCP Boundary
hcp_boundary_cluster_id = "https://<uuid>.boundary.hashicorp.cloud"

worker {
    // 如使用自管理控制器
    initial_upstreams = ["<controller address/dns>:9201"]

    // 省略其他配置
}
// 省略其他配置

bash
docker run \
  --network host \
  -p 9202:9202 \
  -v "$(pwd)":/boundary/ \
  boundary-enterprise