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à.
# Demoni gestiti da Amazon ECS
Amazon ECS Managed Daemons ti consente di distribuire e gestire agenti software, come agenti di sicurezza, osservabilità e rete, nell'infrastruttura di container su Amazon ECS Managed Instances. I Managed Daemons separano la gestione del ciclo di vita dei daemon dalle operazioni delle applicazioni. È possibile distribuire, aggiornare e monitorare gli agenti in modo indipendente, senza ridistribuire i carichi di lavoro o coordinare le modifiche tra i servizi.
## Come funzionano i Managed Daemons
Per utilizzare Managed Daemons, è necessario innanzitutto registrare una definizione di task daemon. Una definizione di task daemon è un modello che descrive i contenitori che formano un demone. Dopo aver registrato una definizione di task daemon, crea un daemon e associalo a un cluster e a uno o più provider di capacità di Amazon ECS Managed Instances. Amazon ECS garantisce quindi che venga eseguita esattamente un'attività daemon su ogni istanza Amazon EC2 fornita tramite tali fornitori di capacità.
I demoni non avviano le istanze in modo indipendente. Quando esegui un'attività applicativa su un provider di capacità Amazon ECS Managed Instances, Amazon ECS effettua il provisioning di un'istanza Amazon EC2, avvia prima l'attività daemon e solo successivamente trasferisce l'attività dell'applicazione a. `RUNNING` Questo ordine garantisce che le funzioni trasversali come la registrazione, il tracciamento e la raccolta dei parametri siano operative prima che l'applicazione inizi a elaborare le richieste.
I demoni sono essenziali, ad esempio, per la salute. Se un'attività daemon si interrompe, Amazon ECS scarica e sostituisce automaticamente l'istanza del contenitore. Questo comportamento di riparazione automatica garantisce una copertura affidabile dei daemon in tutte le istanze senza intervento manuale.
Quando aggiorni un daemon a una nuova revisione della definizione delle attività, Amazon ECS esegue una distribuzione continua su tutte le istanze dei provider di capacità associati. Durante la distribuzione, Amazon ECS scarica contemporaneamente una percentuale configurabile di istanze, effettua il provisioning delle istanze sostitutive con il daemon aggiornato e sostituisce automaticamente le attività del servizio Amazon ECS. Amazon ECS offre una protezione integrata dagli interruttori automatici. Puoi configurare un tempo di cottura e degli CloudWatch allarmi in modo che Amazon ECS monitori la distribuzione dopo aver aggiornato tutte le istanze e ripristini automaticamente in caso di problemi.
## Vantaggi principali
+ **Gestione del ciclo di vita disaccoppiata: aggiorna i daemon** indipendentemente dalle distribuzioni delle applicazioni.
+ **Copertura garantita**: Amazon ECS assicura che le attività daemon inizino prima delle attività applicative su ogni istanza, in modo che le funzioni trasversali siano sempre disponibili.
+ **Aggiornamenti di versione affidabili**: quando aggiorni una versione daemon, Amazon ECS la distribuisce su tutte le istanze dei provider di capacità associati, con protezione da interruttori automatici integrata e rollback automatico per garantire che ogni istanza esegua la revisione di destinazione.
+ **Migliore utilizzo delle risorse**: l'esecuzione di una singola attività daemon per istanza elimina il modello, riducendo il sovraccarico di risorse nel cluster. sidecar-per-task
+ **Riparazione automatica dell'istanza**: se un'attività daemon si interrompe o non funziona correttamente, Amazon ECS scarica e sostituisce automaticamente l'istanza del contenitore. Ciò mantiene una copertura daemon affidabile senza interventi manuali.
**Nota**
Amazon ECS offre una strategia di pianificazione DAEMON per i servizi Amazon ECS per il tipo di lancio di Amazon EC2. Managed Daemons è una nuova funzionalità creata per Amazon ECS Managed Instances per semplificare le implementazioni dei daemon e fornire maggiori garanzie di copertura dei daemon.
## Nozioni di base
Per iniziare, registra una definizione di attività daemon specificando l'immagine del contenitore, quindi crea un daemon con i provider di capacità associati nel cluster. Puoi usare,, o. Console di gestione AWS AWS CLI CloudFormation AWS SDKs Per step-by-step istruzioni, vedere[Creazione e gestione dei demoni](managed-daemons-create-manage.md).
# Definizioni delle attività daemon
Una definizione di task daemon è il modello per il tuo demone. Amazon ECS Managed Daemons utilizza una risorsa dedicata per la definizione delle attività dei daemon, distinta dalle definizioni di attività standard di Amazon ECS. Registri una definizione di attività daemon per specificare l'immagine del contenitore, i requisiti di risorse e la configurazione per il tuo daemon.
## Creazione di una definizione di attività daemon
È possibile creare una definizione di attività daemon utilizzando o il. Console di gestione AWS AWS CLI
### Usando il Console di gestione AWS
1. Apri la console Amazon ECS. Nella barra di navigazione a sinistra, scegli Definizioni delle **attività Daemon**.
1. Scegli **Crea una nuova definizione di attività daemon**.
1. Per la **famiglia di definizioni di attività Daemon**, inserisci un nome univoco. Il nome può contenere fino a 255 caratteri alfanumerici, trattini e caratteri di sottolineatura.
1. (Facoltativo) Per il **ruolo Task**, scegli un ruolo IAM che conceda le autorizzazioni alle applicazioni in esecuzione nei tuoi contenitori. Lascia vuoto questo campo se i contenitori non chiamano. AWS APIs
1. (Facoltativo) Per **Ruolo di esecuzione dell'attività**, selezionare`ecsTaskExecutionRole`. Amazon ECS richiede questo ruolo per estrarre le immagini dei container e pubblicare i log.
1. (Facoltativo) Per le **dimensioni dell'attività**, specifica la CPU e la memoria da riservare per il tuo demone. Ad esempio, `0.25 vCPU` e memoria. `512 MB`
1. Configura i dettagli del contenitore:
+ **Nome del contenitore**: inserisci un nome per il contenitore. Il nome può contenere fino a 255 caratteri alfanumerici, trattini e caratteri di sottolineatura.
+ **Contenitore essenziale****: seleziona Sì.** Ogni definizione di attività daemon richiede almeno un contenitore essenziale. Se un container essenziale si guasta, Amazon ECS interrompe l'intera operazione.
+ **URI dell'immagine**: inserisci l'URI dell'immagine Docker. Puoi sfogliare le immagini di Amazon ECR o utilizzare immagini pubbliche da Docker Hub o da altri registri.
1. (Facoltativo) Configura l'allocazione delle risorse, il controllo dello stato, le variabili di ambiente, la raccolta dei log e i tag in base alle esigenze.
1. Controlla la configurazione e scegli **Crea**.
### Usando il AWS CLI
Registra una definizione di attività daemon creando un file JSON e utilizzando il comando. `register-daemon-task-definition`
Di seguito è riportato un esempio di file JSON:
```
{
"family": "my-daemon-task",
"containerDefinitions": [
{
"name": "daemon-container",
"image": "public.ecr.aws/docker/library/busybox:latest",
"essential": true,
"command": ["sh", "-c", "while true; do echo 'Daemon running'; sleep 30; done"],
"memoryReservation": 512
}
]
}
```
Eseguite il comando seguente per registrare la definizione del task daemon:
```
aws ecs register-daemon-task-definition --cli-input-json file://daemon-taskdef.json
```
## Parametri di definizione del task Daemon
È possibile utilizzare i seguenti parametri quando si registra una definizione di attività daemon.
**Parametri obbligatori**
+ `family`- Il nome della famiglia della definizione dell'attività. Questo raggruppa più revisioni della stessa definizione di attività daemon.
+ `containerDefinitions`- Una serie di `DaemonContainerDefinition` oggetti che descrivono i contenitori del task daemon.
**Parametri opzionali**
+ `cpu`- Unità CPU a livello di attività come stringa (ad esempio,). `"256"`
+ `memory`- Memoria a livello di attività in MiB come stringa (ad esempio,). `"512"`
+ `taskRoleArn`- L'ARN del ruolo IAM che concede le autorizzazioni ai contenitori nell'attività daemon.
+ `executionRoleArn`- L'ARN del ruolo IAM che l'agente container Amazon ECS utilizza per effettuare chiamate AWS API per tuo conto (ad esempio, estrarre immagini da Amazon ECR).
+ `volumes`- Una serie di oggetti. `DaemonVolume` I volumi Daemon supportano solo i bind mount con e. `host` `sourcePath` Le definizioni delle attività daemon non supportano Amazon EBS, Amazon EFS, FSx per Windows File Server, volumi Docker o storage temporaneo.
+ `tags`- Una serie di coppie chiave-valore per etichettare la definizione dell'attività daemon.
## Modalità di rete
I daemon utilizzano una modalità di `daemon_bridge` rete speciale che Amazon ECS imposta automaticamente. Non è possibile specificare una modalità di rete nella definizione dell'attività del demone. Tutti i daemon su un'istanza condividono un unico namespace di rete e sono accessibili localmente tramite un indirizzo IP statico del daemon bridge (per o per). `169.254.172.2` IPv4 `fd00:ec2::172:2` IPv6 Le attività applicative (diverse dai demoni) possono comunicare con i demoni a questo indirizzo senza ulteriori configurazioni di rete.
Poiché i demoni vengono eseguiti in uno spazio dei nomi di rete separato dalle attività applicative, le attività non demoniache non devono preoccuparsi dei conflitti di porta con i daemon. Tuttavia, poiché tutte le attività daemon condividono lo stesso spazio dei nomi, i demoni sulla stessa istanza non possono collegarsi alla stessa porta. Quando distribuisci più daemon, assicurati che ogni daemon utilizzi una porta unica.
## Funzionalità privilegiate
Su Amazon ECS Managed Instances, i daemon supportano funzionalità Linux privilegiate per operazioni a livello di sistema. Gli agenti di sicurezza, gli strumenti di monitoraggio della rete e gli agenti di osservabilità spesso richiedono l'accesso a livello di kernel per funzionare correttamente.
È possibile concedere funzionalità in due modi:
La **modalità con privilegi completi** concede tutte le funzionalità Linux al contenitore. Usala quando il tuo agente richiede un ampio accesso al sistema:
```
{
"containerDefinitions": [{
"name": "security-daemon",
"image": "my-security-agent:latest",
"privileged": true
}]
}
```
**Le funzionalità individuali** concedono solo le autorizzazioni necessarie al demone, secondo il principio del privilegio minimo. Utilizza il `linuxParameters.capabilities` campo per aggiungere funzionalità individuali come`SYS_ADMIN`,, e: `NET_ADMIN` `SYS_PTRACE` `BPF`
```
{
"containerDefinitions": [{
"name": "monitoring-daemon",
"image": "my-monitoring-agent:latest",
"linuxParameters": {
"capabilities": {
"add": ["NET_ADMIN", "SYS_PTRACE"]
}
}
}]
}
```
## Volumi
I Managed Daemons supportano i bind mount utilizzando volumi host con una specifica. `sourcePath` Ciò consente ai contenitori daemon di montare le directory host per accedere a log, metriche e informazioni di sistema sull'istanza Amazon EC2 sottostante. Gli agenti di raccolta dei log, gli esportatori di metriche e gli scanner di sicurezza lo utilizzano comunemente per ottenere visibilità sui dati a livello di host.
La definizione del task daemon supporta le specifiche del volume host con. `sourcePath` I volumi daemon persistono per tutto il ciclo di vita dell'istanza del contenitore sottostante.
**Nota**
I volumi Amazon EBS, i volumi Amazon EFS, FSx per i volumi Windows File Server, i volumi Docker e lo storage temporaneo non sono supportati nelle definizioni delle attività daemon.
**Nota**
I daemon non supportano la condivisione di volumi tra loro. Ogni demone funziona con una propria configurazione di volume indipendente.
L'esempio seguente mostra un demone di raccolta di log con un bind mount:
```
{
"containerDefinitions": [{
"name": "log-collector",
"image": "fluent/fluentd:latest",
"mountPoints": [{
"sourceVolume": "var-log",
"containerPath": "/var/log"
}]
}],
"volumes": [{
"name": "var-log",
"host": {
"sourcePath": "/var/log"
}
}]
}
```
## Parametri del contenitore supportati
Le definizioni dei contenitori Daemon supportano i seguenti parametri:
+ `image`(obbligatorio) - URI dell'immagine del contenitore
+ `name`(obbligatorio) - Nome del contenitore
+ `cpu`- Unità CPU riservate al contenitore
+ `memory`/`memoryReservation`- Limiti di memoria rigida e software
+ `essential`- Se il contenitore è essenziale (impostazione predefinita: true)
+ `command`/`entryPoint`- Sostituisci il comando o il punto di ingresso del contenitore
+ `environment`/`environmentFiles`/`secrets`- Configurazione dell'ambiente
+ `privileged`- Esegui il contenitore in modalità privilegiata
+ `user`- Utente con cui eseguire il contenitore
+ `workingDirectory`- Cartella di lavoro all'interno del contenitore
+ `readonlyRootFilesystem`- Monta il filesystem root in modalità di sola lettura
+ `mountPoints`- Punti di montaggio del volume (bind mount solo con host e SourcePath)
+ `logConfiguration`- Configurazione della registrazione (supporta awslogs, splunk, awsfirelens)
+ `healthCheck`- Configurazione del controllo dello stato del contenitore
+ `dependsOn`- Dipendenze di avvio del contenitore
+ `ulimits`- Limiti delle risorse
+ `systemControls`- Parametri del kernel
+ `linuxParameters.capabilities`- Funzionalità Linux da aggiungere o eliminare
+ `linuxParameters.initProcessEnabled`- Esegui un processo di inizializzazione nel contenitore
+ `repositoryCredentials`- Credenziali per registri privati
+ `restartPolicy`- Politica di riavvio del contenitore
# Creazione e gestione dei demoni
Dopo aver registrato una definizione di task daemon, crea un daemon per distribuirla tra i tuoi provider di capacità Amazon ECS Managed Instances. Amazon ECS inserisce automaticamente un'attività daemon su ogni istanza Amazon EC2 nei provider di capacità associati e gestisce il ciclo di vita del daemon.
## Prerequisiti
Prima di creare un daemon, verifica di disporre di quanto segue:
+ Un cluster Amazon ECS.
+ Uno o più provider di capacità di Amazon ECS Managed Instances associati al cluster.
+ Una definizione di attività daemon registrata.
## Creare un demone
### Console di gestione AWS
1. Apri la console Amazon ECS. Nella barra di navigazione a sinistra, scegli **Cluster, quindi seleziona il tuo cluster**.
1. **Scegli la scheda **Demoni**, quindi scegli Crea.**
1. Per la **famiglia di definizioni di attività Daemon, seleziona la definizione** di attività daemon dal menu a discesa.
1. Per la revisione della **definizione delle attività Daemon, seleziona la revisione** da utilizzare. Lascia vuoto per utilizzare la revisione più recente.
1. Per il nome del **demone, inserisci un nome** univoco. Il nome può contenere fino a 255 caratteri alfanumerici, trattini e caratteri di sottolineatura.
1. Per i **fornitori di capacità**, seleziona uno o più fornitori di capacità di Amazon ECS Managed Instances. Questi determinano quali istanze eseguono le attività daemon.
1. (Facoltativo) Configura le impostazioni di distribuzione:
+ Percentuale di **drenaggio: percentuale** di istanze da drenare contemporaneamente durante gli aggiornamenti. Default: `25`.
+ **Usa CloudWatch allarmi: attiva questa opzione** per monitorare lo stato dell'implementazione e ripristina automaticamente gli allarmi se si attivano gli allarmi.
+ **Tempo di cottura**: il numero di minuti che Amazon ECS attende dopo l'aggiornamento di tutte le istanze alla nuova revisione del daemon prima di completare la distribuzione. Durante questo periodo, Amazon ECS monitora gli CloudWatch allarmi e ripristina automaticamente la distribuzione se si verifica un allarme. Default: `0`.
1. (Facoltativo) Aggiungi tag.
1. (Facoltativo) Attiva **Enable ECS Exec** per eseguire comandi interattivi nei contenitori daemon per la risoluzione dei problemi.
1. **Rivedi la configurazione e scegli Crea.**
### AWS CLI
Crea un file JSON con la configurazione del tuo demone ed esegui il comando. `create-daemon`
Di seguito è riportato un esempio di file JSON:
```
{
"clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster",
"daemonName": "my-monitoring-daemon",
"daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1",
"capacityProviderArns": [
"arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider"
]
}
```
Eseguite il comando seguente per creare il demone:
```
aws ecs create-daemon --cli-input-json file://create-daemon.json
```
**Campi obbligatori**
+ `daemonName`- Un nome univoco per il demone.
+ `clusterArn`- L'ARN del cluster.
+ `daemonTaskDefinitionArn`- L'ARN della definizione dell'attività del demone.
+ `capacityProviderArns`- Una serie di provider di capacità di Amazon ECS Managed Instances. ARNs
**Campi opzionali**
+ `deploymentConfiguration`- Un `DaemonDeploymentConfiguration` oggetto per personalizzare il comportamento di distribuzione.
+ `tags`- Coppie chiave-valore per l'etichettatura.
+ `propagateTags`- Impostazione della propagazione dei tag.
+ `clientToken`- Un token di idempotenza.
## Verifica della distribuzione dei daemon
Dopo aver creato un demone, verificane lo stato utilizzando o il. Console di gestione AWS AWS CLI
### Console di gestione AWS
1. Apri la console Amazon ECS. Nella barra di navigazione a sinistra, scegli **Cluster, quindi seleziona il tuo cluster**.
1. Scegli la scheda **Demoni**.
1. **Verifica che il tuo demone mostri lo stato Attivo.**
1. Scegli la scheda **Attività** per confermare che un'operazione daemon sia in esecuzione su ogni istanza del contenitore.
### AWS CLI
Esegui i seguenti comandi per verificare lo stato del daemon:
```
aws ecs list-daemons \
--cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster
```
```
aws ecs describe-daemons \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon
```
## Aggiornamento di un demone
Per aggiornare un demone con una nuova revisione della definizione di attività o per aggiungere fornitori di capacità, usa o il. Console di gestione AWS AWS CLI Ciò attiva una distribuzione continua in tutte le istanze.
### Console di gestione AWS
1. Apri la console Amazon ECS. Nella barra di navigazione a sinistra, scegli **Cluster, quindi seleziona il tuo cluster**.
1. Scegli la scheda **Demoni**, quindi seleziona il demone che desideri aggiornare.
1. Scegliere **Aggiorna**.
1. Per la revisione della **definizione del task Daemon, seleziona la nuova revisione**.
1. (Facoltativo) Aggiorna i provider di capacità o le impostazioni di distribuzione.
1. Scegli **Aggiorna** per avviare la distribuzione progressiva.
### AWS CLI
Eseguire il comando `update-daemon`:
```
aws ecs update-daemon \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:2 \
--capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider
```
**Importante**
Quando fornisci le impostazioni di configurazione del demone in una `UpdateDaemon` richiesta, Amazon ECS utilizza le impostazioni specificate anziché quelle predefinite. Le impostazioni di configurazione del demone, inclusi i tag e il flag del comando enable execute, non vengono mantenute tra un aggiornamento e l'altro. Ogni chiamata a `UpdateDaemon` deve includere il set completo di impostazioni di configurazione da applicare. Tutte le impostazioni omesse dalla richiesta tornano ai valori predefiniti.
## Eliminazione di un demone
Per eliminare un demone, usa il o il. Console di gestione AWS AWS CLI Attendi che tutte le attività del daemon si interrompano prima di eliminare il provider di capacità o il cluster.
### Console di gestione AWS
1. Apri la console Amazon ECS. Nella barra di navigazione a sinistra, scegli **Cluster, quindi seleziona il tuo cluster**.
1. Scegli la scheda **Demoni**, quindi seleziona il demone che desideri eliminare.
1. Scegli **Elimina**.
1. **Nella finestra di dialogo di conferma, scegli Elimina per confermare.**
### AWS CLI
Eseguire il comando `delete-daemon`:
```
aws ecs delete-daemon \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon
```
# Implementazioni daemon
Quando crei o aggiorni un daemon, Amazon ECS esegue una distribuzione continua per eseguire attività daemon su tutte le istanze nei provider di capacità associati. Questa sezione descrive come funzionano le distribuzioni di daemon e come configurare il comportamento di distribuzione.
## Come funzionano le distribuzioni dei daemon
L'implementazione di un demone segue uno schema. drain-provision-replace Quando crei un daemon su un provider di capacità con istanze esistenti o aggiorni un daemon a una nuova revisione della definizione delle attività, Amazon ECS scarica un batch di istanze, effettua il provisioning delle istanze sostitutive con il daemon aggiornato e sostituisce automaticamente le attività applicative. Questo processo si ripete finché tutte le istanze non eseguono la nuova revisione del daemon.
Il ciclo di vita della distribuzione passa attraverso i seguenti stati:
1. `PENDING`- Amazon ECS ha creato la distribuzione e si sta preparando a iniziare.
1. `IN_PROGRESS`- Amazon ECS sta scaricando attivamente le istanze e fornendo sostituzioni.
1. `SUCCESSFUL`- Tutte le istanze eseguono la revisione del demone di destinazione.
1. `STOPPED`- Amazon ECS ha interrotto la distribuzione perché non è riuscita o è stata sostituita da una nuova distribuzione. Il demone può trovarsi in uno stato misto in cui alcune istanze eseguono la vecchia revisione e altre eseguono la nuova revisione.
Amazon ECS torna automaticamente alla versione precedente del daemon se l'interruttore di distribuzione rileva guasti o se si attiva un allarme durante la distribuzione. CloudWatch
## Parametri di configurazione della distribuzione
È possibile personalizzare il comportamento di distribuzione utilizzando il `deploymentConfiguration` parametro quando si crea o si aggiorna un demone.
+ `drainPercent`(1.0—100.0): la percentuale di istanze da esaurire contemporaneamente durante la distribuzione. Valori più elevati velocizzano le implementazioni ma possono ridurre temporaneamente la capacità disponibile. Ad esempio, un valore di `20.0` drena il 20% delle istanze alla volta. Se non si specifica un valore predefinito, viene utilizzato `25.0`.
+ `alarms`(`DaemonAlarmConfiguration`) - CloudWatch allarmi da monitorare durante l'implementazione. Amazon ECS valuta gli allarmi specificati durante la distribuzione e ripristina automaticamente se viene rilevato un allarme. `ALARM` Amazon ECS ignora gli allarmi già presenti quando inizia `ALARM` la distribuzione.
+ `bakeTimeInMinutes`(0-1440): il numero di minuti che Amazon ECS attende dopo aver aggiornato tutte le istanze alla nuova revisione del daemon prima di completare la distribuzione. Durante questo periodo, Amazon ECS monitora gli CloudWatch allarmi e ripristina automaticamente la distribuzione se si verifica un allarme. Se non si specifica un valore predefinito, viene utilizzato `0`.
**Esempio con configurazione di distribuzione:**
```
aws ecs create-daemon \
--cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster \
--daemon-name my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1 \
--capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider \
--deployment-configuration '{"drainPercent":20.0,"bakeTimeInMinutes":5}'
```
## Monitoraggio delle distribuzioni
Monitora l'avanzamento della distribuzione utilizzando i seguenti comandi:
```
aws ecs list-daemon-deployments \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon
```
```
aws ecs describe-daemon-deployments \
--daemon-deployment-arns arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-daemon-cluster/abc123
```
La `describe-daemon-deployments` risposta include lo stato di distribuzione, la revisione del demone di destinazione e il `totalRunningInstanceCount` campo che indica quante istanze eseguono il demone di destinazione.
## Scenari di distribuzione dei daemon
Questa sezione illustra gli scenari di distribuzione più comuni per Managed Daemons.
+ [Implementa un daemon su un provider di capacità vuoto](#managed-daemons-scenario-empty)
+ [Implementa un daemon su un provider di capacità con istanze esistenti](#managed-daemons-scenario-existing)
+ [Aggiungere un provider di capacità a un demone esistente](#managed-daemons-scenario-add-cp)
+ [Aggiorna un demone a una nuova revisione](#managed-daemons-scenario-update)
### Implementa un daemon su un provider di capacità vuoto
In questo scenario, si distribuisce un daemon su un provider di capacità senza istanze esistenti. Le istanze vengono avviate quando si pianificano le attività dell'applicazione.
**Prerequisiti:** un cluster e un provider di capacità Amazon ECS Managed Instances senza istanze in esecuzione.
1. Registra la definizione del task daemon.
1. Crea il demone. Amazon ECS completa immediatamente la creazione anche se non esistono ancora istanze.
```
aws ecs create-daemon \
--cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster \
--daemon-name my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1 \
--capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider
```
1. Crea un servizio che utilizzi lo stesso provider di capacità. Quando Amazon ECS effettua il provisioning di un'istanza per il servizio, avvia prima l'attività daemon, quindi trasferisce l'attività dell'applicazione a. `RUNNING`
```
aws ecs create-service \
--cluster my-daemon-cluster \
--service-name my-app-service \
--task-definition my-app-task \
--desired-count 2 \
--capacity-provider-strategy capacityProvider=my-daemon-capacity-provider,weight=1
```
1. **Verifica che l'attività daemon sia in esecuzione su ogni istanza utilizzando il `describe-daemons` comando o controllando la scheda Daemons nella console.**
**Nota**
La distribuzione del daemon può rimanere attiva per un breve periodo mentre `PENDING` Amazon ECS esegue il provisioning delle istanze e avvia le attività del daemon. Attendi che la distribuzione arrivi prima di verificare il posizionamento delle attività del daemon`SUCCESSFUL`.
### Implementa un daemon su un provider di capacità con istanze esistenti
In questo scenario, si distribuisce un daemon su un provider di capacità che ha già istanze e attività applicative in esecuzione.
**Prerequisiti:** un cluster con un provider di capacità Amazon ECS Managed Instances con istanze in esecuzione.
1. Registra la definizione del task daemon.
1. Crea il demone. Amazon ECS avvia una distribuzione progressiva per inserire attività daemon su tutte le istanze esistenti.
```
aws ecs create-daemon \
--cluster-arn arn:aws:ecs:us-east-1:123456789012:cluster/my-daemon-cluster \
--daemon-name my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1 \
--capacity-provider-arns arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider \
--deployment-configuration '{"drainPercent":25.0,"bakeTimeInMinutes":3}'
```
Amazon ECS scarica un batch di istanze esistenti (in base a`drainPercent`), fornisce istanze sostitutive con il daemon e sostituisce le attività applicative. Questo processo si ripete finché tutte le istanze non eseguono il daemon.
1. Monitora l'avanzamento della distribuzione:
```
aws ecs list-daemon-deployments \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon
```
### Aggiungere un provider di capacità a un demone esistente
In questo scenario, si aggiunge un secondo provider di capacità a un daemon esistente. Il daemon viene distribuito automaticamente sulle istanze del nuovo provider di capacità.
**Prerequisiti:** un daemon in esecuzione su un primo provider di capacità e un secondo provider di capacità creato e associato al cluster.
1. Aggiornate il daemon per includere entrambi i provider di capacità:
```
aws ecs update-daemon \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:1 \
--capacity-provider-arns \
arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider \
arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-daemon-capacity-provider-2
```
1. Monitora la distribuzione e verifica che le attività daemon vengano eseguite su istanze di entrambi i provider di capacità.
### Aggiorna un demone a una nuova revisione
In questo scenario, si aggiorna un demone esistente per utilizzare una nuova revisione della definizione delle attività.
1. Registra una nuova revisione della definizione del task daemon con l'immagine o la configurazione del contenitore aggiornata.
1. Aggiorna il demone per utilizzare la nuova revisione:
```
aws ecs update-daemon \
--daemon-arn arn:aws:ecs:us-east-1:123456789012:daemon/my-daemon-cluster/my-monitoring-daemon \
--daemon-task-definition-arn arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/my-daemon-task:2
```
Amazon ECS esegue una distribuzione continua. Svuota le istanze che eseguono la vecchia revisione, effettua il provisioning delle istanze sostitutive con la nuova revisione e sostituisce automaticamente le attività dell'applicazione. Se l'interruttore rileva guasti, Amazon ECS torna alla revisione precedente.
1. Monitora la distribuzione e verifica che tutte le istanze eseguano la nuova revisione:
```
aws ecs describe-daemon-deployments \
--daemon-deployment-arns arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-daemon-cluster/deployment-id
```
# Eventi daemon
Amazon ECS invia eventi daemon per fornire visibilità sulla gestione delle attività dei daemon e sulle modifiche del ciclo di vita della distribuzione. Puoi utilizzare questi eventi per monitorare lo stato dei daemon, tenere traccia dei progressi della distribuzione e attivare flussi di lavoro automatizzati.
Amazon ECS supporta i seguenti tipi di eventi daemon:
+ [Eventi di azione del servizio Daemon](#managed-daemons-service-action-events)- Eventi relativi al posizionamento delle attività dei daemon e ai problemi di avvio.
+ [Eventi di modifica dello stato di distribuzione dei daemon](#managed-daemons-deployment-state-change-events)- Eventi relativi alle transizioni del ciclo di vita dell'implementazione dei daemon.
Per informazioni su come creare regole per questi eventi, consulta. [Creazione di regole per gli eventi daemon](#managed-daemons-eventbridge-rules)
## Eventi di azione del servizio Daemon
Amazon ECS invia eventi di azione del servizio daemon con il tipo di dettaglio. `ECS Daemon Service Action` Questi eventi ti avvisano quando Amazon ECS riscontra problemi nell'avvio di attività daemon sulle tue istanze di container.
### DAEMON\$1TASK\$1START\$1IMPAIRED
Amazon ECS invia l'`DAEMON_TASK_START_IMPAIRED`evento quando non è in grado di avviare correttamente un'attività daemon su un'istanza di contenitore. L'evento include un `failureType` campo che indica la causa dell'errore:
+ `TASK_FAILED_TO_RUN`- Il task daemon è stato creato ma non è riuscito a raggiungere `RUNNING` lo stato. Le cause più comuni includono errori di estrazione dell'immagine del contenitore, errori di controllo dello stato del contenitore o uscite essenziali dai container. Il `taskArn` campo è presente nell'evento.
+ `TASK_CREATION_FAILED`- Il daemon task non può essere creato sull'istanza del contenitore. Le cause più comuni includono CPU, memoria o altre risorse insufficienti sull'istanza. Il `taskArn` campo non è presente nell'evento perché non è stata creata alcuna attività.
### Esempio: evento TASK\$1FAILED\$1TO\$1RUN
L'evento seguente mostra un'attività daemon che è stata creata ma non è riuscita a raggiungere lo stato a causa di un errore di estrazione dell'immagine del contenitore. `RUNNING`
```
{
"version": "0",
"id": "12345678-1234-1234-1234-123456789012",
"detail-type": "ECS Daemon Service Action",
"source": "aws.ecs",
"account": "123456789012",
"time": "2026-03-24T12:00:00Z",
"region": "us-west-2",
"resources": [
"arn:aws:ecs:us-west-2:123456789012:task/my-cluster/a1b2c3d4e5f6"
],
"detail": {
"eventType": "WARNING",
"eventName": "DAEMON_TASK_START_IMPAIRED",
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
"containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/a1b2c3d4e5f6",
"taskArn": "arn:aws:ecs:us-west-2:123456789012:task/my-cluster/a1b2c3d4e5f6",
"daemonRevisionArn": "arn:aws:ecs:us-west-2:123456789012:daemon-revision/my-cluster/my-daemon/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"capacityProviderName": "my-capacity-provider",
"daemonArn": "arn:aws:ecs:us-west-2:123456789012:daemon/my-cluster/my-daemon",
"daemonTaskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:daemon-task-definition/my-daemon-td:1",
"failureType": "TASK_FAILED_TO_RUN",
"createdAt": "2026-03-24T12:00:00.000Z",
"reason": "Task failed to reach RUNNING status: CannotPullContainerError: pull image manifest has been retried 5 time(s)"
}
}
```
### Esempio: evento TASK\$1CREATION\$1FAILED
L'evento seguente mostra un'attività daemon che non può essere creata sull'istanza del contenitore a causa di risorse CPU insufficienti. Il `taskArn` campo non è presente perché non è stata creata alcuna attività.
```
{
"version": "0",
"id": "87654321-4321-4321-4321-210987654321",
"detail-type": "ECS Daemon Service Action",
"source": "aws.ecs",
"account": "123456789012",
"time": "2026-03-24T12:01:00Z",
"region": "us-west-2",
"resources": [],
"detail": {
"eventType": "WARNING",
"eventName": "DAEMON_TASK_START_IMPAIRED",
"clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster",
"containerInstanceArn": "arn:aws:ecs:us-west-2:123456789012:container-instance/my-cluster/b2c3d4e5f6a7",
"daemonRevisionArn": "arn:aws:ecs:us-west-2:123456789012:daemon-revision/my-cluster/my-daemon/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"capacityProviderName": "my-capacity-provider",
"daemonArn": "arn:aws:ecs:us-west-2:123456789012:daemon/my-cluster/my-daemon",
"daemonTaskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:daemon-task-definition/my-daemon-td:1",
"failureType": "TASK_CREATION_FAILED",
"createdAt": "2026-03-24T12:01:00.000Z",
"reason": "RESOURCE:CPU - Unable to place daemon task on container instance: insufficient CPU"
}
}
```
## Eventi di modifica dello stato di distribuzione dei daemon
Amazon ECS invia eventi di modifica dello stato di distribuzione del daemon con il tipo di dettaglio. `ECS Daemon Deployment State Change` Amazon ECS emette questi eventi ogni volta che cambia lo stato di distribuzione di un daemon.
### Tipi di eventi di modifica dello stato di distribuzione
Amazon ECS classifica gli eventi di modifica dello stato di distribuzione in base ai seguenti tipi di eventi:
**Eventi INFO**
+ `DAEMON_DEPLOYMENT_PENDING`- Amazon ECS ha avviato una distribuzione daemon.
+ `DAEMON_DEPLOYMENT_IN_PROGRESS`- Amazon ECS ha avviato la distribuzione e sta sostituendo attivamente le attività daemon.
+ `DAEMON_DEPLOYMENT_SUCCESSFUL`- Amazon ECS ha completato con successo la distribuzione con tutte le attività dei daemon in esecuzione e funzionanti.
+ `DAEMON_DEPLOYMENT_STOPPED`- Amazon ECS ha interrotto la distribuzione. Ciò si verifica quando una distribuzione non è riuscita o è stata sostituita da una nuova distribuzione.
+ `DAEMON_DEPLOYMENT_STOP_REQUESTED`- Amazon ECS ha interrotto l'implementazione e ora inizierà a rallentare.
+ `DAEMON_DEPLOYMENT_ROLLBACK_IN_PROGRESS`- Amazon ECS ha avviato un rollback a causa di un errore di implementazione o di un interruttore automatico.
+ `DAEMON_DEPLOYMENT_ROLLBACK_SUCCESSFUL`- Amazon ECS ha completato con successo il rollback della distribuzione.
**Eventi ERROR**
+ `DAEMON_DEPLOYMENT_ROLLBACK_FAILED`- Amazon ECS non è riuscito a completare il rollback della distribuzione.
### Esempio: evento in sospeso di distribuzione
L'evento seguente mostra una distribuzione daemon avviata da Amazon ECS.
```
{
"version": "0",
"id": "3329f79b-3dca-07f8-b1c2-5fe99f0b5e87",
"detail-type": "ECS Daemon Deployment State Change",
"source": "aws.ecs",
"account": "111122223333",
"time": "2026-03-05T15:54:41Z",
"region": "us-west-2",
"resources": [
"arn:aws:ecs:us-west-2:111122223333:daemon/my-cluster/my-daemon"
],
"detail": {
"eventType": "INFO",
"eventName": "DAEMON_DEPLOYMENT_PENDING",
"clusterArn": "arn:aws:ecs:us-west-2:111122223333:cluster/my-cluster",
"daemonArn": "arn:aws:ecs:us-west-2:111122223333:daemon/my-cluster/my-daemon",
"daemonDeploymentArn": "arn:aws:ecs:us-west-2:111122223333:daemon-deployment/my-cluster/my-daemon/0EYSiB0qap8xf0N76FsbE",
"targetDaemonRevisionArn": "arn:aws:ecs:us-west-2:111122223333:daemon-revision/my-cluster/my-daemon/85707969-3732-4b6a-a37d-5cefddd7d7dd",
"updatedAt": "2026-03-05T15:54:41.618059641Z"
}
}
```
## Creazione di regole per gli eventi daemon
È possibile creare regole per ricevere notifiche quando si verificano eventi daemon. Per ulteriori informazioni sulla creazione di regole, consulta [Creating a rule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella *Amazon EventBridge User Guide*.
I modelli di eventi di esempio seguenti mostrano come filtrare gli eventi daemon.
### Esempio: abbina tutti gli eventi di azione del servizio daemon
```
{
"source": ["aws.ecs"],
"detail-type": ["ECS Daemon Service Action"]
}
```
### Esempio: corrisponde a un tipo di errore specifico
```
{
"source": ["aws.ecs"],
"detail-type": ["ECS Daemon Service Action"],
"detail": {
"eventName": ["DAEMON_TASK_START_IMPAIRED"],
"failureType": ["TASK_CREATION_FAILED"]
}
}
```
### Esempio: abbina gli eventi per un cluster specifico
```
{
"source": ["aws.ecs"],
"detail-type": ["ECS Daemon Service Action"],
"detail": {
"eventName": ["DAEMON_TASK_START_IMPAIRED"],
"clusterArn": ["arn:aws:ecs:us-west-2:123456789012:cluster/my-cluster"]
}
}
```
### Esempio: abbina tutti gli eventi di modifica dello stato di distribuzione
```
{
"source": ["aws.ecs"],
"detail-type": ["ECS Daemon Deployment State Change"]
}
```
# Metriche daemon
Amazon ECS pubblica CloudWatch metriche per Managed Daemons. Puoi utilizzare questi parametri per monitorare l'utilizzo della CPU e della memoria per le attività dei daemon in tutto il cluster.
Le metriche dei daemon utilizzano lo stesso spazio dei nomi delle metriche dei servizi. `AWS/ECS` Amazon ECS distingue le metriche del demone dalle metriche del servizio in base al valore della `ServiceName` dimensione, che utilizza il prefisso `daemon:` seguito dal nome del demone (ad esempio,). `daemon:my-daemon`
## Metriche di utilizzo del demone
Amazon ECS misura l'utilizzo della CPU e della memoria del daemon come percentuale di risorse utilizzate dalle attività daemon rispetto alle risorse specificate nella definizione delle attività del daemon.
CloudWatch fornisce le seguenti statistiche per i parametri di utilizzo dei daemon:
+ **Media**: l'utilizzo medio di tutte le attività dei daemon nel cluster.
+ **Minimo**: l'utilizzo del daemon task con il minor utilizzo di risorse.
+ **Massimo**: l'utilizzo del daemon task con il massimo utilizzo di risorse.
### Formule di utilizzo
Amazon ECS calcola la statistica media utilizzando le seguenti formule:
```
(Total CPU units used by daemon tasks) x 100
Daemon CPU utilization = -------------------------------------------------------------------------------
(Total CPU units specified in daemon task definition) x (Number of daemon tasks)
```
```
(Total MiB of memory used by daemon tasks) x 100
Daemon memory utilization = ------------------------------------------------------------------------------------
(Total MiB of memory specified in daemon task definition) x (Number of daemon tasks)
```
Queste formule si applicano solo alla statistica Average. Le statistiche Minimo e Massimo rappresentano la singola attività del demone con il minor e il massimo utilizzo delle risorse, rispettivamente.
L'agente container Amazon ECS campiona l'utilizzo della CPU e della memoria per ogni attività daemon in esecuzione ogni 20 secondi. Ogni minuto, l'agente segnala tre campioni ad Amazon ECS. Amazon ECS aggrega i campioni tra tutte le attività del demone nel cluster e pubblica i valori Media, Minimo e Massimo in percentuale delle risorse totali specificate nella definizione del task del daemon. CloudWatch
### Esempio: calcolo dell'utilizzo
Una definizione di attività daemon specifica 256 unità CPU e 512 MiB di memoria. Il daemon ha 2 attività in esecuzione su 2 istanze di container. Un'attività daemon utilizza 200 unità CPU e 400 MiB di memoria. L'altro utilizza 100 unità CPU e 256 MiB di memoria. Amazon ECS riporta i seguenti parametri:
+ Utilizzo medio della CPU: ((200 \$1 100) x 100)/(256 x 2) = 58,6%
+ Utilizzo medio della memoria: ((400 \$1 256) x 100)/(512 x 2) = 64,1%
## Visualizzazione delle metriche dei daemon
È possibile visualizzare le metriche del demone utilizzando o il. Console di gestione AWS AWS CLI
### Console di gestione AWS
1. Apri la console. CloudWatch
1. Nella barra di navigazione a sinistra, scegli **Metriche**, quindi scegli **Tutte le metriche**.
1. Scegli lo spazio dei nomi **AWS/ECS**.
1. **Scegli la dimensione,. ClusterName ServiceName**
1. Filtra `ServiceName` i valori che iniziano con `daemon:` per individuare le metriche del tuo demone.
### AWS CLI
Esegui il `get-metric-statistics` comando per recuperare le metriche del demone da. CloudWatch Specificare la `ServiceName` dimensione con il prefisso. `daemon:`
### Esempio: visualizzazione dell'utilizzo della CPU del demone
Il comando seguente recupera l'utilizzo medio della CPU per un demone in un periodo di 12 ore con intervalli di 5 minuti.
```
aws cloudwatch get-metric-statistics \
--namespace AWS/ECS \
--metric-name CPUUtilization \
--dimensions Name=ClusterName,Value=my-cluster Name=ServiceName,Value=daemon:my-daemon \
--start-time 2026-03-24T00:00:00Z \
--end-time 2026-03-24T12:00:00Z \
--period 300 \
--statistics Average
```
### Esempio: visualizzazione dell'utilizzo della memoria del demone
Il comando seguente recupera l'utilizzo medio della memoria per un demone in un periodo di 12 ore con intervalli di 5 minuti.
```
aws cloudwatch get-metric-statistics \
--namespace AWS/ECS \
--metric-name MemoryUtilization \
--dimensions Name=ClusterName,Value=my-cluster Name=ServiceName,Value=daemon:my-daemon \
--start-time 2026-03-24T00:00:00Z \
--end-time 2026-03-24T12:00:00Z \
--period 300 \
--statistics Average
```
# Riparazione auto Daemon
Amazon ECS considera tutti i daemon fondamentali per l'integrità delle istanze. Se un'attività daemon si interrompe o non funziona correttamente, Amazon ECS considera l'istanza danneggiata e la prosciuga e la sostituisce automaticamente. Le azioni di riparazione automatica del demone sono le seguenti:
1. Amazon ECS rileva quando un'attività daemon si interrompe o non funziona correttamente.
1. Amazon ECS contrassegna l'istanza come drenante, il che le impedisce di accettare nuove attività applicative.
1. Amazon ECS effettua il provisioning di un'istanza sostitutiva e avvia il daemon task su di essa.
1. Dopo che l'attività daemon ha raggiunto uno stato integro, Amazon ECS pianifica le attività dell'applicazione dall'istanza in fase di esaurimento a quella sostitutiva.
1. Amazon ECS termina l'istanza originale.
**Importante**
I controlli dello stato dei daemon sono facoltativi ma altamente consigliati. Senza un controllo dello stato, Amazon ECS è in grado di rilevare gli errori solo quando l'attività del daemon si interrompe.
Puoi monitorare lo stato del daemon utilizzando l'API o l'API. `DescribeContainerInstances` `DescribeTasks`