IBM Cloud Docs
使用 CLI 加载 Terraform 模板

使用 CLI 加载 Terraform 模板

本教程将指导您如何使用 CLI 将 Terraform 模板加载到帐户中。 通过完成本教程，您将了解如何创建专用目录并导入模板。 之后，您可以验证模板是否可以创建资源或运行脚本，并且可以使其可供有权访问您的帐户的用户使用。

准备工作

  1. 验证您是否正在使用现收现付帐户或预订帐户。 有关更多详细信息，请参阅 查看帐户类型。

  2. 将源代码上载到 GitHub 或 GitLab 存储库中的发行版。 请参阅 设置源代码存储库。

  3. 确保为您分配了以下 IAM 访问权:

    • 目录管理服务的编辑者角色
    • 帐户中所有资源组的查看者角色
    • Secrets Manager 服务上的写程序角色

  4. 安装 IBM Cloud CLI和 IBM Cloud Schematics 插件。 请参阅 设置 CLI 以获取更多信息。

  5. 创建 Terraform 模板。

    1. 查看 支持的映像 的列表。
    2. 创建 IBM Cloud Object Storage 的实例，并将映像添加到存储区。

要与其他帐户共享软件，必须在 Partner Center 中核准您的软件。 有关更多信息，请参阅进行设置以销售软件。

创建专用目录

完成以下步骤以使用 CLI 添加软件。 您可以在 CI/CD 过程中使用此任务。

创建专用目录。 专用目录为您提供了一种方法来管理帐户中用户对产品的访问权。 有关更多信息，请参阅 cli 文档 以创建专用目录。

ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]

将 Terraform 模板添加到目录

将软件添加到您的私人目录中。 有关更多信息，请参阅 cli 文档 以了解如何将软件添加到专用目录。

ibmcloud catalog offering create --catalog "Name of catalog" --zipurl https://software.url.com.tgz

如果要从专用存储库导入软件，可以通过向命令添加 [-- token TOKEN] 来使用个人访问令牌。

向 Terraform 模板添加类别标记

添加类别。 缺省情况下，会将 开发者工具 类别添加到产品中。 有关更多信息，请参阅 cli 文档 以添加类别。

ibmcloud catalog offering add-category --catalog "Name of catalog" --offering "software-offering" --category "category"

更新 Terraform 模板

要更新专用目录中的产品，您首先需要获取该产品，然后可以进行更新。 有关更多信息，请参阅 cli 文档 以更新产品。

运行 offering get 命令。 有关更多信息，请参阅 ibmcloud catalog offering get。

ibmcloud catalog offering get -c <CATALOGID> -o <OFFERINGID> --output json

运行 offering update 命令。

ibmcloud catalog offering update -c <CATALOGID> -o <OFFERINGID> --updated-offering <UPDATED_OFFERING.json>

导入 Terraform 模板的版本

导入目录中所需的软件版本。

ibmcloud catalog offering import-version -c <CATALOGID> -o <OFFERINGID> --zipurl <TGZ> --target-version <VERSION>

验证 Terraform 模板

验证软件。 有关更多信息，请参阅 cli 文档 以验证软件。

ibmcloud catalog offering version validate --version-locator VERSION_NUMBER --cluster CLUSTER_ID --namespace NAME [--timeout TIMEOUT] [--wait WAIT] [--override-values VALUES|FILENAME]

部署软件可能需要几分钟时间。 您可以通过查询产品验证状态来检查验证状态。 当状态为“有效”时，验证完成。 有关更多信息，请参阅 cli 文档 以了解验证状态。

ibmcloud catalog offering version validate-status --version-locator VERSION_NUMBER [--output FORMAT]

将版本标记为就绪

发布产品时，所有在其中标记为就绪的版本都具有相同的可视性。 如果您的产品已获准发布，那么可以使用以下命令来管理版本和产品的共享。

ibmcloud catalog offering ready --vl <VERSION_LOCATOR>

发布 Terraform 模板

发布软件以使其可供帐户中的用户使用。 有关更多信息，请参阅 cli 文档 以发布到您的帐户。

ibmcloud catalog offering publish account [--catalog CATALOG][--offering OFFERING]