IBM Cloud Docs
计划限制和使用

计划限制和使用

The use of IBM Cloud® Continuous Delivery is limited to the building, deploying, testing, and ongoing operations of applications on the IBM Cloud platform or other compatible platform-as-a-service (PaaS) or infrastructure-as-a-service (IaaS) products.

服务实例的作用域

您必须具有 Continuous Delivery 服务实例，才能创建和使用包含 Delivery Pipeline，Git Repos and Issue Tracking和 DevOps Insights 工具集成的 DevOps 工具链。 服务实例位于区域中，属于 资源组。 特定区域和资源组中的Continuous Delivery服务实例管理和监控同一区域和资源组中所有工具链的使用情况。

价格套餐

下表概述了Continuous Delivery 的定价计划：

价格套餐
套餐 成本 限制
Lite 免费 Lite 套餐提供 Continuous Delivery 的完整功能，并限制使用。
Professional 付费 专业套餐提供 Continuous Delivery 的完整功能，并且没有使用限制。

每个帐户最多只能有一个轻量服务实例。 如果要在多个资源组或多个区域内使用工具链，建议使用专业计划。

如需了解更多信息，请参阅 定价计划。

使用情况度量

Continuous Delivery 服务实例跟踪并报告 IBM Cloud 帐户中的使用情况度量。 根据服务实例的定价计划，指标可能会影响使用成本、使用限制或两者。 下表概述了Continuous Delivery 的使用指标：

精简版和专业版计划的使用指标
用途 指标 摘要
授权用户 AUTHORIZED_USERS_PER_MONTH 给定月份内服务实例的平均授权用户数的计数。
管道运行 JOB_EXECUTIONS_PER_MONTH 在给定月份内运行的管道 Tekton 步骤或经典作业总数的计数。

合并计费

缺省情况下，Continuous Delivery 服务实例相互独立地报告使用情况。 如果您将工具链划分为独立账户中的多个资源组或 企业 中的多个账户，则工具链的用户可能会在Continuous Delivery服务的多个相应实例中多次被报告为授权用户。

例如，将对集成到不同资源组中的两个工具链中的 Git Repos and Issue Tracking 项目上的开发者进行计数，并根据 Professional 套餐对其进行两次计费。

缺省情况下，已禁用合并计费。 不过，您可以在企业账户中启用Continuous Delivery服务实例与专业计划的合并计费，这样就可以将一个区域内企业层次结构中所有服务实例的授权用户合并到一个列表中。 这样，您就可以确保授权用户的电子邮件在您的企业和地区内只被计算和计费一次。

合并计费功能仅适用于 Continuous Delivery Professional 套餐。 合并仅在包含已启用合并计费功能的Continuous Delivery服务实例的区域内进行。

启用合并计费

要启用合并计费，您必须在企业账户中拥有Continuous Delivery的专业计划实例，并且必须以编辑或管理员角色访问该实例。

要启用合并计费，请完成以下步骤：

  1. 在IBM Cloud控制台中，从控制台菜单栏的账户下拉菜单中选择要合并计费的企业账户。
  2. 单击导航菜单 导航菜单图标>资源列表。
  3. 输入 "Continuous Delivery 可将列表筛选为现有实例。
  4. 单击要合并账单的实例名称。
  5. 单击管理>合并计费。
  6. 在“启用合并计费”部分单击“开”。
  7. 在“合并授权用户”部分查看电子邮件地址列表，确保其完整和正确。

合并计费详细信息仅适用于Continuous Delivery服务实例，其专业计划位于企业账户（企业层次结构中最顶层的账户）中。

如果将已启用综合计费的Continuous Delivery实例的计划从专业计划更改为其他计划，综合计费将自动禁用。 要重新启用合并计费，必须首先将计划更改回 Professional。

禁用综合账单

  1. 按照上一节的步骤 1 至 7 操作。
  2. 单击启用合并计费部分中的关。

合并计费如何工作?

默认情况下，每个Continuous Delivery实例都会报告授权用户的数量。 企业账户中的实例启用合并计费后，该实例将代表同一区域和企业层次结构中的所有实例（包括所有子账户中的实例和企业账户中其他资源组中的任何其他实例）报告授权用户数。

从区域和账户层次结构中的所有实例中编制授权用户列表。 此外，还会删除重复的电子邮件地址，并在企业账户级别报告由此产生的授权用户电子邮件地址合并列表的计数。

要查看授权用户电子邮件地址的合并列表，请执行以下操作:

  1. 在资源列表中输入 "Continuous Delivery，筛选出适合您的实例。
  2. 单击已启用合并计费的实例名称。
  3. 单击管理>合并计费。
  4. 查看合并授权用户部分的电子邮件地址列表。 该列表为只读，因为它是从企业层次结构中所有服务实例的授权用户列表中生成的。

