Crea un'app di runtime personalizzata nell'ambiente flessibile di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono apparire simili ai codici di paese e provincia di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID regione è facoltativo nell'URL.

I runtime personalizzati consentono di creare app eseguite in un ambiente definito da un Dockerfile. Se utilizzi un Dockerfile, puoi utilizzare pacchetti e linguaggi che non fanno parte di Google Cloud e usufruire delle stesse risorse e degli stessi strumenti usati nell'ambiente flessibile di App Engine.

In questa guida rapida, un server web nginx viene lanciato in App Engine utilizzando un runtime personalizzato.

Prima di iniziare

Prima di eseguire l'app di esempio in questa guida rapida, devi configurare il tuo ambiente e creare un nuovo progetto Google Cloud per App Engine:

  1. Crea un nuovo progetto Google Cloud utilizzando la console Google Cloud:

    1. Apri la console Google Cloud:

      Vai alla pagina Progetti

    2. Fai clic su Crea progetto e assegna un nome al nuovo progetto Google Cloud.

    3. Abilita la fatturazione nel tuo nuovo progetto Google Cloud creando un nuovo account di fatturazione o impostandone uno esistente:

      Vai alla pagina Fatturazione

  2. Scarica e installa Google Cloud CLI, quindi inizializza gcloud CLI:

    Scarica l'SDK

  3. Esegui questo comando gcloud per creare un'applicazione App Engine e specificare in quale regione vuoi eseguire l'app:

    gcloud app create

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le app si trova in una regione specifica e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare la regione in cui vengono eseguite le app. In genere, puoi selezionare la regione più vicina agli utenti della tua app, ma devi considerare le località in cui è disponibile App Engine e le località degli altri prodotti e servizi Google Cloud utilizzati dalla tua app. L'utilizzo di servizi in più località può influire sulla latenza della tua app e sui relativi pricing.

Non puoi modificare la regione di un'app dopo averla impostata.

Se hai già creato un'applicazione App Engine, puoi visualizzarne l'area geografica in uno dei seguenti modi:

scarica l'app Hello World

  1. Scegli una delle seguenti opzioni per scaricare l'app di esempio Hello World da GitHub sulla tua macchina locale:

    • Clona l'app di esempio Hello World dal seguente repository:

      git clone https://github.com/GoogleCloudPlatform/appengine-custom-runtimes-samples

    • Scarica l'esempio come file .zip, quindi estrailo in una directory locale.

  2. Vai alla directory nginx in cui si trova il codice campione, ad esempio:

    cd appengine-custom-runtimes-samples/nginx

Esecuzione di Hello World sulla macchina locale

Puoi testare l'app di esempio scaricando e installando Docker, quindi eseguendo il container Hello World sulla tua macchina locale.

Non ci sono passaggi specifici per App Engine, quindi puoi testare l'app di esempio utilizzando gli strumenti e l'approccio che preferisci.

Deployment di Hello World in App Engine

Quando è tutto pronto per eseguire il deployment dell'app di esempio in App Engine, esegui questi passaggi:

  1. Dalla directory in cui si trovano app.yaml e Dockerfile, esegui questo comando:

    gcloud app deploy

    Scopri di più sui flag facoltativi.

  2. Per vedere la tua app in esecuzione su https://PROJECT_ID.REGION_ID.r.appspot.com, esegui questo comando per avviare il browser:

    gcloud app browse

Flag comuni del comando gcloud

  • Includi il flag --version per specificare un ID che identifichi in modo univoco quella versione della tua app, altrimenti ne viene generato uno per te. Esempio: --version [YOUR_VERSION_ID]
  • Includi il flag --project per specificare un ID progetto Google Cloud alternativo a quello che hai inizializzato come predefinito nello strumento gcloud. Esempio: --project [YOUR_PROJECT_ID]

Esempio:

gcloud app deploy --version pre-prod-5 --project my-sample-app

Per scoprire di più sul deployment dell'app dalla riga di comando, consulta Test e deployment dell'app . Per un elenco di tutti i flag dei comandi, consulta la documentazione di riferimento gcloud app deploy.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Scopri di più sui Dockerfile, consulta il riferimento Dockerfile.

Per informazioni su come creare il tuo runtime personalizzato, consulta Creazione di runtime personalizzati.

Revisione del codice

Hello World è l'app App Engine più semplice possibile, in quanto crea un singolo container che esegue solo un servizio e una versione. Questa sezione descrive in dettaglio ogni file dell'app.

app.yaml

Specifica la configurazione dell'app. Il file app.yaml deve trovarsi nella stessa directory del file Dockerfile.

runtime: custom
env: flex

La voce runtime: custom indica ad App Engine di cercare un elemento Dockerfile che definisca l'immagine del runtime, mentre env: flex specifica che stai eseguendo il deployment nell'ambiente flessibile.

Per maggiori informazioni, consulta la documentazione di app.yaml.

Dockerfile

Definisce il set di istruzioni utilizzate per creare l'immagine Docker per il container dell'app di esempio. Il file Dockerfile deve trovarsi nella stessa directory del file app.yaml. Questo Dockerfile installa il server web nginx e copia alcune configurazioni di base:

# The standard nginx container just runs nginx. The configuration file added
# below will be used by nginx.
FROM nginx

# Copy the nginx configuration file. This sets up the behavior of nginx, most
# importantly, it ensure nginx listens on port 8080. Google App Engine expects
# the runtime to respond to HTTP requests at port 8080.
COPY nginx.conf /etc/nginx/nginx.conf

# create log dir configured in nginx.conf
RUN mkdir -p /var/log/app_engine

# Create a simple file to handle health checks. Health checking can be disabled
# in app.yaml, but is highly recommended. Google App Engine will send an HTTP
# request to /_ah/health and any 2xx or 404 response is considered healthy.
# Because 404 responses are considered healthy, this could actually be left
# out as nginx will return 404 if the file isn't found. However, it is better
# to be explicit.
RUN mkdir -p /usr/share/nginx/www/_ah && \
    echo "healthy" > /usr/share/nginx/www/_ah/health

# Finally, all static assets.
ADD www/ /usr/share/nginx/www/
RUN chmod -R a+r /usr/share/nginx/www

Il comando FROM crea un'immagine di base utilizzando l'immagine Docker ufficiale per il server web nginx.

Con questo Dockerfile, l'immagine container conterrà nginx e tutti i contenuti della directory www/ saranno disponibili per la tua applicazione.

L'app di esempio Hello World include anche un file nginx.conf, che contiene le informazioni di configurazione di base di nginx, nonché il file index.html, che funge da pagina radice per il server web nginx.