Boxfuse 部署
此页面记录了使用下一个主要版本 dpl v2 的部署,该版本目前处于 Beta 发布阶段。请参阅 我们的博文 获取详细信息。当前默认版本为 dpl v1。请查看 此处提供的 dpl v1 文档。
请务必阅读 v2 部署概述。
Travis CI 可以在构建成功后自动部署您的 Boxfuse 应用程序。
对于最小配置,请将以下内容添加到您的 .travis.yml
中
deploy:
provider: boxfuse
user: <user>
secret: <encrypted secret>
edge: true # opt in to dpl v2
您可能还想指定 payload
选项
deploy:
provider: boxfuse
# ⋮
payload: <path/to/artifact> # typically a jar, war, tar.gz or zip file
如果未指定 payload
,Boxfuse 将自动搜索当前目录中兼容的 payload 以进行融合。如果命令在 Maven、Gradle 或 SBT 项目的根目录处执行,则也会自动扫描该项目的输出目录。
状态 #
对 Boxfuse 部署的支持处于 alpha 阶段。有关详细信息,请参阅 成熟度级别。
已知选项 #
使用以下选项进一步配置部署。
用户 |
必需,类型:字符串 |
密钥 |
必需,密钥,类型:字符串 |
有效负载 |
类型:字符串 |
应用 |
类型:字符串 |
版本 |
类型:字符串 |
环境 |
类型:字符串 |
配置文件 |
类型:字符串,别名:configfile (已弃用,请使用 config_file ) |
额外参数 |
类型:字符串 |
共享选项 #
清理 |
在部署之前清理 Git 工作目录中的构建工件 - 类型:布尔值 |
运行 |
部署成功后要执行的命令 - 类型:字符串或字符串数组 |
环境变量 #
如果所有选项以 BOXFUSE_
为前缀,则可以作为环境变量提供。
例如,secret
可以作为 BOXFUSE_SECRET=<secret>
提供。
保护机密 #
机密选项值应作为构建配置(.travis.yml
文件)中的加密字符串或存储库设置中的环境变量提供。
环境变量可以在存储库的设置页面上设置,也可以使用 travis env set
设置。
travis env set BOXFUSE_SECRET <secret>
要加密将选项值添加到 .travis.yml
文件时,请使用 travis encrypt
travis encrypt <secret>
或者使用 --add
直接将其添加到 .travis.yml
文件中。请注意,此命令必须在存储库的根目录中运行
travis encrypt --add deploy.secret <secret>
最后,您还可以通过将 boxfuse.conf
文件放在存储库的根目录中来配置 Boxfuse。有关配置的更多信息,请参阅 Boxfuse 命令行客户端文档。
指定应用程序和映像版本 #
默认情况下,Boxfuse 将从有效负载文件的名称自动检测应用程序和版本。
您可以使用以下方法覆盖此设置
deploy:
provider: boxfuse
# ⋮
image: <image> # boxfuse app and version (e.g. myapp:1.23)
您还可以使用 Travis CI 环境变量(例如 TRAVIS_BUILD_NUMBER
)为映像分配版本,例如 image: "myapp:$TRAVIS_BUILD_NUMBER"
。
指定环境 #
默认情况下,Boxfuse 将部署到您的 test
环境。
您可以使用以下方法覆盖此设置
deploy:
provider: boxfuse
# ⋮
env: <env>
指定配置文件 #
您还可以通过将 boxfuse.conf
文件放在存储库的根目录中来完全配置 Boxfuse。您可以像这样指定备用配置文件
deploy:
provider: boxfuse
# ⋮
config_file: ./boxfuse-alt.conf
指定自定义参数 #
如果您需要的 Boxfuse 客户端 功能未在此处包含,则可以通过使用 extra_args
参数将其他参数传递到 Boxfuse 可执行文件。
deploy:
provider: boxfuse
extra_args: <extra_args> # e.g. -X
更多信息 #
访问 Boxfuse 网站 了解有关 Boxfuse 及其配置的更多信息。
Pull Request #
请注意,Pull Request 构建完全跳过部署步骤。