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à.
# Esecuzione del daemon X-Ray su Amazon ECS
**Nota**
Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. [Cronologia di X-Ray SDK e Daemon Support](xray-sdk-daemon-timeline.md) Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere [Migrazione dalla strumentazione a raggi X](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html) alla strumentazione. OpenTelemetry
In Amazon ECS, crea un'immagine Docker che esegua il daemon X-Ray, caricala in un repository di immagini Docker e quindi distribuiscila nel tuo cluster Amazon ECS. Puoi utilizzare la mappatura delle porte e la modalità di impostazione della rete nel file di definizione dell'attività per consentire alla tua applicazione di comunicare con il container del daemon.
## Utilizzo dell'immagine Docker ufficiale
X-Ray fornisce un'immagine del [contenitore Docker su](https://gallery.ecr.aws/xray/aws-xray-daemon) Amazon ECR che puoi distribuire insieme alla tua applicazione. Per ulteriori informazioni, consulta la sezione [Download del daemon](xray-daemon.md#xray-daemon-downloading).
**Example Definizione di attività**
```
{
"name": "xray-daemon",
"image": "amazon/aws-xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
}
```
## Creare e compilare un'immagine Docker
Per la configurazione personalizzata, potrebbe essere necessario definire la propria immagine Docker.
Aggiungi policy gestite al tuo ruolo di attività per concedere al demone l'autorizzazione a caricare i dati di traccia su X-Ray. Per ulteriori informazioni, consulta [Dare al demone il permesso di inviare dati a X-Ray](xray-daemon.md#xray-daemon-permissions).
Utilizza uno dei seguenti Dockerfiles per creare un'immagine che esegue il daemon.
**Example Docker file — Amazon Linux**
```
FROM amazonlinux
RUN yum install -y unzip
RUN curl -o daemon.zip https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-linux-3.x.zip
RUN unzip daemon.zip && cp xray /usr/bin/xray
ENTRYPOINT ["/usr/bin/xray", "-t", "0.0.0.0:2000", "-b", "0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
**Nota**
I contrassegni `-t` e `-b` sono necessari per specificare un indirizzo di binding per ascoltare il loopback di un ambiente multi-container.
**Example Dockerfile — Ubuntu**
Per le derivazioni di Debian, è inoltre necessario installare i certificati della Certificate Autohority (CA) per evitare problemi durante il download del programma di installazione.
```
FROM ubuntu:16.04
RUN apt-get update && apt-get install -y --force-yes --no-install-recommends apt-transport-https curl ca-certificates wget && apt-get clean && apt-get autoremove && rm -rf /var/lib/apt/lists/*
RUN wget https://s3.us-east-2.amazonaws.com/aws-xray-assets.us-east-2/xray-daemon/aws-xray-daemon-3.x.deb
RUN dpkg -i aws-xray-daemon-3.x.deb
ENTRYPOINT ["/usr/bin/xray", "--bind=0.0.0.0:2000", "--bind-tcp=0.0.0.0:2000"]
EXPOSE 2000/udp
EXPOSE 2000/tcp
```
Nella tua definizione di attività, la configurazione dipende dalla modalità di rete utilizzata. La modalità di rete bridge è l'impostazione predefinita e può essere utilizzato nel VPC di default. In una rete bridge, imposta la variabile di `AWS_XRAY_DAEMON_ADDRESS` ambiente per indicare all'SDK X-Ray a quale porta contenitore fare riferimento e imposta la porta host. In una rete bridge, pubblica la porta UDP 2000 e crea un collegamento dal container della tua applicazione al container del daemon.
**Example Definizione di attività**
```
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"hostPort": 0,
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" },
{ "name" : "AWS_XRAY_DAEMON_ADDRESS", "value" : "xray-daemon:2000" }
],
"portMappings" : [
{
"hostPort": 5000,
"containerPort": 5000
}
],
"links": [
"xray-daemon"
]
}
```
Se esegui il cluster nella sottorete privata di un VPC, puoi utilizzare la [modalità di rete `awsvpc`](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) per collegare ai tuoi container un'interfaccia di rete elastica (ENI). In questo modo puoi evitare di utilizzare i collegamenti. Ometti la porta dell'host nel mappaggio delle porte, il collegamento e la variabile di ambiente `AWS_XRAY_DAEMON_ADDRESS`.
**Example Definizione dell'attività del VPC**
```
{
"family": "scorekeep",
"networkMode":"awsvpc",
"containerDefinitions": [
{
"name": "xray-daemon",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/xray-daemon",
"cpu": 32,
"memoryReservation": 256,
"portMappings" : [
{
"containerPort": 2000,
"protocol": "udp"
}
]
},
{
"name": "scorekeep-api",
"image": "123456789012.dkr.ecr.us-east-2.amazonaws.com/scorekeep-api",
"cpu": 192,
"memoryReservation": 512,
"environment": [
{ "name" : "AWS_REGION", "value" : "us-east-2" },
{ "name" : "NOTIFICATION_TOPIC", "value" : "arn:aws:sns:us-east-2:123456789012:scorekeep-notifications" }
],
"portMappings" : [
{
"containerPort": 5000
}
]
}
]
}
```
## Configura le opzioni della riga di comando nella console Amazon ECS
Le opzioni della riga di comando sovrascrivono qualsiasi valore in conflitto nel file di configurazione dell'immagine. Le opzioni della riga di comando sono in genere utilizzate per i test locali, ma possono anche essere usate per comodità durante l'impostazione delle variabili di ambiente o per controllare il processo di avvio.
Aggiungendo le opzioni della riga di comando, aggiorni il Docker `CMD` che viene passato al contenitore. Per ulteriori informazioni, consulta la [pagina di riferimento per l'esecuzione del Docker](https://docs.docker.com/engine/reference/run/#overriding-dockerfile-image-defaults).
**Come impostare un'opzione della riga di comando**
1. Apri la console Amazon ECS classic all'indirizzo [https://console.aws.amazon.com/ecs/](https://console.aws.amazon.com/ecs/).
1. Dalla barra di navigazione, scegli la regione in cui si trova la definizione di attività.
1. Nel riquadro di navigazione, scegli **Definizioni di attività**.
1. Nella pagina **Task Definitions** (Definizioni di attività), seleziona la casella a sinistra della definizione di attività da modificare e scegli **Create new revision** (Crea nuova revisione).
1. Nella pagina **Create new revision of Task Definition (Crea nuova revisione della definizione di attività)** selezionare il contenitore.
1. Nella sezione **ENVIRONMENT (AMBIENTE)** aggiungere l'elenco separato da virgole di opzioni della riga di comando al campo **Command (Comando)**.
1. Scegliere **Aggiorna**.
1. Verifica le informazioni e scegli **Crea**.
Nell'esempio seguente viene illustrato come scrivere un'opzione della riga di comando separata da virgole per l'opzione `RoleARN`. L'`RoleARN`opzione presuppone il ruolo IAM specificato per caricare i segmenti su un account diverso.
**Example**
```
--role-arn, arn:aws:iam::123456789012:role/xray-cross-account
```
Per ulteriori informazioni sulle opzioni della riga di comando disponibili in X-Ray, vedere [Configurazione](xray-daemon-configuration.md) del demone. AWS X-Ray