Obiettivi e parametri del plug-in Maven di App Engine

Dopo aver aggiunto al tuo progetto il plug-in Maven di App Engine basato su gcloud CLI, sono disponibili i seguenti obiettivi Maven specifici di App Engine:

Obiettivo	Descrizione
appengine:cloudSdkLogin	Imposta lo stato globale dellgcloud CLI per account.
appengine:deploy	Esegue le fasi ed esegue il deployment di un'applicazione in App Engine.
appengine:deployAll	Stage ed esegue il deployment di un'applicazione con tutte le sue configurazioni YAML valide contemporaneamente in App Engine.
appengine:deployCron	Mette in fase ed esegue il deployment di un file di configurazione cron.yaml in App Engine.
appengine:deployDispatch	Mette in fase ed esegue il deployment di un file di configurazione dispatch.yaml in App Engine.
appengine:deployDos	Mette in fase ed esegue il deployment di un file di configurazione dos.yaml in App Engine.
appengine:deployIndex	Prepara ed esegue il deployment di un file di configurazione index.yaml in App Engine.
appengine:deployQueue	Mette in fase ed esegue il deployment di un file di configurazione queue.yaml in App Engine.
appengine:help	Visualizza le informazioni di assistenza sul plug-in Maven di App Engine.
appengine:run	Esegue il server di sviluppo App Engine. Quando il server è in esecuzione, controlla continuamente per determinare se appengine-web.xml è cambiato. In caso affermativo, il server ricarica l'applicazione. Non è necessario arrestare e riavviare l'applicazione a causa delle modifiche apportate a appengine-web.xml. Questo obiettivo è supportato per i servizi in bundle legacy.
appengine:stage	Genera una directory delle applicazioni per il deployment.
appengine:start	Avvia l'esecuzione dello devserver di App Engine in modo asincrono, quindi torna alla riga di comando. Quando viene eseguito questo obiettivo, il comportamento è uguale all'obiettivo run, ma Maven continua a elaborare gli obiettivi e a uscire dopo che il server è attivo e in esecuzione. Questo obiettivo è supportato per i servizi in bundle legacy.
appengine:stop	Arresta un server di sviluppo web di App Engine in esecuzione. Questo obiettivo è supportato per i servizi in bundle legacy.

Nota: gli obiettivi appengine:run, appengine:start e appengine:stop si applicano solo alle app che utilizzano i servizi in bundle legacy e vengono distribuite con un file appengine-web.xml nell'ambiente standard.

Per ulteriori informazioni su come configurare e utilizzare Maven, consulta Utilizzo di Maven.

Utilizzo dei parametri

A ogni obiettivo sono associati parametri che puoi specificare nel file pom.xml. Ad esempio:

<plugins>
   <plugin>
     <groupId>com.google.cloud.tools</groupId>
     <artifactId>appengine-maven-plugin</artifactId>
     <version>2.7.0</version>
     <configuration>
       <deploy.stopPreviousVersion>true</deploy.stopPreviousVersion>
       <cloudSdkHome>/usr/foo/path/to/cloudsdk</cloudSdkHome>
     </configuration>
  </plugin>
</plugins>

Nota: i prefissi dei parametri, ad esempio devserver, sono facoltativi. Puoi aggiungere <port>8080</port> anziché <devserver.port>8080</devserver.port>.

Puoi anche definire i parametri di configurazione nella riga di comando, seguendo il pattern -D[USER_PROPERTY]=[PARAMETER_VALUE].

Ad esempio, per specificare una directory in cui archiviare l'applicazione:

mvn appengine:stage -Dapp.stage.stagingDirectory=[YOUR_STAGING_DIRECTORY]

Consulta le seguenti sezioni per un elenco dei parametri disponibili per ogni obiettivo.

appengine:deploy

Esegue le fasi ed esegue il deployment di un'applicazione in App Engine.

Puoi utilizzare i seguenti parametri, alcuni dei quali corrispondono ai flag della riga di comando gcloud app deploy o ai flag della riga di comando gcloud app services:

