

지원 종료 공지: 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).

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 스키마 형식
<a name="schema-reference_format"></a>

다음 예제에서는 스키마의 전체 구조를 보여줍니다. 상위-하위 관계가 동일하기만 하면 각 스키마 수준의 속성 순서는 중요하지 않습니다. 배열의 요소 순서는 중요합니다.

```
sdk_version: "sdk-version-number"
simulation_properties:
  simulation-properties
workers:
  worker-group-configurations
clock:
  tick_rate: tick-rate
partitioning_strategies:
  partitioning-strategy-configurations
domains:
  domain-configurations
placement_constraints:
  placement-constraints-configuration
```

**Topics**
+ [SDK 버전](schema-reference_format_sdk-version.md)
+ [시뮬레이션 속성](schema-reference_format_simulation-properties.md)
+ [작업자](schema-reference_format_workers.md)
+ [클럭](schema-reference_format_clock.md)
+ [파티셔닝 전략](schema-reference_format_partitioning-strategies.md)
+ [도메인](schema-reference_format_domains.md)
+ [배치 제약 조건](schema-reference_format_placement-constraints.md)

# SDK 버전
<a name="schema-reference_format_sdk-version"></a>

`sdk_version` 섹션(필수)은이 스키마를 지원하는 SimSpace Weaver 앱 SDK의 버전을 식별합니다. 유효한 값: `1.17`, `1.16`, `1.15`, `1.14`, `1.13`, `1.12` 

**중요**  
`sdk_version`의 값에는 메이저 버전 번호와 첫 번째 마이너 버전 번호만 포함됩니다. 예를 들어, `1.12` 값은 `1.12.0`, `1.12.1`, `1.12.2` 등의 모든 버전 `1.12.x`를 지정합니다.

```
sdk_version: "1.17"
```

# 시뮬레이션 속성
<a name="schema-reference_format_simulation-properties"></a>

`simulation_properties` 섹션(필수)은 시뮬레이션의 다양한 속성을 지정합니다. 이 섹션을 사용하여 로깅을 구성하고 기본 컨테이너 이미지를 지정할 수 있습니다. 이 섹션은 로깅을 구성하지 않거나 기본 컨테이너 이미지를 지정하도록 선택한 경우에도 필요합니다.

```
simulation_properties:
  log_destination_resource_name: "log-destination-resource-name"
  log_destination_service: "log-destination-service"
  default_entity_index_key_type: "Vector3<f32>"
  default_image: "ecr-repository-uri"
```

**속성**

`log_destination_resource_name`  
로그를 SimSpace Weaver 쓸 리소스를 지정합니다.  
*필수:* 아니요. 이 속성이 포함되지 않은 경우 SimSpace Weaver 는 시뮬레이션에 대한 로그를 작성하지 않습니다.  
*유형*: 문자열  
*유효한 값:*  
+ CloudWatch Logs 로그 그룹의 이름(예: `MySimulationLogs`)
+ CloudWatch Logs 로그 그룹의 Amazon 리소스 이름(ARN)(예: `arn:aws:logs:us-west-2:111122223333:log-group/MySimulationLogs`)
SimSpace Weaver 는 시뮬레이션과 동일한 계정 및 AWS 리전 의 로그 대상만 지원합니다.

`log_destination_service`  
ARN이 아닌 `logging_destination resource_name`을 지정하는 경우 로깅 대상 리소스의 유형을 나타냅니다.  
*필수:* `log_destination_resource_name`이 지정되어 있고 ARN이 아닌 경우 이 속성을 지정해야 합니다. `log_destination_resource_name`이 지정되어 있지 않고 ARN인 경우 이 속성을 지정할 수 없습니다.  
*유형*: 문자열  
*유효한 값:*  
+ `logs`: 로그 대상 리소스는 로그 그룹입니다.

`default_entity_index_key_type`  
시뮬레이션 엔터티의 인덱스 키 필드에 대한 데이터 유형을 지정합니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값*: `Vector3<f32>`

