La gestione dei siti web può essere difficile con tutto il carico di lavoro connesso alla creazione e alla gestione di istanze di macchine virtuali (VM), cluster, pod, servizi e altro ancora. Questo può essere ragionevole per applicazioni multilivello di grandi dimensioni, ma se il tuo obiettivo è semplicemente quello di eseguire il deployment del sito web e renderlo visibile, il carico di lavoro è davvero eccessivo.
Con Cloud Run, l'implementazione Google Cloud di Knative, puoi gestire il tuo sito web ed eseguirne il deployment senza alcun overhead di cui hai bisogno per i deployment basati su VM o Kubernetes. Questo approccio semplifica la gestione e consente anche di "scalare fino a zero" quando non arrivano richieste al sito web.
Cloud Run non solo porta lo sviluppo serverless ai container, ma può anche essere eseguito su cluster Google Kubernetes Engine (GKE) o su una soluzione PaaS (Platform as a Service) completamente gestita fornita da Cloud Run. In questo codelab testerai quest'ultimo scenario.
Il seguente diagramma illustra il flusso del deployment e dell'hosting in Cloud Run. Inizierai con un'immagine Docker creata tramite Cloud Build, che attiverai in Cloud Shell. Quindi, esegui il deployment dell'immagine in Cloud Run con un comando in Cloud Shell.
Prerequisiti
- Familiarità generale con Docker (vedi la sezione Guida introduttiva del sito web di Docker).
Obiettivi didattici
- Creare un'immagine Docker con Cloud Build e caricarla in gcr.io
- Eseguire il deployment delle immagini Docker in Cloud Run
- Gestire i deployment di Cloud Run
- Come configurare un endpoint per un'app su Cloud Run
Cosa creerai
- Un sito web statico eseguito all'interno di un container Docker
- Una versione di questo contenitore che si trova in Container Registry
- Un deployment di Cloud Run per il tuo sito web statico
Che cosa ti serve
- Un Account Google con accesso amministrativo per creare progetti o un progetto con ruolo di proprietario del progetto.
Configurazione dell'ambiente autonomo
Se non hai ancora un Account Google, devi crearne uno. Poi, accedi alla console Google Cloud e fai clic su Progetto > Crea progetto.
Ricorda l'ID progetto, che viene compilato automaticamente sotto il nome del progetto. L'ID progetto è un nome univoco tra tutti i progetti Google Cloud, quindi il nome nello screenshot è già stato utilizzato e non funzionerà per te. In seguito verrà chiamato PROJECT_ID.
Successivamente, devi abilitare la fatturazione in Cloud Console per utilizzare le risorse Google Cloud e abilitare l'API Cloud Run.
Abilita l'API Cloud Run
Fai clic su menu di navigazione ☰ > API e servizi > Dashboard > Abilita API e servizi. .
Cerca "API Cloud Run", poi fai clic su API Cloud Run > Abilita.
L'esecuzione di questo codelab non dovrebbe costarti più di qualche dollaro, ma potrebbe essere più cara se decidi di utilizzare più risorse o se le lasci in esecuzione (vedi Pulizia alla fine). Per ulteriori informazioni, vedi Prezzi.
I nuovi utenti di Google Cloud possono beneficiare di una prova senza costi di 300$.
Cloud Shell
Anche se Google Cloud e Cloud Run possono essere gestiti da remoto dal tuo laptop, utilizzerai Cloud Shell, un ambiente a riga di comando in esecuzione in Google Cloud. L'ambiente è preconfigurato con tutte le librerie client e i framework necessari.
Questa macchina virtuale basata su Debian viene caricata con tutti gli strumenti di sviluppo di cui avrai bisogno. Offre una home directory permanente da 5 GB e viene eseguita su Google Cloud, migliorando notevolmente le prestazioni di rete e l'autenticazione. Ciò significa che per questo codelab ti servirà solo un browser (sì, funziona su Chromebook).
Per attivare Google Cloud Shell, fai clic sul pulsante in alto a destra della console per gli sviluppatori (il provisioning e la connessione all'ambiente richiedono solo pochi istanti):
Fai clic sul pulsante "Avvia Cloud Shell":
Una volta eseguita la connessione a Cloud Shell, dovresti vedere che il tuo account è già autenticato e il progetto è già impostato sul tuo PROJECT_ID :
gcloud auth list
Output comando
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
Output comando
[core] project = <PROJECT_ID>
Cloud Shell imposta anche alcune variabili di ambiente per impostazione predefinita, che potrebbero essere utili quando esegui comandi futuri.
echo $GOOGLE_CLOUD_PROJECT
Output comando
<PROJECT_ID>
Se per qualche motivo il progetto non è impostato, esegui questo comando :
gcloud config set project <PROJECT_ID>
Stai cercando PROJECT_ID? Controlla l'ID che hai utilizzato nei passaggi di configurazione o cercalo nella dashboard della console:
IMPORTANTE: infine, imposta la zona e la configurazione del progetto predefinite:
gcloud config set compute/zone us-central1-f
Puoi scegliere tra una serie di zone diverse. Puoi trovare ulteriori informazioni nella documentazione relativa alle regioni e alle zone.
Dato che stai eseguendo il deployment di un sito web esistente, devi solo clonare l'origine dal repository per concentrarti sulla creazione di immagini Docker e sul deployment in Cloud Run.
Esegui i comandi seguenti per clonare il repository nell'istanza di Cloud Shell e passare alla directory appropriata. Installerai anche le dipendenze Node.js in modo da poter testare l'app prima del deployment.
cd ~ git clone https://github.com/googlecodelabs/monolith-to-microservices.git cd ~/monolith-to-microservices ./setup.sh
che clona il repository, passa alla directory e installa le dipendenze necessarie per eseguire l'app localmente. L'esecuzione dello script potrebbe richiedere alcuni minuti.
Esegui la due diligence e testa l'app. Esegui questo comando per avviare il server web:
cd ~/monolith-to-microservices/monolith npm start
Output:
Monolith listening on port 8080!
Puoi visualizzare l'anteprima dell'app facendo clic su Anteprima web 
e selezionando Anteprima sulla porta 8080.
Si apre una nuova finestra in cui puoi vedere il tuo Fancy Store in azione.
Puoi chiudere questa finestra dopo aver visualizzato il sito web. Per arrestare il processo del server web, premi CONTROL+C (Command+C su Macintosh) nella finestra del terminale.
Ora che i file sorgente sono pronti per l'uso, puoi "dockerizzare" l'app.
Normalmente, dovresti adottare un approccio in due fasi che prevede la creazione di un container Docker e il relativo push a un registry per archiviare l'immagine da cui GKE esegue il pull. Tuttavia, puoi semplificare la procedura utilizzando Cloud Build per creare il container Docker e inserire l'immagine in Container Registry con un unico comando. Per visualizzare il processo manuale di creazione di un Dockerfile e del relativo push, consulta la Guida rapida per Container Registry.
Cloud Build comprime i file della directory e li sposta in un bucket Cloud Storage. Il processo di compilazione acquisisce quindi tutti i file dal bucket e utilizza il Dockerfile presente nella stessa directory per eseguire il processo di compilazione Docker. Dato che hai specificato il flag --tag con l'host gcr.io per l'immagine Docker, verrà eseguito il push dell'immagine Docker risultante in Container Registry.
Innanzitutto, devi assicurarti di aver abilitato l'API Cloud Build. Esegui il comando seguente per abilitarla:
gcloud services enable cloudbuild.googleapis.com
Una volta abilitata l'API, esegui questo comando in Cloud Shell per avviare il processo di compilazione:
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 .Il processo richiede qualche minuto, ma al termine verrà restituito un output simile al seguente nel terminale:
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ID CREATE_TIME DURATION SOURCE IMAGES STATUS 1ae295d9-63cb-482c-959b-bc52e9644d53 2019-08-29T01:56:35+00:00 33S gs://<PROJECT_ID>_cloudbuild/source/1567043793.94-abfd382011724422bf49af1558b894aa.tgz gcr.io/<PROJECT_ID>/monolith:1.0.0 SUCCESS
Per visualizzare la cronologia delle build o osservare lo svolgimento del processo in tempo reale, vai alla console Cloud, quindi fai clic su Menu di navigazione ☰ > Cloud Build > Cronologia. Qui puoi vedere un elenco di tutte le build precedenti. Dovrebbe essere riportata solo quella che hai creato.
Se fai clic sull'ID build, vedrai tutti i dettagli relativi a quella build, incluso l'output del log. Puoi visualizzare l'immagine container creata facendo clic sul link accanto a Immagine.
Ora che hai containerizzato il sito web e hai eseguito il push in Container Registry, è il momento di eseguire il deployment in Cloud Run.
Per il deployment in Cloud Run è possibile scegliere tra due approcci:
- Cloud Run (completamente gestito) è il modello PaaS in cui viene gestito l'intero ciclo di vita del container. Utilizzerai questo approccio per questo codelab.
- Cloud Run for Anthos è Cloud Run con un livello di controllo aggiuntivo, che ti consente di utilizzare i tuoi cluster e pod da GKE. Per saperne di più, vedi Configurazione di Cloud Run for Anthos su Google Cloud.
Gli esempi di riga di comando saranno in Cloud Shell utilizzando le variabili di ambiente che hai configurato in precedenza.
Riga di comando
Esegui questo comando per eseguire il deployment dell'app:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed Ti verrà chiesto di specificare l'area geografica per l'esecuzione. Seleziona la regione più vicina a te, poi accetta il nome del servizio suggerito predefinito (monolith).
Ai fini del test, consenti le richieste non autenticate all'app. Inserisci y al prompt.
Verifica il deployment
Per verificare che il deployment sia stato creato correttamente, esegui questo comando. Potrebbero essere necessari alcuni istanti prima che Pod status diventi Running:
gcloud run services list
Seleziona [1] Cloud Run (completamente gestito).
Output:
SERVICE REGION URL LAST DEPLOYED BY LAST DEPLOYED AT ✔ monolith us-east1 <your url> <your email> 2019-09-16T21:07:38.267Z
L'output mostra quanto segue: Puoi vedere il deployment, nonché l'utente che lo ha eseguito (il tuo indirizzo email) e l'URL da usare per accedere all'app. Sembra che tutto sia stato creato correttamente.
Apri l'URL fornito nell'elenco dei servizi nel browser web e dovresti vedere lo stesso sito web di cui hai visualizzato l'anteprima in locale.
Ora esegui di nuovo il deployment dell'app, ma questa volta regolando uno dei parametri.
Per impostazione predefinita, un'app Cloud Run avrà un valore di contemporaneità pari a 80, che significa che ogni istanza di container gestirà fino a 80 richieste alla volta. È una differenza considerevole rispetto al modello Functions as a Service (FaaS), in cui ogni istanza gestisce una richiesta alla volta.
Esegui nuovamente il deployment della stessa immagine container con un valore di contemporaneità pari a 1 (solo a scopo di test) e guarda cosa succede.
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 1Rispondi alle domande successive come hai già fatto la prima volta. Quando il comando ha esito positivo, controlla la console Cloud per visualizzare il risultato.
Nella dashboard Cloud Run, fai clic sul servizio monolith per visualizzare i dettagli.
Fai clic sulla scheda Revisioni. Dovresti vedere due revisioni create. Fai clic su monolith-00002 ed esamina i dettagli. Dovresti vedere che il valore di contemporaneità si è ridotto a 1.
]
Anche se questa configurazione è sufficiente a scopo di test, nella maggior parte degli scenari di produzione saranno presenti container che supportano più richieste in contemporanea.
A questo punto, ripristina la contemporaneità originale senza ripetere il deployment. Puoi impostare il valore di contemporaneità su 80 o 0, in modo da rimuovere tutte le limitazioni di contemporaneità e impostare il valore massimo predefinito, ovvero 80 al momento della stesura di questo articolo.
Esegui questo comando in Cloud Shell per aggiornare la revisione corrente:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 80Noterai che è stata creata un'altra revisione, il traffico è stato reindirizzato e la contemporaneità è di nuovo impostata su 80.
Il team di marketing ti ha chiesto di modificare la home page del sito web della tua azienda. Secondo il team, dovrebbe essere più ricca di informazioni relative all'azienda e a ciò che commercializza. In questa sezione, aggiungerai del testo alla home page per soddisfare la richiesta del team di marketing.
Uno dei tuoi sviluppatori ha già creato le modifiche in un file denominato index.js.new. Puoi semplicemente copiare questo file in index.js per riflettere le modifiche. Segui le istruzioni per apportare le modifiche appropriate.
Esegui i comandi seguenti, copia il file aggiornato nel file corretto e stampane il contenuto per controllare le modifiche:
cd ~/monolith-to-microservices/react-app/src/pages/Home mv index.js.new index.js cat ~/monolith-to-microservices/react-app/src/pages/Home/index.js
Il codice risultante dovrebbe avere l'aspetto seguente:
/*
Copyright 2019 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
import React from "react";
import { makeStyles } from "@material-ui/core/styles";
import Paper from "@material-ui/core/Paper";
import Typography from "@material-ui/core/Typography";
const useStyles = makeStyles(theme => ({
root: {
flexGrow: 1
},
paper: {
width: "800px",
margin: "0 auto",
padding: theme.spacing(3, 2)
}
}));
export default function Home() {
const classes = useStyles();
return (
<div className={classes.root}>
<Paper className={classes.paper}>
<Typography variant="h5">
Fancy Fashion & Style Online
</Typography>
<br />
<Typography variant="body1">
Tired of mainstream fashion ideas, popular trends and societal norms?
This line of lifestyle products will help you catch up with the Fancy trend and express your personal style.
Start shopping Fancy items now!
</Typography>
</Paper>
</div>
);
}Hai aggiornato i componenti React, ma devi creare la build dell'app React per generare i file statici. Esegui questo comando per creare la build dell'app React e copiarla nella directory pubblica del monolite:
cd ~/monolith-to-microservices/react-app npm run build:monolith
Ora che il codice è aggiornato, devi ricreare il container Docker e pubblicarlo in Container Registry. Puoi usare lo stesso comando di prima, aggiornando però l'etichetta della versione.
Esegui questo comando per attivare un nuovo processo Cloud Build con una versione aggiornata 2.0.0 dell'immagine:
cd ~/monolith-to-microservices/monolith
#Feel free to test your application
npm start
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 .Nella sezione successiva, utilizzerai questa immagine per aggiornare l'app senza tempi di inattività.
Le modifiche sono state completate e il team di marketing è molto soddisfatto dei tuoi aggiornamenti. Ora è il momento di aggiornare il sito web senza interruzioni per gli utenti.
Cloud Run considera ogni deployment come una nuova revisione, che viene portata online e poi riceve il traffico reindirizzato.
Segui le istruzioni riportate di seguito per aggiornare il tuo sito web.
Riga di comando
Dalla riga di comando, puoi ripetere il deployment del servizio per aggiornare l'immagine a una nuova versione con il comando seguente:
gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --platform managedVerifica il deployment
Convalida l'aggiornamento del deployment eseguendo questo comando:
gcloud run services describe monolith --platform managed
L'output ha il seguente aspetto:
apiVersion: serving.knative.dev/v1alpha1
kind: Service
metadata:
annotations:
client.knative.dev/user-image: gcr.io/my-cloudrun-codelab/monolith:2.0.0
...
Vedrai che il servizio ora utilizza la versione più recente dell'immagine di cui è stato eseguito il deployment in una nuova revisione.
Per verificare le modifiche, torna all'URL esterno del servizio Cloud Run e nota che il titolo dell'app è stato aggiornato.
Esegui questo comando per elencare i servizi e visualizzare l'indirizzo IP se lo hai dimenticato:
gcloud run services list
Nel sito web dovrebbe essere presente il testo che hai aggiunto al componente della home page.
Elimina le immagini Container Registry
# Delete the container image for version 1.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --quiet
# Delete the container image for version 2.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --quietElimina gli artefatti di Cloud Build da Cloud Storage
# The following command will take all source archives from all builds and delete them from cloud storage
# Run this command to print all sources:
# gcloud builds list | awk 'NR > 1 {print $4}'
gcloud builds list | awk 'NR > 1 {print $4}' | while read line; do gsutil rm $line; doneElimina servizio Cloud Run
gcloud run services delete monolith --platform managed
Hai eseguito il deployment del sito web, lo hai reso scalabile e lo hai aggiornato con Cloud Run.