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 构建完全跳过部署步骤。

另请参阅 #