`default_image`  
시뮬레이션의 기본 컨테이너 이미지를 지정합니다(`1.13` 및 `1.12` 버전에서는 지원되지 않음). 이 속성을 지정하면 `image`를 지정하지 않은 도메인에서 `default_image`를 사용합니다.  
*필수 항목 여부*: 아니요  
*유형*: 문자열  
*유효한 값: *  
+ Amazon Elastic Container Registry(Amazon ECR)에 있는 리포지토리의 URI(예: `111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest`)

# 작업자
<a name="schema-reference_format_workers"></a>

`workers` 섹션(필수)은 *작업자 그룹*(작업자의 그룹)의 구성을 지정합니다. SimSpace Weaver 는 이 정보와 함께 `placement_constraints`를 사용하여 시뮬레이션의 기본 인프라를 구성합니다. 현재 하나의 작업자 그룹만 지원됩니다.

작업자 그룹의 속성을 지정하려면 *worker-group-name*을 원하는 이름으로 바꿉니다. 이름은 3\$164자 길이여야 하며 **A**\$1**Z**, **a**\$1**z**, **0**\$1**9**, **\$1\$1**(하이픈) 문자를 포함할 수 있습니다. 이름 뒤에 작업자 그룹의 속성을 지정합니다.

```
workers:
  worker-group-name:
    type: "sim.c5.24xlarge"
    desired: number-of-workers
```

**속성**

`type`  
작업자 유형을 지정합니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값*: `sim.c5.24xlarge`

`desired`  
이 작업자 그룹에 원하는 작업자 수를 지정합니다.  
*필수 항목 여부*: 예  
*유형*: 정수  
*유효한 값:* `1`\$1`3`. 시뮬레이션의 작업자 수에 대한 Service Quotas(한도)에 따라 이 속성의 최대값이 결정됩니다. 예를 들어, Service Quotas가 `2`인 경우 이 속성의 최대값은 `2`입니다. Service Quotas 증가를 요청할 수도 있습니다. 자세한 내용은 [SimSpace Weaver 엔드포인트 및 할당량](service-quotas.md) 단원을 참조하십시오.

# 클럭
<a name="schema-reference_format_clock"></a>

`clock` 섹션(필수)에서는 시뮬레이션 클럭의 속성을 지정합니다.

```
clock:
  tick_rate: tick-rate
```

**속성**

`tick_rate`  
클럭이 앱에 게시하는 초당 틱 수를 지정합니다.  
*필수 항목 여부*: 예  
*Type*:  
+ *버전 `1.14` 및 `1.15`:* 문자열
+ *버전 `1.13` 및 `1.12`:* 정수
*유효한 값:*  
+ *버전 `1.14` 및 `1.15`:* `"10"` \$1 `"15"` \$1 `"30"` \$1 `"unlimited"`
  + `"unlimited"`: 클럭은 모든 앱이 현재 틱에 대한 커밋 작업을 완료하는 즉시 다음 틱을 전송합니다.
+ *버전 `1.13` 및 `1.12`:* `10` \$1 `15` \$1 `30`

# 파티셔닝 전략
<a name="schema-reference_format_partitioning-strategies"></a>

`partitioning_strategies` 섹션(필수)은 공간 도메인의 파티션 구성을 지정합니다.

**참고**  
SimSpace Weaver 는 1개의 파티셔닝 전략만 지원합니다.

파티셔닝 전략의 속성을 지정하려면 *partitioning-strategy-name*을 원하는 이름으로 바꿉니다. 이름은 3\$164자 길이여야 하며 **A**\$1**Z**, **a**\$1**z**, **0**\$1**9**, **\$1\$1**(하이픈) 문자를 포함할 수 있습니다. 이름 뒤에 파티셔닝 전략의 속성을 지정합니다.

```
partitioning_strategies:
  partitioning-strategy-name:
    topology: "Grid"
    aabb_bounds:
      x: [aabb-min-x, aabb-max-x]
      y: [aabb-min-y, aabb-max-y]
    grid_placement_groups:
      x: number-of-placement-groups-along-x-axis
      y: number-of-placement-groups-along-y-axis
```

**속성**

