A https://github.com/rcsnjszg/laravel-alap.git egy olyan alap projektet tartalmaz, ami már tartalmaz egy teljes webszervert docker alapokon, továbbá https://github.com/laravel/laravel oldalon található laravel 9-es verzióját.
A tároló klónozásával hozzunk létre egy új projektet.
A projekt_neve helyére illesszük be, hogy melyik mappában szeretnénk ezt megtenni.
git clone https://github.com/rcsnjszg/laravel-alap.git projekt_neveAmennyiben nem lenne git a gépünkön telepítve, az előbbi műveletet docker segítségével is megtehetjük:
Windows - CMD:
docker run -it --rm -v %cd%:/git alpine/git clone ^
https://github.com/rcsnjszg/laravel-alap.git projekt_neveWindows - Power Shell
docker run -it --rm -v /${PWD}:/git alpine/git clone \
https://github.com/rcsnjszg/laravel-alap.git projekt_neveMac és Linux - bash, zsh, fish
docker run -it --rm -v (pwd):/git alpine/git clone \
https://github.com/rcsnjszg/laravel-alap.git projekt_neveAhogy a Laravel projekt esetén, így itt is szükségünk lesz egy .env fájlra, amit a .env.example másolásával hozhatjuk létre a legegyszerűbben.
Ezt a gyökérkönyvtárban tegyük meg, hiszen ott található a .env.example fájl.
Windows - CMD:
copy .env.example .envWindows - Power Shell
Copy-Item .env.example .envMac és Linux - bash, zsh, fish
cp .env.example .env\pagebreak
Mivel a php nem egy kész image lesz, hanem mi magunk építjük fel, továbbá kiegészítéseket is telepítünk hozzá,
így a docker/php/Dockerfile "recept" alapján kell felépíteni:
docker compose buildElső futtatáskor sok időt vehet igénybe. Amennyiben a Dockerfile-t nem módosítjük legközelebb ezen gyorsan túlléphetünk
Innentől a docker compose up paranccsal indíthatjuk a szerverünket.
A -f meghatározza a compose fájl elérési útvonalát, ebbőltöbbet is használni fogunk.
- Az alap fájl a
docker-compose.yml - A
docker-compose.dev.ymlolyan felüldefiniálásokat tartalmaz, ami a fejlesztéshez fog kelleni. - A
docker-compose.prod.ymlolyan felüldefiniálásokat tartalmaz, ami majd a kész projekt futtatásakor, bemutatásakor használandó. - A
docker-compose.user.ymlakkor kellhet, ha felhasználó jogosultságok az adott gépen nem megfelelően lennének beállítva.
A -d kapcsoló segítségével detached módbín indítjuk, aminek eredményeképp a konténerek kimenete nem kerül a képernyőnkre.
docker compose -f docker-compose.yml -f docker-compose.dev.yml up -dHa szeretnénk visszakeresni, akkor a log fájlból visszanyerhetjük.
Mivel a laravel felhasznál rengeteg előre megírt osztályt, így eszeket a composer segítségével telepíteni kell.
Mivel ez egy php nyelven írt alkalmazás, így ezt a php konténerünkben kell, hogy futtassuk. Mivel a Dockerfile tartalmazza, így magát a composert nem szükséges letölteni/telepíteni.
docker compose exec app composer installA laravel működéséhez szükséges egy egyedi kulcs (API Key) generálása,
amit a laravelhez csomagolt konzolos php szkript,
az artisan megfelelő paraméterezésével key:generate hozhatjuk létre.
docker compose exec app php artisan key:generateItt az app a konténer neve, míg a második php magát a php-cli-t takarja.
Ekkor a .env fájlban az APP_KEY értékét beállítja.
Amennyiben az app konténeren belül adunk ki parancsokat,
úgy az elejéről a docker compose exec app elhagyható.
Ehhez elsőként csatlakozzunk a a konténerhez.
Mivel a docker compose segítségével indítottuk, így most is azt használhatjuk.
A docker compose exec kontener_neve futtatandó_program paraméterek sablon alapján tudunk nekiindulni.
Mivel egy shell-t szeretnénk kapni, így egy létező nevét adhatjuk meg.
Elsőként lehet a /bin/bash jut eszünkbe, de azt alapból az alpine php nem tartalmazza és nem is telepítettük.
Egy másik lehetőség, amit alapból tartalmaz az a /bin/sh. A két shell között akad némi különbség.
Egy kis összehasonlítás: https://www.baeldung.com/linux/sh-vs-bash.
A könnyebb kezelhetőség kedvéért a fish (friendly interactive shell)
hozzá lett adva a Dockerfile-ban, így érdemes ezt választani.
docker compose exec app fishAmenyiben a php konténerben vagyunk egyszerűen futtathatjuk a szükséges parancsokat.
composer install
php artisan key:generateNo application encryption key has been specified.
Amennyiben a kulcs lelett generálva, de ennek ellenére sem működik, akkor a konfigurációs cache-t érdemes újra generálni .
php artisan config:cache\pagebreak
Valamelyik fájl nem írható
Amennyiben jogosultság probléma állna fenn az alaáábi értékeket kellene helyesen megadni a .env fájlban.
Itt lesz szerepe a docker-compose.user.yml fájlnak.
UID=1000
GID=1000
UID értéke: id -u
GID értéke: id -g
The ability to automatically process UID and GID vars will not be added to compose. Reasoning is solidly explained on github (compose-spec/compose-spec#94) as a potential security hole in a declarative language.
- https://stackoverflow.com/questions/50552970/laravel-docker-the-stream-or-file-var-www-html-storage-logs-laravel-log-co
- https://stackoverflow.com/questions/56844746/how-to-set-uid-and-gid-in-docker compose
- https://dev.to/acro5piano/specifying-user-and-group-in-docker-i2e
Hogyan helyes? "composer" vagy "php composer"?
A konténerben a composer úgy van bekonfigurálva, hogy tudja sajátmagáról, hogy ő egy PHP script. Továbbá a PATH-ben szerepel a php elérési útvonala.
Ezeknek köszönhetően elhagyható a php a szkript futtatása előtt. Máshol szükséges kirakni!
Hogyan helyes? "artisan", "php artisan" vagy "./artisan"?
A composer-hez hasonlóan az artisan is php-ban megírt konzolos script lesz.
Meghívható a php közvetlen megadásával, de ez akár el is hahyható bizonyos esetekben.
Az artisan fájl a www mappa gyökerében szerepel, így célszerű ebből a mappából kiadni az artisan parancsokat.
A buildelés megszakadt, hibaüzenetet adott
Amennyiben a docker compose build leállna érdemes újra futtatni, és reménykedni.
\pagebreak
Amennyiben nem szeretnénk soronként futtatni létrehozhatunk olyan szkriptet, ami ezt automatizálja.
A git remote -v parancs segítségével nézhetjük meg, hogy jelenleg mi a beállított távoli repo.
git remote -vorigin git@github.com:rcsnjszg/laravel-alap.git (fetch)
origin git@github.com:rcsnjszg/laravel-alap.git (push)
Láthatjuk, hogy az a repo van beállítva, amit leklónoztunk.
Ugyan publikus, de a push művelethez nincs akárkinek jogosultsága.
Létre kell hozni egy saját repo-t. Ezt beállítani, és ide pusholni, illetve későbbiekben innen pullolni.
A git remote add nem használható, mert már hozzá lett adva (klónozáskor).
Kiadásakor error: remote origin already exists. hibaüzenetet kapunk.
A git remote set-url segítségével cserélhetjük le az URL-t.
Például
git remote set-url origin git@github.com:rcsnjszg/laravel-test-sajat.git