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

  • Artikel
  • 2 menit untuk membaca

| Layanan Azure DevOps Azure DevOps Server 2020 | | Azure DevOps Server 2019 TFS 2018

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.

YAML tidak tersedia untuk TFS 2018.

1 - Fork kode sampel

Fork sampel berikut Express.js aplikasi server 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 menjalankan selesai.

Setelah selesai, Anda memiliki file YAML yang berfungsi azure-pipelines.yml di repositori yang siap untuk 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 tugasNode.js Tool Installer untuk menggunakan Node.js versi 16 LTS.

    trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '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, 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 disalin sebelum didorong ke tujuannya. File-file tersebut disimpan ke dalam folder npm . TugasArtefak Alur Terbitkan Artefak Alur, mengunduh file dari tugas Copy Files sebelumnya dan membuatnya tersedia sebagai artefak alur yang akan diterbitkan dengan build alur Anda.

    - task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '*.tgz' 
    targetFolder: $(Build.ArtifactStagingDirectory)/npm
  displayName: 'Copy npm package'

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: 'package.json' 
    targetFolder: $(Build.ArtifactStagingDirectory)/npm
  displayName: 'Copy package.json'   

- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)/npm'
    artifactName: npm
  displayName: 'Publish npm artifact'

4 - Jalankan alur Anda

Simpan dan jalankan alur Anda. Setelah alur Anda berjalan, verifikasi bahwa pekerjaan berhasil dijalankan dan Anda 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 1604

  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)
      • Tambahkan nama folder akar ke jalur arsip: Dicentang

    • Menerbitkan Artefak Build

      • Biarkan semua nilai default untuk properti

  5. Simpan alur dan antrekan build untuk melihatnya beraksi.

Langkah berikutnya

Selamat, Anda telah berhasil menyelesaikan mulai cepat ini!

Mengonfigurasi JavaScript