将自定义蓝图发布到空间 - Amazon CodeCatalyst
查看和发布自定义蓝图的预览版查看和发布自定义蓝图的正常版本在指定的空间和项目中发布和添加自定义蓝图

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

将自定义蓝图发布到空间

您必须先将自定义蓝图发布到您的空间，之后才能将该自定义蓝图添加到空间的蓝图目录中。您也可以在发布前在 CodeCatalyst 控制台中查看蓝图。您可以发布蓝图的预览版或正常版本。

重要

如果要使用来自外部来源的蓝图包，请考虑使用这些包可能带来的风险。您对添加到空间中的自定义蓝图以及这些蓝图生成的代码负责。

重要

要将自定义蓝图发布到 CodeCatalyst 空间，您必须使用在该空间中具有空间管理员或高级用户角色的账户进行登录。

查看和发布自定义蓝图的预览版

如果您想将自定义蓝图的预览版添加到空间的蓝图目录中，则可以将预览版发布到您的空间。这样就可以在将非预览版本添加到目录之前，以用户身份查看蓝图。使用预览版可以在不占用实际版本的情况下进行发布。例如，如果您正在处理 0.0.1 版本，则可以发布和添加预览版本，这样就可以发布第二个版本的新更新并将其添加为 0.0.2。

进行更改后，可以通过运行 package.json 文件来重新构建自定义蓝图的程序包，并预览所做的更改。

查看和发布自定义蓝图的预览版

  1. 恢复您的开发环境。有关更多信息，请参阅恢复开发环境。

  2. 在您的开发环境中打开工作终端。

  3. （可选）在正常运行的终端中，如果您尚未安装项目所需的依赖项，请安装这些依赖项。使用以下命令：

    yarn

  4. （可选）如果您对 .projenrc.ts 文件进行了更改，请在构建和预览蓝图之前重新生成项目的配置。使用以下命令：

    yarn projen

  5. 使用以下命令重新构建和预览您的自定义蓝图。使用以下命令：

    yarn blueprint:preview

    导航到提供的 See this blueprint at: 链接以预览您的自定义蓝图。根据您的配置，检查用户界面（包括文本）是否按预期显示。如果要更改自定义蓝图，可以编辑 blueprint.ts 文件，重新同步蓝图，然后再次发布预览版本。有关更多信息，请参阅重新合成。

  6. （可选）您可以发布自定义蓝图的预览版，随后可将其添加到空间的蓝图目录中。导航到 Enable version [preview version number] at: 链接以将预览版发布到您的空间。

您无需在 CodeCatalyst 中创建项目即可模拟项目创建过程。要合成项目，请使用以下命令：

yarn blueprint:synth

这将在 synth/synth.[options-name]/proposed-bundle/ 文件夹中生成蓝图。有关更多信息，请参阅合成。

如果您要更新自定义蓝图，请改用以下命令来重新合成您的项目：

yarn blueprint:resynth

这将在 synth/synth.[options-name]/proposed-bundle/ 文件夹中生成蓝图。有关更多信息，请参阅重新合成。

发布预览版后，您可以添加蓝图，以便空间成员能够使用它来创建新项目或将它添加到现有项目。有关更多信息，请参阅将自定义蓝图添加到空间蓝图目录中。

查看和发布自定义蓝图的正常版本

开发和预览自定义蓝图后，您可以查看和发布要添加到空间的蓝图目录的新版本。创建项目时生成的发布工作流将自动发布已推送的更改。如果您在创建蓝图时禁用了工作流生成，则您的蓝图不会自动添加到空间的蓝图目录中。运行 yarn 命令后，您仍可将自定义蓝图发布到您的空间。

查看和发布自定义蓝图

  1. 恢复您的开发环境。有关更多信息，请参阅恢复开发环境。

  2. 在您的开发环境中打开工作终端。

    • 如果您在创建蓝图时选择退出发布工作流生成，请使用以下命令：

      yarn blueprint:release

      您仍可导航到提供的 See this blueprint at: 链接以预览您的自定义蓝图。

      发布自定义蓝图的更新版本，随后可将其添加到空间的蓝图目录中。导航到 Enable version [release version number] at: 链接以将最新版本发布到您的空间。

    • 如果您在创建蓝图时选择了发布工作流，则会在推送更改时自动发布最新的蓝图版本。使用以下命令：

      git add .
      git commit -m "commit message"
      git push

发布正常版本后，您可以添加蓝图，以便空间成员能够使用它来创建新项目或将它添加到现有项目。有关更多信息，请参阅将自定义蓝图添加到空间蓝图目录中。

在指定的空间和项目中发布和添加自定义蓝图

默认情况下，blueprint:preview 和 blueprint:release 命令会发布到已在其中创建蓝图的 CodeCatalyst 空间。如果您有多个企业空间，也可以在这些空间中预览和发布相同的蓝图。您也可以向其他空间的现有项目添加蓝图。

在指定的空间中发布或添加自定义蓝图

  1. 恢复您的开发环境。有关更多信息，请参阅恢复开发环境。

  2. 在您的开发环境中打开工作终端。

  3. （可选）如果您尚未安装项目所需的依赖项，请安装这些依赖项。使用以下命令：

    yarn

  4. 使用 --space 标签将预览版或正常版本发布到指定空间。例如：

    • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

      输出示例：

      Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create
    • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

      输出示例：

      Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

    使用 --project 将自定义蓝图的预览版添加到指定空间中的现有项目。例如：

    yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

    输出示例：

    Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add