

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.

# Implementación del escalado de aplicaciones en Managed Service para Apache Flink
<a name="how-scaling"></a>

Puede configurar la ejecución paralela de las tareas y la asignación de recursos para que Amazon Managed Service para Apache Flink implemente la reducción horizontal. Para obtener más información sobre cómo Apache Flink programa instancias paralelas de las tareas, consulte [Parallel Execution](https://nightlies.apache.org/flink/flink-docs-release-1.19/docs/dev/datastream/execution/parallel/) en la documentación de Apache Flink.

**Topics**
+ [Configurar el paralelismo de aplicaciones y la KPU ParallelismPer](#how-parallelism)
+ [Asignación de unidades de procesamiento de Kinesis](#how-scaling-kpus)
+ [Actualización del paralelismo de la aplicación](#how-scaling-howto)
+ [Uso del escalado automático en Managed Service para Apache Flink](how-scaling-auto.md)
+ [Consideraciones sobre maxParallelism](#how-scaling-auto-max-parallelism)

## Configurar el paralelismo de aplicaciones y la KPU ParallelismPer
<a name="how-parallelism"></a>

Para configurar la ejecución paralela de las tareas de la aplicación de Managed Service para Apache Flink (como leer de una fuente o ejecutar un operador), se utilizan las siguientes propiedades [https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_ApplicationConfiguration.html](https://docs.aws.amazon.com/managed-flink/latest/apiv2/API_ApplicationConfiguration.html): 
+ `Parallelism`: utilice esta propiedad para establecer el paralelismo predeterminado de la aplicación de Apache Flink. Todos los operadores, las fuentes y los receptores se ejecutan con este paralelismo, a menos que estén anulados en el código de la aplicación. El valor predeterminado es `1`, y el valor máximo es `256`.
+ `ParallelismPerKPU`: utilice esta propiedad para configurar el número de tareas paralelas que se pueden programar por unidad de procesamiento de Kinesis (KPU) de la aplicación. El valor predeterminado es `1` y el máximo es `8`. En el caso de las aplicaciones que tienen operaciones de bloqueo (por ejemplo, E/S), un valor más alto de `ParallelismPerKPU` implica la plena utilización de los recursos de KPU.

**nota**  
El límite de `Parallelism` es igual a `ParallelismPerKPU` multiplicado por el límite de KPUs (que tiene un valor predeterminado de 64). El KPUs límite se puede aumentar solicitando un aumento del límite. Para obtener instrucciones sobre cómo solicitar un aumento de este límite, consulte “Para solicitar un aumento del límite” en [Service Quotas](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).

Para obtener información sobre cómo configurar el paralelismo de tareas para un operador específico, consulte [Setting the Parallelism: Operator](https://nightlies.apache.org/flink/flink-docs-release-1.19/docs/dev/datastream/execution/parallel/#operator-level) en la documentación de Apache Flink.

## Asignación de unidades de procesamiento de Kinesis
<a name="how-scaling-kpus"></a>

El servicio gestionado para Apache Flink aprovisiona capacidad como KPUs. Una sola KPU le proporciona 1 vCPU y 4 GB de memoria. Por cada KPU asignada, también se proporcionan 50 GB de almacenamiento para aplicaciones en ejecución. 

Managed Service for Apache Flink calcula las KPUs propiedades necesarias para ejecutar la aplicación mediante las `ParallelismPerKPU` propiedades `Parallelism` y, de la siguiente manera:

```
Allocated KPUs for the application = Parallelism/ParallelismPerKPU
```

Managed Service para Apache Flink proporciona rápidamente recursos a las aplicaciones en respuesta a los picos de rendimiento o de la actividad de procesamiento. Elimina los recursos de la aplicación de forma gradual una vez que ha pasado el pico de actividad. Para deshabilitar la asignación automática de recursos, defina el valor `AutoScalingEnabled` en `false`, como se describe más adelante en [Actualización del paralelismo de la aplicación](#how-scaling-howto). 

El límite predeterminado KPUs para su aplicación es 64. Para obtener instrucciones sobre cómo solicitar un aumento de este límite, consulte “Para solicitar un aumento del límite” en [Service Quotas](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).

**nota**  
Se cobra una KPU adicional por motivos de orquestación. Para obtener más información, consulte [Precios de Managed Service para Apache Flink](https://aws.amazon.com/kinesis/data-analytics/pricing/).

## Actualización del paralelismo de la aplicación
<a name="how-scaling-howto"></a>

Esta sección contiene ejemplos de solicitudes de acciones de la API que establecen el paralelismo de una aplicación. Para ver más ejemplos e instrucciones sobre cómo usar los bloques de solicitudes con las acciones de la API, consulte [Ejemplo de código de API de Managed Service para Apache Flink](api-examples.md).

El siguiente ejemplo de solicitud de la acción [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_CreateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_CreateApplication.html) establece el paralelismo al crear una aplicación:

```
{
   "ApplicationName": "string",
   "RuntimeEnvironment":"FLINK-1_18",
   "ServiceExecutionRole":"arn:aws:iam::123456789123:role/myrole",
   "ApplicationConfiguration": { 
      "ApplicationCodeConfiguration":{
      "CodeContent":{
         "S3ContentLocation":{
            "BucketARN":"arn:aws:s3:::amzn-s3-demo-bucket",
            "FileKey":"myflink.jar",
            "ObjectVersion":"AbCdEfGhIjKlMnOpQrStUvWxYz12345"
            }
         },
      "CodeContentType":"ZIPFILE"
   },   
      "FlinkApplicationConfiguration": { 
         "ParallelismConfiguration": { 
            "AutoScalingEnabled": "true",
            "ConfigurationType": "CUSTOM",
            "Parallelism": 4,
            "ParallelismPerKPU": 4
         }
      }
   }
}
```

El siguiente ejemplo de solicitud de la acción [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html) establece el paralelismo para una aplicación existente:

```
{
   "ApplicationName": "MyApplication",
   "CurrentApplicationVersionId": 4,
   "ApplicationConfigurationUpdate": { 
      "FlinkApplicationConfigurationUpdate": { 
         "ParallelismConfigurationUpdate": { 
            "AutoScalingEnabledUpdate": "true",
            "ConfigurationTypeUpdate": "CUSTOM",
            "ParallelismPerKPUUpdate": 4,
            "ParallelismUpdate": 4
         }
      }
   }
}
```

El siguiente ejemplo de solicitud de la acción [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html) deshabilita el paralelismo para una aplicación existente:

```
{
   "ApplicationName": "MyApplication",
   "CurrentApplicationVersionId": 4,
   "ApplicationConfigurationUpdate": { 
      "FlinkApplicationConfigurationUpdate": { 
         "ParallelismConfigurationUpdate": { 
            "AutoScalingEnabledUpdate": "false"
         }
      }
   }
}
```

## Consideraciones sobre maxParallelism
<a name="how-scaling-auto-max-parallelism"></a>

El paralelismo máximo que puede escalar una tarea de Flink está limitado por el `maxParallelism` *mínimo* en todos los operadores de la tarea. Por ejemplo, en caso de un trabajo simple con solo un origen y un receptor, y el origen tiene un `maxParallelism` de 16 y el receptor tiene 8, la aplicación no podrá escalar más allá del paralelismo de 8.

Para saber cómo se calcula el valor predeterminado `maxParallelism` de un operador y cómo anularlo, consulte [Setting the Maximum Parallelism](https://nightlies.apache.org/flink/flink-docs-release-1.19/docs/dev/datastream/execution/parallel/#setting-the-maximum-parallelism) en la documentación de Apache Flink.

Como regla básica, tenga en cuenta que si no define un `maxParallelism` para ningún operador e inicia la aplicación con un paralelismo menor o igual a 128, todos los operadores tendrán un `maxParallelism` de 128.

**nota**  
El paralelismo máximo del trabajo es el límite superior del paralelismo para escalar la aplicación y retener el estado.   
Si se modifica el `maxParallelism` de una aplicación existente, la aplicación no podrá reiniciarse a partir de una instantánea anterior tomada con el antiguo `maxParallelism`. Solo puede reiniciar la aplicación sin una instantánea.   
Si planea escalar la aplicación a un paralelismo superior a 128, debe configurar de forma explícita el `maxParallelism` en la aplicación.
+ La lógica del escalado automático evitará escalar una tarea de Flink a un paralelismo que supere el paralelismo máximo de la tarea.
+ Si se utiliza un escalado automático personalizado o un escalado programado, configúrelos para que no superen el paralelismo máximo del trabajo.
+ Si escala de manera manual la aplicación más allá del paralelismo máximo, la aplicación no se iniciará.