Správa pracovných front Laravel s Beanstalk a dozorom na Ubuntu 16.04

Beanstalk je rýchly a jednoduchý pracovný front. Umožňuje vám asynchrónne spúšťať časovo náročné úlohy, ako je odosielanie e-mailov, pripojenie k externým API alebo spracovanie obrázkov. Tým znížite latenciu webovej aplikácie. Laravel poskytuje podporu pre beanstalkd.

V tomto návode nainštalujeme beanstalkd, nastavíme demo aplikáciu Laravel a budeme spravovať pracovníkov vo fronte cez Supervisor . Demo aplikácia získa zoznam dostupných OS z Vultr API a náhodne si jeden vyberie.

Predpokladá sa, že už máte vo svojom systéme nainštalovaného správcu. Ak tak neurobíte, mali by ste si prečítať nasledujúci návod, ako nastaviť správcu: Inštalácia a konfigurácia správcu na Ubuntu 16.04

Tiež sa predpokladá, že máte prístup SSH k svojej inštancii Vultr.

Inštalácia Beanstalk

Prvým krokom je inštalácia beanstalkd.

sudo apt-get update
sudo apt-get install beanstalkd

Spustite službu.

sudo systemctl start beanstalkd

Môžete tiež povoliť spustenie služby po inicializácii systému.

sudo systemctl enable beanstalkd

Skontrolujte stav služby zadaním nasledujúceho príkazu.

sudo systemctl status beanstalkd

V predvolenom nastavení beanstalkdpočúva na porte 11300. Beanstalk používa jednoduchý textový protokol opísaný v jeho úložisku github . Jeho protokol môžete otestovať spustením telnet.

telnet localhost 11300

Napíšte nasledovné a stlačte ENTER.

list-tubes

Mali by ste vidieť zoznam skúmaviek dostupných na serveri:

OK 14
---
- default

Na ukončenie spojenia jednoducho napíšte quita potom stlačte ENTER.

Rúry v Beanstalk predstavujú pracovné fronty. Stonky fazule tvoria v podstate výrobcovia , spotrebitelia , pracovné miesta a rúrky . Výrobcovia vkladajú úlohy do skúmavky, ktorú má spotrebovať (spracovať) ľubovoľný počet spotrebiteľov. Upozorňujeme, že výrobcovia aj spotrebitelia sú jednoducho klientmi servera Beanstalk a sú navzájom úplne nezávislí. V praxi to znamená, že pomocou Beanstalk môžete vytvárať svoje úlohy vo svojej aplikácii PHP a nechať ich spracovať napríklad v aplikácii NodeJS. Našťastie Laravel toto všetko abstrahuje a poskytuje nám veľmi jednoduché API na odosielanie a spracovanie úloh, ako uvidíme ďalej.

Ukážkový projekt

Na zostavenie nášho vzorového projektu musíme najskôr nainštalovať jeho závislosti. Nainštalujeme PHP a Composer.

sudo apt-get install php php-mbstring php-xml php-common php-zip composer

Teraz vytvorte projekt založený na Laravel 5.5.

composer create-project --prefer-dist laravel/laravel vultr "5.5.*"

Ďalej cddo nedávno vytvoreného priečinka. Odteraz budeme pracovať v tomto adresári. Tento priečinok môže byť neskôr označený ako PROJECT_ROOT.

cd vultr/

Ak chcete použiť Beanstalk v Laravel, musíme nainštalovať ešte jednu závislosť, klienta PHP Beanstalk.

composer require pda/pheanstalk ~3.0

Musíme tiež vytvoriť zastúpenie Job. V Laravel je to trieda v app/Jobspriečinku. Laravel má príkaz konzoly, ktorý nám pomôže vytvoriť triedu úloh. Poďme vytvoriť našu vzorovú prácu.

php artisan make:job FindFavoriteOS

Aktualizujte app/Jobs/FindFavoriteOS.phpsúbor na nasledujúci.

<?php

namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Support\Facades\Log;

class FindFavoriteOS implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    /**
     * Create a new job instance.
     *
     * @return void
     */
    public function __construct()
    {
        //
    }

    /**
     * Execute the job.
     *
     * @return void
     */
    public function handle()
    {
        $rawData = file_get_contents('https://api.vultr.com/v1/os/list');
        $list = json_decode($rawData, true);
        shuffle($list);
        $key = array_rand($list);
        $favorite = $list[$key];
        Log::info('My Favorite OS is: ' . $favorite['name']);
    }
}