服务实例启用合并计费后，企业层次结构中所有其他实例的“管理”>“授权用户”选项卡都会包含详细信息，说明合并计费适用于这些实例。

合并计费的限制

  • 需要企业账户层次结构。 您无法在独立账户中启用跨资源组的合并计费。
  • 需要专业计划。
    • 您不能使用任何其他计划为Continuous Delivery实例启用合并计费。
    • 授权用户只能从采用专业计划的Continuous Delivery实例中合并。 换句话说，有 Lite 计划的实例不参与合并计费。
  • 您只能为企业账户中的服务实例启用合并计费。 而且，在企业账户中最多只能为一个实例启用该功能。
  • 合并计费仅适用于授权用户。 它不会影响管道运行的报告方式。
  • 合并计费仅限于单个给定区域。 无法将使用情况从一个区域合并到另一个区域。
  • 即使您为特定实例启用了合并计费，但在企业层次结构中，该服务的所有其他专业计划实例的授权用户仍为零，尽管这些实例的授权用户仍在列表中。

删除已启用合并计费的企业账户中的实例时，该实例的计费将停止。 企业和地区的其他服务实例恢复正常计费。 在回收过程中恢复已删除的服务实例时，不会自动重新激活合并计费。 要为已恢复的实例重新启用合并计费，请从已恢复的Continuous Delivery实例选项卡转到管理>合并计费。

管理授权用户

Continuous Delivery定价计划是根据实例的授权用户数量来定义和定价的。 授权用户会根据实例的使用情况自动添加到实例中。

您可以从每个实例的“管理”>“合并计费”选项卡中查看和管理授权用户列表。

如果启用了合并计费，还可以从“合并计费”选项卡中查看企业账户中每个实例的授权用户列表。

如果您的工具链在“IBM提供的”open-toolchain 组中集成了“Git Repos and Issue Tracking项目，例如”us-south.git.cloud.ibm.com/open-toolchain，则这些项目的成员不会被视为您工具链的授权用户。

精简版计划有其局限性。 如需了解更多信息，请参阅 服务定价详情。

您可以维护与授权用户相关的活动日志。 有关查看、管理和审计实例中由服务启动和用户启动的活动的更多信息，请参阅 IBM Cloud Activity Tracker Event Routing事件。

当Continuous Delivery实例位于资源组中时，如何计算用户数量？

使用属于每个Continuous Delivery实例的授权用户列表对用户进行计数和管理。 当用户满足以下任一条件时，会将该用户自动添加到此列表：

  • 查看，编辑或运行交付管道 (直接在用户界面中或通过落实到存储库而间接运行)。
  • 与 DevOps Insights交互。
  • 具有对 Git Repos and Issue Tracking 中存储库的开发者（或更高角色）访问权，能够向该存储库提交和推送更改。 具有开发者 (或更高) 角色的 Git 项目访问令牌的用户将计为授权用户。 这些用户以 bot 用户身份显示在授权用户列表中。

具有访客或报告者角色的用户不会自动添加到授权用户列表中。 要阻止用户访问工具链并阻止自动将其添加到 Continuous Delivery 服务实例的授权用户列表中，请完成以下操作：

  • 删除用户对工具链的身份和访问管理 (IAM) 访问权限。
  • 从连接到资源组和区域中所有工具链的所有 Git Repos and Issue Tracking 存储库中除去开发者和更高级别的访问权，方法是除去其存储库访问权或将其角色降级到访客或报告者。

用于自动计算用户数的具体活动以及计算这些用户数的方法可能会随着时间的推移而改变。 但是，对用户计数的过程将继续符合 Continuous Delivery 套餐的条款。 您也可以随时手动将用户添加到授权用户列表中。

有关使用 IAM 管理对资源组中的工具链的访问权或有关工具链本身的更多信息，请参阅使用 Identity and Access Management 管理用户对工具链的访问权。 有关管理Git Repos and Issue Trackingrepo 访问权限的更多信息，请参阅 项目成员。

在资源组中组织工具链的方法直接影响用户访问和计费。 默认情况下，当用户在多个区域或资源组中使用工具链时，会对每个区域和资源组中的每个Continuous Delivery实例进行核算和计费。 如果在企业账户中使用专业计划，则可以通过启用合并计费（如前所述）来减少企业内计费的授权用户总数。

