Resolución de problemas de implementación de EC2/en las instalaciones

Error de falta de credenciales en el complemento de CodeDeploy CommandPoller

Si aparece un error similar a InstanceAgent::Plugins::CodeDeployPlugin::CommandPoller: Missing credentials - please check if this instance was started with an IAM instance profile, podría deberse a una de las siguientes causas:

Un perfil de instancia de IAM concede permiso al agente de CodeDeploy para comunicarse con CodeDeploy y para descargar la revisión desde Amazon S3. Para las instancias EC2, consulte Administración de identidades y accesos para AWS CodeDeploy. En el caso de las instancias locales, consulte Working with On-Premises Instances.

La implementación produce un error con el mensaje “Validation of PKCS7 signed message failed”

Este mensaje de error indica que la instancia está ejecutando una versión del agente de CodeDeploy que solo admite el algoritmo hash SHA-1. La compatibilidad con el algoritmo hash SHA-2 se introdujo en la versión 1.0.1.854 del agente de CodeDeploy, publicada en noviembre de 2015. A partir del 17 de octubre de 2016, las implementaciones producen un error si se instala una versión del agente de CodeDeploy anterior a la 1.0.1.854. Para obtener más información, consulte AWSAWS to Switch to SHA256 Hash Algorithm for SSL Certificates, NOTICE: Retiring Host Agents Older Than Version 1.0.1.85 y Actualización del agente de CodeDeploy.

La implementación o la reimplementación de los mismos archivos en la misma instancia producen el error "The deployment failed because a specified file already exists at this location"

Cuando CodeDeploy intenta implementar un archivo en una instancia, pero ya existe un archivo con el mismo nombre en la ubicación de destino especificada, la implementación en dicha instancia podría producir un error. Es posible que aparezca el mensaje de error "The deployment failed because a specified file already exists at this location: nombre-ubicación" (Se produjo un error en la implementación porque un archivo especificado ya existe en esta ubicación: nombre-ubicación). Esto se debe a que durante cada implementación CodeDeploy elimina primero todos los archivos de la implementación anterior, que se enumeran en un archivo de registro de limpieza. Si hay archivos en las carpetas de instalación de destino que no figuran en este archivo de limpieza, el agente de CodeDeploy interpreta esto como un error de forma predeterminada y la implementación produce un error.

La forma más sencilla de evitar este error es especificar una opción distinta del comportamiento de error predeterminado de la implementación. Para cada implementación, puede elegir si la implementación produce un error, si se sobrescriben los archivos no incluidos en el archivo de limpieza o si se conservan los archivos que ya están en la instancia.

La opción de sobrescritura resulta útil cuando, por ejemplo, coloca manualmente un archivo en una instancia después de la última implementación, pero después añade un archivo con el mismo nombre a la siguiente revisión de la aplicación.

Puede elegir la opción de conservación para los archivos que coloca en la instancia que desea que formen parte de la siguiente implementación sin tener que añadirlos al paquete de revisión de la aplicación. La opción de conservación también es útil si los archivos de la aplicación ya están en el entorno de producción y desea implementarlos utilizando CodeDeploy por primera vez. Para obtener más información, consulte Creación de una implementación en una plataforma de informática de EC2/en las instalaciones (consola) y Comportamiento de la restauración con contenido existente.

Solución de errores de implementación The deployment failed because a specified file already exists at this location

Si decide no especificar una opción para sobrescribir o conservar el contenido que CodeDeploy detecta en las ubicaciones de implementación de destino (o si no se especifica ninguna opción de implementación para el tratamiento del contenido existente en un comando del código), puede elegir solucionar el error.

Esta información se aplica únicamente si decide no conservar ni sobrescribir el contenido.

Si intenta volver a implementar archivos con los mismos nombres y ubicaciones, la nueva implementación tendrá más probabilidades de que se realice con éxito si especifica el nombre de aplicación y el grupo de implementación con el mismo ID del grupo de implementación subyacente que usó anteriormente. CodeDeploy utiliza el ID del grupo de implementación subyacente para identificar los archivos que se deben eliminar antes de volver a realizar la implementación.

La implementación de nuevos archivos o la reimplementación de los mismos archivos en las mismas ubicaciones de las instancias pueden producir un error por estas razones:

Para solucionar estas situaciones, proceda del modo siguiente:

Las rutas de archivo largas provocan el error “No existe tal archivo o directorio”

En el caso de las implementaciones en instancias de Windows, si tiene una ruta de archivo de más de 260 caracteres en la sección de archivos del archivo appspec.yml, es posible que las implementaciones fallen y se produzca un error similar al siguiente:

No such file or directory @ dir_s_mkdir - C:\your-long-file-path

