Cómo usar el bot de Lighthouse para establecer un presupuesto de rendimiento

Te esforzaste por obtener velocidad. Ahora, asegúrate de mantenerla automatizando las pruebas de rendimiento con Lighthouse Bot.

Lighthouse califica tu app en 5 categorías, y una de ellas es el rendimiento. Si bien puedes intentar recordar monitorear los cambios de rendimiento con DevTools o Lighthouse CLI cada vez que edites tu código, no es necesario que lo hagas. Las herramientas pueden hacer por ti las tareas tediosas. Travis CI es un excelente servicio que ejecuta automáticamente pruebas para tu app en la nube cada vez que envías código nuevo.

Lighthouse Bot se integra en Travis CI, y su función de presupuesto de rendimiento garantiza que no disminuyas el rendimiento por accidente sin darte cuenta. Puedes configurar tu repositorio para que no permita combinar solicitudes de extracción si las puntuaciones de Lighthouse son inferiores a el umbral que estableciste (p.ej., < 96/100).

Las verificaciones del bot de Lighthouse fallan en GitHub
Lighthouse Bot realiza verificaciones en GitHub.

Aunque puedes probar el rendimiento en localhost, tu sitio a menudo se comporta de manera diferente en los servidores en vivo. Para obtener un panorama más realista, lo mejor es implementar tu sitio en un servidor de pruebas. Puedes usar cualquier servicio de hosting. este guía de Firebase Hosting para dar una vuelta.

1. Configuración

Esta app sencilla te ayuda a ordenar tres números.

Clona el ejemplo de GitHub y asegúrate de agregarlo como repositorio a tu cuenta de GitHub.

2. Cómo implementar en Firebase

Para comenzar, necesitarás una cuenta de Firebase. Una vez que hayas hecho esto, haz clic en "Agregar proyecto" para crear un proyecto nuevo en Firebase console:

Implementa en Firebase

Necesitarás Firebase CLI para implementar la . Incluso si ya lo tienes instalado, te recomendamos que lo hagas con frecuencia actualiza la CLI a la versión más reciente con este comando:

npm install -g firebase-tools

Para autorizar Firebase CLI, ejecuta el siguiente comando:

firebase login

Ahora, inicializa el proyecto:

firebase init

La consola te hará una serie de preguntas durante la configuración:

  • Cuando se te solicite que selecciones funciones, elige “Alojamiento”.
  • Para el proyecto de Firebase predeterminado, selecciona el proyecto que creaste en Firebase console.
  • Escribe "public" como directorio público.
  • Escribe “N” (no) a la configuración como una app de una sola página.

Este proceso crea un archivo de configuración firebase.json en la raíz de tu del proyecto.

Felicitaciones, ya puedes realizar la implementación. Ejecución:

firebase deploy

En un instante, tendrás una app publicada.

3. Configura Travis

Deberás registrar una cuenta en Travis y, luego, activar la integración de apps de GitHub en la sección Configuración de tu perfil.

Integración de GitHub Apps en Travis CI

Una vez que tengas una cuenta

Ve a Configuración en tu perfil, presiona el botón Sync account y asegúrate de que el repositorio de tu proyecto aparezca en Travis.

Para iniciar la integración continua, necesitas dos elementos:

  1. Tener un archivo .travis.yml en el directorio raíz
  2. Para activar una compilación con un envío de git normal

El repositorio lighthouse-bot-starter ya tiene un archivo YAML .travis.yml:

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

El archivo YAML le indica a Travis que instale todas las dependencias y compile tu app. Ahora te toca enviar la app de ejemplo a tu propio repositorio de GitHub. Si aún no lo hiciste, ejecuta el siguiente comando:

git push origin main

Haz clic en tu repo en Configuración de Travis para ver el panel de Travis de tu proyecto. Si todo está bien, verás que tu compilación pasa de amarillo a verde en un par de minutos. 🎉

4. Automatiza la implementación de Firebase con Travis

