View a markdown version of this page

Risolvi i problemi di distribuzione di Amazon ECS - AWS CodeDeploy

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risolvi i problemi di distribuzione di Amazon ECS

Si verifica un timeout durante l'attesa del set di attività sostitutive

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The deployment timed out while waiting for the replacement task set to become healthy. This time out period is 60 minutes.

Possibile causa: questo errore può verificarsi se è presente un errore nel file di definizione delle attività o in altri file relativi alla distribuzione. Ad esempio, se c'è un errore di battitura nel image campo del file di definizione delle attività, Amazon ECS tenterà di estrarre l'immagine del contenitore sbagliata e fallirà continuamente, provocando questo errore.

Possibili correzioni e passaggi successivi:

  • Correggi gli errori tipografici e i problemi di configurazione nel file di definizione delle attività e in altri file.

  • Controlla l'evento relativo al servizio Amazon ECS e scopri perché le attività sostitutive non stanno migliorando. Per ulteriori informazioni sugli eventi Amazon ECS, consulta gli eventi Amazon ECS nella Amazon Elastic Container Service Developer Guide.

  • Consulta la sezione sulla risoluzione dei problemi di Amazon ECS nella Amazon Elastic Container Service Developer Guide per eventuali errori relativi ai messaggi presenti nell'evento.

Si verifica un timeout in attesa del proseguimento di una notifica

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The deployment timed out while waiting for a notification to continue. This time out period is n minutes.

Possibile causa: questo errore può verificarsi se hai specificato un tempo di attesa nel campo Specifica quando reindirizzare il traffico al momento della creazione del gruppo di distribuzione, ma la distribuzione non è stata completata prima della scadenza del tempo di attesa.

Possibili correzioni e passaggi successivi:

Il ruolo IAM non dispone di autorizzazioni sufficienti

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The IAM role role-arn does not give you permission to perform operations in the following AWS service: AWSLambda.

Possibile causa: questo errore può verificarsi se hai specificato una funzione Lambda nella Hooks sezione del AppSpec file, ma non hai dato l' CodeDeploy autorizzazione al servizio Lambda.

Possibile soluzione: aggiungere l'lambda:InvokeFunctionautorizzazione al ruolo del CodeDeploy servizio. Per aggiungere questa autorizzazione, aggiungi una delle seguenti politiche AWS gestite al ruolo: AWSCodeDeployRoleForECS oAWSCodeDeployRoleForECSLimited. Per informazioni su queste politiche e su come aggiungerle al ruolo CodeDeploy di servizio, vedereFase 2: Creare un ruolo di servizio per CodeDeploy.

La distribuzione è scaduta in attesa di una richiamata di stato

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The deployment timed out while waiting for a status callback. CodeDeploy expects a status callback within one hour after a deployment hook is invoked.

Possibile causa: questo errore può verificarsi se hai specificato una funzione Lambda nella Hooks sezione del AppSpec file, ma la funzione Lambda non è riuscita a chiamare l'PutLifecycleEventHookExecutionStatusAPI necessaria a cui restituire uno Succeeded stato or. Failed CodeDeploy

Possibili correzioni e passaggi successivi:

  • Aggiungi l'codedeploy:putlifecycleEventHookExecutionStatusautorizzazione al ruolo di esecuzione Lambda utilizzato dalla funzione Lambda specificata nel file. AppSpec Questa autorizzazione concede alla funzione Lambda la possibilità di restituire uno stato pari o a. Succeeded Failed CodeDeploy Per ulteriori informazioni sul ruolo di esecuzione Lambda, consulta il ruolo di esecuzione Lambda nella Guida per l'utente. AWS Lambda

  • Controlla il codice della funzione Lambda e i log di esecuzione per assicurarti che la funzione Lambda stia chiamando l'PutLifecycleEventHookExecutionStatusAPI per indicare se CodeDeploy il test di convalida del ciclo CodeDeploy di vita o. Succeeded Failed Per informazioni sull'putlifecycleEventHookExecutionStatusAPI, consulta PutLifecycleEventHookExecutionStatus l'API Reference. AWS CodeDeploy Per informazioni sui log di esecuzione di Lambda, consulta Accessing Amazon CloudWatch logs for AWS Lambda.

La distribuzione non è riuscita perché una o più delle funzioni di convalida degli eventi del ciclo di vita non sono riuscite

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The deployment failed because one or more of the lifecycle event validation functions failed.

Possibile causa: questo errore può verificarsi se hai specificato una funzione Lambda nella Hooks sezione del AppSpec file, ma la funzione Lambda è tornata Failed al CodeDeploy momento della chiamata. PutLifecycleEventHookExecutionStatus Questo errore indica CodeDeploy che il test di convalida del ciclo di vita non è riuscito.

