

終止支援通知： 將於 2026 AWS 年 5 月 20 日結束對 的支援 AWS SimSpace Weaver。2026 年 5 月 20 日之後，您將無法再存取 SimSpace Weaver 主控台或 SimSpace Weaver 資源。如需詳細資訊，請參閱[AWS SimSpace Weaver 終止支援](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 管理您的 資源 AWS CloudFormation
<a name="working-with_cloudformation"></a>

您可以使用 AWS CloudFormation 來管理您的 AWS SimSpace Weaver 資源。 CloudFormation 是一項獨立的 AWS 服務，可協助您以程式碼形式指定、佈建和管理 AWS 基礎設施。 CloudFormation 使用 建立 JSON 或 YAML 檔案，稱為*[範本](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html#cfn-concepts-templates template)*。您的範本會指定基礎設施的詳細資訊。 CloudFormation 使用您的範本將基礎設施佈建為單一單位，稱為*[堆疊](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-whatis-concepts.html#w2ab1b5c15b9)*。刪除堆疊時，您可以同時 CloudFormation 刪除堆疊中的所有項目。您可以使用標準原始碼管理程序來管理範本 （例如，在 [Git](https://git-scm.com/) 等版本控制系統中追蹤範本）。如需 的詳細資訊 CloudFormation，請參閱[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide)》。

**您的模擬資源**  
在 中 AWS，*資源*是您可以使用的實體。範例包括 Amazon EC2 執行個體、Amazon S3 儲存貯體或 IAM 角色。您的 SimSpace Weaver 模擬是 資源。在組態中，您通常會以 的形式指定 AWS 資源`AWS::service::resource`。對於 SimSpace Weaver，您可以將模擬資源指定為 `AWS::SimSpaceWeaver::Simulation`。如需 中模擬資源的詳細資訊 CloudFormation，請參閱*AWS CloudFormation 《 使用者指南*》中的[SimSpace Weaver](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-simspaceweaver-simulation.html)一節。

**如何 CloudFormation 搭配 使用 SimSpace Weaver？**  
您可以建立 CloudFormation 範本，指定您要佈建 AWS 的資源。您的範本可以指定整個架構、架構的一部分，或小型解決方案。例如，您可以為 SimSpace Weaver 解決方案指定 架構，其中包含 Amazon S3 儲存貯體、IAM 許可、Amazon Relational Database Service 或 Amazon DynamoDB 中的支援資料庫，以及您的 `Simulation` 資源。然後，您可以使用 CloudFormation 將所有這些資源佈建為單位，並同時佈建。

**Example 範本，可建立 IAM 資源並啟動模擬**  
下列範例範本會建立 IAM 角色和許可， SimSpace Weaver 這些角色和許可需要在您的帳戶中執行動作。 SimSpace Weaver 應用程式開發套件指令碼會在您建立專案 AWS 區域 時，於特定 中建立角色和許可，但您可以使用 CloudFormation 範本將模擬部署至另一個 AWS 區域 ，而無需再次執行指令碼。例如，您可以這樣做來設定備份模擬，以用於災難復原。  
在此範例中，原始模擬名稱為 `MySimulation`。結構描述的儲存貯體已存在於 AWS 區域 中，其中 CloudFormation 將建置堆疊。儲存貯體包含已正確設定在其中執行模擬的結構描述版本 AWS 區域。請記住，結構描述會指定應用程式 zip 檔案的位置，這是與模擬相同 AWS 區域 中的 Amazon S3 儲存貯體。當 CloudFormation 建置堆疊 AWS 區域 時，應用程式 zip 儲存貯體和檔案必須已存在於 中，否則模擬不會啟動。請注意，此範例中的儲存貯體名稱包含 AWS 區域，但這無法判斷儲存貯體的實際位置。您必須確定儲存貯體實際位於 AWS 區域 （您可以在 Amazon S3 主控台、使用 Amazon S3 APIs 或 中的 Amazon S3 命令來檢查儲存貯體屬性 AWS CLI)。  
此範例使用 中的一些內建函數和參數 CloudFormation 來執行變數替換。如需詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*》中的[內部函數參考](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference.html)和[虛擬參數參考](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/pseudo-parameter-reference.html)。  

```
AWSTemplateFormatVersion: 2010-09-09
Resources:
  WeaverAppRole:
    Type: AWS::IAM::Role
    Properties:
      RoleName: SimSpaceWeaverAppRole
      AssumeRolePolicyDocument:
        Version: 2012-10-17
        Statement:
        - Effect: Allow
          Principal:
            Service:
              - simspaceweaver.amazonaws.com
          Action:
            - sts:AssumeRole
      Path: /
      Policies:
        - PolicyName: SimSpaceWeaverAppRolePolicy
          PolicyDocument:
            Version: 2012-10-17
            Statement:
            - Effect: Allow
              Action:
                - logs:PutLogEvents
                - logs:DescribeLogGroups
                - logs:DescribeLogStreams
                - logs:CreateLogGroup
                - logs:CreateLogStream
              Resource: *
            - Effect: Allow
              Action:
                - cloudwatch:PutMetricData
              Resource: *
            - Effect: Allow
              Action:
                - s3:ListBucket
                - s3:PutObject
                - s3:GetObject
              Resource: *
  MyBackupSimulation:
    Type: AWS::SimSpaceWeaver::Simulation
    Properties:
      Name: !Sub 'mySimulation-${AWS::Region}'
      RoleArn: !GetAtt WeaverAppRole.Arn
      SchemaS3Location:
        BucketName: !Sub 'weaver-mySimulation-${AWS::AccountId}-schemas-${AWS::Region}'
        ObjectKey: !Sub 'schema/mySimulation-${AWS::Region}-schema.yaml'
```

# 搭配 使用快照 AWS CloudFormation
<a name="working-with_cloudformation_snapshots"></a>

[快照](working-with_snapshots.md)是模擬的備份。下列範例會從快照而非結構描述啟動新的模擬。此範例中的快照是從 SimSpace Weaver 應用程式 SDK 專案 simulation 建立。 會 CloudFormation 建立新的模擬資源，並使用快照中的資料來初始化它。新的模擬可以具有`MaximumDuration`與原始模擬不同的 。

我們建議您製作並使用原始模擬應用程式角色的副本。如果您刪除模擬的堆疊，則可以刪除原始模擬 CloudFormation 的應用程式角色。

```
Description: "Example - Start a simulation from a snapshot"
Resources:
  MyTestSimulation:
    Type: "AWS::SimSpaceWeaver::Simulation"
    Properties:
      MaximumDuration: "2D"
      Name: "MyTestSimulation_from_snapshot"
      RoleArn: "arn:aws:iam::111122223333:role/weaver-MyTestSimulation-app-role-copy"   
      SnapshotS3Location:
        BucketName: "weaver-mytestsimulation-111122223333-artifacts-us-west-2"
        ObjectKey: "snapshot/MyTestSimulation_22-12-15_12_00_00-230428-1207-13.zip"
```