

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.

# Entornos informáticos en instancias administradas de Amazon ECS
<a name="ecs-managed-instances-compute-environments"></a>

AWS Batch Los entornos de procesamiento de las instancias administradas de Amazon ECS utilizan un bloque de `managedInstancesProvider` configuración interno`computeResources`. Esta estructura se alinea con el modelo de proveedor de capacidad de Amazon ECS y es autónoma. Toda la configuración de redes, perfiles de instancias y selección de instancias se encuentra dentro de este bloque.

La siguiente lista describe los parámetros del entorno de procesamiento para los entornos de procesamiento de las instancias administradas de Amazon ECS.

`type`(nivel superior)  
Debe ser `MANAGED`.  

```
"type": "MANAGED"
```

`computeResources.type`  
Debe ser `ECS_MANAGED_INSTANCES`. A diferencia de los entornos informáticos de Fargate y Amazon EC2, la capacidad puntual no se expresa como un tipo independiente (no existe ningún `ECS_MANAGED_INSTANCES_SPOT` tipo). En su lugar, utilice `capacityOptionType` inside `managedInstancesProvider.instanceLaunchTemplate` para especificar On-Demand o detectar la capacidad.  

```
"type": "ECS_MANAGED_INSTANCES"
```

`computeResources.maxvCpus`  
La cantidad máxima de vCPU a las que se puede escalar el entorno de procesamiento. Funciona igual `maxvCpus` que en los entornos informáticos de Fargate: limita el consumo total de vCPU en todos los trabajos en ejecución.  
Actualmente, AWS Batch las evaluaciones se `maxvCpus` basan en el total de vCPU solicitadas por los trabajos en ejecución, no en el total de vCPU de las instancias de Amazon EC2 subyacentes. Las instancias administradas de Amazon ECS utilizan la asignación de instancias de varios inquilinos. Como resultado, la capacidad real de vCPU de la instancia aprovisionada puede superar el total de vCPU de la tarea. El entorno de procesamiento puede aprovisionar más capacidad de instancias de la que implica el `maxvCpus` valor. Es posible que este comportamiento se perfeccione en una actualización futura.

