Node.js Puppeteer ile Sunucudaki "Chrome Bulunamadı" ve Önbellek Yolu Sorunlarını Düzeltme

Node.js ve Laravel Sunucu Ortamında Kuklacı Zorluklarının Üstesinden Gelmek

Yerel bir geliştirme kurulumundan canlı bir sunucuya geçerken sıklıkla beklenmeyen yapılandırma sorunları ortaya çıkar. Özellikle sinir bozucu olabilecek bu tür bir sorun, Node.js kullanarak komut dosyası Kuklacı şu hatayı veriyor: "Chrome bulunamadı." Bu genellikle "www-data" gibi bir Apache sunucu hesabı altında Laravel tabanlı bir betiği çalıştırırken meydana gelir. 🖥️

Yerel bir makinede, Laravel komut dosyaları geçerli kullanıcının hesabı altında yürütülür; bu, ilgili tüm Node işlemlerinin o kullanıcının yapılandırmasını takip ettiği anlamına gelir. Ancak bir sunucuda izinler ve yollar değiştiğinden, Puppeteer'ın güvendiği Chrome ikili dosyasının bulunmasında zorluklar ortaya çıkar. Her ortamın kendine özgü tuhaflıkları ve gereksinimleri olduğundan, bu geliştiriciler için ortak bir zorluktur.

Bu hatanın ardındaki temel sorunlardan biri genellikle yanlış yapılandırılmış veya erişilemeyen bir önbellek yolu Chrome kurulumu için. Puppeteer için Chrome'u manuel olarak yüklemek yardımcı olabilir, ancak sorunu çözmek her zaman yeterli değildir. Birçok geliştirici, sistem düzeyindeki izinler için doğru yapılandırmanın Puppeteer'ı bir sunucuda sorunsuz çalıştırmanın anahtarı olduğunu buldu.

Bu makalede bu hatanın nasıl çözüleceğini açıklayacağız, önbellek yolu yapılandırmasının neden önemli olduğunu keşfedeceğiz ve pratik çözümleri paylaşacağız. 🛠️ Birkaç basit ayarlamayla Puppeteer komut dosyalarınızı sunucu ortamınızda güvenilir bir şekilde çalıştırabileceksiniz.

Sunucudaki Node.js'deki Kuklacı Önbellek Yolu Sorunlarını Anlama ve Çözme

Önceki bölümde sağlanan komut dosyaları, özellikle Node.js komut dosyası farklı bir kullanıcı hesabı (Apache altında "www-data" gibi) tarafından çalıştırıldığında, Puppeteer'ın bir sunucuda yüklü Chrome tarayıcısını bulmasına yardımcı olmak gibi kritik bir amaca hizmet eder. Bu hatanın ortaya çıkmasının temel nedenlerinden biri, Puppeteer'ın Chrome'u genellikle kullanıcıya özel olan varsayılan bir önbellek yolunda aramasıdır. Node betiği bir Apache kullanıcısı tarafından yürütüldüğünde, geçerli kullanıcının ana klasöründeki önbellek dizinine erişimi yoktur. Bu kurulum, aşağıdaki gibi alternatif bir yol ayarlamayı sağlar: /var/www/.cache/puppeteerÇalışan kullanıcıdan bağımsız olarak Chrome'a ​​erişilebilmesi için bu gereklidir. Bu dizini uygun izinlerle oluşturarak ve Puppeteer'ın önbelleğini buna bağlayarak, Chrome tarayıcısının Apache altında çalışan Puppeteer işlemi tarafından güvenilir bir şekilde bulunmasına izin veriyoruz.

