Membuat dan menerbitkan paket Node.js

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

Dalam mulai cepat ini, Anda menggunakan alur untuk membuat paket Node.js dengan Node Package Manager (npm) dan menerbitkan artefak alur. Anda mempelajari cara menggunakan Azure Pipelines untuk membangun, menyebarkan, dan menguji aplikasi JavaScript Anda.

Prasyarat

• Akun GitHub tempat Anda dapat membuat repositori. Buat akun GitHub secara gratis.
• Organisasi Azure DevOps. Buat akun gratis.
• Proyek Azure DevOps. Buat menggunakan Wizard Pembuatan Proyek Azure DevOps.
• Kemampuan untuk menjalankan alur pada agen yang dihosting Microsoft. Anda perlu meminta pemberian gratis pekerjaan paralel atau membeli pekerjaan paralel.

Fork kode sampel

Fork sampel Express.js aplikasi server.

1. Buka repositori js-e2e-express-server.
2. Pilih Fork di sudut kanan atas halaman.
3. Pilih akun GitHub Anda. Secara default, fork diberi nama yang sama dengan repositori induk, tetapi Anda dapat menamainya sesuatu yang berbeda.

Penting

Selama prosedur berikut, Anda mungkin diminta untuk membuat koneksi layanan GitHub atau dialihkan ke GitHub untuk masuk, menginstal Azure Pipelines, atau mengotorisasi Azure Pipelines. Ikuti instruksi di layar untuk menyelesaikan proses. Untuk informasi selengkapnya, lihat Akses ke repositori GitHub.

Membangun alur Anda

YAML

1. Di proyek Azure DevOps Anda, pilih Alur>Buat Alur, lalu pilih GitHub sebagai lokasi kode sumber Anda.
2. Pada layar Pilih repositori, pilih repositori sampel fork Anda.
3. Pada layar Konfigurasikan alur Anda, pilih Alur pemula. Azure Pipelines menghasilkan file YAML yang disebut azure-pipelines.yml untuk alur Anda.
4. Pilih tanda dropdown di samping Simpan dan jalankan, pilih Simpan, lalu pilih Simpan lagi. File disimpan ke repositori GitHub fork Anda.
5. Pada layar berikutnya, pilih Edit.

Buat paket dan terbitkan artefak

Edit file azure-pipelines.yml Anda sebagai berikut.

1. Ganti isi file dengan kode berikut. Kode memperbarui tugas alat penginstal Node.js 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'
   

2. Tambahkan tugas baru berikut ke alur:

   • Tugas salin file menyalin paket npm dan file package.json dari jalur unduhan lokal pada agen dan menyimpannya ke jalur penahapan artefak lokal pada agen. Hanya folder src dan publik yang disalin.

   • Tugas terbitkan artefak alur mendapatkan file dari lokasi penahapan artefak dan menerbitkannya sebagai artefak untuk dijadikan output dengan build alur.

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

Menjalankan alur Anda

Pilih Validasi dan simpan, lalu pilih Simpan, pilih Jalankan, dan pilih Jalankan lagi.

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

Klasik

1. Pilih GitHub sebagai sumber untuk kode Anda.

2. Di bawah Repositori, pilih repositori fork Anda, dan pilih Lanjutkan.

3. Pilih Alur kosong, dan pilih Terapkan.

4. Di bawah Spesifikasi agen di panel kanan, pilih ubuntu-latest.

5. Di panel kiri, tambahkan tugas berikut ke alur secara berurutan. Untuk setiap tugas, pilih + di Pekerjaan agen 1, pilih tugas di sebelah kanan dan pilih Tambahkan, dan konfigurasikan tugas jika perlu.

   1. npm

   2. npm

      • Nama tampilan: pengujian npm
      • Perintah: kustom
      • Perintah dan argumen: uji

   3. Menerbitkan Hasil Pengujian

   4. Mengarsipkan file

      • Folder akar atau file ke arsip: $(System.DefaultWorkingDirectory)
      • Penangguhan nama folder akar ke jalur arsip: Hapus centang

   5. Menerbitkan artefak build

6. Pilih Simpan & antrean, lalu pilih Simpan dan jalankan.

   

Selamat, Anda berhasil membuat dan menjalankan alur yang membangun dan menguji paket Node.js. Anda dapat membangun, menguji, dan menyebarkan aplikasi Node.js sebagai bagian dari sistem integrasi berkelanjutan dan pengiriman berkelanjutan (CI/CD) Azure Pipelines Anda.

Langkah berikutnya

Mengonfigurasi JavaScript