`computeResources.managedInstancesProvider`  
Necesario para los entornos informáticos de las instancias administradas de Amazon ECS. Contiene toda la Instances-specific configuración gestionada de Amazon ECS. Para obtener más información, consulte la referencia [ ManagedInstancesProvider ](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ManagedInstancesProvider.html) de la API de * Amazon Elastic Container Service*. Están disponibles los siguientes campos:    
`infrastructureRoleArn`  
Obligatorio. El ARN de la función de IAM que Amazon ECS asume para administrar las instancias de Amazon EC2 en su nombre. Este rol debe tener una política de confianza para. `ecs.amazonaws.com` Su director de IAM debe tener `iam:PassRole` permiso para desempeñar esta función con esta condición. `iam:PassedToService: ecs.amazonaws.com`  
`propagateTags`  
Opcional. Controla si las etiquetas del proveedor de capacidad se propagan a las instancias de Amazon EC2 que lanza. Los valores válidos son `CAPACITY_PROVIDER` y `NONE`.  
`instanceLaunchTemplate`  
Obligatorio. Contiene la configuración de lanzamiento de la instancia:    
`ec2InstanceProfileArn`  
Obligatorio. El ARN del perfil de instancia de Amazon EC2 para las instancias administradas. Este perfil de instancia debe usar la política `AmazonECSInstanceRolePolicyForManagedInstances` administrada con una política de confianza para. `ec2.amazonaws.com`  
`networkConfiguration`  
Obligatorio. Especifica la configuración de VPC para las instancias administradas.  
+ `subnets`: obligatorio. Las subredes de VPC donde se lanzan las instancias. Las instancias necesitan acceso a una red externa para comunicarse con el punto final del servicio Amazon ECS. Si sus subredes no proporcionan direcciones IP públicas, deben tener una puerta de enlace NAT para el acceso saliente a Internet.
+ `securityGroups`: obligatorio. Los grupos de seguridad de VPC que se van a asociar a las instancias.  
`instanceRequirements`  
Opcional. Especifica las restricciones sobre los tipos de instancias de Amazon EC2 que Amazon ECS puede lanzar. Si no se proporcionan, todos los tipos de instancias disponibles son aptos.  
+ `allowedInstanceTypes`— Una lista de tipos o familias de instancias específicos (por ejemplo, `m5.large` o`g5`). Cuando se especifican, solo se usan estos tipos de instancias.  
`capacityOptionType`  
Opcional. El modelo de precios por capacidad. Los valores válidos son `ON_DEMAND` (predeterminado) y `SPOT`. Con`SPOT`, Amazon ECS lanza instancias puntuales que pueden proporcionar importantes ahorros de costos para las cargas de trabajo tolerantes a errores.  
`storageConfiguration`  
Opcional. Configura el volumen raíz de EBS para las instancias.  
+ `storageSizeGiB`— El tamaño del volumen raíz en GiB.  
`monitoring`  
Opcional. El nivel de CloudWatch supervisión de las instancias. Los valores válidos son `BASIC` y `DETAILED`.  
`fipsEnabled`  
Opcional. Cuando se establece en`true`, habilita el cumplimiento de la FIPS 140-2 en las instancias administradas. No está disponible en todas. Regiones de AWS  
`capacityReservations`  
Opcional. Se dirige a las reservas de On-Demand capacidad (ODCR) para garantizar una disponibilidad de capacidad predecible.  
+ `reservationGroupArn`— El ARN del grupo de reserva de capacidad al que se dirige.
+ `reservationPreference`— Controla cómo se utilizan las reservas de capacidad. Los valores válidos son `RESERVATIONS_ONLY` (solo se aplican a las reservas), `RESERVATIONS_FIRST` (se prefieren las reservas, se recurre a las reservas bajo demanda) y `RESERVATIONS_EXCLUDED` (no se utilizan las reservas).  
`instanceMetadataTagsPropagation`  
Opcional. Controla si se puede acceder a las etiquetas desde el servicio de metadatos de la instancia (IMDS) en las instancias administradas.  
`localStorageConfiguration`  
Opcional. Configura los volúmenes de almacenamiento de instancias locales (SSD NVMe locales) para las instancias administradas.  
+ `useLocalStorage`— Si los volúmenes del almacén de instancias están disponibles para los contenedores que se ejecutan en las instancias administradas.  
`infrastructureOptimization`  
Opcional. Controla la forma en que Amazon ECS administra las instancias inactivas.  
+ `scaleInAfter`— La cantidad de segundos que una instancia debe estar inactiva antes de que Amazon ECS la termine. Los valores válidos son `-1` (para deshabilitar la escalabilidad) o `0` — `3600` (segundos de inactividad antes de la finalización).

`computeResources.capacityTags`  
Opcional. Etiquetas que se deben aplicar al proveedor de capacidad de Amazon ECS y a las instancias de Amazon EC2 administradas por el entorno informático. Solo es válido para entornos `ECS_MANAGED_INSTANCES` informáticos. El director de IAM debe tener `batch:SetCapacityTags` permiso en el recurso del entorno informático para especificar este campo. Para obtener más información, consulte [Controle el acceso a las etiquetas de capacidad `por lotes: SetCapacityTags`](capacity-tags-access-policy.md).  
Estas etiquetas son independientes del nivel superior `tags` del propio recurso del entorno informático. Se utilizan `capacityTags` para la asignación de costos y la organización de los recursos de la infraestructura subyacente.

Los parámetros no se aplican a las instancias administradas de Amazon ECS  
Los siguientes `computeResources` parámetros no son válidos para los entornos informáticos de las instancias administradas de Amazon ECS y no deben especificarse:  
+ `allocationStrategy`
+ `bidPercentage`
+ `desiredvCpus`
+ `minvCpus`
+ `imageId`
+ `instanceTypes`
+ `instanceRole`
+ `ec2Configuration`
+ `ec2KeyPair`
+ `launchTemplate`
+ `placementGroup`
+ `spotIamFleetRole`
+ `subnets`(utilízalo `managedInstancesProvider.instanceLaunchTemplate.networkConfiguration.subnets` en su lugar)
+ `securityGroupIds`(usar `managedInstancesProvider.instanceLaunchTemplate.networkConfiguration.securityGroups` en su lugar)

