Creazione di servizi App Runner - AWSToolkit 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 Explorer e AWSla palette dei comandi di VS Code. Dopo aver scelto di creare un servizio in una AWS regione specifica, i passaggi numerati forniti da Command Palette guidano l'utente attraverso il processo di configurazione dell'istanza del servizio su 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. Aprire AWS Explorer, se non è già aperto.

  2. Fai clic con il pulsante destro del mouse sul nodo App Runner e scegli Create Service (Crea servizio).

    Viene visualizzata la palette 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 GitHubcome provider 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 Command Palette presenta una linea diagonale che la attraversa. 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 non sono stati trovati tag, è necessario tornare indietro di un passaggio per selezionare un repository che contenga un'immagine del contenitore con tag.

  3. Se utilizzi un registro privato Amazon ECR, hai bisogno del ruolo di accesso ECR, AppRunnerECR AccessRole, che consente ad App Runner di accedere alle immagini di Amazon Elastic Container Registry (Amazon ECR) nel tuo account. Scegli l'icona «+» nell'intestazione 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 collegareAWS. 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 l'archivio 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.