Se hai attivato le implementazioni automatiche, ogni volta che esegui il push di un nuovo commit nel ramo attivo del tuo repository GitHub, App Hosting esegue automaticamente l'implementazione di una nuova versione della tua app. Puoi controllare lo stato dell'implementazione nella console Firebase o nel controllo GitHub App Hosting.
Inoltre, App Hosting supporta le implementazioni attivate manualmente per l'integrazione CI/CD o per qualsiasi altro caso in cui vuoi forzare un'implementazione.
Visualizzare le implementazioni
La console Firebase fornisce l'accesso a informazioni dettagliate su tutti i rollout della tua app. In App Hosting, seleziona Visualizza per il backend di cui vuoi visualizzare i rollout. La scheda Implementazioni per il backend mostra una tabella che elenca la cronologia di tutte le implementazioni per questo backend.
Ogni voce di implementazione contiene link al job Cloud Build e alla modifica o al commit che ha attivato l'implementazione, oltre a informazioni di base sull'autore, sulla data di creazione e sullo stato dell'implementazione.
- Il job Cloud Build è l'ambiente di compilazione in cui App Hosting esegue il comando di compilazione della tua app. Puoi accedere ai log Cloud Build facendo clic sull'ID build.
- La modifica è il commit di GitHub o un'altra azione che ha attivato il rollout.
Attivare manualmente un'implementazione
Se vuoi attivare manualmente un'implementazione dall'origine GitHub senza spingere un nuovo commit, puoi creare un'implementazione dalla console Firebase o dalla CLI Firebase. Questa opzione è utile in casi come:
- Forzare la rigenerazione di contenuti statici.
- Consentire a un sistema CI/CD di attivare le implementazioni.
- Limitare i rollout di produzione a date o orari specifici.
Per attivare un'implementazione nella console Firebase:
- In App Hosting, seleziona Visualizza per il backend per cui vuoi creare un'implementazione.
- Nel riepilogo della dashboard di backend, seleziona Crea implementazione.
- Seleziona il ramo da eseguire.
- Seleziona il commit da eseguire il deployment, ovvero l'ultimo commit o un commit precedente specificato dal relativo ID commit.
- Seleziona Crea. Lo stato e un numero di build per l'implementazione vengono visualizzati nella tabella della cronologia dell'implementazione. Al termine del processo di implementazione, questo viene visualizzato come implementazione corrente.
Per attivare un'implementazione nell'interfaccia a riga di comando Firebase, esegui il seguente comando e seleziona il ramo per l'implementazione quando richiesto:
firebase apphosting:rollouts:create BACKEND_ID
In alternativa, puoi avviare l'implementazione dell'ultimo commit per un ramo specifico utilizzando l'opzione --git-branch:
firebase apphosting:rollouts:create BACKEND_ID
--git_branch BRANCH_NAME
Puoi anche creare un implementazione con un commit specifico utilizzando l'opzione --git-commit:
firebase apphosting:rollouts:create BACKEND_ID
--git_commit COMMIT_ID
Ripristinare un rollout precedente
App Hosting offre due opzioni per ripristinare un rollout precedente:
- Esegui il rollback immediatamente senza ricostruire
- Ricostruire ed eseguire il rollback a una versione precedente
Crea un rollback istantaneo
A volte potresti dover ripristinare rapidamente una versione precedente dell'app, ad esempio se hai rilevato un bug critico in un'implementazione appena eseguita o se stai riscontrando un problema di build che blocca i nuovi implementazioni. In questi casi, puoi ripristinare un'immagine container esistente di tua scelta da un rollout precedente. Questa immagine non viene ricostruita, ma utilizza il codice e la configurazione dell'ambiente della prima compilazione.
Per creare un rollback istantaneo:
- In App Hosting, seleziona Visualizza per il backend per cui vuoi creare un rollback.
- Seleziona la scheda Implementazioni.
- Nella tabella Cronologia per il backend, seleziona il menu con tre puntini per una build precedente.
- Seleziona Esegui il rollback a questa build e conferma.
Ricostruisci e esegui il rollback
Se vuoi ripristinare una versione precedente dell'app, ma mantenere la configurazione attuale, puoi ricostruire l'app nell'ambito della procedura di rollback. Ad esempio, se la versione più recente ha aggiornato un valore della chiave API in Secret Manager, la ricostruzione può garantire che la nuova chiave venga utilizzata nell'app dopo il rollback.
Per eseguire la ricostruzione e il rollback:
- In App Hosting, seleziona Visualizza dashboard per il backend per cui vuoi creare un rollback.\
- Seleziona la scheda Implementazioni.
- Seleziona Crea implementazione.
- Nella finestra di dialogo Crea un rollout, seleziona Commit precedente e inserisci l'ID commit della versione di cui vuoi eseguire il ricostruzioni e il rollback. L'ID commit fa parte della sezione "Dettagli della modifica" per ogni implementazione elencata nella cronologia delle implementazioni,racchiuso tra parentesi nell'etichetta.
- Seleziona Crea per iniziare il rollback.
Modificare le impostazioni di implementazione
Puoi modificare il ramo attivo per le implementazioni e disattivare o attivare le implementazioni automatiche utilizzando i controlli nella visualizzazione Impostazioni > Deployment della dashboard per un backend.
- In App Hosting, seleziona Visualizza per il backend in cui vuoi aggiornare le impostazioni di implementazione.
- Nella dashboard di backend, seleziona Impostazioni. La visualizzazione predefinita mostra informazioni su domini e domini personalizzati.
- Seleziona la visualizzazione Deployment. In questa visualizzazione, puoi modificare il ramo attivo per le implementazioni e disattivare o attivare le implementazioni automatiche. Inoltre, esistono opzioni per impostare la home directory dell'app e l'ambiente per il backend (vedi Eseguire il deployment in più ambienti).