サポート終了通知: 2026 年 5 月 20 日に、 AWS は のサポートを終了します 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)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ドメイン
ドメインの設定プロパティのセットの名前を指定します。ドメイン内のアプリケーションの起動設定によって、ドメインのタイプが決まります。
+ **`launch_apps_via_start_app_call`** - カスタムドメイン
+ **`launch_apps_by_partitioning_strategy`** — 空間ドメイン
+ **`launch_apps_per_worker`** (サンプルアプリケーションには含まれていません) — サービスドメイン
**重要**
SimSpace Weaver は、シミュレーションごとに最大 5 つのドメインをサポートします。これには、すべての空間ドメイン、カスタムドメイン、およびサービスドメインが含まれます。
```
domains:
MyViewDomain:
launch_apps_via_start_app_call: {}
app_config:
package: "s3://weaver-myproject-111122223333-us-west-2/MyViewApp.zip"
launch_command: ["MyViewApp"]
required_resource_units:
compute: 1
endpoint_config:
ingress_ports:
- 7000
MySpatialDomain:
launch_apps_by_partitioning_strategy:
partitioning_strategy: "MyGridPartitioning"
grid_partition:
x: 2
y: 2
app_config:
package: "s3://weaver-myproject-111122223333-us-west-2/MySpatialApp.zip"
launch_command: ["MySpatialApp"]
required_resource_units:
compute: 1
```
**注記**
SimSpace Weaver app SDK バージョン 1.12.x プロジェクトでは、アプリケーションの .zip ファイルとスキーマに別々のバケットを使用します。
weaver-*lowercase-project-name*-*account-number*-app-zips-*region*
weaver-*lowercase-project-name*-*account-number*-schemas-*region*
**Topics**
+ [アプリケーションの設定](working-with_configuring-simulation_domains_app-config.md)
+ [空間ドメインの設定](working-with_configuring-simulation_domains_spatial.md)
+ [ネットワークエンドポイント](working-with_configuring-simulation_domains_endpoints.md)
+ [サービスドメインの設定](working-with_configuring-simulation_domains_service-domains.md)
# アプリケーションの設定
アプリケーション (`app_config`) の設定は、そのドメインの設定の一部として指定します。すべてのタイプのドメインが同じアプリケーション設定プロパティを使用します。
```
app_config:
package: "s3://weaver-myproject-111122223333-us-west-2/MyViewApp.zip"
launch_command: ["MyViewApp"]
required_resource_units:
compute: 1
```
**注記**
SimSpace Weaver app SDK バージョン 1.12.x プロジェクトでは、アプリケーションの .zip ファイルとスキーマに別々のバケットを使用します。
weaver-*lowercase-project-name*-*account-number*-app-zips-*region*
weaver-*lowercase-project-name*-*account-number*-schemas-*region*
`package` プロパティは、S3 バケット内の zipP ファイルの S3 URI を指定します。zip ファイルには、アプリケーションの実行ファイル (*バイナリ*とも呼ばれます) と、必要なその他のリソース (ライブラリなど) が含まれます。アプリケーション実行ファイルの各インスタンスは、ワーカーのDockerコンテナで実行されます。
`launch_command` プロパティは、実行ファイルの名前と、アプリケーションを実行するためのコマンドラインオプションを指定します。`launch_command` の値は配列です。起動コマンド文字列全体の各トークンは、配列内の要素です。
**例**
+ 起動コマンドの場合: `MyTestApp --option1 value1`
+ 指定: `launch_command: ["MyTestApp", "-option1", "value1"]`
`required_resource_units` プロパティは、 SimSpace Weaver がこのアプリに割り当てるコンピューティングリソースユニットの数を指定します。コンピュートリソースユニットは、ワーカーの容量 (vCPU) とメモリ (RAM) の固定量です。この値を増やすと、ワーカー上で実行されるアプリケーションの処理能力を増やすことができます。各ワーカーが利用できるコンピュートリソースユニットの数には制限があります。詳細については、「[SimSpace Weaver エンドポイントとクォータ](service-quotas.md)」を参照してください。
# 空間ドメインの設定
空間ドメインの場合は、`partitioning_strategy` を指定する必要があります。このプロパティの値は、スキーマの別の部分で定義したパーティショニング戦略に付けた名前です。
```
MySpatialDomain:
launch_apps_by_partitioning_strategy:
partitioning_strategy: "MyGridPartitioning"
grid_partition:
x: 2
y: 2
app_config:
package: "s3://weaver-myproject-111122223333-us-west-2/MySpatialApp.zip"
launch_command: ["MySpatialApp"]
required_resource_units:
compute: 1
```
**注記**
SimSpace Weaver app SDK バージョン 1.12.x プロジェクトでは、アプリケーションの .zip ファイルとスキーマに別々のバケットを使用します。
weaver-*lowercase-project-name*-*account-number*-app-zips-*region*
weaver-*lowercase-project-name*-*account-number*-schemas-*region*
`Grid` トポロジ (このリリースでサポートされている唯一のトポロジ) を使用したパーティショニング戦略では、 は、このドメインの空間アプリケーションパーティションをグリッドに配置する SimSpace Weaver ように に指示します。`grid_partition` プロパティは、パーティショングリッドの行数と列数を指定します。
SimSpace Weaver は、パーティショングリッド内のセルごとに空間アプリケーションの 1 つのインスタンスを起動します。たとえば、空間ドメインに`grid_partition`値 `x: 2`と がある場合`y: 2`、空間ドメインには 2 \$1 2 = 4 つのパーティションがあります。 SimSpace Weaver は、空間ドメインで設定されたアプリケーションの 4 つのインスタンスを開始し、各アプリケーションインスタンスに 1 つのパーティションを割り当てます。
**トピック**
+ [空間ドメインのリソース要件](#working-with_configuring-simulation_domains_spatial_resources)
+ [複数の空間ドメイン](#working-with_configuring-simulation_domains_spatial_multiple)
+ [空間ドメインに関するよくある質問](#working-with_configuring-simulation_domains_spatial_faq)
+ [空間ドメインのトラブルシューティング](#working-with_configuring-simulation_domains_spatial_troubleshooting)
## 空間ドメインのリソース要件
各ワーカーには最大 17 コンピュートリソースユニットを割り当てることができます。空間ドメインの `app_config` セクションで、各空間アプリケーションが使用するコンピュートリソースユニットの数を指定します。
**Example 空間アプリケーションのコンピュートリソースユニットを示すスキーマスニペット**
```
MySpatialDomain:
launch_apps_by_partitioning_strategy:
partitioning_strategy: "MyGridPartitioning"
grid_partition:
x: 2
y: 2
app_config:
package: "s3://weaver-myproject-111122223333-artifacts-us-west-2/MySpatialApp.zip"
launch_command: ["MySpatialApp"]
required_resource_units:
compute: 1
```
ドメインが必要とするコンピュートリソースユニットの数を計算するには、グリッド内のセル数 (`grid_partition` 内で `x` \$1 `y`) に、空間アプリケーションに割り当てられたコンピュートリソースユニットの数を掛けます。
前の例では、ドメイン `MySpatialDomain` は以下を指定します。
+ `x`: `2`
+ `y`: `2`
+ `compute`: `1`
`MySpatialDomain` のグリッドには 2 \$1 2 = 4 個のセルがあります。空間ドメインには 4 \$1 1 = 4 のコンピュートリソースユニットが必要です。
スキーマで指定する全ドメインのコンピュートリソースユニットの総数は、ワーカー数に各ワーカーのコンピュートリソースユニットの最大数 (17) を掛けた `desired` の数以下でなければなりません。
## 複数の空間ドメイン
複数の空間ドメインを使用するようにシミュレーションを設定できます。例えば、1 つの空間ドメインを使用してシミュレーションの主なアクター (人や車など) を制御し、別の空間ドメインを使用して環境を制御できます。
また、複数の空間ドメインを使用して、シミュレーションのさまざまな部分に異なるリソースを割り当てることもできます。例えば、あるタイプのエンティティが他のタイプの 10 倍のエンティティインスタンスを持つタイプのエンティティの場合、エンティティタイプごとに異なるドメインを作成して各エンティティタイプを処理し、そのエンティティの数が多いドメインにより多くのリソースを割り当てることができます。
**重要**
SimSpace Weaver 1.14.0 より前のバージョンでは、複数の空間ドメインをサポートしていません。
**重要**
AWS SimSpace Weaver Local は現在、複数の空間ドメインをサポートしていません。SimSpace Weaver Local の詳細については、「[でのローカル開発 SimSpace Weaver](working-with_local-development.md)」を参照してください。
**重要**
SimSpace Weaver は、シミュレーションごとに最大 5 つのドメインをサポートします。これには、すべての空間ドメイン、カスタムドメイン、およびサービスドメインが含まれます。
### 複数の空間ドメインを設定する
複数の空間ドメインを設定するには、他の空間ドメイン定義を個別の名前付きセクションとしてスキーマに追加します。各ドメインは `launch_apps_by_partitioning_strategy` キーを指定する必要があります。次のスキーマの例を参照してください。
```
sdk_version: "1.14"
workers:
MyComputeWorkers:
type: "sim.c5.24xlarge"
desired: 1
clock:
tick_rate: "30"
partitioning_strategies:
MyGridPartitioning:
topology: Grid
aabb_bounds:
x: [0, 1000]
y: [0, 1000]
domains:
MySpatialDomain:
launch_apps_by_partitioning_strategy:
partitioning_strategy: "MyGridPartitioning"
grid_partition:
x: 2
y: 2
app_config:
package: "s3://weaver-myproject-111122223333-artifacts-us-west-2/MySpatialApp.zip"
launch_command: ["MySpatialApp"]
required_resource_units:
compute: 1
MySecondSpatialDomain:
launch_apps_by_partitioning_strategy:
partitioning_strategy: "MyGridPartitioning"
grid_partition:
x: 2
y: 2
app_config:
package: "s3://weaver-myproject-111122223333-artifacts-us-west-2/MySpatialApp2.zip"
launch_command: ["MySpatialApp2"]
required_resource_units:
compute: 1
```
### 空間ドメインをまとめて配置する
シナリオによっては、空間ドメインのパーティションを別のドメインのパーティションの隣に配置する場合があります。これにより、これらのパーティションが相互にクロスドメインサブスクリプションを作成する場合に、パフォーマンス特性が向上する可能性があります。
最上位キー`placement_constraints`をスキーマに追加して、どのドメインを一緒に配置 SimSpace Weaver するかを指定します。必要な `on_workers` キーは、スキーマ内の名前付き `workers` 設定を参照している必要があります。
**Example 空間ドメインをまとめて配置したスキーマスニペット**
```
workers:
MyComputeWorkers:
type: "sim.c5.24xlarge"
desired: 2
placement_constraints:
- placed_together: ["MySpatialDomain", "MySecondSpatialDomain"]
on_workers: ["MyComputeWorkers"]
```
**重要**
配置グループを使用する場合:
x \$1 y がワーカー数の倍数であることを確認します。
配置グループの値が、まとめて配置するドメインのグリッド寸法の共通除数であることを確認します。
プレイスメントグループを**使用しない**場合:
空間ドメイングリッドの 1 つの軸に、ワーカー数と等しい公約数があることを確認します。
グループ配置の詳細については、「[パーティショニング戦略](working-with_configuring-simulation_partitioning-strategies.md#working-with_configuring-simulation_partitioning-strategies_placement-groups)」を参照してください。
## 空間ドメインに関するよくある質問
### Q1. 既存のシミュレーションに別の空間ドメインを追加する方法を教えてください。
+ **実行中のシミュレーションの場合** — 実行中のシミュレーションの設定は変更できません。スキーマのドメイン設定を変更し、スキーマとアプリケーションの zip をアップロードして、新しいシミュレーションを開始します。
+ **新しいシミュレーションの場合** — ドメイン設定をスキーマに追加し、スキーマとアプリケーション zip をアップロードして、新しいシミュレーションを開始します。
## 空間ドメインのトラブルシューティング
ドメインの設定が無効な状態でシミュレーションを開始しようとすると、以下のエラーが表示される可能性があります。
```
"StartError": "[{\"errorType\":\"SchemaFormatInvalid\",\"errorMessage\":
\"We were unable to determine an arrangement of your domains that would fit
within the provided set of workers. This can generally be resolved by
increasing the number of workers if able, decreasing your domains\u0027
[\u0027\u0027grid_partition\u0027\u0027] values, or adjusting the
dimensions of your [\u0027\u0027grid_placement_groups\u0027\u0027].\"}]"
```
**可能性のある原因**
+ スキーマが、ワーカーで使用可能な量よりも多くのコンピュートリソースユニットをアプリケーションに割り当てています。
+ SimSpace Weaver は、ワーカーにドメインをまとめて配置する配置を決定できません。これは、複数の空間ドメインを指定しても、ドメイングリッド間に共通の除数や倍数がない場合 (2x4 グリッドと 3x5 グリッドの間など) に発生します。
# ネットワークエンドポイント
カスタムアプリケーションとサービスアプリケーションには、外部クライアントが接続できるネットワークエンドポイントを設定できます。`endpoint_config` 内の `ingress_ports` の値としてポート番号のリストを指定します。これらのポート番号はどちらも TCP と UDP です。カスタムアプリケーションまたはサービスアプリケーションは、 で指定したポート番号にバインドする必要があります`ingress_ports`。 SimSpace Weaver は実行時に動的にポート番号を割り当て、これらのポートを動的ポートにマッピングします。**describe-app** API は、アプリケーションが動的 (実際の) ポート番号を見つけ始めた後に呼び出すことができます。詳細については、「クイックスタートチュートリアル」の「[カスタムアプリケーションの IP アドレスとポート番号を取得するIP アドレスとポート番号を取得する](working-with_get-ip.md)」を参照してください。
```
domains:
MyViewDomain:
launch_apps_via_start_app_call: {}
app_config:
package: "s3://weaver-myproject-111122223333-us-west-2/MyViewApp.zip"
launch_command: ["MyViewApp"]
required_resource_units:
compute: 1
endpoint_config:
ingress_ports:
- 7000
```
**注記**
SimSpace Weaver app SDK バージョン 1.12.x プロジェクトでは、アプリケーションの .zip ファイルとスキーマに別々のバケットを使用します。
weaver-*lowercase-project-name*-*account-number*-app-zips-*region*
weaver-*lowercase-project-name*-*account-number*-schemas-*region*
**注記**
`endpoint_config` はカスタムアプリケーションとサービスアプリケーションのオプションプロパティです。`endpoint_config` を指定しない場合、アプリケーションにはネットワークエンドポイントがありません。
# サービスドメインの設定
ドメイン設定`launch_apps_per_worker:`に が存在する場合は、サービスアプリがあるサービスドメインであることを示します。 は、サービスアプリ SimSpace Weaver を起動および停止します。がアプリ SimSpace Weaver を起動および停止すると、アプリは*マネージドライフサイクル* を持つと見なされます。 SimSpace Weaver は現在、ワーカーごとに 1 つまたは 2 つのサービスアプリの開始をサポートしています。
**Example 各ワーカーで 1 つのサービスアプリケーションを起動するように設定されたドメインの例**
```
domains:
MyServiceDomain:
launch_apps_per_worker:
count: 1
app_config:
package: "s3://weaver-myproject-111122223333-app-zips-us-west-2/PlayerConnectionServiceApp.zip"
launch_command: ["PlayerConnectionServiceApp"]
required_resource_units:
compute: 1
endpoint_config:
ingress_ports:
- 9000
- 9001
```
**Example 各ワーカーで 2 つのサービスアプリケーションを起動するように設定されたドメインの例**
```
domains:
MyServiceDomain:
launch_apps_per_worker:
count: 2
app_config:
package: "s3://weaver-myproject-111122223333-app-zips-us-west-2/PlayerConnectionServiceApp.zip"
launch_command: ["PlayerConnectionServiceApp"]
required_resource_units:
compute: 1
endpoint_config:
ingress_ports:
- 9000
- 9001
```