Inizia a utilizzare Java su Compute Engine

Questo tutorial mostra come iniziare a utilizzare Compute Engine. Segui questo tutorial eseguendo il deployment di un'app web Java Hello World in Compute Engine. Per assistenza su come iniziare a utilizzare App Engine, consulta l'ambiente standard di App Engine.

Obiettivi

• Utilizza Cloud Shell per scaricare ed eseguire il deployment di un'app di esempio Hello World.
• Esegui il deployment di un'app di esempio Hello World in una singola istanza Compute Engine.

Costi

In questo documento vengono utilizzati i seguenti componenti fatturabili di Google Cloud:

• Compute Engine

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il calcolatore prezzi.

I nuovi Google Cloud utenti potrebbero avere diritto a una prova senza costi.

Prima di iniziare

Accedi al tuo Google Cloud account. 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 senza costi per l'esecuzione, il test e il deployment dei workload.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Nella Google Cloud console, apri l'app in Cloud Shell.

   Vai a Cloud Shell

   Cloud Shell fornisce l'accesso da riga di comando alle risorse cloud direttamente dal browser.

2. Se accetti di clonare il repository, fai clic su Conferma per scaricare il codice campione e modificare la directory dell'app.

3. In Cloud Shell, configura gcloud CLI in modo da utilizzare il nuovo Google Cloud progetto:

   # Configure gcloud for your project
   gcloud config set project YOUR_PROJECT_ID

Esecuzione dell'app in Cloud Shell

1. In Cloud Shell, avvia un server web locale:

   mvn -Plocal clean jetty:run-exploded -DprojectID=YOUR-PROJECT-ID
   

2. In Cloud Shell, fai clic su Anteprima web , e seleziona Anteprima sulla porta 8080. Si apre una nuova finestra con l'app in esecuzione.

   Nel browser web, vedrai del testo Hello World, pubblicato dalla tua macchina locale.

3. Quando sei pronto per continuare, arresta il server web locale premendo Ctrl+C in Cloud Shell.

Distribuzione su una singola istanza

Questa sezione ti guida nell'esecuzione di una singola istanza dell'app su Compute Engine.

Da Cloud Shell, puoi eseguire il deployment in una singola macchina virtuale (VM) dell'istanza Compute Engine che esegue l'app.

Utilizzare uno script di avvio per inizializzare un'istanza

Devi indicare all'istanza di scaricare ed eseguire il codice. Un'istanza può avere uno script di avvio che viene eseguito ogni volta che l'istanza viene avviata o riavviata.

Uno script di avvio viene eseguito al primo avvio di un'istanza.

set -e
set -v

# Talk to the metadata server to get the project id
PROJECTID=$(curl -s "http://metadata.google.internal/computeMetadata/v1/project/project-id" -H "Metadata-Flavor: Google")

echo "Project ID: ${PROJECTID}"

# Install dependencies from apt
apt-get install -yq openjdk-11-jdk git maven

mvn --version

# Jetty Setup
mkdir -p /opt/jetty/temp
mkdir -p /var/log/jetty

# Get Jetty
curl -L https://repo1.maven.org/maven2/org/eclipse/jetty/jetty-distribution/9.4.13.v20181111/jetty-distribution-9.4.13.v20181111.tar.gz -o jetty9.tgz
tar xf jetty9.tgz  --strip-components=1 -C /opt/jetty

# Add a Jetty User
useradd --user-group --shell /bin/false --home-dir /opt/jetty/temp jetty

cd /opt/jetty
# Add running as "jetty"
java -jar /opt/jetty/start.jar --add-to-startd=setuid
cd /

# Clone the source repository.
git clone https://github.com/GoogleCloudPlatform/getting-started-java
cd getting-started-java/gce

# Build the .war file and rename.
# very important - by renaming the war to root.war, it will run as the root servlet.
mvn clean package -q
mv target/getting-started-gce-1.0-SNAPSHOT.war /opt/jetty/webapps/root.war

# Make sure "jetty" owns everything.
chown --recursive jetty /opt/jetty

