Menyiapkan lingkungan pengembangan Java

Tutorial ini menunjukkan cara menyiapkan mesin lokal untuk pengembangan Java, termasuk mengembangkan aplikasi Java yang berjalan diGoogle Cloud. Ikuti langkah-langkah berikut untuk menginstal Java dan alat yang relevan.

Tujuan

  • Instal JDK (Java Development Kit).
  • Instal alat otomatisasi build.
  • Instal gcloud CLI.
  • (Opsional) Instal IDE atau editor.
  • (Opsional) Instal plugin IDE Google Cloud .
  • Instal Library Klien Cloud untuk Java.
  • Menyiapkan autentikasi.

Menginstal JDK (Java Development Kit)

Anda dapat memilih distribusi Java pilihan Anda dengan memastikan bahwa variabel lingkungan berikut ditetapkan:

  • JAVA_HOME: Menunjuk ke dasar penginstalan JDK.
  • PATH: Mencakup $JAVA_HOME/bin.

Eclipse Temurin adalah distribusi OpenJDK (Java Development Kit) yang direkomendasikan untuk digunakan dengan Google Cloud. Temurin memiliki lisensi open source, bersertifikasi Java SE TCK, dan telah diuji untuk memastikan performa dan keamanan berkualitas produksi.

Petunjuk penginstalan Temurin bervariasi menurut sistem operasi.

Jika Anda menggunakan image boot Compute Engine, Anda dapat menggunakan skrip penginstalan berikut.

CentOS/RHEL/Rocky

  1. Tentukan versi utama 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. Buat file repo sumber 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. Perbarui daftar paket:
    sudo yum update -y
  4. Instal Temurin:
    sudo yum install -y temurin-17-jdk
  5. Verifikasi penginstalan:
    java -version

Debian/Ubuntu

  1. Instal kunci GPG repo publik. Jika Anda menggunakan Ubuntu 16.4, teruskan kunci melalui gpg --dearmor sebelum menyimpan ke file. (misalnya: 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. Tentukan nama distribusi Linux, lalu buat file daftar sumber, /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. Perbarui daftar paket:
    sudo apt update -y
  4. Instal Temurin:
    sudo apt install -y temurin-17-jdk
  5. Verifikasi penginstalan:
    java -version

SLES

  1. Tentukan versi utama 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. Instal kunci GPG repositori publik:
    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. Tentukan versi SLES, dan daftarkan repositori Adoptium:
    sudo zypper ar -f "https://packages.adoptium.net/artifactory/rpm/sles/$MAJOR_VERSION/$(uname -m)" adoptium
  4. Perbarui daftar paket:
    sudo zypper update -y
  5. Instal Temurin:
    sudo zypper install -y temurin-17-jdk
  6. Verifikasi penginstalan:
    java -version

Windows

Untuk menginstal Temurin, jalankan PowerShell versi 3.0 atau yang lebih tinggi sebagai administrator dengan perintah berikut.

  1. Download Temurin. Perintah Invoke-WebRequest dalam petunjuk di bawah memerlukan PowerShell 3.0 atau yang lebih baru.
    $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. Tetapkan variabel JAVA_HOME dan 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. Verifikasi penginstalan:
    java -version

Menginstal alat otomatisasi build

Apache Maven, Gradle, dan SBT adalah opsi pengelolaan paket yang dapat membantu membangun dependensi aplikasi Java dengan cepat dan konsisten di seluruh platform.

Menginstal gcloud CLI

gcloud CLI adalah serangkaian alat untuk Google Cloud. Cloud SDK berisi gcloud dan bq, yang dapat Anda gunakan untuk mengakses Compute Engine, Cloud Storage, BigQuery, serta produk dan layanan lainnya dari command line. Anda dapat menjalankan alat ini secara interaktif atau dalam skrip otomatis.

(Opsional) Menginstal IDE atau editor

Editor populer (tanpa urutan tertentu) yang digunakan untuk mengembangkan aplikasi Java mencakup, tetapi tidak terbatas pada:

Editor ini (terkadang dengan bantuan plugin) memberi Anda segalanya mulai dari penyorotan sintaksis, intelli-sense, dan penyelesaian kode hingga kemampuan proses debug yang terintegrasi sepenuhnya.

(Opsional) Menginstal plugin IDE

Untuk mendapatkan akses ke fungsi yang berguna dalam editor, lihat plugin berikut:

Instal Library Klien Cloud untuk Java

Gunakan Library Klien Cloud untuk Java untuk berintegrasi dengan layanan Google Cloud, seperti Datastore dan Cloud Storage. Anda dapat menginstal paket untuk setiap API, seperti BigQuery, seperti yang ditunjukkan dalam contoh berikut.

If you are using Maven, add the following to your pom.xml file. For more information about BOMs, see The Google Cloud Platform Libraries BOM.

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

If you are using Gradle, add the following to your dependencies:

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

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

If you are using sbt, add the following to your dependencies:

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

If you're using Visual Studio Code or IntelliJ, you can add client libraries to your project using the following IDE plugins:

The plugins provide additional functionality, such as key management for service accounts. Refer to each plugin's documentation for details.

Menyiapkan autentikasi

Untuk menjalankan library klien, Anda harus menyiapkan autentikasi terlebih dahulu.

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan library klien.

Menggunakan library klien

// 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());
  }
}

Mengonfigurasi endpoint untuk library klien

Jika Anda menggunakan API yang mendukung endpoint regional, gunakan endpoint untuk mengonfigurasi server yang akan menerima permintaan. Misalnya, dengan Google.Cloud.Dataproc.V1 API, Anda dapat mengonfigurasi endpoint klien. Anda dapat membaca lebih lanjut endpoint regional untuk Dataproc di sini. Pastikan untuk mengganti MY-PROJECT dengan nama project Anda dan us-central1 dengan region yang sesuai untuk konfigurasi Anda dalam contoh berikut:

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();
 }

Langkah berikutnya

(Opsional) Menggunakan plugin Maven atau Gradle untuk App Engine

Jika mengembangkan di lingkungan standar atau fleksibel App Engine, Anda dapat menggunakan plugin untuk alat build Apache Maven dan Gradle yang menyediakan fungsi praktis untuk mengembangkan, menguji, dan men-deploy aplikasi Anda secara langsung.

Untuk lingkungan standar App Engine

Gunakan plugin Maven App Engine atau plugin Gradle untuk lingkungan standar App Engine.

Untuk lingkungan fleksibel App Engine

Gunakan plugin Maven App Engine atau plugin Gradle untuk lingkungan fleksibel App Engine.

Referensi lainnya