Membangun dan menguji aplikasi Node.js

Halaman ini menjelaskan cara menggunakan Cloud Build untuk mem-build dan menguji aplikasi Node.js, menyimpan artefak yang di-build di repositori npm di Artifact Registry, dan menghasilkan informasi asal build.

Cloud Build memungkinkan Anda menggunakan image container yang tersedia secara publik untuk menjalankan tugas. Image node publik dari Docker Hub sudah diinstal sebelumnya dengan alat npm. Anda dapat mengonfigurasi Cloud Build untuk mem-build project Node.js dengan alat ini.

Sebelum memulai

Petunjuk di halaman ini mengasumsikan bahwa Anda sudah memahami Node.js. Selain itu:

Membangun dengan npm

Untuk menjalankan tugas di image node dari Docker Hub, tentukan URL image di kolom name dalam file konfigurasi Cloud Build. Cloud Build memulai container yang ditentukan di kolom name menggunakan titik entri default image. Untuk mengganti titik entri default dan menentukan cara langkah build harus dijalankan saat dipanggil, tambahkan kolom entrypoint di langkah build Anda. Image node di Docker Hub sudah diinstal sebelumnya dengan alat npm. Tentukan alat di kolom entrypoint untuk memanggilnya sebagai titik entri langkah build Anda.

Dalam contoh file konfigurasi build berikut:

  • Kolom name menentukan bahwa image node dari Docker Hub digunakan oleh Cloud Build untuk menjalankan tugas Anda. Saat menentukan image node, Anda dapat menghapus versi node agar ditetapkan secara default ke :latest, atau menentukan versi node untuk menggunakan versi tertentu. Misalnya, name: node akan menggunakan node versi terbaru, dan name: node:12 akan menggunakan node:12.

  • Kolom entrypoint menentukan bahwa alat npm digunakan saat gambar node dipanggil.

     steps:
 - name: 'node'
   entrypoint: 'npm'

Mengonfigurasi build Node.js

  1. Di direktori utama project, buat file konfigurasi bernama cloudbuild.yaml.

  2. Menginstal dependensi: Sebelum dapat mem-build aplikasi, Anda harus memastikan bahwa semua dependensi project diinstal dari npm. Anda dapat menginstal dependensi menggunakan perintah install dalam langkah build npm. Kolom args dari langkah build menggunakan daftar argumen dan meneruskannya ke gambar yang dirujuk oleh kolom nama. Dalam file konfigurasi build, tambahkan install ke kolom args untuk memanggil perintah install:

     steps:
 - name: 'node'
   entrypoint: 'npm'
   args: ['install']

  3. Tambahkan pengujian: Jika telah menentukan skrip test di package.json, Anda dapat mengonfigurasi Cloud Build untuk menjalankan skrip dengan menambahkan test ke kolom args:

     steps:
 - name: 'node'
   entrypoint: 'npm'
   args: ['install']
 - name: 'node'
   entrypoint: 'npm'
   args: ['test']

  4. Menjalankan perintah kustom: Jika package.json berisi perintah kustom, Anda dapat mengonfigurasi Cloud Build untuk menjalankan perintah tersebut. Di kolom args, tambahkan run sebagai argumen pertama, diikuti dengan nama perintah kustom. File konfigurasi build berikut memiliki argumen untuk menjalankan perintah kustom yang disebut build:

     steps:
 - name: 'node'
    entrypoint: 'npm'
    args: ['install']
 - name: 'node'
    entrypoint: 'npm'
    args: ['test']
 - name: 'node'
    entrypoint: 'npm'
    args: ['run', 'build']

  5. Upload ke Artifact Registry:

    Dalam file konfigurasi, tambahkan kolom npmPackages dan tentukan repositori npm Anda di Artifact Registry:

     artifacts:
    npmPackages:
    - repository: 'https://LOCATION-npm.pkg.dev/PROJECT-ID/REPOSITORY_NAME'
      packagePath: 'PACKAGE_PATH'

    Ganti nilai berikut:

    • LOCATION: lokasi untuk repositori Anda di Artifact Registry.
    • PROJECT_ID: ID project Google Cloud yang berisi repositori Artifact Registry Anda.
    • REPOSITORY_NAME: nama repositori npm Anda di Artifact Registry.
    • PACKAGE_PATH: jalur untuk direktori lokal yang berisi paket npm yang ingin Anda upload ke Artifact Registry. Sebaiknya gunakan jalur absolut. Nilai PACKAGE_PATH Anda dapat berupa . untuk menggunakan direktori kerja saat ini, tetapi kolom tidak boleh dihilangkan atau dikosongkan. Direktori ini harus berisi file package.json.

  6. Opsional: Mengaktifkan pembuatan asal

    Cloud Build dapat menghasilkan metadata provenans build Supply chain Levels for Software Artifacts (SLSA) yang dapat diverifikasi untuk membantu mengamankan pipeline continuous integration Anda.

    Untuk mengaktifkan pembuatan asal, tambahkan requestedVerifyOption: VERIFIED ke bagian options dalam file konfigurasi Anda.

  7. Mulai build: secara manual atau menggunakan pemicu build.

    Setelah build selesai, Anda dapat melihat detail repositori di Artifact Registry.

    Anda juga dapat melihat metadata asal build dan memvalidasi asal.

