View a markdown version of this page

Creazione di servizi App Runner - AWS Toolkit per VS Code

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 servizi App Runner

È possibile creare un servizio App Runner in Toolkit for VS Code utilizzando AWS Explorer e la palette di comandi di VS Code. Dopo aver scelto di creare un servizio in una AWS regione specifica, i passaggi numerati forniti dalla Command Palette guidano l'utente nel processo di configurazione dell'istanza del servizio in cui viene eseguita l'applicazione.

Prima di creare un servizio App Runner, verifica di aver soddisfatto tutti i prerequisiti. Ciò include specificare le autorizzazioni IAM pertinenti e confermare il repository sorgente specifico che desideri implementare.

Creazione di un servizio App Runner

  1. Apri AWS Explorer, se non è già aperto.

  2. Right-click il nodo App Runner e scegli Create Service.

    Viene visualizzata la tavolozza dei comandi.

  3. Per Select a source code location type (Seleziona un tipo di posizione del codice sorgente), scegli ECR o Repository.

    Se scegli ECR, specifichi un'immagine di container in un repository gestito da Amazon Elastic Container Registry. Se scegli Repository, specifichi un repository di codice sorgente gestito da un provider di repository supportato. Attualmente, App Runner supporta GitHub come fornitore di repository di codice sorgente.

  1. Per Select or enter an image repository (Seleziona o immetti un repository di immagini), scegli o inserisci l'URL del repository di immagini gestito dal tuo registro privato Amazon ECR o dalla galleria pubblica di Amazon ECR.

    Nota

    Se specifichi un repository dalla galleria pubblica di Amazon ECR, assicurati che le implementazioni automatiche siano disattivate: App Runner non supporta questo tipo di implementazioni per immagini in un repository pubblico ECR.

    Le distribuzioni automatiche sono disattivate per impostazione predefinita e ciò viene indicato quando l'icona nell'intestazione della Command Palette è attraversata da una linea diagonale. Se decidi di attivare le implementazioni automatiche, sarà un visualizzato un messaggio per informarti che questa opzione può comportare costi aggiuntivi.

  2. Se il passaggio Command Palette riporta che Nessun tag è stato trovato, devi tornare indietro di un passaggio per selezionare un repository che contiene un'immagine del contenitore con tag.

  3. Se utilizzi un registro privato Amazon ECR, hai bisogno del ruolo di accesso ECR AppRunnerECRAccessRole, che consente ad App Runner di accedere alle immagini di Amazon Elastic Container Registry (Amazon ECR) nel tuo account. Scegli l'icona «+» nell'intestazione della Command Palette per creare automaticamente questo ruolo. Non è necessario un ruolo di accesso se l'immagine è archiviata nella galleria pubblica di Amazon ECR, dove le immagini sono pubblicamente disponibili.

  4. Per Port (Porta), inserisci la porta IP utilizzata dal servizio (porta 8000, ad esempio).

  5. Per Configure environment variables (Configura variabili d'ambiente), puoi specificare un file contenente variabili di ambiente utilizzate per personalizzare il comportamento nell'istanza del servizio. Oppure puoi ignorare questa fase.

  6. Per Name your service (Assegna un nome al servizio), inserisci un nome univoco senza spazi e premi Invio.

  7. Per Select instance configuration (Seleziona configurazione dell'istanza), scegli una combinazione di unità CPU e memoria in GB per la tua istanza di servizio.

    Quando il servizio viene creato, il suo stato cambia da Creating (Creazione in corso) a Running (In esecuzione).

  8. Appena il servizio è in esecuzione, fai clic con il pulsante destro del mouse e scegli Copy Service URL (Copia URL del servizio).

  9. Per accedere all'applicazione implementata, incolla l'URL copiato nella barra degli indirizzi del browser Web.

  1. Per Seleziona una connessione, scegli una connessione a cui GitHub collegare AWS. Le connessioni disponibili per la selezione sono elencate nella pagina delle GitHub connessioni della console App Runner.

  2. Per Seleziona un GitHub repository remoto, scegli o inserisci un URL per il repository remoto.

    I repository remoti già configurati con la gestione del controllo del codice sorgente (SCM) di Visual Studio Code sono disponibili per la selezione. Potrai inoltre incollare un collegamento al repository, se non è presente nell'elenco.

  3. Per Select a branch (Seleziona un ramo), scegli il ramo Git del codice sorgente che desideri implementare.

  4. Per Choose configuration source (Scegli sorgente di configurazione), specifica come desideri definire la configurazione del runtime.

    Se scegli Use configuration file (Utilizza file di configurazione), l'istanza del servizio sarà configurata dalle impostazioni definite dal file di configurazione di apprunner.yaml. Questo file si trova nella directory principale del repository dell'applicazione.

    Se scegli Configura tutte le impostazioni qui, usa la palette Comando per specificare quanto segue:

    • Runtime: scegli Python 3 o Nodejs 12.

    • Build command (Comando build): immetti il comando per creare l'applicazione nell'ambiente di runtime dell'istanza del servizio.

    • Start command (Comando avvio): immetti il comando per avviare l'applicazione nell'ambiente di runtime dell'istanza del servizio.

  5. Per Port (Porta), inserisci la porta IP utilizzata dal servizio (porta 8000, ad esempio).

  6. Per Configure environment variables (Configura variabili d'ambiente), puoi specificare un file contenente variabili di ambiente utilizzate per personalizzare il comportamento nell'istanza del servizio. Oppure puoi ignorare questa fase.

  7. Per Name your service (Assegna un nome al servizio), inserisci un nome univoco senza spazi e premi Invio.

  8. Per Select instance configuration (Seleziona configurazione dell'istanza), scegli una combinazione di unità CPU e memoria in GB per la tua istanza di servizio.

    Quando il servizio viene creato, il suo stato cambia da Creating (Creazione in corso) a Running (In esecuzione).

  9. Appena il servizio è in esecuzione, fai clic con il pulsante destro del mouse e scegli Copy Service URL (Copia URL del servizio).

  10. Per accedere all'applicazione implementata, incolla l'URL copiato nella barra degli indirizzi del browser Web.

Nota

Se il tentativo di creare un servizio App Runner non riesce, il servizio mostra lo stato Create failed (Creazione non riuscita) in AWS Explorer. Per suggerimenti sulla risoluzione dei problemi, consulta Quando la creazione del servizio non riesce nella Guida per gli sviluppatori di App Runner.