Possibile passaggio successivo: controlla i log di esecuzione di Lambda per capire perché il codice del test di convalida non riesce. Per informazioni sui log di esecuzione di Lambda, consulta Accessing Amazon logs for. CloudWatch AWS Lambda

L'ELB non può essere aggiornato a causa del seguente errore: Il gruppo target del taskset primario deve essere dietro l'ascoltatore

Problema: viene visualizzato il seguente messaggio di errore durante la distribuzione dell'applicazione Amazon ECS utilizzando: CodeDeploy

The ELB could not be updated due to the following error: Primary taskset target group must be behind listener

Possibile causa: questo errore può verificarsi se hai configurato un listener di test opzionale ed è configurato con un gruppo target sbagliato. Per ulteriori informazioni sul test listener in CodeDeploy, vedere Prima di iniziare una distribuzione Amazon ECS e. Cosa succede durante una distribuzione di Amazon ECS Per ulteriori informazioni sui set di attività, TaskSet consulta Amazon Elastic Container Service API Reference e describe-task-set nella sezione Amazon ECS del Command Reference. AWS CLI

Possibile soluzione: assicurati che il listener di produzione e il listener di test di Elastic Load Balancing puntino entrambi al gruppo target che attualmente serve i tuoi carichi di lavoro. Ci sono tre posti da controllare:

La mia distribuzione a volte non riesce quando utilizzo Auto Scaling

Problema: stai utilizzando Auto Scaling con CodeDeploy e noti che le tue distribuzioni a volte falliscono. Per ulteriori informazioni sui sintomi di questo problema, consulta l'argomento intitolato Per i servizi configurati per utilizzare il service auto scaling and the blue/green deployment type, l'auto scaling non è bloccato durante una distribuzione, ma la distribuzione potrebbe non riuscire in alcune circostanze nella Amazon Elastic Container Service Developer Guide.

Possibile causa: questo problema può verificarsi in caso di conflitto tra i processi di Auto CodeDeploy Scaling.

Possibile soluzione: sospendi e riprendi i processi di Auto Scaling durante la CodeDeploy distribuzione utilizzando l'RegisterScalableTargetAPI (o il comando corrispondente). register-scalable-target AWS CLI Per ulteriori informazioni, consulta Sospendi e riprendi il ridimensionamento per Application Auto Scaling nella Guida per l'utente di Application Auto Scaling.

Nota

CodeDeploy non posso chiamare direttamente. RegisterScaleableTarget Per utilizzare questa API, devi configurare CodeDeploy l'invio di una notifica o di un evento ad Amazon Simple Notification Service (o Amazon CloudWatch). È quindi necessario configurare Amazon SNS (or CloudWatch) per chiamare una funzione Lambda e configurare la funzione Lambda per chiamare l'API. RegisterScalableTarget L'RegisterScalableTargetAPI deve essere chiamata con il SuspendedState parametro impostato su per sospendere le operazioni true di Auto Scaling e riprenderle. false

La notifica o l'evento CodeDeploy inviato deve avvenire all'avvio di una distribuzione (per attivare le operazioni di sospensione di Auto Scaling) o quando una distribuzione ha esito positivo, negativo o si interrompe (per attivare le operazioni di ripristino di Auto Scaling).

Per informazioni su come configurare la generazione di notifiche o CodeDeploy eventi Amazon SNS, consulta. e. CloudWatch Monitoraggio delle distribuzioni con Amazon Events CloudWatch Monitoring Deployments with Amazon SNS Event Notifications

Solo ALB supporta il routing graduale del traffico, utilizza invece il routing AllAtOnce del traffico quando crei un gruppo di distribuzione create/update

Problema: viene visualizzato il seguente messaggio di errore durante la creazione o l'aggiornamento di un gruppo di distribuzione in: CodeDeploy

Only ALB supports gradual traffic routing, use AllAtOnce Traffic routing instead when you create/update Deployment group.

Possibile causa: questo errore può verificarsi se si utilizza un Network Load Balancer e si tenta di utilizzare una configurazione di distribuzione predefinita diversa da. CodeDeployDefault.ECSAllAtOnce

Possibili soluzioni.

Anche se la mia distribuzione è riuscita, il set di attività sostitutivo non supera i controlli di integrità di Elastic Load Balancing e la mia applicazione è inattiva

Problema: anche se CodeDeploy indica che la mia distribuzione è riuscita, il set di attività sostitutivo non supera i controlli di integrità di Elastic Load Balancing e la mia applicazione è inattiva.

