Membangun aplikasi Java

| Layanan Azure DevOps Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Catatan

Panduan berikut menggunakan alur berbasis YAML yang tersedia di Azure Pipelines. Gunakan tugas yang sesuai dengan yang digunakan dalam YAML berikut.

Anda dapat menggunakan alur untuk membuat dan menguji proyek Java Anda secara otomatis. Setelah membuat dan menguji aplikasi, Anda dapat menyebarkan aplikasi ke Azure App Service, Azure Functions, atau Azure Kubernetes Service. Jika Anda mengerjakan proyek Android, lihat Membuat, menguji, dan menyebarkan aplikasi Android.

Prasyarat

Anda harus memiliki item berikut di Azure DevOps:

  • Sebuah proyek. Jika Anda tidak memilikinya, Buat proyek sekarang.
  • Sebuah alur. Jika Anda tidak memilikinya, Buat alur sekarang.

Membuat alur

  1. Fork repositori berikut di GitHub:

    https://github.com/MicrosoftDocs/pipelines-java
    
  2. Masuk ke organisasi Azure DevOps Anda dan buka proyek Anda.

  3. Buka Alur, lalu pilih Alur baru.

  4. Lakukan langkah-langkah wizard dengan terlebih dahulu memilih GitHub sebagai lokasi kode sumber Anda. Anda dapat diarahkan ke GitHub untuk masuk. Jika demikian, masukkan informasi masuk GitHub Anda.

  5. Pilih repositori Anda. Anda mungkin diarahkan ke GitHub untuk menginstal aplikasi Azure Pipelines. Jika demikian, pilih Setujui & instal.

  6. Saat Anda melihat tab Konfigurasi , pilih Maven atau Gradle atau Ant bergantung pada cara Anda ingin membuat kode.

  7. Saat Anda siap, pilih Simpan dan jalankan.

  8. Terapkan file azure-pipelines.yml baru ke repositori Anda. Pilih Simpan dan jalankan lagi.

    Jika Anda ingin menonton alur Anda beraksi, pilih pekerjaan build.

    Anda baru saja membuat dan menjalankan alur, karena kode Anda tampaknya cocok untuk templat Maven yang kami buat secara otomatis untuk Anda.

    Anda sekarang memiliki alur YAML yang berfungsi (azure-pipelines.yml) di repositori Anda yang siap untuk Anda sesuaikan!

  9. Saat Anda siap untuk membuat perubahan pada alur Anda, pilih di halaman Alur , lalu Editazure-pipelines.yml file.

  1. Impor repositori berikut ke repositori Git Anda di Azure DevOps Server 2019:

    https://github.com/MicrosoftDocs/pipelines-java
    
  2. Simpan alur dan antrekan build. Build #nnnnnnnn.n has been queued Saat pesan muncul, pilih tautan nomor untuk melihat alur Anda beraksi. Anda sekarang memiliki alur kerja yang siap untuk Anda sesuaikan kapan saja!

  1. Impor repositori berikut ke repositori Git Anda di TFS:

    https://github.com/MicrosoftDocs/pipelines-java
    

    Templat ini secara otomatis menambahkan tugas yang Anda butuhkan untuk membangun kode dalam repositori sampel.

  2. Simpan alur dan antrekan build. Build #nnnnnnnn.n has been queued Saat pesan muncul, pilih tautan nomor untuk melihat alur Anda beraksi. Anda sekarang memiliki alur kerja yang siap untuk Anda sesuaikan kapan saja!

Baca lebih lanjut untuk mempelajari beberapa cara yang lebih umum untuk menyesuaikan alur Anda.

Membangun lingkungan

Anda dapat menggunakan Azure Pipelines untuk membangun aplikasi Java tanpa perlu menyiapkan infrastruktur anda sendiri. Anda dapat membuat gambar Windows, Linux, atau macOS. Agen yang dihosting Microsoft di Azure Pipelines memiliki JDK modern dan alat lain untuk Java yang telah diinstal sebelumnya. Untuk mengetahui versi Java mana yang diinstal, lihat Agen yang dihosting Microsoft.

Perbarui cuplikan berikut dalam file Anda azure-pipelines.yml untuk memilih gambar yang sesuai.

pool:
  vmImage: 'ubuntu-latest' # other options: 'macOS-latest', 'windows-latest'

Lihat Agen yang dihosting Microsoft untuk daftar lengkap gambar.

