Distribuzione di una nuova versione dell'applicazione su App Runner

Quando crei un servizio in AWS App Runner, configuri un'origine dell'applicazione, un'immagine del contenitore o un repository di origine. App Runner fornisce le risorse per eseguire il servizio e distribuisce l'applicazione su di esse.

Questo argomento descrive i modi per ridistribuire l'origine dell'applicazione sul servizio App Runner quando diventa disponibile una nuova versione. Può trattarsi di una nuova versione dell'immagine nell'archivio delle immagini o di un nuovo commit nell'archivio del codice. App Runner offre due metodi per l'implementazione su un servizio: automatico e manuale.

Metodi di distribuzione

App Runner offre i seguenti metodi per controllare come vengono avviate le distribuzioni delle applicazioni.

Distribuzione automatica

Utilizza la distribuzione automatica quando desideri un comportamento di integrazione e distribuzione continue (CI/CD) per il tuo servizio. App Runner monitora l'archivio di immagini o codice per rilevare eventuali modifiche.

Archivio di immagini: ogni volta che inserisci una nuova versione di immagine nel tuo archivio di immagini o un nuovo commit nel tuo repository di codice, App Runner la distribuisce automaticamente al tuo servizio senza ulteriori azioni da parte tua.

Archivio di codice: ogni volta che inserisci un nuovo commit nel tuo repository di codice che apporta modifiche nella directory dei sorgenti, App Runner distribuisce l'intero repository. Poiché solo le modifiche nella directory di origine attivano una distribuzione automatica, è importante capire in che modo la posizione della directory di origine influisce sull'ambito di una distribuzione automatizzata.

• Directory di primo livello (radice del repository): questo è il valore predefinito impostato per la directory di origine quando si crea un servizio. Se la directory di origine è impostata su questo valore, significa che l'intero repository si trova all'interno della directory dei sorgenti. Quindi, in questo caso, tutti i commit che invii al repository di origine attiveranno una distribuzione.

• Qualsiasi percorso di directory che non sia la radice del repository (impostazione non predefinita): poiché solo le modifiche inserite nella directory di origine attivano una distribuzione automatica, qualsiasi modifica inserita nel repository che non si trova nella directory di origine non attiverà una distribuzione automatica. Pertanto, è necessario utilizzare una distribuzione manuale per distribuire le modifiche che si inseriscono all'esterno della directory di origine.

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.

Distribuzione manuale

Utilizza la distribuzione manuale quando desideri avviare in modo esplicito ogni distribuzione del tuo servizio. Si avvia una distribuzione se il repository configurato per il servizio ha una nuova versione che si desidera distribuire. Per ulteriori informazioni, consulta Distribuzione manuale.

Nota

Quando esegui una distribuzione manuale, App Runner distribuisce il codice sorgente dall'archivio completo.

È possibile configurare il metodo di distribuzione per il servizio nei seguenti modi:

• Console: per un nuovo servizio che stai creando o per un servizio esistente, nella sezione Impostazioni di distribuzione della pagina di configurazione di origine e distribuzione, scegli Manuale o Automatico.

  

• API o AWS CLI: in una chiamata all'UpdateServiceazione CreateServiceo, imposta il AutoDeploymentsEnabled membro del SourceConfigurationparametro per la distribuzione manuale o False True per la distribuzione automatica.

Confronto tra distribuzioni automatiche e manuali

Sia le implementazioni automatiche che quelle manuali producono lo stesso risultato: entrambi i metodi distribuiscono l'intero repository.

La differenza tra i due metodi è il meccanismo di attivazione:

• Le distribuzioni manuali vengono attivate da una distribuzione dalla console, da una chiamata all'API App Runner o da una chiamata all' AWS CLI API App Runner. La Distribuzione manuale sezione che segue fornisce le relative procedure.

• Le distribuzioni automatiche vengono attivate da una modifica del contenuto della directory di origine.

Distribuzione manuale

Con la distribuzione manuale, è necessario avviare esplicitamente ogni implementazione del servizio. Quando hai una nuova versione dell'immagine o del codice dell'applicazione pronta per la distribuzione, puoi fare riferimento alle seguenti sezioni per scoprire come eseguire una distribuzione utilizzando la console e l'API.

Nota

Quando si esegue una distribuzione manuale, App Runner distribuisce il codice sorgente dall'archivio completo.

Distribuisci una versione dell'applicazione utilizzando uno dei seguenti metodi:

App Runner console

Per eseguire la distribuzione utilizzando la console App Runner

1. Apri la console App Runner e, nell'elenco Regioni, seleziona la tua. Regione AWS

2. Nel pannello di navigazione, scegli Servizi, quindi scegli il servizio App Runner.

   La console mostra la dashboard del servizio con una panoramica del servizio.

   

3. Seleziona Deploy (Implementa).

   Risultato: inizia la distribuzione della nuova versione. Nella pagina del dashboard del servizio, lo stato del servizio cambia in Operazione in corso.

4. Attendi il termine della distribuzione. Nella pagina del pannello di controllo del servizio, lo stato del servizio dovrebbe tornare in esecuzione.

5. Per verificare che l'implementazione abbia esito positivo, nella pagina del pannello di controllo del servizio, scegli il valore di dominio predefinito, che è l'URL del sito Web del servizio. Ispeziona o interagisci con la tua applicazione web e verifica la modifica della versione.

   Nota

   Per aumentare la sicurezza delle applicazioni App Runner, il dominio*.awsapprunner.com è registrato nella Public Suffix List (PSL). Per una maggiore sicurezza, ti consigliamo di utilizzare i cookie con un __Host- prefisso se hai bisogno di impostare cookie sensibili nel nome di dominio predefinito per le tue applicazioni App Runner. Questa pratica ti aiuterà a difendere il tuo dominio dai tentativi CSRF (cross-site request forgery). Per ulteriori informazioni, consulta la pagina Impostazione cookie nella pagina Mozilla Developer Network.

App Runner API or AWS CLI

Per eseguire la distribuzione utilizzando l'API App Runner oppure AWS CLI, richiama l'azione API. StartDeployment L'unico parametro da passare è l'ARN del servizio. Hai già configurato la posizione di origine dell'applicazione quando hai creato il servizio e App Runner può trovare la nuova versione. La distribuzione inizia se la chiamata restituisce una risposta corretta.