Menjalankan pengujian pada beberapa versi node

Terkadang Anda perlu memastikan bahwa project Anda berfungsi di beberapa versi node. Anda dapat membuat dan mengonfigurasi pemicu Cloud Build sehingga:

  • Dalam file konfigurasi build, tentukan versi node sebagai variabel penggantian.
  • Buat satu pemicu untuk setiap versi node yang ingin Anda gunakan untuk mem-build aplikasi.
  • Di setiap setelan pemicu, gunakan kolom nilai variabel penggantian untuk menunjukkan versi node untuk pemicu tersebut.

Langkah-langkah berikut menjelaskan cara menentukan versi node menggunakan variabel penggantian khusus pemicu:

  1. Di root repositori, tambahkan file konfigurasi build, yang menentukan versi node sebagai variabel penggantian. Dalam contoh file konfigurasi build berikut, $_NODE_VERSION adalah variabel penggantian yang ditentukan pengguna:

     steps:
 - name: 'node:$_NODE_VERSION'
   entrypoint: 'npm'
   args: ['install']
 - name: 'node:$_NODE_VERSION'
   entrypoint: 'npm'
   args: ['test']

  2. Untuk setiap versi node yang ingin Anda build, buat pemicu build menggunakan langkah-langkah berikut:

    1. Buka halaman Pemicu di konsol Google Cloud:

      Buka halaman Pemicu

    2. Pilih project Anda dari menu drop-down pemilih project di bagian atas halaman.

    3. Klik Buka.

    4. Klik Create trigger.

      Di halaman Create trigger, masukkan setelan berikut:

      1. Masukkan nama untuk pemicu Anda.

      2. Pilih peristiwa repositori untuk memulai pemicu Anda.

      3. Pilih repositori yang berisi kode sumber dan file konfigurasi build Anda.

      4. Tentukan ekspresi reguler untuk nama cabang atau tag yang akan memulai pemicu Anda.

      5. Configuration: Pilih file konfigurasi build yang Anda buat sebelumnya.

      6. Di bagian Substitution variables, klik Add variable.

        1. Di bagian Variable, tentukan variabel versi node yang Anda gunakan dalam file konfigurasi build, dan di bagian Value, tentukan versi node. Misalnya, _NODE_VERSION dan 12.

    5. Klik Buat untuk menyimpan pemicu build Anda.

Anda dapat menggunakan pemicu ini untuk mem-build kode pada versi node yang ditentukan dalam pemicu.

Langkah selanjutnya