Parametro	Descrizione	Proprietà utente
appEngineDirectory	La directory che contiene app.yaml e altri file di configurazione di App Engine supportati. Il valore predefinito è ${basedir}/src/main/appengine.	app.stage.appEngineDirectory
artifact	La posizione dell'archivio JAR o WAR di cui eseguire il deployment. Il valore predefinito è ${project.build.directory}/${project.build.finalName}.${project.packaging}.	app.stage.artifact
bucket	Il bucket Cloud Storage utilizzato per l'organizzazione temporanea dei file associati al deployment. Se questo argomento non è specificato, viene utilizzato il bucket predefinito dell'applicazione.	app.deploy.bucket
cloudSdkPath	Parametro facoltativo per configurare la località di Google Cloud CLI. L'impostazione predefinita è il rilevamento automatico dal percorso o dal percorso di installazione standard.	cloudSdkPath
deployables	I file YAML per i servizi o le configurazioni di cui vuoi eseguire il deployment. Il valore predefinito è il file app.yaml nella directory temporanea. Se non lo trovi, tenterà di generare automaticamente i file di configurazione necessari (ad esempio app.yaml) nella directory temporanea.	app.deploy.deployables
dockerDirectory	La directory contenente il Dockerfile e altre risorse Docker. Il valore predefinito è ${basedir}/src/main/docker/.	app.stage.dockerDirectory
imageUrl	Esegui il deployment con un'immagine Docker specifica. ImageUrl deve essere un nome di Container Registry valido, ad esempio gcr.io/foo, dove foo è il nome dell'immagine.	app.deploy.imageUrl
projectId	Il nome del progetto Google Cloud da utilizzare per questa chiamata. Il valore predefinito è il progetto corrente selezionato durante l'inizializzazione di gcloud.	app.deploy.projectId
promote	Promuovi la versione di cui è stato eseguito il deployment in modo da ricevere tutto il traffico. Il valore predefinito è True.	app.deploy.promote
server	Il server App Engine a cui connettersi. In genere, non è necessario modificare questo valore.	app.deploy.server
stagingDirectory	Obbligatorio. La directory in cui archiviare l'applicazione. Il valore predefinito è ${project.build.directory}/appengine-staging.	app.stage.stagingDirectory
stopPreviousVersion	Arresta la versione in esecuzione in precedenza quando esegui il deployment di una nuova versione che riceve tutto il traffico.	app.deploy.stopPreviousVersion
version	La versione dell'app che verrà creata o sostituita da questo deployment. Se non specifichi una versione, ne verrà generata automaticamente una.	app.deploy.version

appengine:help

Visualizza le informazioni di assistenza sul plug-in Maven di App Engine. Per visualizzare i dettagli del parametro, richiama:

mvn appengine:help -Ddetail=true -Dgoal=[GOAL_NAME]

Puoi utilizzare i seguenti parametri:

Parametro	Descrizione	Proprietà utente
detail	Se il valore è true, vengono visualizzate tutte le proprietà impostabili per ciascun obiettivo. Il valore predefinito è False.	detail
goal	Il nome dell'obiettivo per cui mostrare la guida. Se non specificati, verranno visualizzati tutti gli obiettivi.	goal
indentSize	Il numero di spazi per livello di rientro. Deve essere un numero positivo. Il valore predefinito è 2.	indentSize
lineLength	La lunghezza massima di una linea di visualizzazione. Deve essere un numero positivo. Il valore predefinito è 80.	lineLength

appengine:stage

Genera una directory delle build dell'applicazione per il deployment.

Puoi utilizzare i seguenti parametri:

Parametro	Descrizione	Proprietà utente
appEngineDirectory	La directory che contiene app.yaml e altri file di configurazione di App Engine supportati. Il valore predefinito è ${basedir}/src/main/appengine.	app.stage.appEngineDirectory
artifact	La posizione dell'archivio JAR o WAR di cui eseguire il deployment. Il valore predefinito è ${project.build.directory}/${project.build.finalName}.${project.packaging}.	app.stage.artifact
cloudSdkPath	Parametro facoltativo per configurare la località di gcloud CLI.	cloudSdkPath
dockerDirectory	La directory contenente il Dockerfile e altre risorse Docker. Il valore predefinito è ${basedir}/src/main/docker/${basedir}/src/main/docker/.	app.stage.dockerDirectory
stagingDirectory	Obbligatorio. La directory in cui archiviare l'applicazione. Il valore predefinito è ${project.build.directory}/appengine-staging	app.stage.stagingDirectory