Menggunakan Lighthouse Bot untuk menetapkan anggaran performa

Anda telah bekerja keras untuk mendapatkan kecepatan, sekarang pastikan Anda tetap cepat dengan mengotomatiskan pengujian performa dengan Lighthouse Bot.

Lighthouse menilai aplikasi Anda dalam 5 kategori, dan salah satunya adalah performa. Meskipun Anda dapat mencoba mengingat untuk memantau perubahan performa dengan DevTools atau Lighthouse CLI setiap kali mengedit kode, Anda tidak perlu melakukannya. Alat dapat melakukan hal-hal yang membosankan untuk Anda. Travis CI adalah layanan hebat yang otomatis menjalankan pengujian untuk aplikasi Anda di cloud setiap kali Anda mendorong kode baru.

Lighthouse Bot terintegrasi dengan Travis CI, dan fitur anggaran performanya memastikan bahwa Anda tidak akan tidak sengaja mendowngrade performa tanpa menyadarinya. Anda dapat mengonfigurasi repositori agar tidak mengizinkan penggabungan permintaan pull jika skor Lighthouse berada di bawah nilai minimum yang telah Anda tetapkan (misalnya, < 96/100).

Pemeriksaan Lighthouse Bot gagal di GitHub
Pemeriksaan Bot Lighthouse di GitHub.

Meskipun Anda dapat menguji performa di localhost, situs Anda sering kali akan berperforma berbeda di server aktif. Untuk mendapatkan gambaran yang lebih realistis, sebaiknya deploy situs Anda ke server staging. Anda dapat menggunakan layanan hosting apa pun; panduan ini akan menggunakan Firebase Hosting.

1. Penyiapan

Aplikasi sederhana ini membantu Anda mengurutkan tiga angka.

Clone contoh dari GitHub, dan pastikan untuk menambahkannya sebagai repositori di akun GitHub Anda.

2. Men-deploy ke Firebase

Untuk memulai, Anda memerlukan akun Firebase. Setelah melakukannya, buat project baru di Firebase console dengan mengklik "Add project":

Men-deploy ke Firebase

Anda memerlukan Firebase CLI untuk men-deploy aplikasi. Meskipun sudah menginstalnya, sebaiknya Anda sering mengupdate CLI ke versi terbaru dengan perintah ini:

npm install -g firebase-tools

Untuk memberikan otorisasi pada Firebase CLI, jalankan:

firebase login

Sekarang inisialisasi project:

firebase init

Konsol akan mengajukan serangkaian pertanyaan kepada Anda selama penyiapan:

  • Saat diminta memilih fitur, pilih "Hosting".
  • Untuk project Firebase default, pilih project yang telah Anda buat di Firebase console.
  • Ketik "public" sebagai direktori publik Anda.
  • Ketik "N" (tidak) untuk mengonfigurasi sebagai aplikasi web satu halaman.

Proses ini akan membuat file konfigurasi firebase.json di root direktori project Anda.

Selamat, Anda siap men-deploy. Jalankan:

firebase deploy

Dalam hitungan detik, Anda akan memiliki aplikasi yang aktif.

3. Menyiapkan Travis

Anda harus mendaftarkan akun di Travis, lalu mengaktifkan integrasi Aplikasi GitHub di bagian Setelan di profil Anda.

Integrasi Aplikasi GitHub di Travis CI

Setelah Anda memiliki akun

Buka Setelan di bagian profil Anda, tekan tombol Sinkronkan akun, dan pastikan repo project Anda tercantum di Travis.

Untuk memulai continuous integration, Anda memerlukan dua hal:

  1. Untuk memiliki file .travis.yml di direktori utama
  2. Untuk memicu build dengan melakukan push git lama biasa

Repositori lighthouse-bot-starter sudah memiliki file YAML .travis.yml:

language: node_js
node_js:
  - "8.1.3"
install:
  - npm install
before_script:
  - npm install -g firebase-tools
script:
  - webpack

File YAML memberi tahu Travis untuk menginstal semua dependensi dan mem-build aplikasi Anda. Sekarang giliran Anda untuk mengirim aplikasi contoh ke repositori GitHub Anda sendiri. Jika Anda belum melakukannya, jalankan perintah berikut:

git push origin main

Klik repo Anda di bagian Setelan di Travis untuk melihat dasbor Travis project Anda. Jika semuanya baik-baik saja, Anda akan melihat build berubah dari kuning menjadi hijau dalam beberapa menit. 🎉

4. Mengotomatiskan deployment Firebase dengan Travis

Pada Langkah 2, Anda login ke akun Firebase dan men-deploy aplikasi dari command line dengan firebase deploy. Agar Travis dapat men-deploy aplikasi ke Firebase, Anda harus memberikan otorisasi. Bagaimana Anda melakukannya? Dengan token Firebase. 🗝️🔥