Komut dosyalarının attığı ilk adımlardan biri, kullanarak önbellek dizininin var olduğundan emin olmaktır. fs.mkdirSync özyinelemeli seçeneği ile. Bu, ihtiyaç duyulan ana dizinlerin tek seferde oluşturulmasını garanti eder. Dizini oluşturduktan sonra komut dosyası, KUKLACI zulası ortam değişkenini Chrome'un yüklendiği yola yönlendirin. Bu ortam değişkeni kritiktir çünkü Puppeteer'ın varsayılan önbellek yolunu geçersiz kılar ve kullanıcıya özel bir yol yerine her zaman belirlenen sunucu dostu yolda görünmesini sağlar. Örneğin, bir hazırlama sunucusu üzerinde çalışıyorsanız ve Puppeteer'ın birden fazla hesapta tutarlı bir şekilde çalıştığından emin olmak istiyorsanız, ortam değişkenini paylaşılan bir konuma ayarlamak, eksik yürütülebilir dosyalar ile ilgili hataları önleyecektir.

Bu komut dosyalarında Puppeteer'ı başlatırken şunu belirtiyoruz: yürütülebilir Yol Chrome ikili dosyasına doğrudan yol sağlayan parametre. Bu, Puppeteer'ın belirli izinler altında başarısız olabilecek birden fazla dizinde arama yapma ihtiyacını ortadan kaldırır. Komut dosyalarında yer alan bir diğer yararlı komut ise args: ['--korumalı alan yok'], sunucu ortamlarında sıklıkla gerekli olan bir argümandır. Varsayılan olarak etkin olan korumalı alan modu bazen root yetkisine sahip olmayan kullanıcılara müdahale edebilir veya belirli sunucu yapılandırmalarındaki izinleri kısıtlayabilir. Bu argümanı ekleyerek Puppeteer'ın Chrome'u korumalı alan olmadan başlatmasına izin veriyoruz, bu da Linux sunucu ortamlarındaki izinlerle ilgili birçok hatayı çözüyor. 🖥️

Son olarak çözümün güvenilir bir şekilde çalıştığından emin olmak için birim testleri sağladık. Bu testler aşağıdaki gibi komutları kullanır: fs.rmdirSync önbellek dizinini sıfırlamak, testleri çalıştırmadan önce betiğin işlevselliğini doğrulayan temiz bir sayfa sağlamak. Ayrıca test, Puppeteer'ın Chrome'u belirtilen yolda bulabildiğini doğrulayarak tarayıcının başarılı şekilde başlatılıp başlatılmadığını kontrol eder. Bu, tarayıcı yapılandırmasının üretimde manuel ayarlamalar olmadan çalışacağını doğruladığından, otomatik dağıtımlara sahip sunucular için önemlidir. Örneğin, sürekli entegrasyon kurulumunda bu testler, kod her dağıtıldığında çalıştırılabilir ve geliştiricilere Puppeteer'ın yapılandırmasının sağlam olduğuna dair güven vererek canlı bir ortamda istenmeyen sürprizlerin önlenmesini sağlar. 🛠️

const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

// Ensure the cache directory exists with appropriate permissions
function ensureCacheDirectory() {
    if (!fs.existsSync(path)) {
        fs.mkdirSync(path, { recursive: true });
        console.log('Cache directory created.');
    }
}

// Launch Puppeteer with a custom cache path
async function launchBrowser() {
    ensureCacheDirectory();
    const browser = await puppeteer.launch({
        headless: true,
        executablePath: '/usr/bin/google-chrome-stable',
        userDataDir: path,
    });
    return browser;
}

// Main function to handle the process
(async () => {
    try {
        const browser = await launchBrowser();
        const page = await browser.newPage();
        await page.goto('https://example.com');
        console.log('Page loaded successfully');
        await browser.close();
    } catch (error) {
        console.error('Error launching browser:', error);
    }
})();

const puppeteer = require('puppeteer');
require('dotenv').config();

// Load cache path from environment variables
const CACHE_PATH = process.env.PUPPETEER_CACHE_PATH || '/var/www/.cache/puppeteer';
process.env.PUPPETEER_CACHE = CACHE_PATH;

// Ensure directory exists
const fs = require('fs');
if (!fs.existsSync(CACHE_PATH)) {
    fs.mkdirSync(CACHE_PATH, { recursive: true });
}

