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
Argomenti
Si verifica un timeout durante l'attesa del set di attività sostitutive
Si verifica un timeout in attesa del proseguimento di una notifica
La distribuzione è scaduta in attesa di una richiamata di stato
La mia distribuzione a volte non riesce quando utilizzo Auto Scaling
Posso collegare più sistemi di bilanciamento del carico a un gruppo di distribuzione?
Posso eseguire CodeDeploy blue/green implementazioni senza un sistema di bilanciamento del carico?
Come posso aggiornare il mio servizio Amazon ECS con nuove informazioni durante una distribuzione?
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:
-
Nel tuo gruppo di distribuzione, imposta Specifica quando reindirizzare il traffico su un periodo di tempo maggiore e ridistribuirlo. Per ulteriori informazioni, consulta Crea un gruppo di distribuzione per una distribuzione Amazon ECS (console).
-
Nel tuo gruppo di distribuzione, modifica Specifica quando reindirizzare il traffico su Reindirizza immediatamente il traffico e ridistribuiscilo. Per ulteriori informazioni, consulta Crea un gruppo di distribuzione per una distribuzione Amazon ECS (console).
-
Ridistribuisci ed esegui il comando aws deploy continue-deployment con l'opzione impostata su. AWS CLI
--deployment-wait-typeREADY_WAITAssicurati di eseguire questo comando prima della scadenza del tempo specificato in Specifica quando il traffico deve essere reindirizzato.
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.SucceededFailedCodeDeploy 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.SucceededFailedPer 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:
-
In Amazon EC2, nelle impostazioni dei listener e delle regole del sistema di bilanciamento del carico. Per ulteriori informazioni, consulta Listeners for your Application Load Balancer nella User Guide for Application Load Balancers o Listeners for your Network Load Balancer nella User Guide for Network Load Balancer.
-
In Amazon ECS, nel tuo cluster, nella configurazione di rete del tuo servizio. Per ulteriori informazioni, consulta le considerazioni su Application Load Balancer e Network Load Balancer nella Amazon Elastic Container Service Developer Guide.
-
In CodeDeploy, nelle impostazioni del tuo gruppo di distribuzione. Per ulteriori informazioni, consulta Crea un gruppo di distribuzione per una distribuzione Amazon ECS (console).
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.
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.
-
Modifica la configurazione di distribuzione predefinita in.
CodeDeployDefault.ECSAllAtOnceQuesta è l'unica configurazione di distribuzione predefinita supportata da Network Load Balancers.Per ulteriori informazioni sulle configurazioni di distribuzione predefinite, vedere. Configurazioni di distribuzione predefinite per una piattaforma di calcolo Amazon ECS
-
Cambia il tuo load balancer in un Application Load Balancer. Application Load Balancer supporta tutte le configurazioni di distribuzione predefinite. Per ulteriori informazioni sulla creazione di un Application Load Balancer, vedere. Configura un sistema di bilanciamento del carico, gruppi target e listener per le distribuzioni di CodeDeploy Amazon ECS
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
Installciclo di vita e prima dell'evento).AllowTrafficConsentendo 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
NotaLe 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.
BeforeAllowTrafficPer 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
Se devi aggiornare il tuo servizio Amazon ECS con un parametro non supportato da CodeDeploy, completa queste attività:
-
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. -
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).