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

ID regione

L'REGION_ID è un codice abbreviato che Google assegna in base alla regione selezionata quando crei l'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici di paesi e province 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 ti consentono di creare app che vengono eseguite in un ambiente definito da un Dockerfile. Utilizzando un Dockerfile, puoi utilizzare linguaggi e pacchetti che non fanno parte del Google Cloud e utilizzare le stesse risorse e gli stessi strumenti utilizzati nell' ambiente flessibile di App Engine.

In questa guida rapida, un server web nginx viene avviato 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 Google Cloud progetto per App Engine:

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

    1. Apri la Google Cloud console:

      Vai a Progetti

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

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

      Vai a Fatturazione

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

    Scarica l'SDK

  3. Esegui il seguente gcloud comando per creare un'applicazione App Engine e specificare in quale regione geografica vuoi che venga eseguita l'app:

    gcloud app create
  4. A causa delle modifiche al comportamento predefinito di utilizzo dei service account di Cloud Build nei nuovi progetti e delle modifiche alle policy dell'organizzazione secure-by-default, potresti dover concedere ruoli aggiuntivi al account di servizio di deployment. Per ulteriori informazioni sulla concessione di ruoli specifici, consulta la guida alla risoluzione dei problemi.

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le tue app si trova in una regione specifica ed è gestita da Google 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 primari per la selezione della regione in cui vengono eseguite le tue app. In genere puoi selezionare la regione più vicina agli utenti della tua app, ma devi considerare le località in cui App Engine è disponibile nonché le località degli altri Google Cloud prodotti e servizi utilizzati dalla tua app. L'utilizzo di servizi in più località può influire sulla latenza dell'app, nonché sui prezzi.

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

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione 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 ed 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

Eseguire 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 sono previsti passaggi specifici di App Engine, quindi puoi testare l'app di esempio utilizzando gli strumenti e l'approccio che preferisci.

Eseguire il deployment di Hello World in App Engine

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

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

    gcloud app deploy

    Scopri di più sui flag facoltativi.

  2. Per visualizzare l'app in esecuzione all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com, esegui il seguente comando per avviare il browser:

    gcloud app browse

Flag comuni dei comandi gcloud

  • Includi il flag --version per specificare un ID che identifica in modo univoco la versione dell'app. In caso contrario, ne viene generato uno automaticamente. Esempio: --version [YOUR_VERSION_ID]
  • Includi il flag --project per specificare un ID progetto alternativo Google Cloud a quello 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 Testare ed eseguire il deployment dell'app . Per un elenco di tutti i flag dei comandi, consulta il riferimento gcloud app deploy.

Libera spazio

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

  1. Nella Google Cloud console, 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 progetto, quindi fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Scopri di più sui Dockerfile nel riferimento a Dockerfile.

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

Revisione del codice

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

app.yaml

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

runtime: custom
env: flex

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

Per ulteriori informazioni, consulta il app.yaml riferimento.

Dockerfile

Definisce l'insieme di istruzioni utilizzate per creare l'immagine Docker per il container dell'app di esempio. Il file Dockerfile deve risiedere 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.

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

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