詳細なチュートリアル: サンプルアプリケーションを構築しながら詳細を説明します

ロギングを有効にする

1. 以下に移動します。

   sdk-folder/Samples/PathfindingSample/tools

2. テキストエディタでスキーマファイルを開きます。

   pathfinding-single-worker-schema.yaml

3. ファイルの冒頭で、simulation_properties: セクションを検索します。

   simulation_properties:
     default_entity_index_key_type: "Vector3<f32>"
   

4. 行 simulation_properties: の後に以下の 2 行を挿入します。

     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
   

5. simulation_properties: セクションが以下と同じであることを確認します。

   simulation_properties:
     log_destination_service: "logs"
     log_destination_resource_name: "MySimulationLogs"
     default_entity_index_key_type: "Vector3<f32>"
   

6. ファイルを保存し、テキストエディタを終了します。

1. 以下に移動します。

   sdk-folder/Samples/PathfindingSample/tools/cloud

2. 次のいずれかのコマンドを実行します。

   • Docker: python quick-start.py

   • WSL: python quick-start.py --al2

1. Weaver スキーマを S3 にアップロードします。

   • SimSpace Weaver はスキーマを使用してシミュレーションを設定します。スキーマは YAML 形式のプレーンテキストファイルです。詳細については、「シミュレーションの設定」を参照してください。