完成以下步骤来管理Continuous Delivery实例的授权用户列表：在Continuous Delivery实例的“管理” 选项卡上。

  1. 在资源列表中输入 "Continuous Delivery，筛选出适合您的实例。

  2. 单击实例名称可浏览实例详细信息。

    • 单击“管理”>“授权用户”，根据需要从授权用户列表中查看、添加或删除用户。
    • 如果启用了合并计费，请单击管理>合并计费查看授权用户的合并列表。

    当用户使用Continuous Delivery实例时，系统会自动添加或重新添加用户。

查看账单和使用详情

您可以查看账户中Continuous Delivery实例的计费和使用详情，以及在IBM Cloud公共环境中针对每个实例报告的用户数量和管道执行次数。

  1. 从控制台菜单栏，单击管理>计费和使用量，然后单击使用量。
  2. 从服务列表中，单击“查看计划获取”Continuous Delivery实例。
  3. 单击“查看详情”查看实例的具体计划详情。
  4. 单击“查看实例详细信息”查看实例的使用信息。

AUTHORIZED_USERS_PER_MONTH 指标是根据每日统计的每月平均用户数计算得出的。 如果启用了综合计费，则启用账户中的实例会报告综合 "AUTHORIZED_USERS_PER_MONTH 指标。 企业层次结构中的所有其他实例报告为零。

超出服务套餐的限制时会发生什么情况？

精简版服务计划包含某些限制，例如服务授权用户数量限制、每月可运行的经典Delivery Pipeline作业或 Tekton 步骤数量限制。 如果在账单期内超过任何计划限制，服务将被暂停。 例如，经典Delivery Pipeline作业和 Tekton 管道步骤在计费期的剩余时间内不会运行。 有关计划的更多信息，请参阅“目录中Continuous Delivery的详细信息”"{: external}"。

您可以避免简装版服务计划的限制，并通过升级到专业版计划来重新激活实例，具体方法如下。

在用户界面中升级服务计划

  1. 从资源列表中，单击具有 Lite 服务计划的Continuous Delivery实例进行升级。
  2. 单击实例仪表板上的计划。
  3. 在更改定价计划部分，选择专业，然后单击保存。

升级计划后，您必须重新启动应用程序：

  1. 转到资源列表，找到服务绑定的应用程序。
  2. 打开“操作”菜单，选择“重启应用程序”。

在 CLI 中升级服务计划

  1. 检查服务是否支持资源控制器。

    ibmcloud catalog service continuous-delivery

    如果该服务已通过资源控制器启用，则会列出 "RC Compatible true。 记下您要升级的计划的 ID。

    ID                 59b735ee-5938-4ebd-a6b2-541aef2d1f68
Name               continuous-delivery
Kind               service
Provider           IBM
Tags               dev_ops, eu_access, gc_migrate, ibm_created, lite, rc_compatible
Active             true
Description        Support DevOps best practices by using Git, issue tracking, and CI/CD pipelines in the Cloud.
Bindable           false
Original Name      continuous-delivery
RC Compatible      true
RC Provisionable   true
IAM Compatible     true
Children           Name                      Kind         ID
                   lite                      plan         a35fb0e9-4fc2-400e-8161-49078e5af632
                   professional              plan         9ca4dc64-bc7b-4aba-9c1c-8bbf30ff127e

  2. 使用 "ibmcloud resource service-instance-update 命令 升级实例的计划。

    ibmcloud resource service-instance-update <service_instance_name>
--service-plan-id <plan_id>

Delivery Pipeline 使用情况

查看“简易服务”计划中包含的输送管道的以下限制：

  • 500 步和作业运行限制包括 Tekton 管道的管道步骤和 Classic 管道的管道作业运行。 如果您的管道在一次运行中包含多个步骤，例如DevSecOps管道，您可能很快就会达到这个限制。
  • 交付管道故障 (不包括跳过的步骤运行和经典作业运行) 将作为每月 500 Tekton 步骤运行限制的一部分进行计算。 此 500 步运行限制也适用于 Classic 管道的 Classic 作业运行。
  • 在一个资源组中，您的所有工具链以及这些工具链中的流水线都会受到每月 500 次 Tekton 步骤运行的限制。 由于管道步骤运行和作业运行是在特定Continuous Delivery实例的资源组级别上计算的，因此使用了相同的限制。

五天宽限期只在首次达到 500 步运行限制时提供一次。

管道的保留期因管道类型和为Continuous Delivery实例选择的计划而异。

  • 经典管道在任一套餐上最多保留 10 个阶段运行。
  • 专业套餐下的 tekton 管道将 PipelineRuns 及其日志保留一年。
  • 轻量套餐下的 Tekton 管道将 PipelineRuns 及其日志保留 30 天。

