使用 SimSpace Weaver 应用程序 SDK 处理快照 - AWS SimSpace Weaver

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

使用 SimSpace Weaver 应用程序 SDK 处理快照

您可以使用 SimSpace Weaver 应用程序 SDK(最低版本 1.13)中提供的脚本来创建和使用快照。

SimSpace Weaver 应用程序 SDK 按项目组织模拟。您可以从一个项目启动多个模拟。其中每个模拟都使用相同的架构和应用程序 .zip 文件。SimSpace Weaver 应用程序 SDK 脚本根据项目名称、AWS 账户 编号和 AWS 区域,将用于模拟的资产放置在特定的 Amazon S3 存储桶中。这些脚本可以处理位于该存储桶根目录下 snapshot 文件夹中的快照文件。指向 snapshot 文件夹的 Amazon S3 URI 采用以下格式:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot
示例
  • 项目名称MyProject

  • AWS 账户 编号:111122223333

  • AWS 区域: us-west-2

  • 快照文件夹 Amazon S3 URI:s3://weaver-myproject-111122223333-artifacts-us-west-2/snapshot

如果您想使用其他 Amazon S3 存储桶,请参阅以下使用快照的其他方法。

使用 SimSpace Weaver 应用程序 SDK 创建快照

要创建快照,您的模拟必须处于 STARTED 状态。快照创建将在当前时间周期完成后开始。SimSpace Weaver 停止向应用程序发送时间周期,但时钟状态仍会显示 STARTED。模拟状态更改为 SNAPSHOT_IN_PROGRESS。快照完成后,模拟状态将变回 STARTED,同时应用程序将再次收到时间周期。

要创建快照
  1. Windows 命令提示符下,转到项目的工具文件夹。

    cd project-folder\tools\windows
  2. 如果您不知道模拟的名称,请调用 list-simulations API 来查看模拟资源列表。确保模拟状态为 STARTED

    .\weaver-project-name-cli.bat list-simulations
  3. 为项目运行 create-snapshot 脚本。

    .\create-snapshot-project-name.bat --simulation simulation-name

    示例

    .\create-snapshot-MyProject.bat --simulation MyProjectSimulation_23-04-29_12_00_00

SimSpace Weaver 在项目构件存储桶中为项目创建快照文件。

示例
  • 项目名称MyProject

  • AWS 账户 编号:111122223333

  • AWS 区域: us-west-2

  • 快照文件夹 Amazon S3 URI:s3://weaver-myproject-111122223333-artifacts-us-west-2/snapshot

  • 模拟名称:MyProjectSimulation_23-04-29_12_00_00

  • 快照时间:April 29, 2023, 15:30:27 UTC

  • 快照文件名:MyProjectSimulation_23-04-29_12_00_00-230429-1530-27.zip

  • 快照文件 Amazon S3 URI:s3://weaver-myproject-111122223333-artifacts-us-west-2/snapshot/MyProjectSimulation_23-04-29_12_00_00-230429-1530-27.zip

使用 SimSpace Weaver 应用程序 SDK 从快照启动模拟

当您使用应用程序 SDK 脚本从快照启动模拟时,这些脚本会创建新的模拟名称,就像在没有快照的情况下启动模拟一样。

您的快照文件必须存在于 Amazon S3 的快照位置,并且具有以下 Amazon S3 URI:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot

应用程序 .zip 文件必须与创建快照时所在的位置相同。

SimSpace Weaver 创建新的模拟资源,使用存储在快照中的实体数据初始化 State Fabric,启动创建快照时正在运行的相同空间和服务应用程序的新实例,并将时钟设置为相应的时间周期。您必须通过正常流程单独启动自定义应用程序。

start-from-snapshot 脚本是 start-simulation 脚本的快照版本。就像 start-simulation 脚本一样,start-from-snapshot 脚本不会启动时钟。您必须单独启动时钟。

从快照启动模拟
  1. Windows 命令提示符下,转到项目的工具文件夹。

    cd project-folder\tools\windows
  2. 运行 start-from-snapshot 脚本。

    .\start-from-snapshot-project-name.bat --snapshot-s3-file snapshot-file-name

    示例

    .\start-from-snapshot-MyProject.bat --snapshot-s3-file MyProjectSimulation_23-04-29_12_00_00-230429-1530-27.zip

使用 SimSpace Weaver 应用程序 SDK 从快照快速启动模拟

您可以从快照快速启动模拟。这类似于不使用快照的快速启动。

您的快照文件必须存在于 Amazon S3 的快照位置,并且具有以下 Amazon S3 URI:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot

应用程序 .zip 文件必须与创建快照时所在的位置相同。

SimSpace Weaver 创建新的模拟资源,使用存储在快照中的实体数据初始化 State Fabric,启动创建快照时正在运行的相同空间和服务应用程序的新实例,并将时钟设置为相应的时间周期。您必须通过正常流程单独启动自定义应用程序。

quick-start-from-snapshot 脚本是 quick-start 脚本的快照版本。就像 quick-start 脚本一样,quick-start-from-snapshot 脚本会启动时钟。它还会启动路径查找示例项目的查看应用程序。

从快照快速启动模拟
  1. Windows 命令提示符下,转到项目的工具文件夹。

    cd project-folder\tools\windows
  2. 运行 quick-start-from-snapshot 脚本。

    .\quick-start-from-snapshot-project-name-cli.bat --snapshot-s3-file snapshot-file-name

    示例

    .\quick-start-from-snapshot-MyProject-cli.bat --snapshot-s3-file MyProjectSimulation_23-04-29_12_00_00-230429-1530-27.zip

使用 SimSpace Weaver 应用程序 SDK 列出项目的快照

您可以使用 list-snapshots 脚本列出项目的快照。该脚本列出项目 snapshot 文件夹中的文件。项目是 SimSpace Weaver 应用程序 SDK 所独有的,因此您只能使用应用程序 SDK 脚本执行此操作,并且只能对项目执行此操作。该脚本假定 Amazon S3 上 snapshot 文件夹中的所有文件都是快照文件。如果您从文件夹中移动或删除文件,则这些文件将不会出现在列表中。

列出项目的快照
  1. Windows 命令提示符下,转到项目的工具文件夹。

    cd project-folder\tools\windows
  2. 运行 list-snapshots 脚本。

    .\list-snapshots-project-name.bat

    示例

    .\list-snapshots-MyProject.bat