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. # Uso de las opciones de configuración de Apache Airflow en Amazon MWAA Las opciones de configuración de Apache Airflow se pueden adjuntar a su entorno de Amazon Managed Workflows para Apache Airflow como variables de entorno. Puede elegir una opción de la lista desplegable sugerida o especificar opciones de configuración personalizadas para su versión de Apache Airflow en la consola Amazon MWAA. En esta página, se describen las opciones de configuración de Apache Airflow disponibles y cómo usarlas para anular los ajustes de configuración de Apache Airflow en su entorno. **Contents** + [Requisitos previos](#configuring-env-variables-prereqs) + [Funcionamiento](#configuring-env-variables-how) + [Uso de las opciones de configuración para cargar complementos](#configuring-2.0-airflow-override) + [Información general de las opciones de configuración](#configuring-env-variables-customizing) + [Opciones de configuración de Apache Airflow](#configuring-env-variables-airflow-ref) + [Referencia de Apache Airflow](#configuring-env-variables-reference-options) + [Uso de la consola de Amazon MWAA](#configuring-env-variables-console-add) + [Referencia de la configuración](#configuring-env-variables-reference) + [Configuración de correo electrónico](#configuring-env-variables-email) + [Configuración de tareas](#configuring-env-variables-tasks) + [Configuraciones del programador](#configuring-env-variables-scheduler) + [Configuraciones del proceso de trabajo](#configuring-env-variables-workers) + [Configuraciones del servidor web](#configuring-env-variables-webserver) + [Configuraciones del desencadenador](#configuring-env-variables-webserver) + [Ejemplos y código de ejemplo](#configuring-env-variables-code) + [Ejemplo de DAG](#configuring-env-variables-dag) + [Ejemplo de configuración de las notificaciones por correo electrónico](#configuring-env-variables-email) + [Siguientes pasos](#configuring-env-variables-next-up) ## Requisitos previos Para poder llevar a cabo los pasos de esta página, necesitará lo siguiente. + **Permisos**: el administrador debe haber concedido a su Cuenta de AWS acceso a la política de control de acceso de [AmazonMWAAFullConsoleAccess](access-policies.md#console-full-access) para su entorno. Además, su [rol de ejecución](mwaa-create-role.md) debe permitir que su entorno de Amazon MWAA acceda a los recursos de AWS que utiliza su entorno. + **Acceso**: si tiene que acceder a los repositorios públicos para instalar dependencias directamente en el servidor web, su entorno debe estar configurado con acceso a un servidor web de **red pública**. Para obtener más información, consulta [Modos de acceso de Apache Airflow](configuring-networking.md). + **Configuración de Amazon S3**: el [bucket de Amazon S3](mwaa-s3-bucket.md) que se utiliza para almacenar los DAG, los complementos personalizados en `plugins.zip` y las dependencias de Python en `requirements.txt` deben estar configurados con el *acceso público bloqueado* y el control de *versiones* activado. ## Funcionamiento Al crear un entorno, Amazon MWAA adjunta los ajustes de configuración que usted especifique en la consola Amazon MWAA en las **opciones de configuración de Airflow** como variables de entorno al contenedor AWS Fargate de su entorno. Si utiliza una configuración con el mismo nombre en `airflow.cfg`, las opciones que especifique en la consola Amazon MWAA anularán los valores incluidos en `airflow.cfg`. Si bien no exponemos el `airflow.cfg` en la interfaz de usuario de Apache Airflow de un entorno de Amazon MWAA de manera predeterminada, puede cambiar las opciones de configuración de Apache Airflow directamente en la consola de Amazon MWAA, incluida la configuración de `webserver.expose_config` para exponer las configuraciones. ## Uso de las opciones de configuración para cargar complementos De forma predeterminada, en Apache Airflow v2 y versiones posteriores, los complementos se configuran para que se carguen de forma “lenta” mediante la configuración `core.lazy_load_plugins : True`. Si usa complementos personalizados, debe agregar `core.lazy_load_plugins : False` como opción de configuración de Apache Airflow para cargar los complementos al inicio de cada proceso de Airflow y anular la configuración predeterminada. ## Información general de las opciones de configuración Cuando agrega una configuración en la consola Amazon MWAA, Amazon MWAA escribe la configuración como una variable de entorno. + **Opciones enumeradas**. Puede elegir uno de los ajustes de configuración disponibles para su versión de Apache Airflow en la lista desplegable. Por ejemplo, `dag_concurrency`: `16`. El ajuste de configuración se traduce al contenedor de Fargate de su entorno como `AIRFLOW__CORE__DAG_CONCURRENCY : 16` + **Opciones personalizadas**. También puede especificar las opciones de configuración de Airflow que no aparecen en la lista desplegable para su versión de Apache Airflow. Por ejemplo, `foo.user`: `YOUR_USER_NAME`. El ajuste de configuración se traduce al contenedor de Fargate de su entorno como `AIRFLOW__FOO__USER : YOUR_USER_NAME` ### Opciones de configuración de Apache Airflow En la siguiente imagen, se muestra dónde puede personalizar las **opciones de configuración de Apache Airflow** en la consola Amazon MWAA. ![En esta imagen, se muestra dónde puede personalizar las opciones de configuración de Apache Airflow en la consola Amazon MWAA.](http://docs.aws.amazon.com/es_es/mwaa/latest/userguide/images/mwaa-console-airflow-config.png) ### Referencia de Apache Airflow Para obtener una lista de las opciones de configuración compatibles con Apache Airflow, consulte la [referencia de configuración](https://airflow.apache.org/docs/apache-airflow/stable/configurations-ref.html) en la *guía de referencia de Apache Airflow*. Para ver las opciones de la versión de Apache Airflow que ejecuta en Amazon MWAA, seleccione la versión en la lista desplegable. ### Uso de la consola de Amazon MWAA A continuación, se explican los pasos que debe seguir para añadir una opción de configuración de Apache Airflow a su entorno. 1. Abra la página [Entornos](https://console.aws.amazon.com/mwaa/home#/environments) en la consola de Amazon MWAA. 1. Seleccione un entorno. 1. Elija **Editar**. 1. Elija **Siguiente**. 1. Seleccione **Agregar configuración personalizada** en el panel **Opciones de configuración de Airflow**. 1. En la lista desplegable, elija una opción de configuración e introduzca un valor. También puede escribir una configuración personalizada e introducir un valor. 1. Seleccione **Agregar configuración personalizada** para cada configuración que desee agregar. 1. Seleccione **Save**. ## Referencia de la configuración La siguiente sección contiene la lista de configuraciones de Apache Airflow disponibles en la lista desplegable de la consola de Amazon MWAA. ### Configuración de correo electrónico En la siguiente lista, se muestran las opciones de configuración de las notificaciones por correo electrónico de Airflow que están disponibles en Amazon MWAA para Apache Airflow v2 y v3. Recomendamos utilizar el puerto 587 para el tráfico SMTP. De forma predeterminada, AWS bloquea el tráfico SMTP de salida en el puerto 25 de todas las instancias de Amazon EC2. Si desea enviar tráfico saliente por el puerto 25, [solicite que se elimine esta restricción](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/). | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | email.email\_backend | La utilidad Apache Airflow utilizada para las notificaciones por correo electrónico en [email\_backend](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#email-backend). | airflow.utils.email.send\_email\_smtp | | smtp.smtp\_host | El nombre del servidor saliente utilizado como dirección de correo electrónico en [smtp\_host](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-host). | localhost | | smtp.smtp\_starttls | La seguridad de la capa de transporte (TLS) se usa para cifrar el correo electrónico a través de Internet en [smtp\_starttls](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-starttls). | False | | smtp.smtp\_ssl | Se usa la capa de sockets seguros (SSL) para conectar el servidor y el cliente de correo electrónico en [smtp\_ssl](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-ssl). | True | | smtp.smtp\_port | El puerto de protocolo de control de transmisión (TCP) designado al servidor en [smtp\_port](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-port). | 587 | | smtp.smtp\_mail\_from | La dirección de correo electrónico saliente en [smtp\_mail\_from](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#smtp-mail-from). | myemail@domain.com | ### Configuración de tareas En la siguiente lista, se muestran las configuraciones disponibles en la lista desplegable para las tareas de Airflow en Amazon MWAA para Apache Airflow v2 y v3. | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | core.default\_task\_retries | El número de veces que se debe volver a intentar una tarea de Apache Airflow en [default\_task\_retries](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-task-retries). | 3 | | core.parallelism | El número máximo de instancias de tareas que se pueden ejecutar simultáneamente en todo el entorno en paralelo ([paralelismo](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#parallelism)). | 40 | ### Configuraciones del programador En la siguiente lista, se muestran las configuraciones del programador de Apache Airflow que están disponibles en el menú desplegable de Amazon MWAA para Apache Airflow v2 y v3. | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | scheduler.catchup\_by\_default | Indica al programador que cree una ejecución de DAG para “alcanzar” el intervalo de tiempo específico de [catchup\_by\_default](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#catchup-by-default). | False | | scheduler.scheduler\_zombie\_task\_threshold No está disponible en Apache Airflow v3. | Indica al programador si debe marcar la instancia de la tarea como fallida y volver a programarla en [scheduler\_zombie\_task\_threshold](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#scheduler-zombie-task-threshold). | 300 | ### Configuraciones del proceso de trabajo En la siguiente lista, se muestran las configuraciones del proceso de trabajo de Airflow que están disponibles en el menú desplegable de Amazon MWAA para Apache Airflow v2 y v3. | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | celery.worker\_autoscale | El número máximo y mínimo de tareas que se pueden ejecutar simultáneamente en cualquier proceso de trabajo que utilice el [Celery Executor](https://airflow.apache.org/docs/apache-airflow/2.0.2/executor/celery.html) de [worker\_autoscale](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#worker-autoscale). El valor debe estar separado por comas en el siguiente orden: `max_concurrency,min_concurrency`. | 16,12 | ### Configuraciones del servidor web En la siguiente lista, se muestran las configuraciones del servidor web de Apache Airflow que están disponibles en el menú desplegable de Amazon MWAA para Apache Airflow v2 y v3. | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | webserver.default\_ui\_timezone No está disponible en Apache Airflow v3. | La configuración de fecha y hora de la interfaz de usuario de Apache Airflow predeterminada en [default\_ui\_timezone](https://airflow.apache.org/docs/apache-airflow/2.0.2/configurations-ref.html#default-ui-timezone). Si se configura la opción `default_ui_timezone`, no se modifica la zona horaria en la que está programada la ejecución de los DAG. Para cambiar la zona horaria de los DAG, puede utilizar un complemento personalizado. Para obtener más información, consulta [Cómo cambiar la zona horaria de un DAG en Amazon MWAA](samples-plugins-timezone.md). | America/New\_York | ### Configuraciones del desencadenador En la siguiente lista, se muestran las configuraciones del [desencadenador](https://airflow.apache.org/docs/apache-airflow/stable/authoring-and-scheduling/deferring.html) de Apache Airflow que están disponibles en Amazon MWAA para Apache Airflow v2 y v3. | Opción de configuración de Airflow | Descripción | Ejemplo de valor | | --- | --- | --- | | mwaa.triggerer\_enabled | Se utiliza para activar y desactivar el desencadenador en Amazon MWAA. De forma predeterminada, este valor se establece en `True`. Si se establece como `False`, Amazon MWAA no iniciará ningún proceso desencadenador en los programadores. | True | | triggerer.default\_capacity (en la versión 2)
triggerer.capacity (en la versión 3) | Define el número de desencadenamientos que cada desencadenador puede ejecutar en paralelo. En Amazon MWAA, esta capacidad se establece para cada desencadenador y para cada programador, ya que ambos componentes funcionan juntos. El valor predeterminado para cada programador es `60`, `125`, `250`, `500` y `1000` para instancias pequeñas, medianas y grandes, xlarge y 2xlarge respectivamente. | 125 | ## Ejemplos y código de ejemplo ### Ejemplo de DAG Puede usar el siguiente DAG para imprimir las opciones de configuración `email_backend` de Apache Airflow. Para ejecutarlo en respuesta a eventos de Amazon MWAA, copie el código en la carpeta DAG de su entorno en su bucket de almacenamiento de Amazon S3. ``` from airflow.decorators import dag from datetime import datetime def print_var(**kwargs): email_backend = kwargs['conf'].get(section='email', key='email_backend') print("email_backend") return email_backend @dag( dag_id="print_env_variable_example", schedule_interval=None, start_date=datetime({{yyyy}}, {{m}}, {{d}}), catchup=False, ) def print_variable_dag(): email_backend_test = PythonOperator( task_id="email_backend_test", python_callable=print_var, provide_context=True ) print_variable_test = print_variable_dag() ``` ### Ejemplo de configuración de las notificaciones por correo electrónico Las siguientes opciones de configuración de Apache Airflow se pueden utilizar para una cuenta de correo electrónico de Gmail.com con una contraseña de aplicación. Para obtener más información, consulte [Cómo iniciar sesión con contraseñas de aplicaciones](https://support.google.com/mail/answer/185833?hl=en-GB) en la *guía de referencia de Gmail*. ![En esta imagen, se muestra cómo configurar una cuenta de correo de gmail.com mediante las opciones de configuración de Apache Airflow en la consola MWAA.](http://docs.aws.amazon.com/es_es/mwaa/latest/userguide/images/mwaa-console-config-email-configuration.png) ## Siguientes pasos + Obtenga información sobre cómo cargar la carpeta de DAG a su bucket de Amazon S3 en [Cómo añadir o actualizar DAG](configuring-dag-folder.md).