AWS App Runner non sarà più aperto a nuovi clienti a partire dal 30 aprile 2026. Se desideri utilizzare App Runner, registrati prima di tale data. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta [AWS App Runner la pagina Modifica della disponibilità](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html). 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à. # Configurazione di un servizio App Runner Quando si [crea un AWS App Runner servizio](manage-create.md), si impostano diversi valori di configurazione. È possibile modificare alcune di queste impostazioni di configurazione dopo aver creato il servizio. Altre impostazioni possono essere applicate solo durante la creazione del servizio e non possono essere modificate in seguito. Questo argomento descrive la configurazione del servizio utilizzando l'API App Runner, la console App Runner e un file di configurazione App Runner. **Topics** + [ ## Configura il tuo servizio utilizzando l'API App Runner o AWS CLI ](#manage-configure.api) + [ ## Configura il tuo servizio utilizzando la console App Runner ](#manage-configure.console) + [ ## Configura il tuo servizio utilizzando un file di configurazione di App Runner ](#manage-configure.file) + [ # Configurazione dell'osservabilità per il servizio ](manage-configure-observability.md) + [ # Configurazione delle impostazioni del servizio utilizzando risorse condivisibili ](manage-configure-resources.md) + [ # Configurazione dei controlli sanitari per il servizio ](manage-configure-healthcheck.md) ## Configura il tuo servizio utilizzando l'API App Runner o AWS CLI L'API definisce quali impostazioni possono essere modificate dopo la creazione del servizio. L'elenco seguente illustra le azioni, i tipi e le limitazioni pertinenti. + [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)azione: può essere richiamato dopo la creazione per aggiornare alcune impostazioni di configurazione. + *Può essere aggiornato*: è possibile aggiornare le impostazioni nei `HealthCheckConfiguration` parametri `SourceConfiguration``InstanceConfiguration`, e. Tuttavia, in`SourceConfiguration`, non è possibile cambiare il tipo di sorgente da codice a immagine o viceversa. È necessario fornire lo stesso parametro di repository fornito al momento della creazione del servizio. O è o. `CodeRepository` `ImageRepository` È inoltre possibile aggiornare le seguenti risorse ARNs di configurazione separate associate al servizio: + `AutoScalingConfigurationArn` + `VpcConnectorArn` + *Non può essere aggiornato*: non è possibile modificare i `EncryptionConfiguration` parametri `ServiceName` and disponibili nell'[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)azione. Non possono essere modificati dopo la creazione. L'[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)azione non include questi parametri. + *API o file*: puoi impostare il `ConfigurationSource` parametro del [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)tipo (utilizzato per gli archivi di codice sorgente come parte di`SourceConfiguration`) su. `Repository` In questo caso, App Runner ignora le impostazioni di configurazione e le legge da un file di [configurazione](config-file.md) presente nel `CodeConfigurationValues` repository. Se si imposta su `ConfigurationSource``API`, App Runner ottiene tutte le impostazioni di configurazione dalla chiamata API e ignora il file di configurazione, anche se ne esiste uno. + [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)azione: può essere richiamata dopo la creazione del servizio per aggiungere tag al servizio o aggiornare i valori dei tag esistenti. + [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)azione: può essere richiamato dopo la creazione del servizio per rimuovere i tag dal servizio. **Nota** Se crei un connettore VPC per il traffico in uscita per un servizio, il processo di avvio del servizio che segue presenterà una latenza unica. È possibile impostare questa configurazione per un nuovo servizio al momento della creazione o in seguito, con un aggiornamento del servizio. Per ulteriori informazioni, consulta il [Latenza una tantum](network-vpc.md#network-vpc.VPC-connector.latency) capitolo *Networking with App Runner* di questa guida. ## Configura il tuo servizio utilizzando la console App Runner La console utilizza l'API App Runner per applicare gli aggiornamenti di configurazione. Le regole di aggiornamento imposte dall'API, come definito nella sezione precedente, determinano cosa è possibile configurare utilizzando la console. Alcune impostazioni che erano disponibili durante la creazione del servizio non possono essere modificate in seguito. Inoltre, se decidi di utilizzare un [file di configurazione](config-file.md), le impostazioni aggiuntive vengono nascoste nella console e App Runner le legge dal file. **Per configurare il servizio** 1. Apri la [console App Runner](https://console.aws.amazon.com/apprunner) e, nell'elenco **Regioni**, seleziona il tuo Regione AWS. 1. Nel riquadro di navigazione, scegli **Servizi**, quindi scegli il servizio App Runner. La console mostra la dashboard del servizio con una **panoramica del servizio**. ![\[Pagina del dashboard del servizio App Runner che mostra l'elenco delle attività\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/console-dashboard.png) 1. Nella pagina del dashboard del servizio, scegli la scheda **Configurazione**. Risultato: la console mostra le impostazioni di configurazione correnti del servizio in diverse sezioni: **Origine e distribuzione**, **Configure build** e **Configure service**. 1. Per aggiornare le impostazioni in qualsiasi categoria, scegli **Modifica**. 1. Nella pagina di modifica della configurazione, apporta le modifiche desiderate, quindi scegli **Salva modifiche**. **Nota** Se crei un connettore VPC per il traffico in uscita per un servizio, il processo di avvio del servizio che segue presenterà una latenza unica. È possibile impostare questa configurazione per un nuovo servizio al momento della creazione o in seguito, con un aggiornamento del servizio. Per ulteriori informazioni, consulta il [Latenza una tantum](network-vpc.md#network-vpc.VPC-connector.latency) capitolo *Networking with App Runner* di questa guida. ## Configura il tuo servizio utilizzando un file di configurazione di App Runner Quando crei o aggiorni un servizio App Runner, puoi indicare ad App Runner di leggere alcune impostazioni di configurazione da un file di configurazione fornito come parte del tuo repository di origine. In questo modo, puoi gestire le impostazioni relative al codice sorgente sotto il controllo del codice sorgente, insieme al codice stesso. Il file di configurazione fornisce anche alcune impostazioni avanzate che non è possibile configurare utilizzando la console o l'API. Per ulteriori informazioni, consulta [Impostazione delle opzioni del servizio App Runner utilizzando un file di configurazione](config-file.md). **Nota** Se crei un connettore VPC per il traffico in uscita per un servizio, il processo di avvio del servizio che segue presenterà una latenza unica. È possibile impostare questa configurazione per un nuovo servizio al momento della creazione o in seguito, con un aggiornamento del servizio. Per ulteriori informazioni, consulta il [Latenza una tantum](network-vpc.md#network-vpc.VPC-connector.latency) capitolo *Networking with App Runner* di questa guida. # Configurazione dell'osservabilità per il servizio AWS App Runner si integra con diversi AWS servizi per fornirti un'ampia suite di strumenti di osservabilità per il tuo servizio App Runner. Per ulteriori informazioni, consulta [Osservabilità per il tuo servizio App Runner](monitor.md). App Runner supporta l'attivazione di alcune funzionalità di osservabilità e la configurazione del loro comportamento utilizzando una risorsa condivisibile chiamata. *ObservabilityConfiguration* È possibile fornire una risorsa di configurazione dell'osservabilità quando si crea o si aggiorna un servizio. La console App Runner ne crea una per te quando crei un nuovo servizio App Runner. La fornitura di una configurazione di osservabilità è facoltativa. Se non ne fornisci una, App Runner fornisce una configurazione di osservabilità predefinita. È possibile condividere una singola configurazione di osservabilità tra più servizi App Runner per garantire che abbiano lo stesso comportamento di osservabilità. Per ulteriori informazioni, consulta [Configurazione delle impostazioni del servizio utilizzando risorse condivisibili](manage-configure-resources.md). È possibile configurare le seguenti funzionalità di osservabilità utilizzando configurazioni di osservabilità: + *Configurazione di tracciamento*: impostazioni per tracciare le richieste servite dall'applicazione e le chiamate a valle effettuate dall'applicazione. Per ulteriori informazioni sul tracciamento, consulta [Tracciamento per l'applicazione App Runner con X-Ray](monitor-xray.md). ## Gestisci l'osservabilità Gestisci l'osservabilità dei tuoi servizi App Runner utilizzando uno dei seguenti metodi: ------ #### [ App Runner console ] Quando [crei un servizio](manage-create.md) utilizzando la console App Runner o quando [ne aggiorni la configurazione in un secondo momento](manage-configure.md), puoi configurare le funzionalità di osservabilità per il tuo servizio. Cerca la sezione sulla configurazione dell'**osservabilità** nella pagina della console. ![\[Pagina di configurazione della console App Runner che mostra le opzioni di osservabilità\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-configure-observability.png) ------ #### [ App Runner API or AWS CLI ] Quando si richiamano le azioni dell'API [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)o [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)dell'App Runner, è possibile utilizzare l'oggetto `ObservabilityConfiguration` parametro per abilitare le funzionalità di osservabilità e specificare una risorsa di configurazione dell'osservabilità per il servizio. Utilizza le seguenti azioni dell'API App Runner per gestire le risorse di configurazione dell'osservabilità. + [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— Crea una nuova configurazione di osservabilità o una revisione di una configurazione esistente. + [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— Restituisce un elenco delle configurazioni di osservabilità associate all'utente Account AWS, con informazioni di riepilogo. + [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— Restituisce una descrizione completa di una configurazione di osservabilità. + [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— Elimina una configurazione di osservabilità. È possibile eliminare una revisione specifica o l'ultima revisione attiva. Potrebbe essere necessario eliminare le configurazioni di osservabilità non necessarie se si raggiunge la quota di configurazione di osservabilità prevista per la propria. Account AWS ------ # Configurazione delle impostazioni del servizio utilizzando risorse condivisibili Per alcune funzionalità, è opportuno condividere la configurazione tra AWS App Runner i servizi. Ad esempio, potresti volere che un set di servizi abbia lo stesso comportamento di ridimensionamento automatico. Oppure potresti volere impostazioni di osservabilità identiche per tutti i tuoi servizi. App Runner consente di condividere le impostazioni utilizzando risorse condivisibili separate. Crei una risorsa che definisce un set di impostazioni di configurazione per una funzionalità, quindi fornisci l'Amazon Resource Name (ARN) di questa risorsa di configurazione a uno o più servizi App Runner. App Runner implementa risorse di configurazione condivisibili per le seguenti funzionalità: + [Dimensionamento automatico](manage-autoscaling.md) + [Osservabilità](manage-configure-observability.md) + [Accesso VPC](network-vpc.md) La pagina del documento per ciascuna di queste funzionalità fornisce informazioni sulle impostazioni disponibili e sulle procedure di gestione. Le funzionalità che utilizzano risorse di configurazione separate condividono alcune caratteristiche e considerazioni di progettazione. + **Revisioni**: alcune risorse di configurazione possono avere delle revisioni. La scalabilità automatica e l'osservabilità sono esempi di due risorse di configurazione che utilizzano le revisioni. *In questi casi, ogni configurazione ha un *nome e una revisione* numerica.* Più revisioni di una configurazione hanno lo stesso nome e numeri di revisione diversi. È possibile utilizzare nomi di configurazione diversi per scenari diversi. Per ogni nome, è possibile aggiungere più revisioni per ottimizzare le impostazioni per uno scenario specifico. La prima configurazione creata con un nome ottiene il numero di revisione 1. Le configurazioni successive con lo stesso nome ottengono numeri di revisione consecutivi (a partire da 2). È possibile associare il servizio App Runner a una revisione di configurazione specifica o all'ultima revisione della configurazione. + **Condiviso**: puoi condividere una singola risorsa di configurazione tra più servizi App Runner. Ciò è utile se si desidera mantenere configurazioni identiche tra questi servizi. In particolare, se le tue risorse supportano le revisioni, puoi configurare più servizi per utilizzare la revisione più recente di una configurazione. È possibile farlo specificando solo il nome della configurazione, ma non una revisione. Tutti i servizi configurati in questo modo ricevono aggiornamenti di configurazione quando si aggiorna il servizio. Per ulteriori informazioni sulle modifiche alla configurazione, vedere[Configurazione di un servizio App Runner](manage-configure.md). + **Gestione delle risorse**: puoi utilizzare App Runner per creare ed eliminare configurazioni. Non è possibile aggiornare direttamente una configurazione. Invece, per le risorse che supportano le revisioni, puoi creare una nuova revisione di un nome di configurazione esistente per aggiornare efficacemente la configurazione. **Nota** Per la scalabilità automatica, puoi creare configurazioni e revisioni *multiple* sia con la console App Runner che con l'API App Runner. Sia la console App Runner che l'API App Runner possono anche eliminare configurazioni e revisioni. Per ulteriori dettagli, consultare [Gestione del ridimensionamento automatico di App Runner](manage-autoscaling.md). Per altri tipi di configurazione, come le configurazioni di osservabilità, puoi creare una configurazione con una *sola revisione solo con la console App Runner*. Per creare più revisioni ed eliminare le configurazioni, devi utilizzare l'API App Runner. + Quota di **risorse: sono previste quote** prestabilite per il numero di nomi di configurazione e di revisioni univoci che è possibile avere per le risorse di configurazione in ciascuno di essi. Regione AWS Se raggiungi queste quote, devi eliminare un nome di configurazione o almeno alcune delle relative revisioni prima di poterne creare altre. Per le revisioni delle configurazioni con ridimensionamento automatico, puoi utilizzare la console App Runner o l'API App Runner per eliminarle. Per ulteriori dettagli, consultare [Gestione del ridimensionamento automatico di App Runner](manage-autoscaling.md). È necessario utilizzare l'API App Runner per eliminare altre risorse. Per ulteriori informazioni sulle quote, consulta [Quote di risorse di App Runner](architecture.md#architecture.quotas). + **Nessun costo in termini di risorse**: non sono previsti costi aggiuntivi per la creazione di una risorsa di configurazione. Potresti sostenere dei costi per la funzionalità stessa (ad esempio, ti vengono addebitati i AWS X-Ray costi normali quando attivi il tracciamento X-Ray), ma non per la risorsa di configurazione App Runner che configura la funzionalità per il tuo servizio App Runner. # Configurazione dei controlli sanitari per il servizio AWS App Runner monitora lo stato del servizio eseguendo controlli sanitari. Il protocollo predefinito per il controllo dello stato di salute è TCP. App Runner esegue il ping del dominio assegnato al servizio. In alternativa, puoi impostare il protocollo di controllo dello stato di salute su HTTP. App Runner invia richieste HTTP per il controllo dello stato di salute all'applicazione web. È possibile configurare alcune impostazioni relative ai controlli sanitari. La tabella seguente descrive le impostazioni dei controlli sanitari e i relativi valori predefiniti. | **Impostazione** | **Descrizione** | **Impostazione predefinita** | | --- | --- | --- | | Protocollo | Il protocollo IP utilizzato da App Runner per eseguire i controlli dell'integrità per il servizio. Se imposti il protocollo su`TCP`, App Runner esegue il ping del dominio predefinito assegnato al servizio sulla porta che l'applicazione sta ascoltando. Se si imposta il protocollo su`HTTP`, App Runner invia le richieste di controllo dello stato di salute al percorso configurato. | `TCP` | | Path | L'URL a cui App Runner invia le richieste di controllo dello stato HTTP. Applicabile solo ai controlli HTTP. | `/` | | Interval | L'intervallo di tempo, in secondi, tra i controlli dell'integrità. | `5` | | Timeout | Il tempo di attesa, in secondi, per una risposta del controllo dell'integrità prima di decidere che il controllo dell'integrità non è riuscito. | `2` | | Soglia salutare | Il numero di controlli consecutivi che devono essere completati correttamente prima che App Runner decida che il servizio è integro. | `1` | | Soglia non salutare | Il numero di controlli consecutivi non riusciti prima che App Runner decida che il servizio non è integro. | `5` | ## Configura i controlli sanitari Configura i controlli di integrità per il tuo servizio App Runner utilizzando uno dei seguenti metodi: ------ #### [ App Runner console ] Quando crei il servizio App Runner utilizzando la console App Runner o quando ne aggiorni la configurazione in un secondo momento, puoi configurare le impostazioni del controllo dello stato. Per le procedure complete della console, consulta [Creazione di un servizio App Runner](manage-create.md) e. [Configurazione di un servizio App Runner](manage-configure.md) In entrambi i casi, cerca la sezione di configurazione **Health check** nella pagina della console. ![\[Pagina di configurazione della console App Runner che mostra le opzioni di controllo dello stato\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/console-health-check.png) ------ #### [ App Runner API or AWS CLI ] Quando richiami le azioni [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)o [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API, puoi utilizzare il `HealthCheckConfiguration` parametro per specificare le impostazioni del controllo dello stato. Per informazioni sulla struttura del parametro, consulta [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)l'*AWS App Runner API Reference*. ------