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à.
# Creazione di un servizio App Runner
AWS App Runner automatizza la transizione da un'immagine del contenitore o da un repository di codice sorgente a un servizio Web in esecuzione con scalabilità automatica. Indirizzi App Runner all'immagine o al codice sorgente, specificando solo un numero limitato di impostazioni richieste. App Runner crea l'applicazione se necessario, fornisce risorse di calcolo e distribuisce l'applicazione per eseguirla su di esse.
*Quando si crea un servizio, App Runner crea una risorsa di servizio.* In alcuni casi, potrebbe essere necessario fornire una risorsa di *connessione*. Se si utilizza la console App Runner, la console crea implicitamente la risorsa di connessione. Per ulteriori informazioni sui tipi di risorse App Runner, consulta. [Risorse App Runner](architecture.md#architecture.resources) Per ognuno di questi tipi di risorse sono associate delle quote associate al tuo account. Regione AWS Per ulteriori informazioni, consulta [Quote di risorse di App Runner](architecture.md#architecture.quotas).
Esistono sottili differenze nella procedura di creazione di un servizio a seconda del tipo di fonte e del provider. In questo argomento vengono illustrate diverse procedure per la creazione di questi tipi di fonti in modo da poter seguire quella più adatta alla propria situazione. Per iniziare una procedura di base con un esempio di codice, vedere[Guida introduttiva a App Runner](getting-started.md).
## Prerequisiti
Prima di creare il servizio App Runner, assicurati di completare le seguenti azioni:
+ Completa i passaggi di configurazione in[Configurazione per App Runner](setting-up.md).
+ Assicurati che il codice sorgente dell'applicazione sia pronto. Puoi utilizzare un repository di codice in [Bitbucket](https://bitbucket.org/) o un'immagine contenitore in [GitHub](https://github.com/)Amazon Elastic Container Registry (Amazon ECR) [Elastic Container Registry (Amazon ECR) per creare un servizio](https://docs.aws.amazon.com/AmazonECR/latest/userguide/) App Runner.
## Creazione di un servizio
Questa sezione illustra il processo di creazione per i due tipi di servizio App Runner: basato sul codice sorgente e basato sull'immagine di un contenitore.
**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.
### Crea un servizio da un repository di codice
[Le sezioni seguenti mostrano come creare un servizio App Runner quando la fonte è un repository di codice in [GitHub](https://github.com/)o Bitbucket.](https://bitbucket.org/) Quando si utilizza un repository di codice, App Runner deve connettersi all'organizzazione o all'account del provider. Pertanto, è necessario contribuire a stabilire questa connessione. Per ulteriori informazioni sulle connessioni App Runner, vedere[Gestione delle connessioni App Runner](manage-connections.md).
Quando crei il servizio, App Runner crea un'immagine Docker che contiene il codice dell'applicazione e le dipendenze. Quindi avvia un servizio che esegue un'istanza contenitore di questa immagine.
#### Creazione di un servizio dal codice utilizzando la console App Runner
**Per creare un servizio App Runner utilizzando la console**
1. Configura il tuo codice sorgente.
1. Apri la [console App Runner](https://console.aws.amazon.com/apprunner) e, nell'elenco **Regioni**, seleziona il tuo Regione AWS.
1. Se Account AWS non dispone ancora di alcun servizio App Runner, viene visualizzata la home page della console. Scegli **Crea un servizio App Runner.**
![\[Home page della console App Runner che mostra il pulsante di creazione del servizio\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-home.png)
Se Account AWS dispone di servizi esistenti, viene visualizzata la pagina **Servizi** con un elenco dei servizi. Selezionare **Create service (Crea servizio)**.
![\[Pagina dei servizi della console App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-services.png)
1. Nella pagina **Origine e distribuzione**, nella sezione **Sorgente**, per **Tipo di archivio**, scegli Archivio del **codice sorgente.**
1. Seleziona un tipo di **provider**. Scegli uno dei due **GitHub**o **Bitbucket**.
1. Quindi seleziona un account o un'organizzazione per il provider che hai utilizzato in precedenza o scegli **Aggiungi** nuovo. Quindi, esegui la procedura di fornitura delle credenziali del repository del codice e scegli un account o un'organizzazione a cui connetterti.
1. Per **Repository**, seleziona il repository che contiene il codice dell'applicazione.
1. Per **Branch**, seleziona il ramo che desideri distribuire.
1. Per la **directory di origine**, inserite la directory nel repository di origine che memorizza il codice dell'applicazione e i file di configurazione.
**Nota**
I comandi build e start vengono eseguiti dalla directory di origine specificata. App Runner gestisce il percorso come assoluto a partire da root. Se non si specifica un valore qui, la directory predefinita è la radice del repository.
1. Configura le tue distribuzioni.
1. **Nella sezione **Impostazioni di distribuzione**, scegli **Manuale o Automatico**.**
Per ulteriori informazioni sui metodi di distribuzione, consulta[Metodi di distribuzione](manage-deploy.md#manage-deploy.methods).
1. Scegli **Next (Successivo)**.
![\[Impostazioni di origine e distribuzione durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-create-source-depl.png)
1. Configura la build dell'applicazione.
1. Nella pagina **Configura build**, per **File di configurazione**, scegli **Configura tutte le impostazioni qui** se il tuo repository non contiene un file di configurazione di App Runner, oppure **Usa un file di configurazione in caso affermativo**.
**Nota**
Un file di configurazione di App Runner è un modo per mantenere la configurazione della build come parte dell'origine dell'applicazione. Quando ne fornisci uno, App Runner legge alcuni valori dal file e non ti consente di impostarli nella console.
1. Fornisci le seguenti impostazioni di build:
+ **Runtime**: scegli un runtime gestito specifico per la tua applicazione.
+ **Comando di compilazione**: immetti un comando che crea l'applicazione a partire dal suo codice sorgente. Potrebbe trattarsi di uno strumento specifico della lingua o di uno script fornito con il codice.
+ **Comando di avvio**: immetti il comando che avvia il tuo servizio web.
+ **Porta**: inserisci la porta IP che il tuo servizio web ascolta.
1. Scegli **Next (Successivo)**.
![\[Crea impostazioni durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-create-build.png)
1. Configura il tuo servizio.
1. Nella pagina **Configura servizio**, nella sezione **Impostazioni del servizio**, inserisci un nome di servizio.
**Nota**
Tutte le altre impostazioni del servizio sono opzionali o hanno impostazioni predefinite fornite dalla console.
1. Facoltativamente, è possibile modificare o aggiungere altre impostazioni per soddisfare i requisiti dell'applicazione.
1. Scegli **Next (Successivo)**.
![\[Impostazioni del servizio durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-create-github-service.png)
1. Nella pagina **Rivedi e crea**, verifica tutti i dettagli che hai inserito, quindi scegli **Crea e distribuisci**.
**Risultato:** se il servizio viene creato correttamente, la console visualizza la dashboard del servizio con una **panoramica del servizio** del nuovo servizio.
![\[Pagina del pannello di controllo del servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-create-dashboard.png)
1. Verifica che il servizio sia in esecuzione.
1. Nella pagina del pannello di controllo del servizio, attendi che **lo stato** del servizio sia **in esecuzione**.
1. Scegli il valore di **dominio predefinito**. È l'URL del sito Web del tuo servizio.
1. Usa il tuo sito Web e verifica che funzioni correttamente.
#### Creazione di un servizio dal codice utilizzando l'API App Runner o AWS CLI
Per creare un servizio utilizzando l'API App Runner oppure AWS CLI, richiama l'azione `CreateService` API. Per ulteriori informazioni e un esempio, consulta [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html). Se è la prima volta che crei un servizio utilizzando un'organizzazione o un account specifico per un repository di codice sorgente (GitHub o Bitbucket), inizia chiamando. [CreateConnection](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateConnection.html) Ciò stabilisce una connessione tra App Runner e l'organizzazione o l'account del fornitore del repository. Per ulteriori informazioni sulle connessioni di App Runner, vedere. [Gestione delle connessioni App Runner](manage-connections.md)
Se la chiamata restituisce una risposta corretta con un oggetto [Service](https://docs.aws.amazon.com/apprunner/latest/api/API_Service.html) visualizzato`"Status": "CREATING"`, il servizio inizia la creazione.
Per una chiamata di esempio, consulta [Creare un servizio di repository del codice sorgente](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html#API_CreateService_Example_1) nell'*AWS App Runner API* Reference
### Creare un servizio da un'immagine Amazon ECR
Le seguenti sezioni mostrano come creare un servizio App Runner quando l'origine è un'immagine del contenitore archiviata in [Amazon ECR](https://docs.aws.amazon.com/AmazonECR/latest/userguide/). Amazon ECR è un Servizio AWS. Pertanto, per creare un servizio basato su un'immagine Amazon ECR, fornisci ad App Runner un ruolo di accesso contenente le autorizzazioni di azione Amazon ECR necessarie.
**Nota**
Le immagini archiviate in Amazon ECR Public sono disponibili pubblicamente. Pertanto, se l'immagine è archiviata in Amazon ECR Public, non è richiesto un ruolo di accesso.
Quando il servizio viene creato, App Runner avvia un servizio che esegue un'istanza contenitore dell'immagine fornita. In questo caso non è prevista alcuna fase di compilazione.
Per ulteriori informazioni, consulta [Servizio App Runner basato su un'immagine sorgente](service-source-image.md).
#### Creazione di un servizio da un'immagine utilizzando la console App Runner
**Per creare un servizio App Runner utilizzando la console**
1. Configura il tuo codice sorgente.
1. Apri la [console App Runner](https://console.aws.amazon.com/apprunner) e, nell'elenco **Regioni**, seleziona il tuo Regione AWS.
1. Se Account AWS non dispone ancora di alcun servizio App Runner, viene visualizzata la home page della console. Scegli **Crea un servizio App Runner.**
![\[Home page della console App Runner che mostra il pulsante di creazione del servizio\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-home.png)
Se Account AWS dispone di servizi esistenti, viene visualizzata la pagina **Servizi** con un elenco dei servizi. Selezionare **Create service (Crea servizio)**.
![\[Pagina dei servizi della console App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/getting-started-services.png)
1. Nella pagina **Origine e distribuzione**, nella sezione **Origine**, per **Tipo di repository**, scegli **Container** registry.
1. Per **Provider**, scegli il provider in cui è archiviata l'immagine:
+ **Amazon ECR**: un'immagine privata archiviata in Amazon ECR.
+ **Amazon ECR Public**: un'immagine leggibile pubblicamente archiviata in Amazon ECR Public.
1. **Per l'**URI dell'immagine del contenitore, scegli** Sfoglia.**
1. Nella finestra di dialogo **Seleziona l'immagine del contenitore Amazon ECR**, per **Image repository**, seleziona il repository che contiene l'immagine.
1. **Per il **tag Image**, seleziona il tag di immagine specifico che desideri distribuire (ad esempio, il **più recente**), quindi scegli Continua.**
![\[Selezione di un'immagine Amazon ECR durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-create-ecr-select-image.png)
1. Configura le tue distribuzioni.
1. **Nella sezione **Impostazioni di distribuzione**, scegli **Manuale o Automatico**.**
**Nota**
App Runner non supporta la distribuzione automatica per le immagini pubbliche di Amazon ECR e per le immagini in un repository Amazon ECR che appartiene a un AWS account diverso da quello in cui si trova il servizio.
Per ulteriori informazioni sui metodi di distribuzione, consulta. [Metodi di distribuzione](manage-deploy.md#manage-deploy.methods)
1. [Provider **Amazon ECR**] Per il **ruolo di accesso ECR**, scegli un ruolo di servizio esistente nel tuo account o scegli di crearne uno nuovo. Se utilizzi la distribuzione manuale, puoi anche scegliere di utilizzare il ruolo utente IAM al momento della distribuzione.
1. Scegli **Next (Successivo)**.
![\[Impostazioni di origine e distribuzione durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-create-ecr-source-depl.png)
1. Configura il tuo servizio.
1. Nella pagina **Configura servizio**, nella sezione **Impostazioni del servizio**, inserisci un nome di servizio e la porta IP che il sito Web del servizio ascolta.
**Nota**
Tutte le altre impostazioni del servizio sono opzionali o hanno impostazioni predefinite fornite dalla console.
1. (Facoltativo) Modifica o aggiungi altre impostazioni in base alle esigenze dell'applicazione.
1. Scegli **Next (Successivo)**.
![\[Impostazioni del servizio durante la creazione di un servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-create-ecr-service.png)
1. Nella pagina **Rivedi e crea**, verifica tutti i dettagli che hai inserito, quindi scegli **Crea e distribuisci**.
**Risultato:** se il servizio viene creato correttamente, la console mostra la dashboard del servizio, con una **panoramica del servizio** del nuovo servizio.
![\[Pagina del pannello di controllo del servizio App Runner\]](http://docs.aws.amazon.com/it_it/apprunner/latest/dg/images/manage-create-ecr-dashboard.png)
1. Verifica che il servizio sia in esecuzione.
1. Nella pagina del pannello di controllo del servizio, attendi che **lo stato** del servizio sia **in esecuzione**.
1. Scegli il valore di **dominio predefinito**. È l'URL del sito Web del tuo servizio.
1. Usa il tuo sito Web e verifica che funzioni correttamente.
#### Creazione di un servizio da un'immagine utilizzando l'API App Runner o AWS CLI
Per creare un servizio utilizzando l'API App Runner oppure AWS CLI, richiama l'azione [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)API.
La creazione del servizio inizia se la chiamata restituisce una risposta corretta con la visualizzazione `"Status": "CREATING"` di un oggetto [Service](https://docs.aws.amazon.com/apprunner/latest/api/API_Service.html).
Per una chiamata di esempio, consulta [Creare un servizio di repository di immagini di origine](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html#API_CreateService_Example_2) nell'*AWS App Runner API* Reference