// Launch Puppeteer with environment-based cache path
async function launchBrowser() {
    const browser = await puppeteer.launch({
        headless: true,
        args: ['--no-sandbox'],
        executablePath: '/usr/bin/google-chrome-stable',
    });
    return browser;
}

(async () => {
    try {
        const browser = await launchBrowser();
        console.log('Browser launched successfully');
        await browser.close();
    } catch (error) {
        console.error('Launch error:', error);
    }
})();

const { exec } = require('child_process');
const puppeteer = require('puppeteer');
const fs = require('fs');
const path = '/var/www/.cache/puppeteer';

describe('Puppeteer Configuration Tests', () => {
    it('should create cache directory if missing', (done) => {
        if (fs.existsSync(path)) fs.rmdirSync(path, { recursive: true });
        exec('node setupScript.js', (error) => {
            if (error) return done(error);
            expect(fs.existsSync(path)).toBe(true);
            done();
        });
    });

    it('should launch Puppeteer successfully', async () => {
        const browser = await puppeteer.launch({
            headless: true,
            executablePath: '/usr/bin/google-chrome-stable',
            userDataDir: path,
        });
        expect(browser).toBeDefined();
        await browser.close();
    });
});

Çok Kullanıcılı Ortamlarda Kuklacı ve Chrome Yolu Hatalarını Çözme

Kullanırken karşılaşılan zorluklardan biri Kuklacı bir sunucu ortamında doğrunun sağlanmasıdır önbellek yolu Chrome için, özellikle de komut dosyası Apache'nin "www-data"sı gibi farklı bir kullanıcı hesabı altında çalıştığında. Bu kurulum, varsayılan Puppeteer önbellek yoluna "www-data" hesabı tarafından erişilemeyebileceği için genellikle yapılandırmayı karmaşık hale getirir. Puppeteer, Chrome ikili dosyasını bulamadığında, Chrome önceden yüklenmiş olsa bile genellikle "Chrome bulunamadı" hatasıyla sonuçlanır. Önbellek yolunu manuel olarak yapılandırmak veya ortam değişkenlerini ayarlamak, Puppeteer'ın kullanıcılar arasında paylaşılan bir dizine bakmasını sağlayarak bu sorunu çözebilir: /var/www/.cache/puppeteer.

Göz önünde bulundurulması gereken başka bir husus da, bir sunucu ortamında Puppeteer için özel başlatma argümanlarının ayarlanmasıdır. Örneğin, Chrome korumalı alanını devre dışı bırakmak args: ['--no-sandbox'] Root yetkisi olmayan kullanıcılar için korumalı alanı her zaman iyi şekilde ele almayan Linux sunucularında izin sorunlarının önlenmesine yardımcı olur. Bu seçenek, özel bir yürütülebilir yol belirtmenin yanı sıra Puppeteer'ın sunucu ortamlarıyla uyumluluğunu artırır. Yerel kurulumda, Puppeteer geçerli kullanıcının izinleriyle çalıştığı için bu sorunlarla karşılaşmayabilirsiniz, ancak üretimde daha kısıtlayıcı olan "www-data" kullanıcısı, açıkça yapılandırılmadığı sürece bazı kaynaklara erişemez.

Son olarak, komut dosyalarını paylaşılan veya üretim ortamlarında dağıtırken bu yapılandırmaları otomatikleştirmek iyi bir uygulamadır. Önbellek yolunu ayarlama ve Chrome'u aşağıdaki gibi bir komut kullanarak yükleme gibi adımları otomatikleştirme npx puppeteer browsers install her dağıtımın Puppeteer'ı manuel müdahale olmadan çalıştırmaya hazır olmasını sağlar. Ayrıca, Chrome'un doğru bir şekilde başlatıldığını doğrulamak için testler eklemek, yanlış yapılandırmalardan kaynaklanan kesintileri önleyebilir. Bu ayarlamalar, betiği çalıştıran kullanıcı hesabından bağımsız olarak Puppeteer'ın beklendiği gibi çalıştığı istikrarlı bir ortam oluşturmak için gereklidir. 🛠️