IBM Cloud Docs
创建“部署到 IBM Cloud”按钮

创建“部署到 IBM Cloud”按钮

“部署到 IBM Cloud”按钮是共享公共 Git 源代码应用程序的有效方法，这样其他人就能使用工具链来试用代码并将其部署到 IBM Cloud。 此按钮不但需要的配置最少，而且可插入到支持标记的任何位置。 任何用户单击此按钮后，都会在新的 Git 存储库中创建代码的克隆副本，这样原始应用程序始终不受影响。

当用户单击您的按钮时，会发生以下操作：

  1. 如果用户没有活动的 IBM Cloud 帐户，那么必须创建帐户。 用户可以创建试用帐户，也可以创建实际帐户。

  2. 该人员可以通过单击 Delivery Pipeline 图标来选择区域，资源组和应用程序名称。 建议让应用程序名称与工具链名称相同，该名称是由原始 Git 存储库的名称和时间构成的。 也可以编辑工具链名称。

  3. 将创建一个工具链，其中包含 Git 存储库的新专用克隆，用于构建和部署代码更改的管道以及问题跟踪程序。

    如果 .bluemix 目录包含 toolchain.yml 文件，那么该文件用于指定工具链的工具集成。 有关 toolchain.yml 文件的更多信息，请参阅 创建定制工具链模板。

  4. 如果应用程序需要构建文件，那么会自动检测构建文件并构建应用程序。

  5. 如果为构建和部署过程配置了管道，那么将使用 pipeline.yml 文件来部署应用程序。

  6. 如果应用程序需要容器，那么会使用用于定义 IBM Cloud Kubernetes Service 的 pipeline.yml 文件和用于定义图像的 Dockerfile 在 IBM Cloud Kubernetes Service 中部署应用程序。

  7. 应用程序会部署到用户选定的 IBM Cloud 组织中。

按钮示例

下面是公共 Git Repos and Issue Tracking 存储库的应用程序按钮示例：

"部署到 IBM Cloud " 按钮

下面是公共 GitHub 存储库的应用程序按钮示例：

"部署到 IBM Cloud " 按钮

创建按钮

要创建“部署到 IBM Cloud”按钮，请复制并修改下列某个片段模板。 在 URL 中指定 Git 存储库和分支。

创建 HTML 格式的按钮

要创建 HTML 格式的按钮，请复制以下片段并插入公共 Git 存储库 URL 和分支。

<a href="https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>"><img src="https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg" alt="Deploy to IBM Cloud" target="_blank"></a>

如果未在片段的存储库 URL 中包含 branch 参数，那么“部署到 IBM Cloud”按钮缺省为存储库的主分支。

创建 Markdown 格式的按钮

要创建 Markdown 格式的按钮，请复制以下片段并插入公共 Git 存储库 URL 和分支。

[![Deploy to IBM Cloud button](https://cloud.ibm.com/media/docs/images/icons/Deploy_to_cloud.svg)](https://cloud.ibm.com/devops/setup/deploy?repository=<git_repository_URL>&branch=<git_branch>)

如果未在片段的存储库 URL 中包含 branch 参数，那么“部署到 IBM Cloud”按钮缺省为存储库的主分支。

使用按钮片段

创建“部署到 IBM Cloud”按钮片段后，可以将其插入博客、文章、Wiki、自述文件或您希望推广自己应用程序的其他任何位置。

定制“部署到 IBM Cloud”按钮的片段时，请考虑这两个模板都使用 SVG 格式和英语的外部按钮图像的缺省路径。 如果您希望本地存储图像，那么可以下载图像并将其存储在 Git 存储库中。 调整路径以使用图像的相对位置。

存储库注意事项

查看在“部署到 IBM Cloud”按钮中使用的存储库的以下注意事项。

构建文件需求

如果必须先构建应用程序，然后才能进行部署，那么必须在存储库中包含构建文件。 如果在存储库的根目录中检测到构建脚本文件，那么将在部署前触发代码的自动构建。

支持的构建器包括：

  • Ant: build.xml，用于构建到 ./output/ 文件夹的输出
  • Gradle: /build.gradle，用于构建 . 文件夹的输出
  • Ggrunt: /Gruntfile.js，用于构建到 . 文件夹的输出
  • Maven: /pom.xml，用于构建到 ./target/ 文件夹的输出

管道文件需求

要在 .bluemix 目录中为工具链配置管道，请包含 pipeline.yml 文件。 对于该目录中的每个 pipeline.yml 文件，在实例化工具链时将分别创建一个管道。

要创建管道文件，请参阅 创建定制工具链模板 文档中的示例文件。 与在 Web 界面中定义管道一样，可以使用文本通过创建阶段和作业，设置输入和环境变量以及添加脚本来定义管道。 您还可以在 此演示项目中查看多个更复杂的管道文件。

容器 Dockerfile 需求

要使用 IBM Cloud Kubernetes Service 在容器中部署应用程序，必须在存储库的根目录中包含 Dockerfile，并在 .bluemix 目录中包含 pipeline.yml 文件。

Dockerfile 类似于某种应用程序构建脚本。 如果在存储库中检测到 Dockerfile，那么在容器中部署应用程序之前，会自动将该应用程序构建到映像中。 如果必须先构建应用程序，然后才能将其构建到映像中，那么要包含应用程序的构建脚本和 Dockerfile。

要了解有关创建 Dockerfile 的更多信息，请参阅 Docker 文档。 要了解有关 Kubernetes的更多信息，请参阅 IBM Cloud Kuberenetes Service。

要手动创建专门针对容器的 pipeline.yml，请参阅 GitHub中的示例。