`topology`  
이 분할 전략의 토폴로지(파티션 정렬 스키마)를 지정합니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값*: `"Grid"`

`aabb_bounds`  
시뮬레이션을 위한 주축 정렬 경계 상자 (AABB)의 경계를 지정합니다. 경계를 각 축(x 및 y)의 최소값과 최대값(순서대로)을 설명하는 2 요소 순서 배열로 지정합니다.  
*필수 항목 여부*: 조건부. 토폴로지가 `"Grid"`로 설정된 경우 이 속성은 필수이며 지정만 가능합니다.  
*유형:* `Float` 배열(각 축용)  
*유효한 값:* `-3.4028235e38`\$1`3.4028235e38`

`grid_placement_groups`  
그리드 토폴로지에서 각 축(x 및 y)의 배치 그룹 수를 지정합니다. 배치 그룹은 공간적으로 인접한 파티션(동일한 도메인 내)의 모음입니다.  
*필수 항목 여부*: 조건부. 토폴로지가 `"Grid"`로 설정된 경우 이 속성은 필수이며 지정만 가능합니다. 배치 그룹 구성을 지정하지 않으면 SimSpace Weaver 가 계산합니다. 배치 그룹 구성 없이 분할 전략을 사용하는 모든 도메인은 `grid_partition`을 지정해야 합니다([공간 도메인 파티셔닝 전략](schema-reference_format_domains_spatial.md#schema-reference_format_domains_spatial_partitioning-strategy) 참조).  
*유형:* 정수(각 축용)  
*유효한 값:* `1`\$1`20`. x\$1 y는 원하는 작업자 수와 같게 설정하는 것이 좋습니다. 그렇지 않으면 SimSpace Weaver 는 사용 가능한 작업자 간에 배치 그룹의 균형을 맞추려고 시도합니다.

# 도메인
<a name="schema-reference_format_domains"></a>

`domains` 섹션(필수)은 각 도메인의 속성을 지정합니다. 모든 시뮬레이션에는 하나 이상의 공간 영역 섹션이 있어야 합니다. 추가 도메인에 대해 여러 섹션을 생성할 수 있습니다. 각 도메인 유형에는 고유한 구성 형식이 있습니다.

**중요**  
`1.13` 및 `1.12` 버전에서는 다중 공간 도메인을 지원하지 않습니다.

**중요**  
SimSpace Weaver 는 각 시뮬레이션에 대해 최대 5개의 도메인을 지원합니다. 여기에는 모든 공간, 사용자 지정 및 서비스 도메인이 포함됩니다.

```
domains:
  domain-name:
    domain-configuration
  domain-name:
    domain-configuration
  ...
```

**Topics**
+ [공간](schema-reference_format_domains_spatial.md)
+ [사용자 지정(Custom)](schema-reference_format_domains_custom.md)
+ [Service](schema-reference_format_domains_service.md)

# 공간 도메인 구성
<a name="schema-reference_format_domains_spatial"></a>

공간 도메인의 속성을 지정하려면 *spatial-domain-name*을 원하는 이름으로 바꿉니다. 이름은 3\$164자 길이여야 하며 **A**\$1**Z**, **a**\$1**z**, **0**\$1**9**, **\$1\$1**(하이픈) 문자를 포함할 수 있습니다. 이름 뒤에 공간 도메인의 속성을 지정합니다.

```
  spatial-domain-name:
    launch_apps_by_partitioning_strategy:
      partitioning_strategy: "partitioning-strategy-name"
      grid_partition:
        x: number-of-partitions-along-x-axis
        y: number-of-partitions-along-y-axis
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
    image: "ecr-repository-uri"
```

## 공간 도메인 파티셔닝 전략
<a name="schema-reference_format_domains_spatial_partitioning-strategy"></a>

`launch_apps_by_partitioning_strategy` 섹션(필수)은 시뮬레이션 공간의 분할 전략 및 크기(파티션 수)를 지정합니다.

```
    launch_apps_by_partitioning_strategy:
      partitioning_strategy: "partitioning-strategy-name"
      grid_partition:
        x: number-of-partitions-along-x-axis
        y: number-of-partitions-along-y-axis
```

**속성**

`partitioning_strategy`  
이 공간 도메인의 분할 전략을 지정합니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값:* 이 속성의 값은 `partitioning_strategies` 섹션에 정의된 파티션 전략의 이름과 일치해야 합니다. 자세한 내용은 [파티셔닝 전략](schema-reference_format_partitioning-strategies.md) 단원을 참조하십시오.

`grid_partition`  
그리드 토폴로지에서 각 축(x 및 y)과 함께 파티션 수를 지정합니다. 이 크기는 이 도메인의 전체 시뮬레이션 공간을 나타냅니다.  
*필수 항목 여부*: 조건부. 토폴로지가 `"Grid"`로 설정된 경우 이 속성은 지정만 가능합니다. 이 속성은 이 도메인에 지정된 파티셔닝 전략의 `grid_placement_groups` 속성에 따라 달라집니다.  
+ 이 속성은 이 도메인의 파티셔닝 전략이 `grid_placement_groups` 구성을 지정하지 않는 경우 필요합니다.
+ `grid_placement_groups` 구성이 있지만 `grid_partition`을 지정하지 않은 경우 SimSpace Weaver 는 `grid_placment_groups` 구성과 동일한 크기를 사용합니다.
+ `grid_placement_groups` 및 `grid_partition` 모두 지정하는 경우 `grid_partition`의 크기는 `grid_placement_groups` 크기의 배수여야 합니다. 예를 들어 `grid_placement_groups` 크기가 2x2인 경우 유효한 `grid_partition` 크기는 2x2, 4x4, 6x6, 8x8, 10x10입니다.
*유형:* 정수(각 축용)  
*유효한 값:* `1`\$1`20`

## 공간 앱 구성
<a name="schema-reference_format_domains_spatial_app-config"></a>

`app_config` 섹션(필수)은 이 도메인의 앱에 대한 패키지, 시작 구성 및 리소스 요구 사항을 지정합니다.

```
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
```

**속성**

`package`  
앱 실행 파일/바이너리가 포함된 패키지(zip 파일)를 지정합니다. 패키지는 Amazon S3 버킷에 저장해야 합니다. zip 파일 형식만 지원됩니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값:* Amazon S3 버킷에서 패키지의 Amazon S3 URI입니다. 예: `s3://weaver-myproject-111122223333-app-zips-us-west-2/MySpatialApp.zip`.

`launch_command`  
앱을 시작하기 위한 실행/바이너리 파일 이름 및 명령줄 파라미터를 지정합니다. 각 명령줄 문자열 토큰은 배열의 한 요소입니다.  
*필수 항목 여부*: 예  
*유형:* 문자열 배열

`required_resource_units`  
 SimSpace Weaver 가 이 앱의 각 인스턴스에 할당해야 하는 리소스 단위의 수를 지정합니다. *리소스 단위*는 작업자에 있는 고정된 양의 가상 중앙 처리 장치 (vCPUs) 및 임의 액세스 메모리 (RAM)입니다. 리소스 단위에 대한 자세한 내용은 [엔드포인트 및 Service Quotas](service-quotas.md) 섹션을 참조하세요. `compute` 속성은 작업자의 `compute` 패밀리를 위한 자원 단위 할당을 지정하며, 현재 유일하게 유효한 할당 유형입니다.  
*필수 항목 여부*: 예  
*유형*: 정수  
*유효한 값:* `1`\$1`4`

## 사용자 지정 컨테이너 이미지
<a name="schema-reference_format_domains_spatial_image"></a>

`image` 속성(선택 사항)은가이 도메인에서 앱을 실행하는 데 SimSpace Weaver 사용하는 컨테이너 이미지의 위치를 지정합니다( 버전 `1.13` 및 에서는 지원되지 않음`1.12`). 이미지를 포함하는 Amazon Elastic Container Registry(Amazon ECR) 리포지토리에 URI를 제공합니다. 이 속성이 지정되지 않았지만 `default_image`가 최상위 `simulation_properties` 섹션에 지정된 경우 이 도메인의 앱은 `default_image`를 사용합니다. 자세한 내용은 [사용자 지정 컨테이너](working-with_custom-containers.md) 단원을 참조하십시오.

```
    image: "ecr-repository-uri"
```

**속성**

`image`  
이 도메인에서 앱을 실행할 컨테이너 이미지의 위치를 지정합니다.  
*필수 항목 여부*: 아니요  
*유형*: 문자열  
*유효한 값: *  
+ Amazon Elastic Container Registry(Amazon ECR)에 있는 리포지토리의 URI(예: `111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest`)

# 사용자 지정 도메인 구성
<a name="schema-reference_format_domains_custom"></a>

사용자 지정 도메인의 속성을 지정하려면 *custom-domain-name*을 원하는 이름으로 바꿉니다. 이름은 3\$164자 길이여야 하며 **A**\$1**Z**, **a**\$1**z**, **0**\$1**9**, **\$1\$1**(하이픈) 문자를 포함할 수 있습니다. 이름 뒤에 사용자 지정 도메인의 속성을 지정합니다. 각 사용자 지정 도메인에 대해 이 절차를 반복합니다.

```
  custom-domain-name:
    launch_apps_via_start_app_call: {}
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
      endpoint_config:
        ingress_ports: [port1, port2, ...]
    image: "ecr-repository-uri"
```

**속성**

`launch_apps_via_start_app_call`  
이 속성은 **StartApp** API를 사용하여 사용자 지정 앱을 시작하는 데 필요합니다.  
*필수 항목 여부*: 예  
*유형:* N/A  
*유효한 값*: `{}`

## 사용자 지정 앱 구성
<a name="schema-reference_format_domains_custom_app-config"></a>

`app_config section` 섹션(필수)은 이 사용자 지정 도메인의 앱에 대한 패키지, 시작 구성, 리소스 요구 사항 및 네트워크 포트를 지정합니다.

```
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
      endpoint_config:
        ingress_ports: [port1, port2, ...]
```

**속성**

`package`  
앱 실행 파일/바이너리가 포함된 패키지(zip 파일)를 지정합니다. 패키지는 Amazon S3 버킷에 저장해야 합니다. zip 파일 형식만 지원됩니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값:* Amazon S3 버킷에서 패키지의 Amazon S3 URI입니다. 예: `s3://weaver-myproject-111122223333-app-zips-us-west-2/MyCustomApp.zip`.

`launch_command`  
앱을 시작하기 위한 실행/바이너리 파일 이름 및 명령줄 파라미터를 지정합니다. 각 명령줄 문자열 토큰은 배열의 한 요소입니다.  
*필수 항목 여부*: 예  
*유형:* 문자열 배열

`required_resource_units`  
 SimSpace Weaver 가 이 앱의 각 인스턴스에 할당해야 하는 리소스 단위의 수를 지정합니다. *리소스 단위*는 작업자에 있는 고정된 양의 가상 중앙 처리 장치 (vCPUs) 및 임의 액세스 메모리 (RAM)입니다. 리소스 단위에 대한 자세한 내용은 [엔드포인트 및 Service Quotas](service-quotas.md) 섹션을 참조하세요. `compute` 속성은 작업자의 `compute` 패밀리를 위한 자원 단위 할당을 지정하며, 현재 유일하게 유효한 할당 유형입니다.  
*필수 항목 여부*: 예  
*유형*: 정수  
*유효한 값:* `1`\$1`4`

`endpoint_config`  
이 도메인에 있는 앱의 네트워크 엔드포인트를 지정합니다. 의 값은 수신 클라이언트 연결을 위해 사용자 지정 앱이 바인딩하는 포트를 `ingress_ports` 지정합니다.는 동적으로 할당된 포트를 지정된 수신 포트에 SimSpace Weaver 매핑합니다. 수집 포트는 모두 TCP와 UDP입니다. **DescribeApp** API를 사용하여 클라이언트를 연결하는 데 필요한 실제 포트 번호를 찾을 수 있습니다.  
*필수:* 아니요. 엔드포인트 구성을 지정하지 않으면 이 도메인의 사용자 지정 앱에 네트워크 엔드포인트가 없습니다.  
*유형:* 정수 배열  
*유효한 값:* `1024`\$1`49152`. 값은 고유해야 합니다.

## 사용자 지정 컨테이너 이미지
<a name="schema-reference_format_domains_custom_image"></a>

`image` 속성(선택 사항)은가이 도메인에서 앱을 실행하는 데 SimSpace Weaver 사용하는 컨테이너 이미지의 위치를 지정합니다( 버전 `1.13` 및 에서는 지원되지 않음`1.12`). 이미지를 포함하는 Amazon Elastic Container Registry(Amazon ECR) 리포지토리에 URI를 제공합니다. 이 속성이 지정되지 않았지만 `default_image`가 최상위 `simulation_properties` 섹션에 지정된 경우 이 도메인의 앱은 `default_image`를 사용합니다. 자세한 내용은 [사용자 지정 컨테이너](working-with_custom-containers.md) 단원을 참조하십시오.

```
    image: "ecr-repository-uri"
```

**속성**

`image`  
이 도메인에서 앱을 실행할 컨테이너 이미지의 위치를 지정합니다.  
*필수 항목 여부*: 아니요  
*유형*: 문자열  
*유효한 값: *  
+ Amazon Elastic Container Registry(Amazon ECR)에 있는 리포지토리의 URI(예: `111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest`)

# 서비스 도메인 구성
<a name="schema-reference_format_domains_service"></a>

서비스 도메인의 속성을 지정하려면 *service-domain-name*을 원하는 이름으로 바꿉니다. 이름은 3\$164자 길이여야 하며 **A**\$1**Z**, **a**\$1**z**, **0**\$1**9**, **\$1\$1**(하이픈) 문자를 포함할 수 있습니다. 이름 뒤에 서비스 도메인의 속성을 지정합니다. 각 사용자 지정 도메인에 대해 이 절차를 반복합니다.

```
  service-domain-name:
    launch_apps_per_worker:
      count: number-of-apps-to-launch
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
      endpoint_config:
        ingress_ports: [port1, port2, ...]
    image: "ecr-repository-uri"
```

## 작업자당 앱 시작
<a name="schema-reference_format_domains_service_launch-apps-per-worker"></a>

`launch_apps_per_worker` 섹션(필수)은 이 구성이 서비스 도메인 구성임을 나타내며 작업자당 시작할 서비스 앱 수를 지정합니다.

```
    launch_apps_per_worker:
      count: number-of-apps-to-launch
```

**속성**

`count`  
이 속성은 작업자당 시작할 서비스 앱 수를 지정합니다.  
*필수 항목 여부*: 예  
*유형*: 정수  
*유효한 값*: `{}` \$1 `1` \$1 `2`. `{}` 값은 `1` 기본값을 지정합니다.

## 서비스 앱 구성
<a name="schema-reference_format_domains_service_app-config"></a>

`app_config section` 섹션(필수)은 이 서비스 도메인의 앱에 대한 패키지, 시작 구성, 리소스 요구 사항 및 네트워크 포트를 지정합니다.

```
    app_config:
      package: "app-package-s3-uri"
      launch_command: ["app-launch-command", "parameter1", ...]
      required_resource_units:
        compute: app-resource-units
      endpoint_config:
        ingress_ports: [port1, port2, ...]
```

**속성**

`package`  
앱 실행 파일/바이너리가 포함된 패키지(zip 파일)를 지정합니다. 패키지는 Amazon S3 버킷에 저장해야 합니다. zip 파일 형식만 지원됩니다.  
필수 항목 여부**: 예  
*유형*: 문자열  
*유효한 값:* Amazon S3 버킷에서 패키지의 Amazon S3 URI입니다. 예: `s3://weaver-myproject-111122223333-app-zips-us-west-2/MyServiceApp.zip`.

`launch_command`  
앱을 시작하기 위한 실행/바이너리 파일 이름 및 명령줄 파라미터를 지정합니다. 각 명령줄 문자열 토큰은 배열의 한 요소입니다.  
*필수 항목 여부*: 예  
*유형:* 문자열 배열

`required_resource_units`  
 SimSpace Weaver 가 이 앱의 각 인스턴스에 할당해야 하는 리소스 단위의 수를 지정합니다. *리소스 단위*는 작업자에 있는 고정된 양의 가상 중앙 처리 장치 (vCPUs) 및 임의 액세스 메모리 (RAM)입니다. 리소스 단위에 대한 자세한 내용은 [엔드포인트 및 Service Quotas](service-quotas.md) 섹션을 참조하세요. `compute` 속성은 작업자의 `compute` 패밀리를 위한 자원 단위 할당을 지정하며, 현재 유일하게 유효한 할당 유형입니다.  
*필수 항목 여부*: 예  
*유형*: 정수  
*유효한 값:* `1`\$1`4`

`endpoint_config`  
이 도메인에 있는 앱의 네트워크 엔드포인트를 지정합니다. `ingress_ports` 값은 들어오는 클라이언트 연결을 위해 서비스 앱이 바인딩하는 포트를 지정합니다. SimSpace Weaver 는 동적으로 할당된 포트를 지정된 수집 포트에 매핑합니다. 수집 포트는 모두 TCP와 UDP입니다. **DescribeApp** API를 사용하여 클라이언트를 연결하는 데 필요한 실제 포트 번호를 찾을 수 있습니다.  
*필수:* 아니요. 엔드포인트 구성을 지정하지 않으면 이 도메인의 서비스 앱에 네트워크 엔드포인트가 없습니다.  
*유형:* 정수 배열  
*유효한 값:* `1024`\$1`49152`. 값은 고유해야 합니다.

## 사용자 지정 컨테이너 이미지
<a name="schema-reference_format_domains_service_image"></a>

`image` 속성(선택 사항)은가이 도메인에서 앱을 실행하는 데 SimSpace Weaver 사용하는 컨테이너 이미지의 위치를 지정합니다( 버전 `1.13` 및 에서는 지원되지 않음`1.12`). 이미지를 포함하는 Amazon Elastic Container Registry(Amazon ECR) 리포지토리에 URI를 제공합니다. 이 속성이 지정되지 않았지만 `default_image`가 최상위 `simulation_properties` 섹션에 지정된 경우 이 도메인의 앱은 `default_image`를 사용합니다. 자세한 내용은 [사용자 지정 컨테이너](working-with_custom-containers.md) 단원을 참조하십시오.

```
    image: "ecr-repository-uri"
```

**속성**

`image`  
이 도메인에서 앱을 실행할 컨테이너 이미지의 위치를 지정합니다.  
*필수 항목 여부*: 아니요  
*유형*: 문자열  
*유효한 값: *  
+ Amazon Elastic Container Registry(Amazon ECR)에 있는 리포지토리의 URI(예: `111122223333.dkr.ecr.us-west-2.amazonaws.com/my-ecr-repository:latest`)

# 배치 제약 조건
<a name="schema-reference_format_placement-constraints"></a>

`placement_constraints` 섹션(선택 사항)은 SimSpace Weaver 가 동일한 작업자에 함께 배치해야 하는 공간 도메인을 지정합니다. 자세한 내용은 [공간 도메인 구성](working-with_configuring-simulation_domains_spatial.md) 단원을 참조하십시오.

**중요**  
`1.13` 및 `1.12` 버전에서는 `placement_constraints`를 지원하지 않습니다.

```
placement_constraints:
  - placed_together: ["spatial-domain-name", "spatial-domain-name", ...]
    on_workers: ["worker-group-name"]
```

**속성**

`placed_together`  
함께 배치 SimSpace Weaver 해야 하는 공간 도메인을 지정합니다.  
*필수 항목 여부*: 예  
*유형:* 문자열 배열  
*유효한 값:* 스키마에 지정된 공간 도메인의 이름

`on_workers`  
도메인을 배치 SimSpace Weaver 해야 하는 작업자 그룹을 지정합니다.  
*필수 항목 여부*: 예  
*유형:* 1요소 문자열 배열  
*유효한 값:* 스키마에 지정된 작업자 그룹의 이름