在入职期间扩展可部署架构

在将可部署架构加入私有目录时，您可以选择将其与其他架构堆叠来进行扩展。 在添加其他架构时，您需要指定这些架构是否是按计划部署架构所必需的，或者是否可以选择使用它们来扩展用例。 当您完成入职培训后，就能获得一个由多个可部署架构组成的强大端到端解决方案。

您想堆叠在一起的可部署架构是否已经在目录中提供？ 如果是这样，您可以 在一个项目中堆叠这些架构，并将该解决方案作为一个单独的目录条目加入。 目前，在项目中堆叠可部署架构时，不支持包含可选或可互换架构。 因此，如果要部署端到端解决方案，需要将所有架构堆叠在一起，那么这种方法最有效。

为什么要扩展可部署架构？

您可以出于不同的原因扩展可部署架构。 例如，如果您要上架的架构需要一个依赖项，您可以将其与它所依赖的架构堆叠在一起。 如果依赖关系被列为必需，那么用户在配置和部署可部署架构时，就会将其一并包含在内。

同样，为了鼓励默认情况下的可部署架构的安全性，您可以将满足安全需求的其他架构与该架构堆叠在一起。 如果按照建议将其他可部署架构包括在内，则有助于确保组织中的用户以特定方式部署架构，并将这些安全防护措施落实到位。 默认情况下包含推荐架构，但用户可以将其移除。

您还可以扩展可部署架构，为用户提供更多自定义选项，以便他们利用扩展用例。 也许你的架构与另一个可部署架构配合得很好，而后者并不需要满足依赖性或合规性要求。 您可以将可部署架构添加为可选项，用户可以在将可部署架构添加到项目时选择包含该架构。

准备工作

完成 将可部署架构加入私有目录的 步骤后，系统会提示您配置版本详细信息。 转到“扩展你的架构”，将其他可部署架构与你正在入驻的架构堆叠在一起。

如果您已经启用了可部署架构，请编辑私有目录中的版本，然后转到扩展架构。

喜欢用代码工作？ 您可以在目录清单文件中指定其他可部署架构的详细信息，以便与您要上载的架构堆叠。 将 dependency_version_2 属性设置为 true，然后使用 dependencies 数组指定要将哪些架构包含在入驻的架构中。 有关如何构建目录清单的更多信息，请参阅 本地编辑清单文件。

添加可部署架构

当您采用可部署架构时，您可以通过与其他架构堆叠来扩展它。 在添加其他架构时指定关系，然后定义变量供用户在堆叠在一起的架构中进行配置。 完成以下步骤：

  1. 将可部署架构加入目录时，在“扩展架构”部分单击“添加”。
  2. 使用产品菜单选择要添加的可部署架构。 您可以在目录中选择您的账户可以访问的任何可部署架构。
  3. 为要添加的可部署架构选择“关系”选项。 该架构要么是必需的，要么是无法拆除的。 这是可选项，用户可以选择是否包含。 或者，默认情况下推荐并包含该功能，但用户可以选择将其移除。 更多信息，请转到 指定关系。
  4. 可选项：如果要添加两个或更多可部署架构，并可根据用户的偏好进行互换，请在“扩展架构”表中选择它们，然后单击“分组为可互换”。 用户可以根据自己的需要选择使用哪种架构。
  5. 完成添加可部署架构后，单击下一步 > 定义变量，为用户定义变量。 在这里，你可以将可部署架构连接在一起，这样用户就可以在一个界面中配置输入，而不是逐个配置架构。 如需了解更多信息，请参阅 为用户定义变量。

指定关系

当您将可部署架构与入驻的架构堆叠在一起时，您会被要求指定一个“关系”。 您添加的可部署架构与您加入私有目录的整体解决方案之间有什么关系？ 您可以从三个选项中进行选择：必填、可选和推荐。 下表描述并解释了当用户从私有目录将架构添加到项目时，每个选项对定制端到端解决方案的影响：

关系选项说明
选项 描述
必需 当用户将您的架构添加到项目中时就会包括在内。 用户无法删除所需的架构，因为它们是整个解决方案按预期运行所必需的。
可选 默认不包括。 如果用户希望利用扩展用例，可以选择包含可选架构。
建议 默认情况下已包含，但用户可以根据需要将其移除。

例如，您可能希望通过在可部署架构中添加 IBM Cloud Secrets Manager 作为建议来鼓励安全部署。这样，当用户将您的可部署架构添加到项目中时，就会默认包含 Secrets Manager。 不过，如果用户有其他管理机密的工具，或者不需要 Secrets Manager，则可以选择将其排除在外。

为用户定义变量

通过堆叠其他架构扩展可部署架构后，需要为用户定义变量。 最终目标是将可部署的架构连接在一起，这样用户就可以在一个界面中配置输入，而不是逐个配置架构。 请考虑以下问题：

  • 用户需要配置可部署架构中的哪些输入？ 需要将这些输入添加到您的产品中，这样用户就可以对其进行配置，而无需逐一编辑各个架构。 选择添加到产品即可。

  • 哪些可部署架构需要通过引用输入或输出连接在一起？ 例如，如果一个架构中的输入依赖于另一个架构的输出，则在输入中添加一个引用，将其连接到输出。 选择“引用变量”即可。

    只有您添加到产品中的输入才能引用输出。 如果您添加了一个架构，而它的一个输入需要引用另一个架构的输出，请为该输入选择添加到产品。 然后，为您添加的输入选择引用变量。 在这里，您可以选择包含输出的架构。 选择输出作为变量类型，然后选择输入要引用的输出名称。

  • 是否为用户解决了所有必要的输入问题？ 对于未添加到产品中的所需输入，请提供一个固定值或参考值来解决这些输入。 这样做可以连接端到端解决方案中的架构，使用户更容易配置和部署。

    控制台中不能提供默认值。 使用目录清单文件 configuration 数组中的 default_value 属性来指定默认值。 更多信息，请参阅 本地编辑清单文件。

  • 用户是否需要任何有关变量的额外信息来帮助他们配置变量？ 在产品中添加输入变量时，您可以改变输入在用户面前的显示方式。 通常情况下，为变量或描述提供一个新名称是非常有用的，尤其是在包含两个相似变量的情况下。 例如，如果您正在上架的架构包含一个 region 输入，并且您还从基础架构中添加了一个 region 输入，那么当您将其添加到产品中时，请考虑将该输入命名为 region-infrastructure。 一个有意义的名称有助于识别输入的使用位置，并使其更易于配置。

您添加到产品中的任何输入都包含在输入变量表中。 如果需要删除已添加的变量，请选择该变量并单击“删除”。

后续步骤

在为用户定义好变量后，继续启用可部署架构。 完成后，可以访问您的私有目录的用户就可以将您的可部署架构添加到项目中。 当他们这样做时，他们可以根据您在入职过程中指定的内容选择他们想要包含的架构，从而对其进行自定义。