Configura un ambiente di sviluppo Java

Questo tutorial mostra come preparare la tua macchina locale per lo sviluppo con Java, incluso lo sviluppo di app Java eseguite suGoogle Cloud. Segui questi passaggi per installare Java e gli strumenti pertinenti.

Obiettivi

• Installa un JDK (Java Development Kit).
• Installa uno strumento di automazione della build.
• Installa gcloud CLI.
• (Facoltativo) Installa un IDE o un editor.
• (Facoltativo) Installa il plug-in Google Cloud IDE.
• Installa le librerie client di Cloud per Java.
• Configurare l'autenticazione.

Installa un JDK (Java Development Kit)

Puoi scegliere qualsiasi distribuzione Java di tua scelta assicurandoti che siano impostate le seguenti variabili di ambiente:

• JAVA_HOME: rimanda alla base dell'installazione del JDK.
• PATH: include $JAVA_HOME/bin.

Eclipse Temurin è la distribuzione OpenJDK (Java Development Kit) consigliata per l'utilizzo con Google Cloud. Temurin ha una licenza open source, è certificato Java SE TCK e testato per garantire prestazioni e sicurezza di qualità di produzione.

(Consigliato) Installazione di Temurin

Le istruzioni di installazione di Temurin variano in base al sistema operativo.

• I programmi binari sono disponibili per il download.
• Per i container Docker, utilizza l'immagine ufficiale "eclipse-temurin".

Se utilizzi immagini di avvio di Compute Engine, puoi utilizzare i seguenti script di installazione.

Installa uno strumento di automazione della build

Apache Maven, Gradle e SBT sono opzioni di gestione dei pacchetti che possono aiutare a creare le dipendenze delle app Java in modo rapido e coerente su tutte le piattaforme.

Installa gcloud CLI

gcloud CLI è un insieme di strumenti per Google Cloud. Contiene gcloud e bq, che puoi utilizzare per accedere a Compute Engine, Cloud Storage, BigQuery e altri prodotti e servizi dalla riga di comando. Puoi eseguire questi strumenti in modo interattivo o nei tuoi script automatizzati.

(Facoltativo) Installa un IDE o un editor

Gli editor più diffusi (in nessun ordine particolare) utilizzati per sviluppare app Java includono, a titolo esemplificativo:

• Visual Studio Code
• IntelliJ IDEA e/o Webstorm di JetBrains
• Eclipse di Eclipse Foundation
• Atom di GitHub

Questi editor (a volte con l'aiuto di plug-in) offrono tutto, dall'evidenziazione della sintassi, all'IntelliSense e al completamento del codice fino a funzionalità di debug completamente integrate.

(Facoltativo) Installa un plug-in IDE

Per accedere a funzioni utili all'interno dell'editor, consulta i seguenti plug-in:

• Cloud Code for IntelliJ
• Cloud Code per VS Code

Installa le librerie client di Cloud per Java

Utilizza le librerie client di Cloud per Java per l'integrazione con i servizi Google Cloud, come Datastore e Cloud Storage. Puoi installare il pacchetto per una singola API, ad esempio BigQuery, come mostrato nell'esempio seguente.

Se utilizzi Maven, aggiungi quanto segue al file pom.xml. Per saperne di più sulle distinte base (BOM), consulta La distinta base (BOM) delle librerie di Google Cloud.

<!--  Using libraries-bom to manage versions.
See https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>libraries-bom</artifactId>
      <version>26.62.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-bigquery</artifactId>
  </dependency>
</dependencies>

Se utilizzi Gradle, aggiungi quanto segue alle tue dipendenze:

implementation platform('com.google.cloud:libraries-bom:26.45.0')

implementation 'com.google.cloud:google-cloud-bigquery'

Se utilizzi sbt, aggiungi quanto segue alle tue dipendenze:

libraryDependencies += "com.google.cloud" % "google-cloud-bigquery" % "2.42.2"

Se utilizzi Visual Studio Code o IntelliJ, puoi aggiungere librerie client al tuo progetto utilizzando i seguenti plug-in IDE:

• Cloud Code per VS Code
• Cloud Code for IntelliJ

I plug-in forniscono funzionalità aggiuntive, come la gestione delle chiavi per i service account. Per i dettagli, consulta la documentazione di ciascun plug-in.

Configura l'autenticazione

Per eseguire la libreria client, devi prima configurare l'autenticazione.

Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente:

gcloud auth application-default login

Non è necessario farlo se utilizzi Cloud Shell.

Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per l'utilizzo delle librerie client.

Utilizza la libreria client

// Imports the Google Cloud client library
import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Dataset;
import com.google.cloud.bigquery.DatasetInfo;

public class QuickstartSample {
  public static void main(String... args) throws Exception {
    // Instantiate a client. If you don't specify credentials when constructing a client, the
    // client library will look for credentials in the environment, such as the
    // GOOGLE_APPLICATION_CREDENTIALS environment variable.
    BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

    // The name for the new dataset
    String datasetName = "my_new_dataset";

    // Prepares a new dataset
    Dataset dataset = null;
    DatasetInfo datasetInfo = DatasetInfo.newBuilder(datasetName).build();

    // Creates the dataset
    dataset = bigquery.create(datasetInfo);

    System.out.printf("Dataset %s created.%n", dataset.getDatasetId().getDataset());
  }
}

Configura gli endpoint per la libreria client

Se utilizzi API che supportano gli endpoint regionali, utilizza gli endpoint per configurare il server a cui inviare le richieste. Ad esempio, con l'API Google.Cloud.Dataproc.V1, puoi configurare un endpoint client. Puoi scoprire di più sugli endpoint regionali per Dataproc qui. Assicurati di sostituire MY-PROJECT con il nome del progetto e us-central1 con la regione appropriata per la tua configurazione nell'esempio seguente:

ClusterControllerSettings settings =
     ClusterControllerSettings.newBuilder()
        .setEndpoint("us-central1-dataproc.googleapis.com:443")
        .build();
 try (ClusterControllerClient clusterControllerClient = ClusterControllerClient.create(settings)) {
   String projectId = "MY-PROJECT";
   String region = "us-central1";
   Cluster cluster = Cluster.newBuilder().build();
 }

(Facoltativo) Osservabilità

Google Cloud Observability include servizi di osservabilità che ti aiutano a comprendere il comportamento, l'integrità e le prestazioni delle tue applicazioni Java. Per saperne di più, consulta Google Cloud Observability per Java.

Passaggi successivi

(Facoltativo) Utilizza il plug-in Maven o Gradle per App Engine

Se sviluppi nell'ambiente standard o flessibile di App Engine, puoi utilizzare i plug-in per gli strumenti di build Apache Maven e Gradle, che forniscono funzioni utili per sviluppare, testare ed eseguire il deployment delle tue app direttamente.

Per gli ambienti standard App Engine

Utilizza il plug-in Maven App Engine o il plug-in Gradle per gli ambienti standard di App Engine.

Per gli ambienti flessibili di App Engine

Utilizza il plug-in Maven App Engine o il plug-in Gradle per gli ambienti flessibili di App Engine.

Altre risorse

• Sfoglia la documentazione per i prodotti Google Cloud .
• Clona il repository di esempi Java da GitHub.