构建和部署

IBM Cloud® Continuous Delivery 包含 Delivery Pipeline，可用于实现可重复的持续集成和持续交付过程。

完成以下任务以配置管道。

添加阶段

在“管道”页面上，单击添加阶段。此时将打开“阶段配置”页面。
配置阶段。

a. 在输入选项卡上，选择阶段的输入。对于构建阶段，输入选项卡包含分支字段，以指定存储库中要用于输入的分支。

b. 在作业选项卡上，至少添加和配置一个作业。第一个阶段通常至少具有一个构建作业。
单击保存。

将作业添加到阶段

单击阶段的阶段配置图标，然后单击配置阶段。
单击作业选项卡。
单击添加作业。选择要添加的作业类型。
配置作业。
单击保存。

运行阶段

您可以通过单击“管道”页面上的运行阶段图标来手动运行阶段。

点击舞台上的 "运行舞台 "图标* 运行舞台" caption-side="bottom"}点击舞台上的 "运行舞台 "图标* {: caption="舞台

您还可以从构建历史记录页面通过以下两种方式之一来请求随需应变构建和部署：

将构建拖动到已配置阶段下的框中。
在“上次执行结果”部分，单击“发送到”图标，然后选择要部署到的空间。

带有此构建 {: caption="的执行阶段部署" caption-side="bottom"}

要取消正在运行的阶段，请在该阶段上单击查看日志和历史记录。在作业列表中，单击正在运行的作业号，然后单击取消。您还可以通过单击作业，再单击取消，或单击其阶段上作业的停止图标，单独取消作业。

部署应用程序

如果正确配置了部署作业，那么只要运行该作业，就可以将应用程序部署到目标。要手动运行部署作业，请单击作业所在阶段的运行阶段图标。

输入修订版

在手动运行某阶段时，或者在因为前一阶段完成而开始运行某阶段时，正在运行的阶段会选择其输入修订版。通常，输入修订版是构建号。要选择输入修订版，阶段应符合以下条件：

如果选择特定修订版，那么使用该修订版。
如果未指定特定修订版，那么搜索之前的阶段直至找到使用相同输入的阶段。查找并使用该输入上次成功运行的修订版。
如果未指定特定修订版且没有其他阶段使用指定的源作为输入，那么使用该输入的最新修订版。

您可以部署之前的构建。在包含该构建的阶段上，单击查看日志和历史记录。在打开的页面上，单击以展开运行号，然后单击构建作业。单击发送到，然后选择目标。

将服务添加到应用程序

您可以从 IBM Cloud 仪表板向应用程序添加服务并管理这些服务。有关添加服务的更多信息，请参阅将服务连接到外部应用程序。

查看日志

您可以查看作业的日志，并在阶段正在运行时，在“阶段历史记录”页面上查看阶段。

要查看作业日志，请单击作业。或者在阶段上，单击查看日志和历史记录。
要查看已部署应用程序的运行时日志，请单击查看运行时日志。

除了作业日志之外，您还可以查看任何构建作业的单元测试结果、生成的工件和代码更改。

您还可以通过“阶段历史记录”页面，运行、重新部署、取消或配置阶段。单击运行以运行阶段，单击重新部署以重新部署（如果是部署作业）或配置以配置阶段。阶段运行时，您可以通过单击运行号然后单击取消以取消阶段。

通过脚本下载日志

可以通过脚本下载管道作业的日志文件，并保存管道作业运行期间提供的 PIPELINE_LOG_URL。以下示例说明了将管道作业的日志文件上传到其他系统的步骤。

为阶段设置 JOB_LOG 环境属性。
在管道作业中，保存 PIPELINE_LOG_URL。
```
export JOB_LOG="$PIPELINE_LOG_URL"
```

在同一阶段的后续作业中使用 PIPELINE_LOG_URL 来下载日志文件，以将其导出到其他系统。使用 IBM Cloud 不记名令牌来访问日志文件。

ibmcloud login -a cloud.ibm.com \
  --apikey <INSERT API KEY HERE>

BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )

curl -H "Authorization: Bearer $BEARER"  \
  -H "Accept: text/plain" \
  -D /tmp/headers.txt \
  -o job_log.txt \
  "$JOB_LOG"

检查 X-More-Data 头。如果此头设置为 true，说明正在生成或处理日志文件。如果此头设置为 false，说明日志文件可供使用。
```
grep X-More-Data /tmp/headers.txt
X-More-Data: false
```

将日志文件上传到系统。

scp job_log.txt user@example.org:/job1/logs

通过脚本下载工件

可以通过脚本下载管道构建作业的工件，并保存管道作业运行期间提供的 PIPELINE_ARTIFACT_URL。以下示例说明了将管道作业的工件上传到其他系统的步骤。

为阶段设置 JOB_ARTIFACT 环境属性。
在管道作业中，保存 PIPELINE_ARTIFACT_URL。
```
export JOB_ARTIFACT="$PIPELINE_ARTIFACT_URL"
```

在同一阶段的后续作业中使用 PIPELINE_ARTIFACT_URL 来下载工件，以将其导出到其他系统。使用 IBM Cloud 不记名令牌来访问工件。

ibmcloud login -a cloud.ibm.com \
  --apikey <INSERT API KEY HERE>

BEARER=$( ibmcloud iam oauth-tokens | grep "IAM token" | sed 's/^.*Bearer //g' )

DOWNLOAD_URL=$( curl -H "Authorization: Bearer $BEARER"  \
  "$JOB_ARTIFACT" )

curl -O  "$DOWNLOAD_URL"

将工件上传到系统。

scp $(basename "$DOWNLOAD_URL") user@example.org:/job1/artifacts