

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.

# Solución de problemas: creación y actualización de entornos de Amazon MWAA
<a name="t-create-update-environment"></a>

En esta página, se describen los errores que puede encontrar al crear y actualizar entornos de Amazon Managed Workflows para Apache Airflow y cómo resolverlos.

**Contents**
+ [Actualización de `requirements.txt`](#troubleshooting-reqs)
  + [He especificado una nueva versión de mi `requirements.txt` y la actualización de mi entorno está tardando más de 20 minutos](#t-requirements)
+ [Complementos](#troubleshooting-plugins)
  + [¿Admite Amazon MWAA la implementación de una interfaz de usuario personalizada?](#custom-ui)
+ [Creación de un bucket](#troubleshooting-create-bucket)
  + [No puedo seleccionar la opción de bloqueo de acceso público en S3](#t-create-bucket)
+ [Creación de un entorno](#troubleshooting-create-environment)
  + [Intenté crear un entorno, pero se atascó en el estado `Creating`](#t-stuck-failure)
  + [Intenté crear un entorno, pero aparece el estado como `Create failed`](#t-create-environ-failed)
  + [Intenté seleccionar una VPC y se produjo el error `Network Failure`](#t-network-failure)
  + [He intentado crear un entorno y he recibido un mensaje de error que indica que el servicio, la partición o el recurso “deben pasarse”](#t-service-partition)
  + [Intenté crear un entorno que muestra el estado como `Available`, pero cuando intento acceder a la UI de Airflow aparece el mensaje de error `Empty Reply from Server` o `502 Bad Gateway`.](#t-create-environ-empty-reply)
  + [Intenté crear un entorno y mi nombre de usuario es un conjunto de nombres de caracteres aleatorios](#t-create-environ-random-un)
+ [Actualización de entornos](#troubleshooting-update-environment)
  + [Intenté cambiar la clase del entorno, pero la actualización falló](#t-rollback-billing-failure)
+ [Acceso a entornos](#troubleshooting-access-environment)
  + [No puedo acceder a la interfaz de usuario de Apache Airflow](#t-no-access-airflow-ui)

## Actualización de `requirements.txt`
<a name="troubleshooting-reqs"></a>

En la siguiente página, se describen los errores que puede encontrar al actualizar su `requirements.txt`.

### He especificado una nueva versión de mi `requirements.txt` y la actualización de mi entorno está tardando más de 20 minutos
<a name="t-requirements"></a>

Si su entorno tarda más de 20 minutos en instalar una nueva versión de un archivo `requirements.txt`, quiere decir que se ha producido un error en la actualización del entorno y Amazon MWAA está volviendo a la última versión estable de la imagen del contenedor.

1. Compruebe las versiones de los paquetes. Recomendamos especificar siempre una versión específica (`==`) o una versión máxima (`<=`) para las dependencias de Python en su `requirements.txt`.

1. Compruebe los registros de Apache Airflow. Si ha activado los registros de Apache Airflow, compruebe que los grupos de registros se hayan creado correctamente en la [página Grupos de registros](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups) de la consola de CloudWatch. Si ve registros en blanco, el motivo más común es la falta permisos en su rol de ejecución para CloudWatch o Amazon S3, donde se escriben los registros. Consulte [Rol de ejecución](mwaa-create-role.md) para obtener más información.

1. Compruebe las opciones de configuración de Apache Airflow. Si utiliza Secrets Manager, compruebe que los pares clave-valor que especificó como opción de configuración de Apache Airflow se hayan configurado correctamente. Consulte [Configuración de una conexión de Apache Airflow mediante un secreto AWS Secrets Manager](connections-secrets-manager.md) para obtener más información.

1. Compruebe la configuración de la red de VPC. Consulte [Intenté crear un entorno, pero se atascó en el estado `Creating`](#t-stuck-failure) para obtener más información.

1. Compruebe los permisos de los roles de ejecución. Un rol de ejecución es un rol AWS Identity and Access Management (de IAM) con una política de permisos que otorga a Amazon MWAA permiso para invocar los recursos de otros servicios de AWS (como Amazon S3, CloudWatch, Amazon SQS o Amazon ECR) en su nombre. También se debe permitir el acceso a su [clave administrada por el cliente](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) o su [clave propiedad de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk). Consulte [Rol de ejecución](mwaa-create-role.md) para obtener más información.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

## Complementos
<a name="troubleshooting-plugins"></a>

En la siguiente página, se describen los problemas que pueden surgir al configurar o actualizar los complementos de Apache Airflow.

### ¿Admite Amazon MWAA la implementación de una interfaz de usuario personalizada?
<a name="custom-ui"></a>

A partir de la versión 2.2.2 de Apache Airflow, Amazon MWAA admite la instalación de complementos en el servidor web de Apache Airflow y la implementación de una UI personalizada. Si su entorno Amazon MWAA ejecuta Apache Airflow v2.0.2 o una versión anterior, no podrá implementar una interfaz de usuario personalizada.

Para obtener más información sobre la administración de versiones y la actualización de sus entornos existentes, consulte [Versiones de Apache Airflow en Amazon Managed Workflows para Apache Airflow](airflow-versions.md).

## Creación de un bucket
<a name="troubleshooting-create-bucket"></a>

En la siguiente página, se describen los errores que pueden generarse al crear un bucket de Amazon S3.

### No puedo seleccionar la opción de bloqueo de acceso público en S3
<a name="t-create-bucket"></a>

El [rol de ejecución](mwaa-create-role.md) de su entorno de Amazon MWAA necesita permiso para realizar la acción de `GetBucketPublicAccessBlock` en el bucket de Amazon S3 para verificar que el bucket ha bloqueado el acceso público. Recomendamos los siguientes pasos:

1. Siga los pasos para [adjuntar una política de JSON a su rol de ejecución](mwaa-create-role.md).

1. Adjunte la siguiente política JSON:

   ```
   {
     "Effect":"Allow",
     "Action":[
       "s3:GetObject*",
       "s3:GetBucket*",
       "s3:List*"
     ],
     "Resource":[
       "arn:aws:s3:::{{amzn-s3-demo-bucket}}",
       "arn:aws:s3:::{{amzn-s3-demo-bucket}}/*"
     ]
   }
   ```

   Sustituya los marcadores de posición de ejemplo en {{amzn-s3-demo-bucket}} por el nombre del bucket de Amazon S3.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

## Creación de un entorno
<a name="troubleshooting-create-environment"></a>

En la siguiente página, se describen los errores que pueden generarser al crear un entorno.

### Intenté crear un entorno, pero se atascó en el estado `Creating`
<a name="t-stuck-failure"></a>

Recomendamos los siguientes pasos:

1. Compruebe la red de VPC con *enrutamiento público*. Si usa una Amazon VPC con acceso a Internet, compruebe lo siguiente:

   1. Que su Amazon VPC esté configurada para permitir el tráfico de red entre los distintos recursos de AWS que utiliza su entorno de Amazon MWAA, tal y como se define en [Acerca de las redes en Amazon MWAA](networking-about.md). Por ejemplo, su grupo de seguridad de VPC debe permitir todo el tráfico en una regla de autorreferencia o, si lo desea, especificar el rango de puertos para el rango de puertos HTTPS 443 y un rango de puertos TCP 5432.

1. Compruebe la red de VPC con *enrutamiento privado*. Si usa una Amazon VPC sin acceso a Internet, compruebe lo siguiente:

   1. Que su Amazon VPC esté configurada para permitir el tráfico de red entre los distintos recursos de AWS de su entorno Amazon MWAA, tal y como se define en [Acerca de las redes en Amazon MWAA](networking-about.md). Por ejemplo, sus dos subredes privadas **no** deben tener una tabla de enrutamiento a una puerta de enlace de NAT (o instancia de NAT) **ni** a una puerta de enlace de Internet.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

### Intenté crear un entorno, pero aparece el estado como `Create failed`
<a name="t-create-environ-failed"></a>

Recomendamos los siguientes pasos:

1. Compruebe la configuración de la red de VPC. Consulte [Intenté crear un entorno, pero se atascó en el estado `Creating`](#t-stuck-failure) para obtener más información.

1. Compruebe los permisos de usuario. Amazon MWAA realiza una prueba con las credenciales de un usuario antes de crear un entorno. Es posible que su Cuenta de AWS no tenga permiso en AWS Identity and Access Management (IAM) para crear algunos de los recursos de un entorno. Por ejemplo, si eligió el modo de acceso de **red privada** para Apache Airflow, su administrador debe haber concedido acceso a su Cuenta de AWS a la política de control de acceso de [AmazonMWAAFullConsoleAccess](access-policies.md#console-full-access) para su entorno, que permite a su cuenta crear puntos de conexión de VPC.

1. Compruebe los permisos de los roles de ejecución. Un rol de ejecución es un rol AWS Identity and Access Management (de IAM) con una política de permisos que otorga a Amazon MWAA permiso para invocar los recursos de otros servicios de AWS (como Amazon S3, CloudWatch, Amazon SQS o Amazon ECR) en su nombre. También se debe permitir el acceso a su [clave administrada por el cliente](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk) o su [clave propiedad de AWS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk). Consulte [Rol de ejecución](mwaa-create-role.md) para obtener más información.

1. Compruebe los registros de Apache Airflow. Si ha activado los registros de Apache Airflow, compruebe que los grupos de registros se hayan creado correctamente en la [página Grupos de registros](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups) de la consola de CloudWatch. Si ve registros en blanco, el motivo más común es la falta permisos en su rol de ejecución para CloudWatch o Amazon S3, donde se escriben los registros. Consulte [Rol de ejecución](mwaa-create-role.md) para obtener más información.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

1. Si utiliza una Amazon VPC *sin* acceso a Internet, asegúrese de haber creado un punto de conexión de puerta de enlace de Amazon S3 y de haber concedido los permisos mínimos necesarios a Amazon ECR para acceder a Amazon S3. Para obtener más información sobre cómo crear un punto de conexión de puerta de enlace de Amazon S3, consulte los siguientes recursos:
   + [Creación de una red Amazon VPC sin acceso a Internet](vpc-create.md#vpc-create-template-private-only)
   + [Creación del punto de conexión de la puerta de enlace de Amazon S3](https://docs.aws.amazon.com/AmazonECR/latest/userguide/vpc-endpoints.html#ecr-setting-up-s3-gateway) en la *Guía del usuario de Amazon Elastic Container Registry*

### Intenté seleccionar una VPC y se produjo el error `Network Failure`
<a name="t-network-failure"></a>

Recomendamos los siguientes pasos:
+ Si aparece el error `Network Failure` al intentar seleccionar una Amazon VPC cuando se crea el entorno, desactive todos los proxies del navegador que se estén ejecutando e inténtelo de nuevo.

### He intentado crear un entorno y he recibido un mensaje de error que indica que el servicio, la partición o el recurso “deben pasarse”
<a name="t-service-partition"></a>

Recomendamos los siguientes pasos:
+ Es posible que reciba este error porque el URI que especificó para su bucket de Amazon S3 incluye una barra oblicua (“/”) al final del URI. Le recomendamos que elimine la barra inclinada (“/”) de la ruta. El valor debe tener el siguiente formato:

  ```
  s3://amzn-s3-demo-bucket
  ```

### Intenté crear un entorno que muestra el estado como `Available`, pero cuando intento acceder a la UI de Airflow aparece el mensaje de error `Empty Reply from Server` o `502 Bad Gateway`.
<a name="t-create-environ-empty-reply"></a>

Recomendamos los siguientes pasos:

1. Compruebe la configuración del grupo de seguridad de VPC. Consulte [Intenté crear un entorno, pero se atascó en el estado `Creating`](#t-stuck-failure) para obtener más información.

1. Confirme que todos los paquetes de Apache Airflow que haya publicado en `requirements.txt` corresponden a la versión de Apache Airflow que utiliza en Amazon MWAA. Consulte [Instalación de dependencias de Python](working-dags-dependencies.md) para obtener más información.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

### Intenté crear un entorno y mi nombre de usuario es un conjunto de nombres de caracteres aleatorios
<a name="t-create-environ-random-un"></a>
+ Apache Airflow tiene un máximo de 64 caracteres para los nombres de usuario. Si su rol AWS Identity and Access Management (de IAM) supera esta longitud, se utilizará un algoritmo de hash para reducirla y, para que, al mismo tiempo, siga siendo única.

## Actualización de entornos
<a name="troubleshooting-update-environment"></a>

En la siguiente página, se describen los errores que se pueden producir al actualizar un entorno.

### Intenté cambiar la clase del entorno, pero la actualización falló
<a name="t-rollback-billing-failure"></a>

Si actualiza su entorno a una clase de entorno diferente (por ejemplo, al cambiar de un `mw1.medium` a un `mw1.small`) y la solicitud de actualización no se puede realizar correctamente, el estado del entorno pasará a `UPDATE_FAILED` y el entorno se revertirá a su versión estable anterior y se facturará de acuerdo con ella.

Recomendamos los siguientes pasos:

1. Pruebe sus DAG, complementos personalizados y dependencias de Python de forma local con [aws-mwaa-docker-images](https://github.com/aws/amazon-mwaa-docker-images) en GitHub.

1. Para ejecutar un script de solución de problemas que compruebe la configuración de la red de Amazon VPC para su entorno Amazon MWAA, consulte el script [Verify Environment](https://github.com/awslabs/aws-support-tools/tree/master/MWAA) (Verificar entorno) en las herramientas de soporte de AWS en GitHub.

## Acceso a entornos
<a name="troubleshooting-access-environment"></a>

En la siguiente página, se describen los errores que se pueden producir al acceder un entorno.

### No puedo acceder a la interfaz de usuario de Apache Airflow
<a name="t-no-access-airflow-ui"></a>

Recomendamos los siguientes pasos:

1. Compruebe los permisos de usuario. Es posible que no se le haya concedido acceso a una política de permisos que le permita ver la UI de Apache Airflow. Consulte [Acceso a un entorno de Amazon MWAA](access-policies.md) para obtener más información.

1. Compruebe el acceso a la red. Esto puede deberse a que seleccionó el modo de acceso de **red privada**. Si la URL de la UI de Apache Airflow tiene el siguiente formato `387fbcn-8dh4-9hfj-0dnd-834jhdfb-vpce.c10.us-west-2.airflow.amazonaws.com`, significa que está usando un *enrutamiento privado* para su servidor web de Apache Airflow. Puede actualizar el modo de acceso de Apache Airflow al modo de acceso de **red pública** o crear un mecanismo para acceder al punto de conexión de VPC de su *servidor web* de Apache Airflow. Consulte [Administración del acceso a los puntos de conexión de Amazon VPC específicos del servicio en Amazon MWAA](vpc-vpe-access.md) para obtener más información.