Mulai cepat - Menggunakan Azure Pipelines untuk membangun dan menerbitkan paket Node.js

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

Anda dapat menggunakan alur Azure DevOps untuk membangun, menyebarkan, dan menguji aplikasi JavaScript.

Mulai cepat ini menjelaskan cara menggunakan alur untuk membuat paket Node.js dengan Node Package Manager (npm) dan menerbitkan artefak alur.

Prasyarat

Anda harus memiliki item berikut di Azure DevOps:

  • Akun GitHub tempat Anda dapat membuat repositori. Buat akun gratis.
  • Organisasi dan proyek Azure DevOps. Buat akun gratis.
  • Kemampuan untuk menjalankan jaringan alur pada agen yang dihosting Microsoft. Anda dapat membeli pekerjaan paralel atau Anda dapat meminta tingkat gratis.

1 - Lakukan forking pada kode sampel

Lakukan forking pada sampel aplikasi server Express.js berikut di GitHub.

https://github.com/Azure-Samples/js-e2e-express-server

2 - Buat alur Anda

  1. Masuk ke Azure Pipelines. Browser Anda akan masuk ke https://dev.azure.com/my-organization-name dan menampilkan dasbor Azure DevOps Anda.

  2. Buka proyek Anda dan pilih Alur>Buat alur baru.

  3. Pilih GitHub sebagai lokasi kode sumber Anda.

  4. Jika Anda dialihkan ke GitHub untuk masuk, masukkan kredensial GitHub Anda.

  5. Saat daftar repositori muncul, pilih repositori sampel Node.js Anda.

  6. Azure Pipelines menganalisis kode di repositori Anda dan merekomendasikan Node.js templat untuk alur Anda. Pilih templat tersebut.

  7. Azure Pipelines menghasilkan file YAML untuk alur Anda. Pilih Simpan dan jalankan>Penerapan langsung ke cabang utama, lalu pilih Simpan dan jalankan lagi.

  8. Eksekusi baru dimulai. Tunggu sampai eksekusi selesai.

Setelah selesai, Anda memiliki file YAML yang berfungsi azure-pipelines.yml di repositori yang siap anda sesuaikan.

  1. Buat alur dan pilih templat YAML .

  2. Atur kumpulan Agen dan jalur file YAML untuk alur Anda.

  3. Simpan alur dan antrekan build. Saat pesan Build #nnnnnnnn.n telah diantrekan muncul, pilih tautan nomor untuk melihat alur Anda beraksi.

3 - Bangun paket Anda dan terbitkan artefak

  1. Edit file azure-pipelines.yml Anda.

  2. Perbarui tugas Node.js Tool Installer untuk menggunakan Node.js versi 16 LTS.

    trigger:
    - main
    
    pool:
      vmImage: 'ubuntu-latest'
    
    steps:
    - task: UseNode@1
      inputs:
        version: '16.x'
      displayName: 'Install Node.js'
    
    - script: |
        npm install
      displayName: 'npm install'
    
    - script: |
        npm run build
      displayName: 'npm build'
    
  3. Tambahkan tugas baru ke alur Anda untuk menyalin paket npm Anda, package.json, dan untuk menerbitkan artefak Anda. Tugas Salin File menyalin file dari jalur lokal pada agen tempat file kode sumber Anda diunduh dan menyimpan file ke jalur lokal pada agen tempat artefak apa pun disalin sebelum didorong ke tujuannya. src Hanya folder dan public yang mendapatkan salinan. Tugas Terbitkan Artefak Alur mengunduh file dari tugas File Salin sebelumnya dan membuatnya tersedia sebagai artefak alur yang akan diterbitkan dengan build alur Anda.

    - task: CopyFiles@2
      inputs:
        sourceFolder: '$(Build.SourcesDirectory)'
        contents: |
           src/*
           public/*
        targetFolder: '$(Build.ArtifactStagingDirectory)'
      displayName: 'Copy project files'
    
    - task: PublishPipelineArtifact@1
      inputs:
        artifactName: e2e-server
        targetPath: '$(Build.ArtifactStagingDirectory)'
        publishLocation: 'pipeline'
      displayName: 'Publish npm artifact'
    

4 - Jalankan alur Anda

Simpan dan jalankan alur Anda. Setelah alur Anda berjalan, verifikasi bahwa pekerjaan berhasil dijalankan dan Anda akan melihat artefak yang diterbitkan.

Cuplikan layar eksekusi alur yang berhasil dengan artefak.

  1. Fork repositori berikut di GitHub.

    https://github.com/Azure-Samples/js-e2e-express-server
    
  2. Setelah Anda memiliki kode sampel di repositori Anda sendiri, buat alur pertama Anda dan pilih templat Proses kosong.

  3. Pilih Proses di bawah tab Tugas di editor alur dan ubah properti sebagai berikut:

    • Antrean agen:Hosted Ubuntu Latest
  4. Tambahkan tugas berikut ke alur dalam urutan yang ditentukan:

    • npm

      • Perintah:install
    • npm

      • Nama tampilan:npm test
      • Perintah:custom
      • Perintah dan argumen:test
    • Menerbitkan Hasil Pengujian

      • Biarkan semua nilai default untuk properti
    • File Arsip

      • Folder akar atau file yang akan diarsipkan:$(System.DefaultWorkingDirectory)
      • Penangguhan nama folder akar ke jalur arsip: Tidak dicentang
    • Terbitkan Artefak Build

      • Biarkan semua nilai default untuk properti
  5. Simpan alur dan antrekan build untuk menampilkan tindakannya.

Langkah berikutnya

Selamat, Anda telah berhasil menyelesaikan panduan mulai cepat ini!