## Actualización de los entornos informáticos de las instancias administradas de Amazon ECS
<a name="ecs-managed-instances-compute-environment-updates"></a>

Todos los atributos del entorno informático de las instancias administradas de Amazon ECS se pueden actualizar`capacityOptionType`, excepto el tipo de entorno informático y`fipsEnabled`. Las actualizaciones llegan al proveedor de capacidad subyacente de Amazon ECS. Las instancias nuevas utilizan la configuración actualizada. Las instancias existentes siguen ejecutándose hasta que finalicen sus tareas y, a continuación, se agotan de forma natural.

No se puede cambiar lo siguiente después de la creación:
+ El tipo de entorno informático (`ECS_MANAGED_INSTANCES`no se puede cambiar a `FARGATE` ningún otro tipo) `EC2`
+ `capacityOptionType`— No puedes cambiar entre Spot On-Demand y Spot después de la creación
+ `fipsEnabled`— El modo FIPS no se puede cambiar después de la creación

## Ejemplos
<a name="ecs-managed-instances-compute-environment-examples"></a>

### Configuración mínima
<a name="ecs-managed-instances-ce-example-minimal"></a>

El siguiente ejemplo muestra la configuración mínima requerida para crear un entorno informático de instancias administradas de Amazon ECS. Amazon ECS selecciona automáticamente los tipos de instancias de entre todos los tipos disponibles.

```
{
  "computeEnvironmentName": "my-managed-instances-ce",
  "type": "MANAGED",
  "state": "ENABLED",
  "computeResources": {
    "type": "ECS_MANAGED_INSTANCES",
    "maxvCpus": 256,
    "managedInstancesProvider": {
      "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
      "instanceLaunchTemplate": {
        "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
        "networkConfiguration": {
          "subnets": ["subnet-abcde012", "subnet-bcde012a"],
          "securityGroups": ["sg-abcde012"]
        }
      }
    }
  }
}
```

### Carga de trabajo de GPU con tipos de instancias específicos
<a name="ecs-managed-instances-ce-example-gpu"></a>

En el siguiente ejemplo, se crea un entorno informático restringido a los tipos de instancias de GPU de NVIDIA para las cargas de trabajo de aprendizaje automático.

```
{
  "computeEnvironmentName": "my-gpu-managed-instances-ce",
  "type": "MANAGED",
  "state": "ENABLED",
  "computeResources": {
    "type": "ECS_MANAGED_INSTANCES",
    "maxvCpus": 1000,
    "managedInstancesProvider": {
      "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
      "instanceLaunchTemplate": {
        "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
        "networkConfiguration": {
          "subnets": ["subnet-abcde012", "subnet-bcde012a"],
          "securityGroups": ["sg-abcde012"]
        },
        "instanceRequirements": {
          "allowedInstanceTypes": ["g5.xlarge", "g5.2xlarge", "g5.4xlarge"]
        },
        "capacityOptionType": "ON_DEMAND"
      }
    }
  }
}
```

### Detecte la capacidad para cargas de trabajo sensibles a los costos
<a name="ecs-managed-instances-ce-example-spot"></a>

El siguiente ejemplo crea un entorno Spot-backed informático para cargas de trabajo por lotes tolerantes a errores.

```
{
  "computeEnvironmentName": "my-spot-managed-instances-ce",
  "type": "MANAGED",
  "state": "ENABLED",
  "computeResources": {
    "type": "ECS_MANAGED_INSTANCES",
    "maxvCpus": 5000,
    "managedInstancesProvider": {
      "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole",
      "instanceLaunchTemplate": {
        "ec2InstanceProfileArn": "arn:aws:iam::123456789012:instance-profile/ecsInstanceProfile",
        "networkConfiguration": {
          "subnets": ["subnet-abcde012", "subnet-bcde012a", "subnet-cde012ab"],
          "securityGroups": ["sg-abcde012"]
        },
        "instanceRequirements": {
          "allowedInstanceTypes": ["m5.large", "m5.xlarge", "m6i.large", "m6i.xlarge"]
        },
        "capacityOptionType": "SPOT",
        "storageConfiguration": {
          "storageSizeGiB": 100
        }
      }
    }
  }
}
```