Per iniziare: configurazione dell'ambiente di sviluppo

Scopri come configurare il tuo ambiente di build per lo sviluppo e il deployment delle app sul runtime Java 8 nell'ambiente standard di App Engine.

Questa guida ti mostrerà come:

  • Installa Google Cloud CLI.
  • Installa e configura il plug-in App Engine per Maven. App Engine fornisce anche plug-in per Gradle, IntelliJ IDEA ed Eclipse, ma questa guida illustra il plug-in Maven.
  • Creare un nuovo progetto App Engine.
  • Autorizza Cloud Build per abilitare la creazione e il deployment della tua app.

Installazione degli SDK richiesti

  1. Se non hai ancora installato l'SDK Java SE 8, installa il Java SE 8 Development Kit (JDK).

  2. Installa e inizializza la versione più recente di gcloud CLI.

    Installa e inizializza gcloud CLI

  3. Installa il componente Java di App Engine:

    gcloud components install app-engine-java
    
  4. Autorizza il tuo account utente:

    gcloud auth application-default login
    

Configurazione di Maven nell'ambiente di sviluppo

  1. Scarica Maven 3.5 o versioni successive dal sito web di Maven.

  2. Installa Maven 3.5 o versioni successive sulla tua macchina locale.

Creazione di un nuovo progetto App Engine

Per creare un'app App Engine:

  1. Crea una nuova directory.

  2. Inizializza il nuovo progetto nella directory creata:

     mvn archetype:generate -Dappengine-version=1.9.59 -Djava8=true -DCloudSDK_Tooling=true -Dapplication-id=your-app-id -Dfilter=com.google.appengine.archetypes:
    
    1. Imposta -Dappengine-version sulla versione più recente dell'SDK di App Engine per Java e application-id sull'ID del progetto Google Cloud.

    2. Imposta -Djava8=true per eseguire il deployment del progetto nel runtime Java 8.

    3. Imposta -DCloudSDK_Tooling=true per utilizzare gli strumenti gcloud CLI.

  3. Quando viene richiesto di scegliere un archetipo, scegli il valore 2 per lo scheletro di App Engine. Viene creato un progetto vuoto contenente la struttura di directory e i file richiesti.

  4. Quando ti viene richiesta la versione, premi Invio per selezionare la versione predefinita più recente.

  5. Quando viene richiesto di Define value for property 'groupId', fornisci lo spazio dei nomi desiderato per l'app, ad esempio com.mycompany.myapp.

  6. Quando richiesto, inserisci il nome del progetto, Define value for property 'artifactId', ad esempio myapp.

  7. Quando viene richiesto Define value for property 'version', accetta il valore predefinito.

  8. Quando viene richiesto Define value for property 'package', fornisci il nome del pacchetto che preferisci (o accetta il valore predefinito). I file Java generati avranno il nome del pacchetto specificato qui.

  9. Quando ti viene chiesto di confermare le tue scelte, accetta il valore predefinito (Y).

  10. Attendi la fine della generazione del progetto, quindi modifica le directory nella directory del nuovo progetto, ad esempio myapp/.

  11. Aggiungi il plug-in basato su gcloud CLI al file pom.xml del tuo progetto.

    <build>
        <plugins>
           [...]
              <plugin>
                <groupId>com.google.cloud.tools</groupId>
                <artifactId>appengine-maven-plugin</artifactId>
                <version>2.4.4</version>
                <configuration>
                    <projectId>your-project-ID-goes-here</projectId>
                    <version>1</version>
                </configuration>
              </plugin>
           [...]
        </plugins>
    </build>
    
  12. Specifica l'ID progetto della piattaforma Google Cloud di destinazione e il servizio e la versione nella configurazione del plug-in.

Concedi l'autorizzazione a Cloud Build

Quando esegui il deployment dell'app, App Engine utilizza Cloud Build per creare l'app in un container ed eseguire il deployment del container nel runtime. Cloud Build non dispone dell'autorizzazione per eseguire il deployment di app Java 8 per impostazione predefinita, quindi devi concedere a Cloud Build l'autorizzazione a eseguire il deployment delle app nel tuo progetto. Le build vengono create nella regione dell'app.

Passaggi successivi

Ora che l'ambiente di sviluppo è configurato, puoi iniziare a sviluppare e eseguire il deployment di app Java in App Engine.