tudásbázis

SEGÍTSÉG A DOMAIN, WEBTÁRHELY, VPS
ÉS EMAIL SZOLGÁLTATÁSOKHOZ

Válaszok gyakori kérdésekre

BitBucket repo telepítése Plesk Laravel alkalmazás segítségével

2024-12-13

Bella András

Ebben a tudásbázis cikkben lépésről lépésre végigvezetünk egy BitBucket repository telepítésén a Plesk Laravel kezelőfelületen keresztül. Ez a folyamat magában foglalja az alkalmazás telepítését, a Git repository klónozását, SSH kulcs hozzáadását, valamint az alkalmazás konfigurálását és beállítását.

1. Belépés a Plesk adminisztrációs felületére

Első lépésként jelentkezz be a Plesk felületére, ahol kezelheted a szerveren futó alkalmazásokat.
A bal oldali menüsorban keresd meg a "Laravel" menüpontot, és kattints rá.

2. Laravel alkalmazás telepítése

A Laravel kezelőfelületén kattints a "Install application" gombra, hogy elindítsd a telepítési folyamatot.

3. Domain és repository beállítása

A következő lépésben válaszd ki azt a domaint, amelyre a Laravel alkalmazást szeretnéd telepíteni.
Jelöld be az "Install from remote repository" opciót, hogy egy távoli Git repóból telepítsd az alkalmazást.

4. SSH kulcs hozzáadása a BitBucket repositoryhoz

Mielőtt klónoznád a repository-t, hozzá kell adnod a szervered SSH kulcsát a BitBuckethez.

Másold ki a Plesk felületén látható SSH kulcsot.
Menj a BitBucket felületére, majd navigálj a Repository settings menüpontra.
Itt keresd meg az Access keys szekciót, és illeszd be az SSH kulcsot, hogy hozzáférést adj a Plesk szervernek a repository-hoz.
Miután hozzáadtad az SSH kulcsot, a BitBucket repository SSH git linkjét illeszd be a Plesk "Repository" mezőjébe.
Kattints az "Install Application" gombra, hogy elindítsd a klónozási folyamatot.

5. Projekt telepítésének ellenőrzése

A "Deploying project" ablakban követheted a telepítési folyamatot. Ha sikeresen befejeződik, az ablak automatikusan bezárul.
Hibakezelés: Ha hiba lép fel, valószínűleg a repository URL-je nem helyes, vagy az SSH kulcsot nem adtad hozzá megfelelően. Ilyen esetben:

Ellenőrizd az URL-t és az SSH kulcsot.
Ha továbbra is hiba van, keress bennünket!

6. Environment változók beállítása

Miután sikeresen klónoztad a repository-t, konfiguráld az alkalmazás környezeti változóit:

Adatbázis beállítások (pl.: adatbázisnév, felhasználónév, jelszó)
Levelezési szolgáltatások (SMTP szerver, email címek stb.)
Fejlesztői környezet beállításai (pl.: debug mód, API kulcsok)

Ezt a .env fájlban vagy a Plesk kezelőfelületén is megadhatod.

7. Composer függőségek telepítése

A következő lépésben lépj át a "Composer" fülre, és futtasd le a szükséges függőségek telepítéséhez a következő parancsot:

composer install

Ez a parancs letölti és telepíti az összes szükséges PHP függőséget, amelyek az alkalmazás futtatásához kellenek.

8. Adatbázis migráció és seedelés

Lépj át az "Artisan" fülre, és futtasd az adatbázis migrációt a következő paranccsal:
css

php artisan migrate --seed

Ez a parancs létrehozza az adatbázis struktúráját, és ha van, feltölti azt alapadatokkal (seedelés).

9. Frontend telepítése (Node.js)

Ha az alkalmazásodnak van frontend része, amit külön kell telepíteni, lépj át a "Node.js" fülre, és válaszd ki a megfelelő Node.js verziót.

npm install
npm run build

Ezek a parancsok telepítik a frontendhez szükséges csomagokat, és előállítják az optimalizált, buildelt változatot.

Hasznos információk

1. Scheduled Tasks beállítása (CRON)

A Dashboard fülön engedélyezheted az időzített feladatok (Scheduled Tasks) futtatását.
Miután ez engedélyezve van, megjelenik egy új fül, "Scheduled Tasks", ahol megadhatod, hogy milyen parancsokat szeretnél időzítve futtatni.
Tipp: Ezeket a feladatokat manuálisan is lefuttathatod az Artisan fülön keresztül.
Minta parancs:/opt/plesk/php/8.3/bin/php 'httpdocs/artisan' 'schedule:run'

2. Artisan parancsok manuális futtatása

Az Artisan fül alatt további parancsokat futtathatsz le manuálisan, például cache törlése (php artisan cache:clear).

3.Queue kezelés

A Queue kezelése szintén a Dashboard fül alatt engedélyezhető. Miután engedélyezted, egy új Queue fül jelenik meg, ahol részletes beállításokat végezhetsz el, például a háttérben futó feladatok ütemezését, prioritását és egyéb specifikus paramétereket.

4. Maintenance mode (Karbantartási mód)

A Maintenance mode lehetővé teszi a weboldal ideiglenes leállítását, például karbantartási munkák vagy frissítések idejére. Ezt szintén a Dashboard fülön keresztül tudod aktiválni, így a látogatók egy karbantartási üzenetet kapnak, míg az alkalmazás zárt állapotban van.

5. CI / CD folyamat kezelése

A CI / CD (Continuous Integration/Continuous Deployment) funkciót a Deployment fül alatt kezelheted. Alapértelmezetten a rendszer manuális élesítési (deploy) módban van, ami azt jelenti, hogy kódmódosítások után manuálisan kell a "Deploy" gombra kattintani.

Kódmódosítás után javasolt újra lefuttatni a 7., 8., és 9. lépést, valamint ellenőrizni a .env fájlt a Dashboard → Environment Variables menüpont alatt.
Haladó felhasználók számára lehetőség van automatikus CI/CD folyamat kialakítására az "Automatic" kapcsoló használatával. Ebben az esetben a Webhook URL-en [továbbiakban WH] keresztül indítható a deploy folyamat. (Fontos: amennyiben BitBucket oldalról a hívás WH 403-as response kóddal tér vissza, akkor a plesk5 ... helyett az elérésben az IP címet kell megadni, pl.: https://plesk5.hosting.intelliweb.hu:8443/ -> https://185.43.207.65)
A Webhook URL a Deployment fül alatt található, és beállítható a repository kezelő felületén a repository settings → webhooks menüpont alatt. A webhook általában a git push eseményre reagál, tehát kód feltöltésekor automatikusan elindítja a deploy folyamatot.

Összegzés

Ez a lépésről lépésre összeállított útmutató segít a BitBucket repository Plesk Laravel környezetben történő telepítésében és konfigurálásában. A folyamat során gondosan ügyelj a repository SSH kulcsának helyes hozzáadására, valamint a környezeti változók és a futtatási parancsok megfelelő beállítására.