Інтеграція Puppeteer у Cloud Functions другого покоління: Практичний посібник

3 Березня 2024 в 17:26 28

Розробка синтетичних моніторів за допомогою Puppeteer для перевірки аутентифікованих сторінок є важливим аспектом забезпечення надійності веб-додатків. Використання Puppeteer у середовищі Cloud Functions другого покоління вимагає специфічного підходу, особливо коли мова йде про роботу з аутентифікованими сторінками.

Початкові умови

Згідно з документацією Google Cloud, синтетичні монітори дозволяють виконувати окремі функції другого покоління, розгорнуті на Cloud Run, для періодичної перевірки стану веб-сервісів. Для створення монітора, що автоматично логіниться на сайт і перевіряє доступність сторінок, можна використовувати Puppeteer – інструмент для автоматизації дій у браузері Chrome.

Виклик

Проте, під час імплементації можуть виникнути проблеми, зокрема, пов’язані з неможливістю знайти або запустити Chromium, що є необхідним для Puppeteer. Це може бути пов’язано або з невстановленням необхідних залежностей, або з некоректною конфігурацією шляху кешу.

Рішення

Перш за все, важливо переконатися, що всі необхідні залежності встановлено коректно. У випадку роботи з Cloud Functions другого покоління, розгорнутих на Cloud Run, потрібно створити власний Dockerfile з усіма необхідними системними пакетами для запуску Headless Chrome.

# Використання офіційного образу Node.js як базового
FROM node:20-slim
# Встановлення робочої директорії
WORKDIR /app
# Встановлення інструментів і бібліотек для Puppeteer і Chromium
RUN apt-get update && apt-get install -y \
    ca-certificates \
    fonts-liberation \
    gnupg \
    libasound2 \
    libatk-bridge2.0-0 \
    libatk1.0-0 \
    libc6 \
    libcairo2 \
    libcups2 \
    libdbus-1-3 \
    libexpat1 \
    libfontconfig1 \
    libgbm1 \
    libgcc1 \
    libglib2.0-0 \
    libgtk-3-0 \
    libnspr4 \
    libnss3 \
    libpango-1.0-0 \
    libpangocairo-1.0-0 \
    libstdc++6 \
    libx11-6 \
    libx11-xcb1 \
    libxcb1 \
    libxcomposite1 \
    libxcursor1 \
    libxdamage1 \
    libxext6 \
    libxfixes3 \
    libxi6 \
    libxrandr2 \
    libxrender1 \
    libxss1 \
    libxtst6 \
    lsb-release \
    procps \
    wget \
    xdg-utils \
    --no-install-recommends \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*
# Встановлення Chromium
RUN apt-get update \
    && apt-get install -y chromium \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*
# Копіювання файлів проекту
COPY . .
# Встановлення залежностей проекту
RUN npm install
# Запуск додатку
CMD ["node", "index.js"]

# Використання офіційного образу Node.js як базового

FROM node:20-slim

# Встановлення робочої директорії

WORKDIR /app

# Встановлення інструментів і бібліотек для Puppeteer і Chromium

RUN apt-get update && apt-get install -y \

ca-certificates \

fonts-liberation \

gnupg \

libasound2 \

libatk-bridge2.0-0 \

libatk1.0-0 \

libc6 \

libcairo2 \

libcups2 \

libdbus-1-3 \

libexpat1 \

libfontconfig1 \

libgbm1 \

libgcc1 \

libglib2.0-0 \

libgtk-3-0 \

libnspr4 \

libnss3 \

libpango-1.0-0 \

libpangocairo-1.0-0 \

libstdc++6 \

libx11-6 \

libx11-xcb1 \

libxcb1 \

libxcomposite1 \

libxcursor1 \

libxdamage1 \

libxext6 \

libxfixes3 \

libxi6 \

libxrandr2 \

libxrender1 \

libxss1 \

libxtst6 \

lsb-release \

procps \

wget \

xdg-utils \

--no-install-recommends \

&& apt-get clean \

&& rm -rf /var/lib/apt/lists/*

# Встановлення Chromium

RUN apt-get update \

&& apt-get install -y chromium \

&& apt-get clean \

&& rm -rf /var/lib/apt/lists/*

# Копіювання файлів проекту

COPY . .

# Встановлення залежностей проекту

RUN npm install

# Запуск додатку

CMD ["node", "index.js"]

Після створення Dockerfile, важливо переконатися, що Puppeteer налаштовано на використання локального шляху до Chromium, що можна зробити за допомогою конфігураційного файлу .puppeteerrc.cjs, де вказано кеш-директорію.

const {join} = require('path');
/**
 * @type {import("puppeteer").Configuration}
 */
module.exports = {
  cacheDirectory: join(__dirname, 'node_modules', '.puppeteer_cache'),
};

const {join} = require('path');

/**

* @type {import("puppeteer").Configuration}

module.exports = {

cacheDirectory: join(__dirname, 'node_modules', '.puppeteer_cache'),

};

Таке рішення дозволяє зберегти кеш між збірками і уникнути проблем, пов’язаних з перевстановленням Puppeteer. Після цього Puppeteer має бути налаштований на використання Chromium, встановленого у контейнері, що дозволяє успішно виконувати скрипти для перевірки аутентифікованих сторінок.

Висновок

Інтеграція Puppeteer у Cloud Functions другого покоління вимагає ретельного планування та налаштування. Створення спеціалізованого Dockerfile, налаштування шляху кешу для Puppeteer, і коректне використання Chromium є ключовими аспектами успішної імплементації. Дотримуючись цих рекомендацій, можна ефективно створити синтетичні монітори для перевірки аутентифікованих веб-сторінок, забезпечуючи високий рівень надійності та доступності веб-додатків.