Crea un'app Go nell'ambiente flessibile di App Engine

Crea un'app Go nell'ambiente flessibile di App Engine

ID regione

REGION_ID è un codice abbreviato che Google assegna in base alla regione selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono sembrare simili ai codici 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.

Scopri di più sugli ID regione.

Ok

Questa guida rapida illustra come creare ed eseguire il deployment di un'app che visualizza un breve messaggio. L'applicazione di esempio utilizza Go versione 1.18. Puoi utilizzare lo stesso esempio di codice per Go 1.18 e versioni successive, specificando la versione in app.yaml.

Gli esempi di codice per Go 1.15 e versioni precedenti sono disponibili in GitHub.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva Cloud Build API.

   Abilita l'API

5. Installa Google Cloud CLI.

6. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

9. Attiva Cloud Build API.

   Abilita l'API

10. Installa Google Cloud CLI.

11. Per initialize gcloud CLI, esegui questo comando:

    gcloud init

Prerequisiti aggiuntivi

1. Inizializza la tua app App Engine con il tuo progetto e scegli la relativa area geografica:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando richiesto, seleziona l'area geografica in cui vuoi individuare l'applicazione App Engine.

   Attenzione: non puoi modificare la regione di un'app dopo averla impostata.

2. Installa i seguenti prerequisiti:

   • Scarica e installa Git.

• Esegui questo comando per installare il componente gcloud che include l'estensione App Engine per Go:

  gcloud components install app-engine-go
  

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le tue 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 della regione.

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

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

Nota: due località, chiamate europe-west e us-central nei comandi App Engine e nella console Google Cloud, sono denominate rispettivamente europe-west1 e us-central1 altrove nella documentazione di Google.

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione eseguendo una delle seguenti operazioni:

• Esegui il comando gcloud app describe.

• Apri la dashboard di App Engine nella console Google Cloud. L'area viene visualizzata vicino alla parte superiore della pagina.

Ok

Questa guida rapida presuppone che tu abbia familiarità con il linguaggio di programmazione Go e che tu abbia installato Go.

scarica l'app Hello World

Abbiamo creato una semplice app Hello World per App Engine, così puoi capire come eseguire il deployment di un'app in Google Cloud.

1. Clona il repository dell'app di esempio Hello World nella tua macchina locale.

   git clone https://github.com/GoogleCloudPlatform/golang-samples
   

2. Passa alla directory che contiene il codice campione.

      cd golang-samples/appengine_flexible/helloworld
   

Esegui Hello World sul computer locale

Per eseguire l'applicazione Hello World nel computer locale:

1. Avvia un server web locale.

   go run *.go
   

2. Nel browser web, inserisci il seguente indirizzo:

   http://localhost:8080

   Se utilizzi Cloud Shell, fai clic su Anteprima web nella barra degli strumenti e seleziona Anteprima sulla porta 8080.

Nella pagina viene visualizzato il messaggio Hello World dell'app di esempio. Nella finestra del terminale, premi Ctrl+C per uscire dal server web.

Esegui il deployment di Hello World ed eseguilo su App Engine

Per eseguire il deployment dell'app nell'ambiente flessibile di App Engine:

1. Esegui il deployment dell'app Hello World eseguendo questo comando dalla directory helloworld:

   gcloud app deploy

   Scopri di più sui flag facoltativi.

   Flag dei comandi gcloud comuni

   • Includi il flag --version per specificare un ID che identifica in modo univoco quella versione dell'app, altrimenti ne viene generato uno automaticamente. 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 della tua 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.

   Ok

2. Avvia il browser per visualizzare l'app all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   dove PROJECT_ID rappresenta l'ID progetto Google Cloud.

Questa volta la pagina che visualizza il messaggio Hello World viene pubblicata da un server web in esecuzione su un'istanza di App Engine.

Complimenti! Hai eseguito il deployment della tua prima app di App Engine nell'ambiente flessibile di App Engine.

Se hai riscontrato errori durante il deployment della tua applicazione, consulta i suggerimenti per la risoluzione dei problemi.

Consulta le sezioni seguenti per informazioni sulla pulizia e per i link ai possibili passaggi successivi che puoi intraprendere.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il tuo progetto Google Cloud per interrompere la fatturazione di tutte le risorse utilizzate all'interno del progetto.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:
• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.
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

Impara a conoscere l'intera piattaforma

Ora che sai com'è lo sviluppo e il deployment delle app di App Engine, puoi esplorare il resto di Google Cloud. Hai già installato Google Cloud CLI, che ti offre gli strumenti per interagire con prodotti come Cloud SQL, Cloud Storage, Firestore e altri ancora.

Scopri di più sull'ambiente flessibile di App Engine

Ecco alcuni argomenti che ti aiuteranno a continuare a conoscere App Engine:

• Panoramica di App Engine
• Routing delle richieste
• Gestione delle richieste
• Gestione delle istanze

Revisione del codice Hello World

Hello World è l'app di App Engine più semplice possibile: contiene un solo servizio, ha una sola versione e tutto il codice si trova nella directory radice dell'app. Questa sezione descrive nel dettaglio ogni file dell'app.

helloworld.go

Il file helloworld.go registra un gestore che rimane in ascolto delle richieste a / e risponde con il messaggio "Hello world!".

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	http.HandleFunc("/", handle)
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
	log.Printf("Listening on port %s", port)
	if err := http.ListenAndServe(":"+port, nil); err != nil {
		log.Fatal(err)
	}
}

func handle(w http.ResponseWriter, r *http.Request) {
	if r.URL.Path != "/" {
		http.NotFound(w, r)
		return
	}
	fmt.Fprint(w, "Hello world!")
}

app.yaml

Il file app.yaml descrive la seguente configurazione per la tua app:

• Imposta env: flex, a indicare che la tua app utilizza l'ambiente flessibile di App Engine.

• Specifica il runtime utilizzato dall'app.

  # 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.
  
  runtime: go
  env: flex
  
  runtime_config:
    operating_system: 'ubuntu22'
    runtime_version: 1.21
  # This sample incurs costs to run on the App Engine flexible environment. 
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  
  

  • Per maggiori informazioni su come funziona il runtime di Go, consulta il runtime di Go.

  • Per ulteriori dettagli su come progettare un'app per sfruttare versioni e servizi, vedi Panoramica di App Engine.

  • Per maggiori dettagli sulle impostazioni di configurazione per App Engine, vedi Configurare l'app con app.yaml.