Instalación de complementos personalizados
Amazon Managed Workflows para Apache Airflow es compatible con el administrador de complementos integrado en Apache Airflow, lo que le permite utilizar operadores, enlaces, sensores o interfaces personalizados de Apache Airflow. En esta página se describen los pasos para instalar los complementos personalizados de Apache Airflowplugins.zip
.
Contenido
- Requisitos previos
- Funcionamiento
- Cuándo usar los complementos
- Información general de los complementos personalizados
- Ejemplos de complementos personalizados
- Crear un archivo plugins.zip
- Cómo cargar plugins.zip a Amazon S3
- Instalación de complementos personalizados en su entorno
- Ejemplos de casos de uso de plugins.zip
- Siguientes pasos
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 para su entorno. Además, su rol de ejecución 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, consulte Modos de acceso de Apache Airflow.
-
Configuración de Amazon S3: el bucket de Amazon S3 que se utiliza para almacenar los DAG, los complementos personalizados en
plugins.zip
y las dependencias de Python enrequirements.txt
deben estar configurados con el acceso público bloqueado y el control de versiones activado.
Funcionamiento
Para ejecutar complementos personalizados en su entorno, debe hacer tres cosas:
-
Cree un archivo
plugins.zip
local. -
Cargue el archivo
plugins.zip
en su bucket de Amazon S3. -
Especifique la versión de este archivo en el campo Archivo de complementos de la consola de Amazon MWAA.
nota
Si es la primera vez que sube un archivo plugins.zip
a su bucket de Amazon S3, también tendrá que especificar la ruta al archivo en la consola de Amazon MWAA. Solo necesita realizar este paso una vez.
Cuándo usar los complementos
Los complementos solo son necesarios para ampliar la interfaz de usuario de Apache Airflow, como se describe en la documentación de Apache Airflow/dags
junto con el código DAG
.
Si necesita crear sus propias integraciones con sistemas externos, colóquelas en la carpeta /dags
o en una de sus subcarpetas, pero no en la carpeta plugins.zip
. En Apache Airflow 2.x, los complementos se utilizan principalmente para ampliar la interfaz de usuario.
Del mismo modo, no se deben colocar otras dependencias en plugins.zip
. En su lugar, se pueden almacenar en una ubicación dentro de la carpeta /dags
de Amazon S3, donde se sincronizarán con cada contenedor de Amazon MWAA antes de que se inicie Apache Airflow.
nota
Cualquier archivo de la carpeta /dags
o en plugins.zip
que no defina explícitamente un objeto DAG de Apache Airflow debe figurar en un archivo .airflowignore
.
Información general de los complementos personalizados
El administrador de complementos integrado de Apache Airflow puede integrar características externas en su núcleo simplemente colocando archivos en una carpeta $AIRFLOW_HOME/plugins
. Le permite utilizar operadores, enlaces, sensores o interfaces personalizados de Apache Airflow. La siguiente sección proporciona un ejemplo de estructuras de directorios planas y anidadas en un entorno de desarrollo local y las instrucciones de importación resultantes, que determinan la estructura de directorios dentro de un plugins.zip.
Directorio de complementos personalizados y límites de tamaño
El programador y los procesos de trabajo de Apache Airflow buscan complementos personalizados durante el inicio en el contenedor de Fargate administrado por AWS para su entorno en /usr/local/airflow/plugins/
.*
-
Estructura de directorios. La estructura de directorios (en
/
) se basa en el contenido del archivo*
plugins.zip
. Por ejemplo, si suplugins.zip
contiene el directoriooperators
como directorio de nivel superior, el directorio se extraerá a/usr/local/airflow/plugins/
en su entorno.operators
-
Límite de tamaño. Se recomienda un archivo
plugins.zip
de menos de 1 GB. Cuanto mayor sea el tamaño del archivoplugins.zip
, mayor será el tiempo de inicio en un entorno. Aunque Amazon MWAA no limita el tamaño de un archivoplugins.zip
de forma explícita, si las dependencias no se pueden instalar en diez minutos, el servicio Fargate agotará el tiempo de espera e intentará revertir el entorno a un estado estable.
nota
Para los entornos que utilizan Apache Airflow v1.10.12 o Apache Airflow v2.0.2, Amazon MWAA limita el tráfico saliente en el servidor web Apache Airflow y no le permite instalar complementos ni dependencias de Python directamente en el servidor web. A partir de la versión 2.2.2 de Apache Airflow, Amazon MWAA puede instalar complementos y dependencias directamente en el servidor web.
Ejemplos de complementos personalizados
En la siguiente sección, se utiliza un código de muestra de la guía de referencia de Apache Airflow para mostrar cómo estructurar su entorno de desarrollo local.
Ejemplo de uso de una estructura de directorios plana en plugins.zip
Ejemplo de uso de una estructura de directorios anidada en plugins.zip
Crear un archivo plugins.zip
En los pasos siguientes se describen los pasos que recomendamos para crear un archivo plugins.zip de forma local.
Paso uno: pruebe los complementos personalizados con la utilidad CLI de Amazon MWAA
-
La utilidad de la interfaz de la línea de comandos (CLI) replica entornos en Amazon Managed Workflows para Apache Airflow de forma local.
-
La CLI crea localmente una imagen de contenedor de Docker similar a una imagen de producción de Amazon MWAA. Esto le permite ejecutar un entorno local de Apache Airflow para desarrollar y probar los DAG, los complementos personalizados y las dependencias antes de implementarlos en Amazon MWAA.
-
Para ejecutar la CLI, consulte aws-mwaa-local-runner
en GitHub.
Paso dos: crear el archivo plugins.zip
Puede utilizar una utilidad de archivado ZIP integrada o cualquier otra utilidad ZIP (como 7zip
nota
La utilidad zip integrada para el sistema operativo Windows puede agregar subcarpetas al crear un archivo .zip. Le recomendamos comprobar el contenido del archivo plugins.zip antes de subirlo a su bucket de Amazon S3 para asegurarse de que no se hayan añadido directorios adicionales.
-
Cambie los directorios a su directorio local de complementos de Airflow. Por ejemplo:
myproject$
cd plugins
-
Ejecute el siguiente comando para asegurarse de que el contenido tiene permisos de ejecución (solo para macOS y Linux).
plugins$
chmod -R 755 .
-
Comprima el contenido de la carpeta
plugins
.plugins$
zip -r plugins.zip .
Cómo cargar plugins.zip
a Amazon S3
Puede usar la consola de Amazon S3 o la AWS Command Line Interface (AWS CLI) para cargar un archivo plugins.zip
a su bucket de Amazon S3.
Uso del AWS CLI
La AWS Command Line Interface (AWS CLI) es una herramienta de código abierto que le permite interactuar con los servicios de AWS mediante el uso de comandos en el intérprete de comandos de la línea de comandos. Para completar los pasos de esta página, necesita lo siguiente:
Carga mediante la AWS CLI
-
En el símbolo del sistema, vaya hasta el directorio en el que está almacenado el archivo
plugins.zip
. Por ejemplo:cd plugins
-
Use el siguiente comando para obtener una lista de todos los buckets de Amazon S3.
aws s3 ls
-
Utilice el comando siguiente para enumerar los archivos y las carpetas del bucket de Amazon S3 para su entorno.
aws s3 ls s3://
YOUR_S3_BUCKET_NAME
-
Utilice el siguiente comando para cargar el archivo
plugins.zip
en el bucket de Amazon S3 para su entorno.aws s3 cp plugins.zip s3://
YOUR_S3_BUCKET_NAME
/plugins.zip
Uso de la consola de Amazon S3
La consola de Amazon S3 es una interfaz de usuario basada en la web que le permite crear y administrar los recursos de su bucket de Amazon S3.
Carga del contenido usando la consola de Amazon S3
-
Abra la página Entornos
en la consola de Amazon MWAA. -
Seleccione un entorno.
-
Seleccione el enlace del bucket S3 en el panel de códigos de DAG en S3 para abrir el bucket de almacenamiento en la consola de Amazon S3.
-
Seleccione Cargar.
-
Elija Añadir archivo.
-
Seleccione la copia local de su
plugins.zip
, elija Cargar.
Instalación de complementos personalizados en su entorno
En esta sección se describe cómo instalar los complementos personalizados que ha cargado en su bucket de Amazon S3 especificando la ruta al archivo plugins.zip y especificando la versión del archivo plugins.zip cada vez que se actualiza el archivo zip.
Especificación de la ruta a plugins.zip
en la consola MWAA de Amazon (la primera vez)
Si es la primera vez que sube un archivo plugins.zip
a su bucket de Amazon S3, también tendrá que especificar la ruta al archivo en la consola de Amazon MWAA. Solo necesita realizar este paso una vez.
-
Abra la página Entornos
en la consola de Amazon MWAA. -
Seleccione un entorno.
-
Elija Editar.
-
En el panel Código DAG en Amazon S3, elija Explorar S3 junto al campo Archivo de complementos: opcional.
-
Seleccione el archivo
plugins.zip
en su bucket de Amazon S3. -
Seleccione Elegir.
-
Seleccione Siguiente, Actualizar entorno.
Especificación de la versión de plugins.zip
en la consola de Amazon MWAA
Debe especificar la versión de su archivo plugins.zip
en la consola de Amazon MWAA cada vez que cargue una nueva versión de su plugins.zip
en su bucket de Amazon S3.
-
Abra la página Entornos
en la consola de Amazon MWAA. -
Seleccione un entorno.
-
Elija Editar.
-
En el panel Código de DAG en Amazon S3, elija una versión de
plugins.zip
de la lista desplegable. -
Elija Siguiente.
Ejemplos de casos de uso de plugins.zip
-
Obtenga información sobre cómo crear un complemento personalizado en Creación de un complemento con Apache Hive y Hadoop.
-
Obtenga información sobre cómo crear un complemento personalizado en Complemento personalizado para parchear PythonVirtualEnvOperator .
-
Obtenga información sobre cómo crear un complemento personalizado en Complemento personalizado con Oracle.
-
Obtenga información sobre cómo crear un complemento personalizado en Cómo cambiar la zona horaria de un DAG en Amazon MWAA.
Siguientes pasos
-
Pruebe sus DAG, complementos personalizados y dependencias de Python de forma local con aws-mwaa-local-runner
en GitHub.