Este error se produce porque, de forma predeterminada, Windows no permite rutas de archivos de más de 260 caracteres, como se detalla en la documentación de Microsoft.

Para las versiones 1.4.0 o posteriores del agente de CodeDeploy, puede habilitar las rutas de archivo largas de dos maneras, según el proceso de instalación del agente:

Si el agente de CodeDeploy aún no se ha instalado:

Si el agente de CodeDeploy ya se ha instalado:

Los procesos de larga duración pueden producir un error en la implementación

Para las implementaciones en instancias de Amazon Linux, Ubuntu Server y RHEL, si tiene un script de implementación que inicia un proceso de larga duración, CodeDeploy puede dedicar mucho tiempo a esperar al evento de ciclo de vida de la implementación y se producirá un error en la implementación. Esto se debe a que, si el proceso se ejecuta durante más tiempo que el tiempo previsto de ejecución de los procesos en primer y segundo plano de ese evento, CodeDeploy detiene la implementación aunque el proceso siga ejecutándose según lo previsto.

Suponga, por ejemplo, que la revisión de la aplicación contiene dos archivos en su raíz, after-install.sh y sleep.sh. Su archivo AppSpec contiene las siguientes instrucciones:

version: 0.0
os: linux
files:
  - source: ./sleep.sh
    destination: /tmp
hooks:
  AfterInstall:
    - location: after-install.sh
      timeout: 60

El archivo after-install.sh se ejecuta durante el evento de ciclo de vida AfterInstall de la aplicación. Este es su contenido:

#!/bin/bash
/tmp/sleep.sh

El archivo sleep.sh contiene lo siguiente, que suspende la ejecución del programa durante tres minutos (180 segundos), lo que simula un proceso de larga duración:

#!/bin/bash
sleep 180

Cuando after-install.sh llame a sleep.sh, sleep.sh se iniciará y se mantendrá en ejecución durante tres minutos (180 segundos), que es dos minutos más (120 segundos) que el tiempo que CodeDeploy espera que sleep.sh (y, por relación, after-install.sh) dejen de ejecutarse. Tras el tiempo de espera de un minuto (60 segundos), CodeDeploy detiene la implementación en los eventos de ciclo de vida AfterInstall de la aplicación, aunque siga ejecutándose sleep.sh según lo previsto. Se muestra el siguiente error:

Script at specified location: after-install.sh failed to complete in 60 seconds.

No basta con añadir un signo de ampersand (&) en after-install.sh para ejecutar sleep.sh en segundo plano.

#!/bin/bash
# Do not do this.
/tmp/sleep.sh &

Si hace eso, la implementación se quedará en un estado pendiente hasta el período de tiempo de espera predeterminado del evento de ciclo de vida de la implementación, después de lo cual CodeDeploy detendrá la implementación en el evento de ciclo de vida AfterInstall de la aplicación como antes.

En after-install.sh, llame a sleep.sh del modo siguiente para que CodeDeploy pueda continuar después de que el proceso empiece a ejecutarse:

#!/bin/bash
/tmp/sleep.sh > /dev/null 2> /dev/null < /dev/null &

En la llamada anterior, sleep.sh es el nombre del proceso que desea empezar a ejecutar en segundo plano, redirigiendo stdout, stderr y stdin a /dev/null.

Solución de problemas con un evento de ciclo de vida AllowTraffic que ha producido un error no registrado en los registros de implementación

En algunos casos, una implementación blue/green producirá un error durante el evento de ciclo de vida AllowTraffic, pero la causa del error no se indica en los registros de implementación.

Este error se debe normalmente a que las comprobaciones de estado se han configurado incorrectamente en Elastic Load Balancing para la instancia del Equilibrador de carga clásico, del Equilibrador de carga de aplicación o del Equilibrador de carga de red usada para administrar el tráfico del grupo de implementación.

Para resolver el problema, revise y corrija los errores en la configuración de la comprobación de estado del balanceador de carga.

Para equilibradores de carga clásicos, consulte Configuración de comprobaciones de estado en la Guía del usuario de los equilibradores de carga clásicos y ConfigureHealthCheck en la Referencia de la API de Elastic Load Balancing, versión 2012-06-01.

Para los equilibradores de carga de aplicación, consulte Comprobaciones de estado de los grupos de destino en la Guía del usuario de los equilibradores de carga de aplicación.

Para los equilibradores de carga de red, consulte Comprobaciones de estado de los grupos de destino en la Guía del usuario de los equilibradores de carga de red.

Solución de problemas con eventos de ciclo de vida de la implementación ApplicationStop, BeforeBlockTraffic y AfterBlockTraffic que han producido un error