Sebagai alternatif untuk menggunakan agen yang dihosting Microsoft, Anda dapat menyiapkan agen yang dihost sendiri dengan Java yang diinstal. Anda juga dapat menggunakan agen yang dihost sendiri untuk menghemat lebih banyak waktu jika Anda memiliki repositori besar atau Anda dapat menjalankan build bertambah bertahap.

Build Anda berjalan pada agen yang dihost sendiri. Pastikan Anda telah menginstal Java pada agen.

Membuat kode Anda

Maven

Dengan build Maven Anda, cuplikan berikut akan ditambahkan ke file Anda azure-pipelines.yml . Anda dapat mengubah nilai, seperti jalur ke file Anda pom.xml , agar sesuai dengan konfigurasi proyek Anda. Lihat tugas Maven untuk informasi selengkapnya tentang opsi ini.

steps:
- task: Maven@4
  inputs:
    mavenPomFile: 'pom.xml'
    mavenOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: '1.8'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    goals: 'package'

Untuk Spring Boot, Anda juga dapat menggunakan tugas Maven . Pastikan nilai Anda mavenPomFile mencerminkan jalur ke file Anda pom.xml . Misalnya, jika Anda menggunakan repositori sampel Spring Boot, jalur Anda akan menjadi complete/pom.xml.

Mengkustomisasi jalur build

Sesuaikan mavenPomFile nilai jika file Anda pom.xml tidak berada di akar repositori. Nilai jalur file harus relatif terhadap akar repositori, seperti IdentityService/pom.xml atau $(system.defaultWorkingDirectory)/IdentityService/pom.xml.

Menyesuaikan tujuan Maven

Atur nilai tujuan ke daftar tujuan yang dipisahkan spasi untuk dijalankan Maven, seperti clean package.

Untuk detail tentang fase dan tujuan Java umum, lihat dokumentasi Maven Apache.

Gradle

Dengan build Gradle, cuplikan berikut ditambahkan ke file Anda azure-pipelines.yml . Untuk informasi selengkapnya tentang opsi ini, lihat tugas Gradle .

steps:
- task: Gradle@2
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: '1.8'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    tasks: 'build'

Pilih versi Gradle

Versi Gradle yang diinstal pada mesin agen akan digunakan kecuali file repositori gradle/wrapper/gradle-wrapper.properties Anda memiliki distributionUrl properti yang menentukan versi Gradle yang berbeda untuk diunduh dan digunakan selama build.

Menyesuaikan jalur build

Sesuaikan workingDirectory nilai jika file Anda gradlew tidak berada di akar repositori. Nilai direktori harus relatif terhadap akar repositori, seperti IdentityService atau $(system.defaultWorkingDirectory)/IdentityService.

Sesuaikan gradleWrapperFile nilai jika file Anda gradlew tidak berada di akar repositori. Nilai jalur file harus relatif terhadap akar repositori, seperti IdentityService/gradlew atau $(system.defaultWorkingDirectory)/IdentityService/gradlew.

Menyesuaikan tugas Gradle

Sesuaikan nilai tugas untuk tugas yang harus dijalankan Gradle, seperti build atau check.

Untuk informasi selengkapnya tentang tugas Plugin Java umum untuk Gradle, lihat dokumentasi Gradle.

Ant

Dengan build Ant, cuplikan berikut ditambahkan ke file Anda azure-pipelines.yml . Ubah nilai, seperti jalur ke file Anda build.xml agar sesuai dengan konfigurasi proyek Anda. Untuk informasi selengkapnya tentang opsi ini, lihat tugas Ant .

steps:
- task: Ant@1
  inputs:
    workingDirectory: ''
    buildFile: 'build.xml'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: '1.8'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'

Skrip

Untuk membuat dengan baris perintah atau skrip, tambahkan salah satu cuplikan berikut ke file Anda azure-pipelines.yml .

Skrip Sebaris

Langkah ini script: menjalankan skrip sebaris menggunakan Bash di Linux dan macOS dan Command Prompt di Windows. Untuk detailnya, lihat tugas Bash atau Baris perintah .

steps:
- script: |
    echo Starting the build
    mvn package
  displayName: 'Build with Maven'

File skrip

Cuplikan ini menjalankan file skrip yang ada di repositori Anda. Untuk detailnya, lihat tugas Skrip Shell, Skrip Batch, atau PowerShell .

steps:
- task: ShellScript@2
  inputs:
    scriptPath: 'build.sh'

Langkah berikutnya

Setelah membuat dan menguji aplikasi, Anda dapat mengunggah output build ke Azure Pipelines, membuat dan menerbitkan paket Maven, atau mengemas output build ke dalam file .war/jar untuk disebarkan ke aplikasi web.