# Configure the default paths for the Jetty service
cp /opt/jetty/bin/jetty.sh /etc/init.d/jetty
echo "JETTY_HOME=/opt/jetty" > /etc/default/jetty
{
  echo "JETTY_BASE=/opt/jetty"
  echo "TMPDIR=/opt/jetty/temp"
  echo "JAVA_OPTIONS=-Djetty.http.port=80"
  echo "JETTY_LOGS=/var/log/jetty"
} >> /etc/default/jetty

# Reload daemon to pick up new service
systemctl daemon-reload

# Install logging monitor. The monitor will automatically pickup logs sent to syslog.
curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
sudo bash add-logging-agent-repo.sh --also-install

service google-fluentd restart &

service jetty start
service jetty check

echo "Startup Complete"

Lo script di avvio esegue queste attività:

• Installa Java 11 e lo imposta come versione predefinita.

• Installa e configura Jetty.

• Copia il file WAR Java dal bucket Cloud Storage nella directory webapps di Jetty e lo rinomina root.war. In questo modo diventa la servlet principale, quindi non è necessario assegnargli un nome nell'URL.

• Installa l'agente Cloud Logging e lo configura per monitorare i log dell'app. Ciò significa che i log configurati nei passaggi precedenti di questo tutorial vengono caricati come se stessi utilizzando l'ambiente flessibile di App Engine.

Crea e configura un'istanza Compute Engine

1. Crea un'istanza Compute Engine:

   gcloud compute instances create my-app-instance 
   
       --image-family=debian-10 
   
       --image-project=debian-cloud 
   
       --machine-type=g1-small 
   
       --scopes userinfo-email,cloud-platform 
   
        --metadata-from-file startup-script=gce/startup-script.sh 
   
       --zone YOUR_ZONE 
   
       --tags http-server
     

   Sostituisci YOUR_ZONE con una zona di sviluppo, ad esempio us-central1-a. Per saperne di più su regioni e zone, consulta Area geografica e regioni.

   Viene creata una nuova istanza, che può accedere ai Google Cloud servizi ed eseguire lo script di avvio. Il nome dell'istanza è my-app-instance.

2. Verifica lo stato di avanzamento della creazione dell'istanza:

   gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
   

   Al termine dello script di avvio, viene visualizzato il seguente messaggio:

   startup-script: INFO Finished running startup scripts.
   

3. Crea una regola firewall per consentire il traffico nell'istanza:

   gcloud compute firewall-rules create default-allow-http-80 \
       --allow tcp:80 \
       --source-ranges 0.0.0.0/0 \
       --target-tags http-server \
       --description "Allow port 80 access to http-server"
   

4. Ottieni l'indirizzo IP esterno dell'istanza:

   gcloud compute instances list
   

5. Per visualizzare l'app in esecuzione, inserisci questo URL nel browser:

   http://YOUR_INSTANCE_IP
   

   Sostituisci YOUR_INSTANCE_IP con l'indirizzo IP esterno dell'istanza.

Gestire e monitorare un'istanza

Puoi utilizzare la Google Cloud console per monitorare e gestire l'istanza.

1. Nella Google Cloud console, vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga di l'istanza a cui vuoi connetterti.

3. Per visualizzare tutti i log generati dalle risorse di Compute Engine, vai alla pagina Esplora log.

   Vai a Esplora log

   Cloud Logging è configurato automaticamente per raccogliere i log di vari servizi comuni, tra cui syslog.

Libera spazio

Per evitare che al tuo Account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il 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à descritte in questo documento, eliminerai anche tutto il lavoro che hai 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.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

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 e fai clic su Chiudi per eliminare il progetto.

Elimina le singole risorse

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-80

Passaggi successivi

• Esplora architetture di riferimento, diagrammi e best practice su Google Cloud. Consulta il nostro Cloud Architecture Center.

• Per altre risorse Java per la creazione di app, consulta quanto segue:

  • Gestisci e monitora il deployment del gruppo di istanze in Compute Engine > Gruppi di istanze.
  • Gestisci la configurazione del bilanciamento del carico, inclusi le mappe URL e i servizi di backend, in Servizi di rete > Bilanciamento del carico.

• Deployment di un'app in Google Kubernetes Engine

• Esplora altri Google Cloud servizi.