可接受的使用行为包括但不限于以下行为：

  • 对于受支持的编程语言，编译和组合工件。
  • 自动部署应用程序工件、配置和支持资源或服务。
  • 因开发流程而触发的测试、验证和其他由开发事件生成的行为。

不允许的使用行为包括但不限于以下行为：

  • 使用管道作业或工作程序执行一般计算行为，如比特币挖掘、分布式拒绝服务攻击和对 IBM Cloud 平台内的其他客户或用户或者一般因特网用户的恶意或攻击行为。
  • 在正常开发过程中使用宣扬仇恨言论的网站或服务，或其他违反 "IBM商业行为指南的活动。
  • 使用事件生成的行为，对 IBM Cloud 或其他站点进行恶意侵入或攻击。

对于违反 "Continuous Delivery服务可接受使用行为或 "IBM商业行为准则的用户，"IBM可自行决定禁用其服务，恕不另行通知。 如果用户在收到攻击行为通知后改正其使用行为，某些服务可以恢复。 否则，可能会暂挂或终止帐户。

Git Repos and Issue Tracking 限制

Git Repos and Issue Tracking建立在 "GitLab"和 "Community Edition"之上，并由“IBM Cloud托管，但”GitLab的一些选项不可用：

  • 因为 Delivery Pipeline 为 IBM Cloud 提供持续集成和持续交付，所以在 GitLab 中不支持持续集成功能。
  • GitLab管理功能不可用，因为它们由IBM 管理。
  • 可能无法完全访问 Git Repos and Issue Tracking。

Git Repos and Issue Tracking 用户信息和内容

可以使用三种 Git Repos and Issue Tracking 项目类型：

  • 公共项目对所有站点访问者可见。 访问Continuous Delivery的每个人都能看到公共项目中的内容，即使他们没有被邀请加入项目。
  • 专用项目仅对精选的用户显示。 有关授予用户项目访问权的更多信息，请参阅项目 成员。
  • 内部项目对所有登录的用户可见。 具有 IBM Cloud 帐户的任何用户都可以查看这些项目。

有关项目设置的更多信息，请参阅 更改项目可视性。

当您使用 Git Repos and Issue Tracking 时，您向项目提供的内容即获得该项目中指定的任何条款的许可。 当您创建项目时，请包括描述适用于该内容的许可证的文件。 当您提交至项目时，您与提交相关联的名称和电子邮件地址可能对公众可见。 当您通过 IBM Cloud Web 界面创建提交时，会使用与 Git Repos and Issue Tracking 帐户相关联的电子邮件地址。

将实例链接到Git项目

Git项目必须链接到使用工具链的Continuous Delivery实例，因为Git Repos and Issue Tracking是服务的组成部分。 将您的项目添加到工具链后，使用其他工具Continuous Delivery会更加方便。Pipelines 或DevOps Insights。 因此，它可以简化开发工作流程，提高代码质量。

您可以使用控制台或 API 将您的实例和工具链实例链接到Git项目。

在用户界面中链接Continuous Delivery和工具链实例

链接新项目

创建新项目时，您需要使用用户界面来链接Continuous Delivery和工具链实例。

连接现有项目

  1. 转到项目>常规>设置。
  2. 选择要添加实例的项目。
  3. 转到 Continuous Delivery>展开以更新或添加Continuous Delivery和工具链实例。

使用 API 链接Continuous Delivery和工具链实例

在使用 API 创建新项目时，您可以链接Continuous Delivery和工具链实例。

  • 在创建项目时，使用可选标题 "IBM-CLOUD-API-KEY 添加Continuous Delivery和工具链。 从 控制台登录页面 生成 API 密钥的键值。

  • 添加请求参数“toolchain_ID 和”cd_instance，将Git项目链接到特定的Continuous Delivery和工具链实例。

    • toolchain_id 参数取代 cd_instance 参数。 如果两者都提供，则使用工具链 ID。 但是，如果只给出 cd_instance 参数，则会自动为指定的 CD 实例创建默认工具链。

      要成功使用这些请求参数，必须使用 IBM-CLOUD-API-KEY 标头。

完成以下步骤，查找Continuous Delivery和工具链实例的 ID：

  1. 在控制台中，单击导航菜单 导航菜单图标>资源列表。

  2. 从资源列表中，单击所需的工具链或Continuous Delivery实例。

  3. 单击 Details 查看并复制 GUID 和 CRN 详情。

    对于 "toolchain_ID 参数，使用工具链的 GUID。 对于 "cd_instance 参数，可使用 GUID 或 CRN 作为其值。