Memberi otorisasi ke Firebase

Untuk membuat token, jalankan perintah ini:

firebase login:ci

Tindakan ini akan membuka tab baru di jendela browser sehingga Firebase dapat memverifikasi Anda. Setelah itu, lihat kembali konsol, dan Anda akan melihat token yang baru dibuat. Salin dan kembali ke Travis.

Di dasbor Travis project Anda, buka Opsi lainnya > Setelan > Variabel lingkungan.

Tempelkan token di kolom nilai, beri nama variabel FIREBASE_TOKEN, lalu tambahkan.

Menambahkan deployment ke penyiapan Travis

Anda memerlukan baris berikut untuk memberi tahu Travis agar men-deploy aplikasi setelah setiap build berhasil. Tambahkan ke akhir file .travis.yml. 🔚

after_success:
  - firebase deploy --token $FIREBASE_TOKEN --non-interactive

Kirim perubahan ini ke GitHub dan tunggu deployment otomatis pertama Anda. Jika Anda melihat log Travis, log tersebut akan segera menampilkan ✔️ Deployment selesai.

Sekarang, setiap kali Anda membuat perubahan pada aplikasi, perubahan tersebut akan otomatis di-deploy ke Firebase.

5. Menyiapkan Bot Lighthouse

Friendly Lighthouse Bot akan memberi tahu Anda tentang skor Lighthouse aplikasi Anda. Anda hanya memerlukan undangan ke repo Anda.

Di GitHub, buka setelan project Anda dan tambahkan "badgebot" sebagai kolaborator (Settings>Collaborators):

Status kolaborator bot Lighthouse

Menyetujui permintaan ini adalah proses manual sehingga tidak selalu terjadi secara instan. Sebelum Anda memulai pengujian, pastikan lighthousebot telah menyetujui status kolaboratornya. Sementara itu, Anda juga perlu menambahkan kunci lain ke variabel lingkungan project di Travis. Berikan email Anda di sini, dan Anda akan mendapatkan kunci Lighthouse Bot di kotak masuk. 📬

Di Travis, tambahkan kunci ini sebagai variabel lingkungan dan beri nama LIGHTHOUSE_API_KEY:

Menambahkan Lighthouse Bot ke project Anda

Selanjutnya, tambahkan Lighthouse Bot ke project Anda dengan menjalankan:

npm i --save-dev https://github.com/ebidel/lighthousebot

Dan tambahkan bagian ini ke package.json:

"scripts": {
  "lh": "lighthousebot"
}

Menambahkan Lighthouse Bot ke konfigurasi Travis

Untuk trik terakhir, uji performa aplikasi setelah setiap permintaan pull.

Di .travis.yml, tambahkan langkah lain di after_success:

after_success:
  - firebase deploy --token $FIREBASE_TOKEN --non-interactive
  - npm run lh -- https://staging.example.com

Audit ini akan menjalankan audit Lighthouse pada URL yang diberikan. Jadi, ganti https://staging.example.com dengan URL aplikasi Anda (yaitu aplikasi-anda-123.firebaseapp.com).

Tetapkan standar yang tinggi dan sesuaikan penyiapan sehingga Anda tidak menerima perubahan apa pun pada aplikasi yang membuat skor performa di bawah 95:

- npm run lh -- --perf=95 https://staging.example.com

Membuat permintaan pull untuk memicu pengujian Lighthouse Bot di Travis

Lighthouse Bot hanya akan menguji permintaan pull, jadi jika Anda melakukan push ke cabang utama sekarang, Anda hanya akan mendapatkan "Skrip ini hanya dapat dijalankan pada permintaan PR Travis" di log Travis.

Untuk memicu pengujian Bot Lighthouse:

  1. Melakukan checkout cabang baru
  2. Kirim ke GitHub
  3. Membuat permintaan pull

Tunggu di halaman permintaan pull tersebut dan tunggu Lighthouse Bot bernyanyi. 🎤

Lulus skor Lighthouse

Lulus pemeriksaan GitHub

Skor performanya bagus, aplikasi berada di bawah anggaran, dan pemeriksaan telah lulus.

Opsi Lighthouse lainnya

Ingat bagaimana Lighthouse menguji 5 kategori berbeda? Anda dapat menerapkan skor untuk salah satu dari flag Lighthouse Bot:

--perf  # performance
--pwa   # progressive web app score
--a11y  # accessibility score
--bp    # best practices score
--seo   # SEO score

Contoh:

npm run lh -- --perf=93 --seo=100 https://staging.example.com

Hal ini akan menyebabkan PR gagal jika skor performa turun di bawah 93 atau skor SEO menurun di bawah 100.

Anda juga dapat memilih untuk tidak mendapatkan komentar Lighthouse Bot dengan opsi --no-comment.