Aviso de fin de soporte: el 20 de mayo de 2026, AWS finalizará el soporte para AWS SimSpace Weaver. Después del 20 de mayo de 2026, ya no podrás acceder a la SimSpace Weaver consola ni a SimSpace Weaver los recursos. Para obtener más información, consulta [AWS SimSpace Weaver el fin del soporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Dominios Debe proporcionar un nombre para un conjunto de propiedades de configuración de un dominio. La configuración de inicio de las aplicaciones de un dominio determina el tipo de dominio: + **`launch_apps_via_start_app_call`**: dominio personalizado + **`launch_apps_by_partitioning_strategy`**: dominio espacial + **`launch_apps_per_worker`**(no incluido en la aplicación de muestra): dominio de servicio **importante** SimSpace Weaver admite hasta 5 dominios para cada simulación. Esto incluye todos los dominios espaciales, personalizados y de servicio. ``` 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 ``` **nota** SimSpace Weaver Los proyectos de la versión 1.12.x del SDK de la aplicación utilizan cubos separados para los archivos.zip de la aplicación y el esquema: weaver- - -app-zips- *lowercase-project-name* *account-number* *region* weaver- - -esquemas- *lowercase-project-name* *account-number* *region* **Topics** + [Configuración de la aplicación](working-with_configuring-simulation_domains_app-config.md) + [Configuración de dominios espaciales](working-with_configuring-simulation_domains_spatial.md) + [Puntos de conexión de red](working-with_configuring-simulation_domains_endpoints.md) + [Configuración de dominios de servicio](working-with_configuring-simulation_domains_service-domains.md) # Configuración de la aplicación La configuración de una aplicación (`app_config`) se especifica como parte de la configuración de su dominio. Todos los tipos de dominios utilizan estas mismas propiedades de configuración de la aplicación. ``` app_config: package: "s3://weaver-myproject-111122223333-us-west-2/MyViewApp.zip" launch_command: ["MyViewApp"] required_resource_units: compute: 1 ``` **nota** SimSpace Weaver Los proyectos de la versión 1.12.x del SDK de la aplicación utilizan cubos separados para los archivos.zip de la aplicación y el esquema: weaver- - -app-zips- *lowercase-project-name* *account-number* *region* weaver- - -esquemas- *lowercase-project-name* *account-number* *region* La propiedad `package` especifica el URI de S3 de un archivo zip de un bucket de S3. El archivo zip contiene el ejecutable de la aplicación (también denominado *binario*) y cualquier otro recurso que necesite (como bibliotecas). Cada instancia del ejecutable de la aplicación se ejecuta en un contenedor Docker en un dispositivo de trabajo. La propiedad `launch_command` especifica el nombre del ejecutable y cualquier opción de línea de comandos para ejecutar la aplicación. El valor de `launch_command` es una matriz. Cada símbolo de toda la cadena de comandos de lanzamiento es un elemento de la matriz. **Ejemplo** + Para el comando de lanzamiento: `MyTestApp --option1 value1` + Especifique: `launch_command: ["MyTestApp", "-option1", "value1"]`. La `required_resource_units` propiedad especifica el número de unidades de recursos de cómputo que se SimSpace Weaver deben asignar a esta aplicación. Una unidad de recursos informáticos es una cantidad fija de capacidad de procesamiento (vCPU) y memoria (RAM) de un trabajador. Puede aumentar este valor para aumentar la cantidad de potencia de cálculo disponible para la aplicación cuando se ejecuta en un trabajador. Hay un número limitado de unidades de recursos informáticos en cada trabajador. Para obtener más información, consulte [SimSpace Puntos finales y cuotas de Weaver](service-quotas.md). # Configuración de dominios espaciales Para los dominios espaciales, debe especificar un `partitioning_strategy`. El valor de esta propiedad es el nombre que ha asignado a una estrategia de partición que ha definido en otra parte del esquema. ``` 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 ``` **nota** SimSpace Weaver Los proyectos de la versión 1.12.x del SDK de la aplicación utilizan depósitos independientes para los archivos.zip de la aplicación y el esquema: weaver- - -app-zips- *lowercase-project-name* *account-number* *region* weaver- - -esquemas- *lowercase-project-name* *account-number* *region* Una estrategia de particionamiento con una `Grid` topología (la única topología compatible en esta versión) permite organizar las particiones de aplicaciones espaciales de este dominio en una cuadrícula. SimSpace Weaver La propiedad `grid_partition` especifica el número de filas y columnas de la cuadrícula de particiones. SimSpace Weaver iniciará 1 instancia de la aplicación espacial para cada celda de la cuadrícula de particiones. Por ejemplo, si un dominio espacial tiene `grid_partition` valores `x: 2` y `y: 2` hay 2 \$1 2 = 4 particiones en el dominio espacial. SimSpace Weaver iniciará 4 instancias de la aplicación configuradas en el dominio espacial y asignará 1 partición a cada instancia de la aplicación. **Temas** + [Requisitos de recursos para los dominios espaciales](#working-with_configuring-simulation_domains_spatial_resources) + [Múltiples dominios espaciales](#working-with_configuring-simulation_domains_spatial_multiple) + [Preguntas frecuentes sobre dominios espaciales](#working-with_configuring-simulation_domains_spatial_faq) + [Solución de problemas de dominios espaciales](#working-with_configuring-simulation_domains_spatial_troubleshooting) ## Requisitos de recursos para los dominios espaciales Puede asignar hasta 17 unidades de recursos de procesamiento para cada trabajador. Usted especifica el número de unidades de recursos informáticos que utiliza cada aplicación espacial en la sección `app_config` de su dominio espacial. **Example fragmento de esquema que muestra las unidades de recursos de cómputo de una aplicación espacial** ``` 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 ``` Para calcular el número de unidades de recursos informáticos que requiere un dominio, multiplique el número de celdas de la cuadrícula (en su `grid_partition`, `x` \$1 `y`) por el número de unidades de recursos informáticos asignadas a las aplicaciones espaciales. En el ejemplo anterior, el dominio `MySpatialDomain` especifica: + `x`: `2` + `y`: `2` + `compute`: `1` La cuadrícula para `MySpatialDomain` tiene 2 \$1 2 = 4 celdas. El dominio espacial requiere 4 x 1 = 4 unidades de recursos informáticos. El número total de unidades de recursos informáticos para todos los dominios especificados en el esquema debe ser inferior o igual al `desired` número de trabajadores multiplicado por el número máximo de unidades de recursos informáticos de cada trabajador (17). ## Múltiples dominios espaciales Puede configurar la simulación para que utilice más de un dominio espacial. Por ejemplo, puede usar un dominio espacial para controlar los actores principales de una simulación (como personas y automóviles) y un dominio espacial diferente para controlar el entorno. También puede utilizar varios dominios espaciales para asignar distintos recursos a distintas partes de la simulación. Por ejemplo, si la simulación tiene un tipo de entidad que tiene 10 veces más instancias de entidad que otro tipo, puede crear diferentes dominios para gestionar cada tipo de entidad y asignar más recursos al dominio con más entidades. **importante** SimSpace Weaver las versiones anteriores a la 1.14.0 no admiten varios dominios espaciales. **importante** AWS SimSpace Weaver Localactualmente no admite varios dominios espaciales. Para obtener más información acerca de SimSpace Weaver Local, consulte [Desarrollo local en SimSpace Weaver](working-with_local-development.md). **importante** SimSpace Weaver admite hasta 5 dominios para cada simulación. Esto incluye todos los dominios espaciales, personalizados y de servicio. ### Configurar varios dominios espaciales Para configurar más de un dominio espacial, añada las demás definiciones de dominio espacial como secciones con nombres independientes en su esquema. Cada dominio debe especificar la clave `launch_apps_by_partitioning_strategy`. Consulte el siguiente esquema de ejemplo. ``` 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 ``` ### Colocar dominios espaciales juntos En algunos casos, es posible que desee colocar las particiones de un dominio espacial en los trabajadores junto a las particiones de otro dominio. Esto puede mejorar las características de rendimiento si esas particiones se suscriben entre sí a varios dominios. Añada la clave de nivel superior `placement_constraints` a su esquema para especificar qué dominios SimSpace Weaver deben colocarse juntos. La clave `on_workers` requerida debe hacer referencia a una configuración de `workers` con nombre en el esquema. **Example fragmento de esquema que muestra los dominios espaciales colocados juntos** ``` workers: MyComputeWorkers: type: "sim.c5.24xlarge" desired: 2 placement_constraints: - placed_together: ["MySpatialDomain", "MySecondSpatialDomain"] on_workers: ["MyComputeWorkers"] ``` **importante** Si utiliza grupos de ubicación: Asegúrese de que x\$1 y sea múltiplo de la cantidad de trabajadores. Asegúrese de que los valores de los grupos de ubicación sean divisores comunes para las dimensiones de la cuadrícula de los dominios que coloque juntos. Si **no utiliza** grupos de ubicación: Asegúrese de que 1 eje de las cuadrículas de su dominio espacial tenga un divisor común que sea igual al número de trabajadores. Para obtener más información acerca de los grupos de ubicación, consulte [Estrategias de partición](working-with_configuring-simulation_partitioning-strategies.md#working-with_configuring-simulation_partitioning-strategies_placement-groups). ## Preguntas frecuentes sobre dominios espaciales ### Q1 (P1). ¿Cómo puedo añadir otro dominio espacial a una simulación existente? + **Para una simulación en ejecución**: no se puede cambiar la configuración de una simulación en ejecución. Cambie la configuración del dominio en el esquema, cargue el esquema y los archivos comprimidos de la aplicación e inicie una nueva simulación. + **Para una nueva simulación**: añada la configuración del dominio en el esquema, cargue el esquema y los archivos comprimidos de la aplicación e inicie una nueva simulación. ## Solución de problemas de dominios espaciales Cuando intenta iniciar la simulación, pero la configuración de dominio no es válida, puede aparecer el siguiente mensaje de error: ``` "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].\"}]" ``` **Causas posibles** + El esquema asigna más unidades de recursos de cómputo a las aplicaciones de las que están disponibles para los trabajadores. + SimSpace Weaver no se puede determinar un acuerdo para agrupar los dominios en los trabajadores. Esto ocurre cuando se especifican varios dominios espaciales, pero no hay un divisor común o un múltiplo entre las cuadrículas de dominios (por ejemplo, entre una cuadrícula de 2x4 y una cuadrícula de 3x5). # Puntos de conexión de red Las aplicaciones personalizadas y de servicio pueden tener puntos de conexión de red a los que se pueden conectar los clientes externos. Debe especificar una lista de números de puerto como valor `ingress_ports` en. `endpoint_config` Estos números de puerto son TCP y UDP. La aplicación personalizada o de servicio debe enlazarse a los números de puerto que especifiques`ingress_ports`. SimSpace Weaver asigna dinámicamente los números de puerto en tiempo de ejecución y asigna estos puertos a los puertos dinámicos. Puede llamar a la API **describe-app** una vez que sus aplicaciones hayan empezado a encontrar los números de puerto dinámicos (reales). Para obtener más información, consulte [Obtenga la dirección IP y el número de puerto de una aplicación personalizadaObtenga la dirección IP y el número de puerto](working-with_get-ip.md) en el tutorial de inicio rápido. ``` 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 ``` **nota** SimSpace Weaver Los proyectos de la versión 1.12.x del SDK de la aplicación utilizan cubos separados para los archivos.zip de la aplicación y el esquema: weaver- - -app-zips- *lowercase-project-name* *account-number* *region* weaver- - -esquemas- *lowercase-project-name* *account-number* *region* **nota** `endpoint_config` es una propiedad opcional para aplicaciones personalizadas y aplicaciones de servicio. Si no especifica ningún `endpoint_config`, la aplicación no tendrá un punto de conexión de red. # Configuración de dominios de servicio La presencia de `launch_apps_per_worker:` en una configuración de dominio indica que se trata de un dominio de servicio que tiene aplicaciones de servicio. SimSpace Weaver inicia y detiene las aplicaciones de servicio por usted. Cuando se SimSpace Weaver inicia y detiene una aplicación, se considera que la aplicación tiene un *ciclo de vida gestionado*. SimSpace Weaver actualmente permite iniciar 1 o 2 aplicaciones de servicio en todos y cada uno de los trabajadores. **Example Ejemplo de un dominio configurado para lanzar una aplicación de servicio en cada trabajador** ``` 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 Ejemplo de un dominio configurado para lanzar dos aplicaciones de servicio en cada trabajador** ``` 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 ```