Durante una implementación, el agente de CodeDeploy ejecuta los scripts especificados para ApplicationStop, BeforeBlockTraffic y AfterBlockTraffic en el archivo AppSpec de la implementación satisfactoria anterior. (Todos los demás scripts se ejecutan desde el archivo AppSpec de la implementación actual). Si alguno de estos scripts contiene un error y no se ejecuta correctamente, la implementación puede producir un error.

Los posibles motivos de estos errores son los siguientes:

Utilice la consola de CodeDeploy para investigar por qué una implementación ha podido producir un error durante cualquiera de estos eventos. En la página de detalles de la implementación, elija View events (Ver eventos). En la página de detalles de la instancia, en la fila ApplicationStop, BeforeBlockTraffic o AfterBlockTraffic, elija View logs (Ver registros). O utilice la AWS CLI para llamar al comando get-deployment-instance.

Si la causa del error es un script de la última implementación correcta que no se ejecuta nunca correctamente, cree una nueva implementación y especifique que se omitan los errores de ApplicationStop, BeforeBlockTraffic y AfterBlockTraffic. Hay dos formas de hacer esto:

Cuando vuelva a implementar la revisión de la aplicación, la implementación continuará aunque algunos de estos eventos de ciclo de vida produzcan un error. Si la nueva revisión incluye scripts fijos para los eventos de ciclo de vida, puede que las implementaciones futuras se realicen correctamente si aplica esta solución.

Solución de problemas con un evento de ciclo de vida de la implementación DownloadBundle que ha producido el error "UnknownError: not opened for reading"

Si intenta implementar una revisión de la aplicación desde Amazon S3 y la implementación produce el error UnknownError: not opened for reading durante el evento de ciclo de vida DownloadBundle de la implementación:

En la página de detalles del evento de la implementación, en la fila Download bundle (Descargar paquete), elija View logs (Ver registros). O utilice la AWS CLI para llamar al comando get-deployment-instance. Si se produce un error, debería aparecer un error en el resultado con el código de error UnknownError y el mensaje de error not opened for reading.

Para determinar la causa de este error:

Para obtener información sobre cómo encontrar el archivo de registro en red y habilitar y deshabilitar el registro en red, consulte :log_aws_wire: en Referencia de configuración del agente de CodeDeploy.

Solución de problemas cuando se omiten todos los eventos del ciclo de vida

Si todos los eventos del ciclo de vida de una implementación de EC2 o en las instalaciones se omiten, es posible que reciba un error similar a The overall deployment failed because too many individual instances failed deployment, too few healthy instances are available for deployment, or some instances in your deployment group are experiencing problems. (Error code: HEALTH_CONSTRAINTS). Estas son algunas posibles causas y soluciones:

El script de Windows PowerShell no puede usar la versión de 64 bits de Windows PowerShell de forma predeterminada

Si un script de Windows PowerShell que se ejecuta como parte de una implementación depende de la funcionalidad de 64 bits (por ejemplo, porque consume más memoria que la que permite una aplicación de 32 bits o porque llama a bibliotecas que solo se ofrecen en una versión de 64 bits), puede que el script se bloquee o que no se ejecute según lo previsto. Esto se debe a que, de forma predeterminada, CodeDeploy utiliza la versión de 32 bits de Windows PowerShell para ejecutar scripts de Windows PowerShell que forman parte de una revisión de la aplicación.

Añada código como el siguiente al comienzo de cualquier script que tenga que ejecutar con la versión de 64 bits de Windows PowerShell:

# Are you running in 32-bit mode?
#   (\SysWOW64\ = 32-bit mode)

if ($PSHOME -like "*SysWOW64*")
{
  Write-Warning "Restarting this script under 64-bit Windows PowerShell."

  # Restart this script under 64-bit Windows PowerShell.
  #   (\SysNative\ redirects to \System32\ for 64-bit mode)

  & (Join-Path ($PSHOME -replace "SysWOW64", "SysNative") powershell.exe) -File `
    (Join-Path $PSScriptRoot $MyInvocation.MyCommand) @args

  # Exit 32-bit script.

  Exit $LastExitCode
}

# Was restart successful?
Write-Warning "Hello from $PSHOME"
Write-Warning "  (\SysWOW64\ = 32-bit mode, \System32\ = 64-bit mode)"
Write-Warning "Original arguments (if any): $args"

# Your 64-bit script code follows here...
# ...

Aunque la información de ruta del archivo de este código pueda parecer contradictoria, la versión de 32 bits de Windows PowerShell utiliza una ruta como la siguiente:

c:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe

La versión de 64 bits de Windows PowerShell utiliza una ruta como la siguiente:

c:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe