View a markdown version of this page

Creazione di un servizio App Runner - AWS App Runner
PrerequisitiCreazione di un servizio

AWS App Runner non è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS App Runner la modifica della disponibilità.

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 che si ridimensiona automaticamente. 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 le risorse di calcolo e distribuisce l'applicazione per l'esecuzione su di esse.

Quando crei 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 di App Runner, vedere. Risorse App Runner Questi tipi di risorse hanno delle quote associate al tuo account in ciascuno di essi. Regione AWS Per ulteriori informazioni, consulta Quote di risorse di App Runner.

Esistono sottili differenze nella procedura di creazione di un servizio a seconda del tipo di fonte e del fornitore. Questo argomento illustra diverse procedure per la creazione di questi tipi di sorgenti, in modo da poter seguire quella più adatta alla propria situazione. Per iniziare una procedura di base con un esempio di codice, vedereGuida introduttiva a App Runner.

Prerequisiti

Prima di creare il servizio App Runner, assicurati di completare le seguenti azioni:

Creazione di un servizio

Questa sezione illustra il processo di creazione dei due tipi di servizio App Runner: basato sul codice sorgente e basato su un'immagine del contenitore.

Nota

Se crei un connettore VPC per il traffico in uscita per un servizio, il processo di avvio del servizio che segue subirà una latenza una tantum. È possibile impostare questa configurazione per un nuovo servizio al momento della creazione o successivamente con un aggiornamento del servizio. Per ulteriori informazioni, consulta il Latenza una tantum capitolo Networking with App Runner di questa guida.

Le sezioni seguenti mostrano come creare un servizio App Runner quando la fonte è un repository di codice in GitHub Bitbucket o Bitbucket. https://bitbucket.org/ Quando usi 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, consultaGestione delle connessioni App Runner.

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 e, nell'elenco delle regioni, seleziona il tuo Regione AWS.

    2. Se Account AWS non dispone ancora di servizi App Runner, viene visualizzata la home page della console. Scegli Crea un servizio App Runner.

      Pagina iniziale della console App Runner che mostra il pulsante di creazione del servizio

      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

    3. Nella pagina Origine e distribuzione, nella sezione Origine, per Tipo di repository, scegli Repository del codice sorgente.

    4. Seleziona un tipo di provider. Scegli uno GitHub o Bitbucket.

    5. Quindi seleziona un account o un'organizzazione per il provider che hai utilizzato in precedenza o scegli Aggiungi nuovo. Quindi, segui la procedura di fornitura delle credenziali del repository di codice e scegli un account o un'organizzazione a cui connetterti.

    6. Per Repository, seleziona il repository che contiene il codice dell'applicazione.

    7. Per Branch, seleziona il ramo che desideri distribuire.

    8. Per la directory di origine, immettete 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 specifichi un valore qui, per impostazione predefinita la directory principale del repository.

  2. Configura le tue distribuzioni.

    1. Nella sezione Impostazioni di distribuzione, scegli Manuale o Automatico.

      Per ulteriori informazioni sui metodi di distribuzione, vedere. Metodi di distribuzione

    2. Scegli Next (Successivo).

    Impostazioni di origine e distribuzione durante la creazione di un servizio App Runner

  3. 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 o Usa un file di configurazione se lo contiene.

      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.

    2. Fornisci le seguenti impostazioni di compilazione:

      • Runtime: scegli un runtime gestito specifico per la tua applicazione.

      • Comando Build: inserisci un comando che crea l'applicazione dal suo codice sorgente. Potrebbe trattarsi di uno strumento specifico della lingua o di uno script fornito con il codice.

      • Comando di avvio: immettete il comando che avvia il servizio web.

      • Porta: inserisci la porta IP che il tuo servizio web è in ascolto.

    3. Scegli Next (Successivo).

    Crea le impostazioni durante la creazione di un servizio App Runner

  4. Configura il tuo servizio.

    1. Nella pagina Configura il servizio, nella sezione Impostazioni del servizio, inserisci un nome di servizio.

      Nota

      Tutte le altre impostazioni del servizio sono opzionali o hanno valori predefiniti forniti dalla console.

    2. Facoltativamente, modifica o aggiungi altre impostazioni per soddisfare i requisiti dell'applicazione.

    3. Scegli Next (Successivo).

    Impostazioni del servizio durante la creazione di un servizio App Runner

  5. 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 il dashboard del servizio con una panoramica del nuovo servizio.

    Pagina del dashboard del servizio App Runner

  6. Verifica che il servizio sia in esecuzione.

    1. Nella pagina del dashboard del servizio, attendi che lo stato del servizio sia in esecuzione.

    2. Scegli il valore del dominio predefinito. È l'URL del sito Web del tuo servizio.

    3. Usa il tuo sito Web e verifica che funzioni correttamente.

Creazione di un servizio a partire dal codice utilizzando l'API App Runner o AWS CLI

Per creare un servizio utilizzando l'API App Runner o AWS CLI, richiama l'azione CreateService API. Per ulteriori informazioni e un esempio, consulta CreateService. 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 Questo stabilisce una connessione tra App Runner e l'organizzazione o l'account del provider del repository. Per ulteriori informazioni sulle connessioni App Runner, consulta. Gestione delle connessioni App Runner

Se la chiamata restituisce una risposta corretta con un oggetto Service visualizzato"Status": "CREATING", il servizio inizia a creare.

Per una chiamata di esempio, consulta Create a source code repository service in AWS App Runner API Reference

Le sezioni seguenti mostrano come creare un servizio App Runner quando l'origine è un'immagine contenitore archiviata in Amazon ECR. 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 al pubblico. Quindi, 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 una fase di compilazione.

Per ulteriori informazioni, consulta Servizio App Runner basato su un'immagine sorgente.

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 e, nell'elenco delle regioni, seleziona il tuo Regione AWS.

    2. Se Account AWS non dispone ancora di servizi App Runner, viene visualizzata la home page della console. Scegli Crea un servizio App Runner.

      Pagina iniziale della console App Runner che mostra il pulsante di creazione del servizio

      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

    3. Nella pagina Origine e distribuzione, nella sezione Origine, per Tipo di repository, scegli Container registry.

    4. 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.

    5. Per l'URI dell'immagine del contenitore, scegli Browse.

    6. Nella finestra di dialogo Seleziona l'immagine del contenitore Amazon ECR, per Image repository, seleziona il repository che contiene l'immagine.

    7. 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

  2. Configura le tue implementazioni.

    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

    2. [Provider Amazon ECR] Per il ruolo di accesso ECR, scegli un ruolo di servizio esistente nel tuo account o scegli di creare un nuovo ruolo. Se utilizzi la distribuzione manuale, puoi anche scegliere di utilizzare il ruolo utente IAM al momento della distribuzione.

    3. Scegli Next (Successivo).

    Impostazioni di origine e distribuzione durante la creazione di un servizio App Runner

  3. Configura il tuo servizio.

    1. Nella pagina Configura il servizio, nella sezione Impostazioni del servizio, inserisci il nome del servizio e la porta IP che il sito Web del servizio è in ascolto.

      Nota

      Tutte le altre impostazioni del servizio sono opzionali o hanno valori predefiniti forniti dalla console.

    2. (Facoltativo) Modifica o aggiungi altre impostazioni in base alle esigenze dell'applicazione.

    3. Scegli Next (Successivo).

    Impostazioni del servizio durante la creazione di un servizio App Runner

  4. 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 il dashboard del servizio, con una panoramica del nuovo servizio.

    Pagina del dashboard del servizio App Runner

  5. Verifica che il servizio sia in esecuzione.

    1. Nella pagina del dashboard del servizio, attendi che lo stato del servizio sia in esecuzione.

    2. Scegli il valore del dominio predefinito. È l'URL del sito Web del tuo servizio.

    3. 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 o AWS CLI, richiama l'azione CreateService API.

La creazione del servizio inizia se la chiamata restituisce una risposta corretta con la visualizzazione "Status": "CREATING" di un oggetto Service.

Per una chiamata di esempio, consulta Create a source image repository service in AWS App Runner API Reference