2. カスタムコンテナを構築してアップロードします (オプション）。

   • スキーマがカスタムコンテナを定義する場合、クイックスタートスクリプトは Docker イメージを構築し、Amazon ECR にアップロードします。詳細については、「カスタムコンテナ」を参照してください。この機能の例については、PythonBubblesSampleスキーマを参照してください。

3. プロジェクトをビルドします。

   • quick-start.py は、 で定義された build_project関数を呼び出しますbuild.py。このステップはプロジェクトによって異なります。PathfindingSample には、CMake が使用されます。CMake コマンドと Docker コマンド。このコマンドは にありますbuild.py。

4. ビルドアーティファクトを S3 にアップロードします。

   • S3 バケットをチェックして、すべてのアップロードが成功したことを確認できます。Amazon S3 でファイルを管理する方法については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 バケットの作成、設定、および使用」を参照してください。

   • サンプルアプリケーションの zip と S3 バケットは、次の名前形式を使用します。

     • weaver-sample-bucket-account-number-region

     • 空間アプリケーション: ProjectNameSpatial.zip

     • 表示 (カスタム) アプリ: ProjectNameView.zip

5. シミュレーションを開始します。

   • これはaws simspaceweaver start-simulation AWS CLI 呼び出しのラッパーです。詳細については、AWS CLI 「 コマンドリファレンス」を参照してください SimSpace Weaver。

   • スクリプトは、シミュレーションのステータスが STARTED または FAILED になるまでループします。シミュレーションが開始されるまで数分かかる場合があります。

6. シミュレーションの詳細を取得します。

   • DescribeSimulation API は、シミュレーションの状態など、シミュレーションに関する詳細を提供します。シミュレーションは、以下の状態のいずれかになります。

     シミュレーションライフサイクルの状態

     1. STARTING — StartSimulation 呼び出し後の初期状態

     2. STARTED — すべての空間アプリケーションが起動し、正常に動作している

     3. STOPPING — StopSimulation 呼び出し後の初期状態

     4. STOPPED — すべてのコンピュートリソースが停止している

     5. DELETING — DeleteSimulation 呼び出し後の初期状態

     6. DELETED — シミュレーションに割り当てられたすべてのリソースが削除されている

     7. FAILED — シミュレーションに重大なエラー/障害が発生して停止している

     8. SNAPSHOT_IN_PROGRESS — スナップショットが進行中

     シミュレーションの詳細を取得する

     1. ListSimulations API を呼び出します。

        aws simspaceweaver list-simulations

        このスクリプトには、以下のような各シミュレーションの詳細が表示されます。

        {
            "Status": "STARTED",
            "CreationTime": 1664921418.09,
            "Name": "MyProjectSimulation_22-10-04_22_10_15",
            "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
            "TargetStatus": "STARTED"
        }
        

     2. DescribeSimulation を呼び出して、シミュレーションの詳細を取得します。simulation-name を前のステップの出力のシミュレーションの Name に置き換えます。

        aws simspaceweaver describe-simulation --simulation simulation-name

        スクリプトには、以下のように、指定したシミュレーションに関する詳細が表示されます。

        {
            "Status": "STARTED",
            "CreationTime": 1664921418.09,
            "Name": "MyProjectSimulation_22-10-04_22_10_15",
            "Arn": "arn:aws:simspaceweaver:us-west-2:111122223333:simulation/MyProjectSimulation_22-10-04_22_10_15",
            "TargetStatus": "STARTED"
        }
        

7. カスタムアプリケーションを起動します。

   • SimSpace Weaver はカスタムアプリケーションのライフサイクルを管理しません。カスタムアプリケーションを起動する必要があります。シミュレーションクロックを開始する前にカスタムアプリケーションを起動するのがベストプラクティスですが、カスタムアプリケーションはシミュレーションクロックを開始した後でも起動できます。

     StartApp API を呼び出してカスタムアプリケーションを起動できます。

     aws simspaceweaver start-app --simulation simulation-name --name app-name --domain domain-name

     StartApp API コールは、指定した名前を使用してカスタムアプリケーションの新しいインスタンスを作成して起動します。既に存在するアプリケーション名を指定すると、エラーが返されます。特定のアプリケーション (インスタンス) を再起動する場合は、まずそのアプリケーションを停止して削除する必要があります。

     注記

     カスタムアプリケーションの起動前は、シミュレーションのステータスは STARTED である必要があります。

     サンプルアプリケーションには、シミュレーションを表示する ViewApp カスタムアプリケーションが用意されています。このアプリケーションは、シミュレーションクライアントを接続するための静的 IP アドレスとポート番号を提供します (これについてはこのチュートリアルの後のステップで行います)。domain は、同じ実行コードと起動オプションを持つアプリケーションのクラスと考えることができます。app name はアプリケーションのインスタンスを識別します。 SimSpace Weaver 概念の詳細については、「」を参照してくださいの主な概念 SimSpace Weaver。

     DescribeApp API を使用して、起動後にカスタムアプリケーションのステータスを確認できます。

     aws simspaceweaver describe-app --simulation simulation-name --app app-name --domain domain-name

     このチュートリアルでビューアプリケーションを起動する

     1. StartApp に を呼び出しますViewApp。

        aws simspaceweaver start-app --simulation simulation-name --name ViewApp --domain MyViewDomain

     2. DescribeApp を呼び出して、カスタムアプリケーションのステータスを確認します。

        aws simspaceweaver describe-app --simulation simulation-name --app ViewApp --domain MyViewDomain

     カスタムアプリケーション (インスタンス) のステータスが STARTED になると、DescribeApp の出力にはそのカスタムアプリケーション (インスタンス) の IP アドレスとポート番号が含まれます。以下の出力例では、IP アドレスは Address の値で、ポート番号は EndpointInfo ブロック内の Actual の値です。

     
     {
         "Status": "STARTED",
         "Domain": "MyViewDomain",
         "TargetStatus": "STARTED",
         "Simulation": "MyProjectSimulation_22-10-04_22_10_15",
         "LaunchOverrides": {
             "LaunchCommands": []
         },
         "EndpointInfo": {
             "IngressPortMappings": [
                 {
                     "Declared": 7000,
                     "Actual": 4321
                 }
             ],
             "Address": "198.51.100.135"
         },
         "Name": "ViewApp"
     }
     
     

     注記

     Declared の値はアプリケーションコードのバインド先となるポート番号です。の値は、 がクライアントに SimSpace Weaver 公開して app に接続するポート番号Actualです。 はDeclaredポートをActualポートに SimSpace Weaver マッピングします。

     注記

     「」で説明されている手順を使用してカスタムアプリケーションの IP アドレスとポート番号を取得する、起動したカスタムアプリケーションの IP アドレスとポート番号を取得できます。

8. クロックを起動します。

   • シミュレーションを初めて作成したとき、クロックはありますが、作動していません。クロックが作動していないときは、シミュレーションの状態は更新されません。クロックを起動すると、アプリにティックが送信され始めます。ティックごとに、空間アプリケーションは所有するエンティティをステップスルーし、結果をコミットします。 SimSpace Weaver

     注記

     クロックの起動には 30～60 秒かかることがあります。

     StartClock API を呼び出します。

     aws simspaceweaver start-clock --simulation simulation-name

     注記

     StartClock API は simulation-name を使用します。これは ListSimulations API を使用して検索できます。

     aws simspaceweaver list-simulations