En el paso 2, accediste a tu cuenta de Firebase y, luego, implementaste la app desde la línea de comandos con firebase deploy. Para que Travis implemente tu app en Firebase, debes autorizarlo. ¿Cómo puede hacerlo? Con un token de Firebase 🗝️🔥

Autoriza Firebase

Para generar el token, ejecuta este comando:

firebase login:ci

Se abrirá una pestaña nueva en una ventana del navegador para que Firebase pueda verificarte. Luego, vuelve a la consola y verás tu token recién creado. Cópialo y regresa a Travis.

En el panel de Travis de tu proyecto, ve a Más opciones > Configuración > Variables de entorno.

Pega el token en el campo de valor, asigna el nombre FIREBASE_TOKEN a la variable y agrégala.

Agrega una implementación a tu configuración de Travis

Necesitas las siguientes líneas para indicarle a Travis que implemente la app después de cada compilación exitosa. Agrégalos al final del archivo .travis.yml. 🔚

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

Envía este cambio a GitHub y espera tu primera implementación automática. Si observas tu registro de Travis, pronto debería decir ✔️ Implementación completa.

Ahora, cada vez que realices cambios en tu app, estos se implementarán automáticamente en Firebase.

5. Cómo configurar Lighthouse Bot

El bot de Lighthouse te informa sobre los puntajes de Lighthouse de tu app. Solo necesita una invitación a tu repo.

En GitHub, ve a la configuración del proyecto y agrega " Lighthousebot". como colaborador (Configuración > Colaboradores):

Estado de colaborador de bots de Lighthouse

Aprobar estas solicitudes es un proceso manual, por lo que no siempre se realizan de forma inmediata. Antes de comenzar las pruebas, asegúrate de que lighthousebot haya aprobado su estado de colaborador. Mientras tanto, también debes agregar otra llave a tu variables de entorno del proyecto en Travis. Deja tu correo electrónico aquí, y recibirá una clave Lighthouse Bot en su bandeja de entrada. 📬

En Travis, agrega esta clave como una variable de entorno y asígnale el nombre LIGHTHOUSE_API_KEY:

Agrega Lighthouse Bot a tu proyecto

A continuación, ejecuta el siguiente comando para agregar Lighthouse Bot a tu proyecto:

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

Agrega este bit a package.json:

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

Agrega el bot de Lighthouse a tu configuración de Travis

Para el truco final, prueba el rendimiento de la app después de cada paso. solicitud.

En .travis.yml, agrega otro paso en after_success:

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

Se ejecutará una auditoría de Lighthouse en la URL proporcionada, por lo que debes reemplazar https://staging.example.com por la URL de tu app (es decir, tu-app-123.firebaseapp.com).

Establece estándares altos y modifica la configuración para no aceptar cambios en la app que lleva la puntuación de rendimiento por debajo de 95:

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

Realiza una solicitud de extracción para activar la prueba de bot de Lighthouse en Travis

Lighthouse Bot solo probará las solicitudes de extracción, por lo que, si envías a la rama principal ahora, solo verás el mensaje "This script can only be run on Travis PR requests" en tu registro de Travis.

Para activar la prueba de Lighthouse Bot, haz lo siguiente:

  1. Confirmar la compra de una sucursal nueva
  2. Enviar a GitHub
  3. Cómo realizar una solicitud de extracción

No te pierdas la página de solicitud de extracción y espera a que cante Lighthouse Bot. 🎤

Puntuaciones de Lighthouse para aprobar

Pasa las verificaciones de GitHub

La puntuación de rendimiento es excelente, la app está dentro del presupuesto y se aprobó la verificación.

Más opciones de Lighthouse

¿Recuerdas cómo Lighthouse evalúa 5 categorías diferentes? Puedes aplicar puntuaciones para cualquiera de las marcas con las marcas de Lighthouse Bot:

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

Ejemplo:

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

La PR fallará si la puntuación de rendimiento cae por debajo de 93 o la puntuación de SEO cae por debajo de 100.

También puedes elegir no recibir los comentarios de Lighthouse Bot con la opción --no-comment.