Possibile causa: questo problema potrebbe verificarsi se hai eseguito una distribuzione CodeDeploy completa e il set di attività sostitutivo (verde) contiene un codice errato che causa il fallimento dei controlli di integrità di Elastic Load Balancing. Con la configurazione di distribuzione completa, i controlli di integrità del load balancer iniziano a essere eseguiti sul set di attività sostitutivo dopo che il traffico è stato trasferito su di esso (ovvero, dopo che si è verificato l'evento del ciclo di vita). CodeDeploy AllowTraffic Ecco perché i controlli sullo stato del set di attività sostitutive non andranno a buon fine dopo lo spostamento del traffico, ma non prima. Per informazioni sugli eventi del ciclo di vita che CodeDeploy vengono generati, consulta. Cosa succede durante una distribuzione di Amazon ECS

Possibili soluzioni.

  • Modifica la configurazione di distribuzione da completa a canaria o lineare. In una configurazione canaria o lineare, i controlli di integrità del load balancer iniziano a essere eseguiti sul set di attività sostitutive durante l' CodeDeploy installazione dell'applicazione nell'ambiente di sostituzione e prima che il traffico venga spostato (ovvero durante l'evento del Install ciclo di vita e prima dell'evento). AllowTraffic Consentendo l'esecuzione dei controlli durante l'installazione dell'applicazione ma prima che il traffico venga spostato, verrà rilevato un codice errato dell'applicazione e causerà errori di distribuzione prima che l'applicazione diventi disponibile al pubblico.

    Per informazioni su come configurare le distribuzioni canarie o lineari, vedere. Modifica le impostazioni del gruppo di distribuzione con CodeDeploy

    Per informazioni sugli eventi del CodeDeploy ciclo di vita che si verificano durante una distribuzione di Amazon ECS, consulta. Cosa succede durante una distribuzione di Amazon ECS

    Nota

    Le configurazioni di distribuzione Canary e lineare sono supportate solo con Application Load Balancer.

  • Se desideri mantenere la configurazione di distribuzione completa, configura un listener di test e controlla lo stato di integrità del task sostitutivo impostato con il lifecycle hook. BeforeAllowTraffic Per ulteriori informazioni, consulta Elenco degli hook relativi agli eventi del ciclo di vita per una distribuzione Amazon ECS.

Posso collegare più sistemi di bilanciamento del carico a un gruppo di distribuzione?

No. Se desideri utilizzare più Application Load Balancer o Network Load Balancer, utilizza gli aggiornamenti continui di Amazon ECS anziché le distribuzioni. CodeDeploy blue/green Per ulteriori informazioni sugli aggiornamenti continui, consulta Rolling update nella Amazon Elastic Container Service Developer Guide. Per ulteriori informazioni sull'utilizzo di più sistemi di bilanciamento del carico con Amazon ECS, consulta Registrazione di più gruppi target con un servizio nella Amazon Elastic Container Service Developer Guide.

Posso eseguire CodeDeploy blue/green implementazioni senza un sistema di bilanciamento del carico?

No, non è possibile eseguire CodeDeploy blue/green distribuzioni senza un load balancer. Se non riesci a utilizzare un sistema di bilanciamento del carico, utilizza invece la funzionalità di aggiornamenti continui di Amazon ECS. Per ulteriori informazioni sugli aggiornamenti continui di Amazon ECS, consulta Rolling update nella Amazon Elastic Container Service Developer Guide.

Come posso aggiornare il mio servizio Amazon ECS con nuove informazioni durante una distribuzione?

Per CodeDeploy aggiornare il servizio Amazon ECS con un nuovo parametro durante la distribuzione, specifica il parametro nella sezione del file. resources AppSpec Sono supportati solo alcuni parametri Amazon ECS CodeDeploy, ad esempio il file di definizione delle attività e i parametri del nome del contenitore. Per un elenco completo dei parametri di Amazon ECS che CodeDeploy possono essere aggiornati, consulta. AppSpec sezione «risorse» per le distribuzioni di Amazon ECS

Nota

Se devi aggiornare il tuo servizio Amazon ECS con un parametro non supportato da CodeDeploy, completa queste attività:

  1. Chiama l'UpdateServiceAPI di Amazon ECS con il parametro che desideri aggiornare. Per un elenco completo dei parametri che possono essere aggiornati, consulta UpdateService il riferimento alle API di Amazon Elastic Container Service.

  2. Per applicare la modifica alle attività, crea una nuova blue/green distribuzione Amazon ECS. Per ulteriori informazioni, consulta Crea un'implementazione di Amazon ECS Compute Platform (console).