Configurer un environnement de développement Java

Ce tutoriel explique comment préparer votre machine locale pour Java développement, y compris le développement d'applications Java s'exécutant sur Google Cloud. Suivez ces étapes pour installer Java et les outils pertinents.

Objectifs

  • Installer un JDK (kit de développement Java)
  • Installer un outil de compilation automatique
  • Installer gcloud CLI
  • (Facultatif) Installer un IDE ou un éditeur
  • (Facultatif) Installer un plug-in IDE Google Cloud
  • Installer les bibliothèques clientes Cloud pour Java
  • Configurer l'authentification

Installer un JDK (kit de développement Java)

Vous pouvez choisir la distribution Java de votre choix en vous assurant que les variables d'environnement suivantes sont définies :

  • JAVA_HOME : pointe vers la base de l'installation du JDK.
  • PATH : inclut $JAVA_HOME/bin.

Eclipse Temurin est la distribution OpenJDK (kit de développement Java) recommandée pour une utilisation avec Google Cloud. Temurin est une distribution Open Source sous licence, certifiée Java SE TCK et testée pour garantir des performances et une sécurité de qualité en production.

Les instructions d'installation de Temurin varient en fonction du système d'exploitation.

Si vous utilisez des images de démarrage Compute Engine, vous pouvez utiliser les scripts d'installation suivants.

CentOS/RHEL/Rocky

  1. Déterminez la version majeure de CentOS/RHEL/Rocky Linux :
    eval "$(grep VERSION_ID /etc/os-release)"
    eval "$(grep ^ID= /etc/os-release)"
    OLD_IFS=$IFS
    IFS='.'
    read -ra split_version <<< "$VERSION_ID"
    IFS=$OLD_IFS
    MAJOR_VERSION=$split_version
  2. Créez le fichier de dépôt source Adoptium, `/etc/yum.repos.d/adoptium.repo`:
    sudo tee /etc/yum.repos.d/adoptium.repo << EOM
    [Adoptium]
    name=Adoptium
    baseurl=https://packages.adoptium.net/artifactory/rpm/$ID/$MAJOR_VERSION/\$basearch
    enabled=1
    gpgcheck=1
    gpgkey=https://packages.adoptium.net/artifactory/api/gpg/key/public
    EOM
  3. Mettez à jour les listes de packages :
    sudo yum update -y
  4. Installez Temurin :
    sudo yum install -y temurin-17-jdk
  5. Vérifiez l'installation :
    java -version

Debian/Ubuntu

  1. Installez la clé GPG du dépôt public. Si vous utilisez Ubuntu 16.4, transmettez la clé via gpg --dearmor avant de l'enregistrer dans un fichier. (par exemple, sudo wget ... | gpg --dearmor | sudo tee ...)
    sudo mkdir -p /etc/apt/keyrings
    sudo wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public |
      sudo tee /etc/apt/keyrings/adoptium.asc
  2. Déterminez le nom de la distribution Linux, puis créez le fichier de liste source, /etc/apt/sources.list.d/adoptium.list :
    eval "$(grep VERSION_CODENAME /etc/os-release)"
    sudo tee /etc/apt/sources.list.d/adoptium.list << EOM
    deb [signed-by=/etc/apt/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $VERSION_CODENAME main
    EOM
  3. Mettez à jour les listes de packages :
    sudo apt update -y
  4. Installez Temurin :
    sudo apt install -y temurin-17-jdk
  5. Vérifiez l'installation :
    java -version

SLES

  1. Déterminez la version majeure de SLES :
    eval "$(grep VERSION_ID /etc/os-release)"
    OLD_IFS=$IFS
    IFS='.'
    read -ra split_version <<< "$VERSION_ID"
    IFS=$OLD_IFS
    MAJOR_VERSION=$split_version
  2. Installez la clé GPG du dépôt public :
    sudo mkdir -p /etc/zypp/keyrings
    sudo wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public |
      sudo tee /etc/zypp/keyrings/adoptium.asc
    sudo rpm --import /etc/zypp/keyrings/adoptium.asc
  3. Déterminez la version de SLES, puis enregistrez le dépôt Adoptium :
    sudo zypper ar -f "https://packages.adoptium.net/artifactory/rpm/sles/$MAJOR_VERSION/$(uname -m)" adoptium
  4. Mettez à jour les listes de packages :
    sudo zypper update -y
  5. Installez Temurin :
    sudo zypper install -y temurin-17-jdk
  6. Vérifiez l'installation :
    java -version

Windows

Pour installer Temurin, exécutez PowerShell version 3.0 ou ultérieure en tant qu' administrateur avec les commandes suivantes.

  1. Téléchargez Temurin. La commande Invoke-WebRequest présentée dans les instructions ci-dessous nécessite PowerShell 3.0 ou une version ultérieure.
    $JdkVersion = 17
    $JdkUrl = "https://api.adoptium.net/v3/binary/latest/$JdkVersion/ga/windows/x64/jdk/hotspot/normal/eclipse?project=jdk"
    $JdkExtractionPath = "C:\temurin-$JdkVersion-jdk"
    $JdkDownload = "$JdkExtractionPath.zip"
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]'Tls12'
    Invoke-WebRequest -Uri $JdkUrl -OutFile $JdkDownload
    Expand-Archive $JdkDownload -DestinationPath $JdkExtractionPath -Force
  2. Définissez les variables JAVA_HOME et Path :
    pushd $JdkExtractionPath
    $JdkPath = (Get-ChildItem).FullName
    popd
    [System.Environment]::SetEnvironmentVariable('JAVA_HOME', $JdkPath, 'Machine')
    
          
  3. (Optional) Refresh your session's `$env:Path` value. Otherwise, start a new session:
    $MachinePath = [System.Environment]::GetEnvironmentVariable('Path', 'Machine')
    $UserPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
    $env:Path = "$MachinePath;$UserPath"
  4. Vérifiez l'installation :
    java -version

Installer un outil de compilation automatique

Apache Maven, Gradle, et SBT sont des options de gestion de packages permettant de créer rapidement et systématiquement des dépendances d'applications Java sur toutes les plates-formes.

Installer gcloud CLI

La gcloud CLI est un ensemble d'outils pour Google Cloud. Elle contient gcloud et bq, que vous pouvez utiliser pour accéder à Compute Engine, Cloud Storage, BigQuery et à d'autres produits et services à partir de la ligne de commande. Vous pouvez exécuter ces outils de façon interactive ou dans des scripts automatisés.

(Facultatif) Installer un IDE ou un éditeur

Voici une liste non exhaustive d'éditeurs courants permettant de développer des applications Java (sans ordre particulier) :

Ces éditeurs, parfois accompagnés de plug-ins, contiennent de nombreuses fonctionnalités, telles que la coloration syntaxique, IntelliSense, le complément du code et les fonctions de débogage entièrement intégrées.

(Facultatif) Installer un plug-in IDE

Pour accéder à des fonctions utiles de votre éditeur, découvrez les plug-ins suivants :

Installer les bibliothèques clientes Cloud pour Java

Utilisez les bibliothèques clientes Cloud pour Java afin de réaliser l'intégration aux Google Cloud services, tels que Datastore et Cloud Storage. Vous pouvez installer le package pour une API individuelle, telle que BigQuery, comme indiqué dans l'exemple suivant.

Si vous utilisez Maven, ajoutez les lignes suivantes à votre pom.xml fichier. Pour en savoir plus sur les BOM, consultez la page The Google Cloud Platform Libraries BOM (BOM des bibliothèques Google Cloud Platform).

<!--  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>

Si vous utilisez Gradle, ajoutez les éléments suivants à vos dépendances :