Membangun aplikasi Java

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

Anda dapat menggunakan alur untuk secara otomatis:

• Buat proyek Anda menggunakan Maven, Gradle, atau Ant.
• Jalankan pengujian dan alat analisis kode.
• Terbitkan aplikasi Anda ke alur dan Azure Artifacts Anda.
• Sebarkan aplikasi Anda ke Azure App Service, Azure Functions, atau Azure Kubernetes Service.

Jika Anda sedang mengerjakan proyek Android, lihat Membuat, menguji, dan menyebarkan aplikasi Android.

Prasyarat

Untuk menjalankan contoh berikut, Anda harus memiliki:

• Akun GitHub tempat Anda dapat membuat repositori. Buat akun gratis.
• Organisasi Azure DevOps. Buat akun gratis.
• Proyek Azure DevOps. Jika Anda tidak memilikinya, Buat proyek sekarang.

Menyiapkan repositori GitHub

Fork repositori berikut ke akun GitHub Anda:

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

Buat alur

1. Masuk ke organisasi Azure DevOps Anda dan buka proyek Anda.

2. Buka Alur, lalu pilih Alur baru atau Buat alur jika membuat alur pertama dalam proyek.

3. 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.

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

5. Saat Anda melihat tab Konfigurasikan alur , pilih Maven, Gradle, atau Ant bergantung pada cara Anda ingin membuat kode.

6. File azure-pipelines.yml yang berisi definisi alur Anda dibuat di repositori Anda dan dibuka di editor YAML. Anda dapat mengkustomisasi alur dengan menambahkan lebih banyak tugas atau mengubah tugas yang ada. Untuk informasi selengkapnya tentang tugas build, lihat Membangun kode Anda.

7. Setelah selesai mengedit azure-pipelines.yml, pilih Simpan dan jalankan.

8. Untuk menerapkan file ke azure-pipelines.yml repositori Anda, pilih Simpan dan jalankan lagi.

Pilih Pekerjaan untuk menonton alur Anda beraksi.

Anda sekarang memiliki alur YAML yang berfungsi (azure-pipelines.yml) di repositori Anda yang siap untuk Anda sesuaikan! Untuk membuat perubahan pada alur Anda, pilih di halaman Alur , lalu Edit azure-pipelines.yml file.

Membangun lingkungan

Anda dapat menggunakan Azure Pipelines untuk membangun aplikasi Java tanpa perlu menyiapkan infrastruktur anda sendiri. Anda dapat membangun di 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.

Untuk memilih gambar yang sesuai, perbarui cuplikan berikut dalam file Anda azure-pipelines.yml .

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 Menjalankan build bertambah bertahap.

Membuat kode Anda

Anda dapat membuat aplikasi Java dengan Maven, Gradle, Ant, atau skrip. Bagian berikut menunjukkan kepada Anda cara menambahkan langkah build ke alur Anda untuk setiap metode.

Maven

Dengan build Maven Anda, tugas berikut ditambahkan ke file Anda azure-pipelines.yml . Ganti nilai agar sesuai dengan proyek Anda. Untuk informasi selengkapnya tentang opsi tugas, lihat tugas Maven.

steps:
- task: Maven@4
  inputs:
    mavenPomFile: 'pom.xml'
    mavenOptions: '-Xmx3072m'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    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 adalah 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 bagi Maven untuk dieksekusi, seperti clean package. Untuk detail tentang fase dan tujuan Java umum, lihat dokumentasi Maven Apache.

Gradle

Dengan build Gradle, tugas 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: 'default'
    jdkArchitectureOption: 'x64'
    publishJUnitResults: true
    testResultsFiles: '**/TEST-*.xml'
    tasks: 'build'

Pembungkus Gradle

Anda harus memiliki gradlew file di repositori Anda. Jika Anda tidak memilikinya, Anda dapat membuatnya dengan menjalankannya gradle wrapper di direktori akar proyek Anda. Untuk informasi tentang membuat pembungkus Gradle, lihat Gradle.

Pilih versi Gradle

Versi Gradle yang diinstal pada komputer agen 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, tambahkan tugas berikut 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 . Jika menggunakan repositori sampel, Anda perlu menyediakan build.xml file di repositori Anda.

steps:
- task: Ant@1
  inputs:
    workingDirectory: ''
    buildFile: 'build.xml'
    javaHomeOption: 'JDKVersion'
    jdkVersionOption: 'default'
    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

Tugas 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

Anda dapat menerbitkan output build ke alur Anda. Anda dapat mengemas dan menerbitkan aplikasi Anda dalam paket Maven atau file .war/jar untuk disebarkan ke aplikasi web.

Pelajari selengkapnya tentang membuat alur CI/CD untuk target penyebaran Anda:

• Azure App Service
• Azure Functions
• Layanan Azure Kubernetes