Metóda handle je to, čo sa efektívne vykoná, keď je úloha spotrebovaná. Tu získavame údaje z Vultr API, náhodne vyberieme OS a zapíšeme zvolený OS do súboru denníka. Súbor denníka sa nachádza na adrese storage/logs/laravel.log.

Beanstalk sme už nainštalovali a definovali úlohu, ktorú má vykonať. Teraz je čas povedať Laravelovi, aby použil Beanstalk ako predvolený pracovný front. Skopírujte predvolený .envsúbor poskytnutý inštaláciou Laravel.

cp .env.example .env

Teraz otvorte .envsúbor a aktualizujte riadok, kde je zadaný ovládač frontu.

QUEUE_DRIVER=beanstalkd

Nakoniec vygenerujte aplikačný kľúč.

php artisan key:generate

Teraz sme pripravení odoslať úlohy do pracovného radu Beanstalk.

Dispečing a prevádzka úloh

Odoslanie práce v Laravel je celkom jednoduché. Aktualizujte routes/web.phpsúbor.

<?php

Route::get('/', function () {
    for ($i = 0; $i < 50; $i++) {
        \App\Jobs\FindFavoriteOS::dispatch();
    }

    return '50 Jobs dispatched!';
});

Napriek tomu, že sa neodporúča spúšťať vstavaný poskytnutý server vo výrobe, budeme ho tu používať kvôli stručnosti.

php artisan serve --host 0.0.0.0 --port 8000

Teraz vo webovom prehliadači prejdite na http://[vultr-instance-ip]:8000. Uvidíte nasledujúcu správu.

50 Jobs dispatched!

Otvorte nové pripojenie SSH k vášmu serveru a v koreňovom adresári nášho projektu vykonajte nasledujúce.

php artisan queue:work --once

Toto je očakávaný výstup:

[2018-02-14 00:03:52] Processing: App\Jobs\FindFavoriteOS
[2018-02-14 00:03:53] Processed:  App\Jobs\FindFavoriteOS

Potvrďte, že denník bol vygenerovaný.

cat storage/logs/laravel.log

Konfigurácia supervízora

Aby sme sa vyhli potrebe manuálneho spracovania frontu, použijeme supervisord. Vytvorte nasledujúcu konfiguráciu programu v /etc/supervisor/conf.d/vultr.conf.

[program:vultr]
process_name=%(program_name)s_%(process_num)02d
command=php [PROJECT_ROOT]/artisan queue:work
autostart=true
autorestart=true
numprocs=8
redirect_stderr=true
stdout_logfile=/var/log/worker.log

Všimnite si, že správna cesta na umiestnenie konfiguračného súboru správcu bude závisieť od vášho nastavenia. Nezabudnite tiež nahradiť [PROJECT_ROOT]úplnou cestou k súboru PROJECT_ROOTvo vašom systéme.

Tu konfigurujeme správcu tak, aby automaticky začal spracovávať front a v prípade zlyhania skriptu ho reštartoval. Všimnite si tiež, že nevytvárame inštanciu jedného pracovníka, ale 8 procesov. Môžete si vytvoriť inštanciu bez ohľadu na to, koľko procesov považujete za potrebné v závislosti od vašej aplikácie.

Ak chcete nadriadenému umožniť spravovať nášho pracovníka, prinútiť ho, aby si znova prečítal svoju konfiguráciu.

sudo supervisorctl reread
sudo supervisorctl update

Ak služba Dozorca nebola spustená, mnohí ju musíte spustiť.

sudo systemctl start supervisord

Teraz sa pozrime, či sa úlohy spracovávajú.

tail -f storage/logs/laravel.log

Vo webovom prehliadači prejdite na http://[vultr-instance-ip]:8000. Na vašej konzole uvidíte generované protokoly.

Záver

Úspešne sme nakonfigurovali aplikáciu Laravel na používanie Beanstalk ako pracovného frontu. Tiež sme ukázali, ako používať supervízor na riadenie pracovníkov.