Laravel-kirjasto¶

yhteenveto

Laravel-kirjasto on ilmainen Plesk-tunniste, jonka avulla voit yksinkertaistaa Laravel-sovellusten isännöintiin liittyviä rutiinitehtäviä.

Tässä aiheessa opit lataamaan palvelimeen, määrittämään ja suorittamaan Laravel-sovelluksia Plesk-ympäristössä. Huomaa, että tämä aihe olettaa, että sinulla on jo valmis sovellus tai aiot luoda sellaisen. Tämä ei ole opas Laravel-sovellusten luomiseen.

Edellytykset¶

Ennen kuin voit isännöidä Laravel-sovelluksia, Plesk-palvelimelle on asennettava ilmainen Laravel-kirjasto-tunniste:

Jos olet Pleskin järjestelmänvalvoja, asenna tunniste Tunnisteluettelosta.
Muussa tapauksessa ota yhteyttä palveluntarjoajaan ja pyydä häntä asentamaan tunniste puolestasi.

Kun laajennus on asennettu, olet valmis aloittamaan. Näet Laravel-painikkeen navigointipaneelissa sekä ”Create Website” -laatikossa kaikkien toimialueidesi korteissa.

Sovelluksen lataaminen¶

Ennen kuin voit määrittää ja suorittaa sovelluksesi, sinun on ladattava se Plesk-palvelimelle ja rekisteröitävä se Laravel-kirjastoon. Tämän voi tehdä kolmella tavalla:

Luo Laravel-kehys. Jos sovelluksesi on tallennettu kansioon tai pakattuun tiedostoon tietokoneellesi tai haluat luoda sovelluksen alusta alkaen, Laravel-kirjasto voi luoda tarvittavan hakemistorakenteen sekä paikallisen Git-säilön.
Asenna etä-Git-säilöstä. Jos sovelluksesi on tallennettu etäsäilöön, voit ottaa sen käyttöön Plesk-palvelimella.
Skannaa olemassa oleva sovellus. Jos olet jo ladannut sovelluksesi Plesk-palvelimelle, voit rekisteröidä sovelluksesi Laravel-kirjastoon skannaamalla sen.

Muista

Jotta voit luoda Laravel-kehyksen tai asentaa etä-Git-säilöstä, Plesk-palvelimelle on asennettava ilmainen Git-laajennus.

Laravel-kehyksen luominen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi toimialue, joka isännöi sovellustasi, ja napsauta sitten Create Website > Laravel.
Valitse ”Install Skeleton” ja napsauta Asenna sovellus.
Kun kehys on asennettu, sinun on ladattava sovelluksesi tiedostot Plesk-palvelimelle (esimerkiksi käyttämällä FTP tai Tiedostonhallinta), korvaten oletustiedostot tarpeen mukaan.

Asentaminen etä-Git-säilöstä:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi toimialue, joka isännöi sovellustasi, ja napsauta sitten Create Website > Laravel.
Valitse ”Asenna etäpakettivarastosta”.
Kirjoita tai liitä sovelluksesi tiedostot sisältävän etäsäilön URL-osoite.
Jos etäsäilö vaatii todennuksen, lisää säilöön tällä sivulla näkyvä julkinen avain.
Napsauta Asenna sovellus.

Olemassa olevan sovelluksen skannaaminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi toimialue, joka isännöi sovellustasi, ja avaa ”Isännöinti ja DNS”-välilehti.
Napsauta Isännöinti.
Muuta ”Kotikansio”-arvoa vastaamaan sovelluksesi public-hakemiston polkua (oletuksena /httpdocs/public) ja napsauta sitten Tallenna.
Palaa ”Dashboard”-välilehdelle, napsauta Create Website > Laravel, napsauta Peruuta ja napsauta sitten Skannaa.

Kun olet ladannut tai ottanut käyttöön sovelluksesi tiedostot ja sovellus on rekisteröity Laravel-kirjastoon, Laravel-painike ilmestyy sovellusta isännöivän toimialueen kortissa.

Voit nyt siirtyä seuraavaan vaiheeseen.

Artisan-, Composer- ja Node.js-komentojen suorittaminen¶

Laravel-sovelluksen hallintaan tarvitset todennäköisesti Artisan-, Composer- ja/tai Node.js-komentoja. Laravel-kirjasto tekee niiden suorittamisesta helppoa Plesk-liittymästä ilman shell-käyttöoikeutta.

Jos et ole varma, tarvitsetko Artisan-, Composer- ja/tai Node.js-komentoja sovelluksesi oikeaan toimintaan, ota yhteyttä henkilöön tai organisaatioon, joka toimitti sovelluksen sinulle.

Muista

Node.js-komentojen suorittamiseksi Plesk-palvelimelle on asennettava ilmainen Node.js-laajennus.

Artisan-, Composer- tai Node.js-komennon suorittaminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Siirry vastaavaan välilehteen, kirjoita suoritettava komento tai valitse se luettelosta ja paina sitten Enter-näppäintä tai napsauta -painiketta.

Muista

Kun suoritat Node.js-komentoja, saatat joutua määrittämään tietyn Node.js-version ja/tai pakettienhallinnan, jotta komento toimii halutulla tavalla. Jos et ole varma, mitä valita, ota yhteyttä henkilöön tai organisaatioon, joka toimitti sovelluksen sinulle.

Sovelluksen lokitiedostojen katseleminen¶

Sovelluksen suorituksen aikana Laravel-sovellus kirjoittaa lokinsa erilliseen lokitiedostoon. Voit nähdä tiedoston sisällön suoraan Laravel-kirjaston liittymästä, mikä helpottaa sovelluksen valvontaa ja mahdollisten ongelmien vianmääritystä.

Sovelluksen lokin katseleminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Napsauta Lokit.

Tämä avaa toimialueen lokiselaimen, jossa näkyvät vain Laravel-lokin lokimerkinnät.

Sovelluksen ajoitettujen tehtävien katseleminen¶

Laravelilla voit ajoittaa tehtäviä sovelluksen koodin sisällä sen sijaan, että käyttäisit ulkoista ajastinta, kuten cronia. Laravel-kirjaston avulla voit nähdä kaikki tällä hetkellä määritetyt ajoitetut tehtävät suoraan Laravel-kirjaston liittymästä sekä ottaa Laravelin ajoitetut tehtävät käyttöön tai poistaa ne käytöstä.

Muista

Et voi lisätä, poistaa tai muokata Laravelin ajoitettuja tehtäviä Laravel-kirjaston liittymästä. Lue, miten tehtävät ajoitetaan sovelluksen koodin sisällä

Sovelluksen ajoitettujen tehtävien katseleminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Siirry ”Ajoitetut tehtävät” -välilehdelle (välilehti näkyy vain, kun yksi tai useampi ajoitettu tehtävä on määritetty).

Muista

Jotta voit ottaa sovelluksesi ajoitetut tehtävät käyttöön tai poistaa ne käytöstä, sinun on ensin suoritettava tietty toimenpide riippuen siitä, käytätkö Plesk for Linux -versiota vai Plesk for Windows -versiota. Sinun on tehtävä se jokaiselle toimialueelle, jossa isännöidään Laravel-sovellusta, jonka ajoitettuja tehtäviä haluat suorittaa.

Ajoitettujen tehtävien hallinnan ottaminen käyttöön:

Kirjaudu Pleskiin.
Ota ”Ajoitustoiminnon hallinta” -käyttöoikeus käyttöön (löytyy ”Käyttöoikeudet”-välilehdeltä) tilaukselle, johon sovellusta isännöivä toimialue kuuluu.
(Plesk for Linux) Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue, siirry ”Isännöinti ja DNS”-välilehdelle ja napsauta Isännöinti.
(Plesk for Linux) Valitse ”SSH Access”-kohdasta jokin muu vaihtoehto kuin ”Forbidden” ja napsauta sitten Tallenna.

Voit nyt ottaa sovelluksesi ajoitetut tehtävät käyttöön tai poistaa ne käytöstä.

Sovelluksesi ajoitettujen tehtävien ottaminen käyttöön:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Napsauta Ajoitetut tehtävät -kytkintä, jotta se näyttää ”Käytössä”.

Ajoitetut tehtävät on nyt otettu käyttöön Laravel-sovelluksellesi.

Ympäristömuuttujien muokkaaminen¶

Sovelluksesi saattaa tarvita yhden tai useamman mukautetun ympäristömuuttujan toimiakseen oikein, tai sen toiminta voi muuttua asetettujen ympäristömuuttujien mukaan. Jos et ole varma, tarvitseeko sovelluksesi ympäristömuuttujia toimiakseen oikein, ota yhteyttä henkilöön tai organisaatioon, joka toimitti sovelluksen sinulle.

Ympäristömuuttujien muokkaaminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Napsauta ”Environment variables (.env)” -kohdan vieressä olevaa Muokkaa-painiketta.
Muokkaa ympäristömuuttujia tarpeen mukaan ja napsauta sitten Päivitä.

Päivitetyt ympäristömuuttujat ovat nyt voimassa.

Sovelluksen siirtäminen ylläpitotilaan¶

Estääksesi verkkosivuston kävijöitä näkemästä virheitä sovelluksen työstämisen tai päivittämisen aikana, voit siirtää sen ylläpitotilaan. Kun sovellus on ylläpitotilassa, verkkosivuston kävijät näkevät sivun, jossa lukee virhe ”503 SERVICE UNAVAILABLE”.

Sovelluksen siirtäminen ylläpitotilaan:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Napsauta Ylläpitotila-kytkintä, jotta se näyttää ”Käytössä”.

Laravel-sovelluksesi on nyt ylläpitotilassa.

Muista

Muista poistaa sovelluksesi ylläpitotilasta, kun olet lopettanut sen työstämisen tai päivittämisen.

Sovelluksen päivittäminen¶

Riippumatta siitä, onko Laravel-sovelluksesi tiedostot tallennettu paikalliseen vai etä-Git-säilöön, sinun on varmistettava, että sovelluksen koodiin tehdyt muutokset siirtyvät Plesk-palvelimelle. Voit valita muutosten ottamisen käyttöön manuaalisesti tai automaattisesti.

Jos haluat tarkan hallinnan siitä, milloin sovellus päivitetään, suosittelemme päivittämistä manuaalisesti. Tällöin säilössä olevan sovelluksen koodin muutoksia ei siirretä Plesk-palvelimelle ennen kuin olet valmis. Tämän lähestymistavan haittapuoli on, että sinun on tehtävä manuaalisia toimia aina, kun sovellus on päivitettävä.

Sovelluksen päivittäminen manuaalisesti:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Siirry ”Deployment”-välilehdelle ja valitse kohdasta ”Deployment mode” ”Manual”-valintanappi.
Poista ”Deployment scenario”-kohdan alta valintaruudut niiden vaiheiden kohdalta, joita et halua suorittaa käyttöönoton aikana, ja napsauta sitten Deploy.

Kun Laravel-kirjasto on suorittanut kaikki käyttöönottovaiheet, sovelluksesi ja sen riippuvuudet päivitetään.

Jos haluat, että sovelluksen koodiin tehdyt muutokset siirtyvät automaattisesti Plesk-palvelimelle, menetelmä eroaa sen mukaan, onko sovelluksen koodi tallennettu paikalliseen vai etä-Git-säilöön.

Sovelluksen päivittäminen automaattisesti (paikallinen säilö):

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Siirry ”Deployment”-välilehdelle ja valitse ”Deployment mode”-kohdan alta ”Automatic”-valintanappi.
Poista ”Deployment scenario”-kohdan alta valintaruudut niiden vaiheiden kohdalta, joita et halua suorittaa käyttöönoton aikana.

Nyt aina, kun commit työnnetään paikallisen säilön master-haaraan, johon sovelluksen koodi on tallennettu, sovelluksesi ja sen riippuvuudet päivitetään.

Sovelluksen päivittäminen automaattisesti (etäsäilö):

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Kopioi tässä näkyvä webhook-URL-osoite ja lisää se etäsäilöön. Katso tarkemmat ohjeet palveluntarjoajasi dokumentaatiosta.
Siirry ”Deployment”-välilehdelle ja valitse ”Deployment mode”-kohdan alta ”Automatic”-valintanappi.
Poista ”Deployment scenario”-kohdan alta valintaruudut niiden vaiheiden kohdalta, joita et halua suorittaa käyttöönoton aikana.

Nyt aina, kun webhookin laukaiseva tapahtuma tapahtuu etäsäilössä, johon sovelluksen koodi on tallennettu, sovelluksesi ja sen riippuvuudet päivitetään.

Käyttöönottoskriptin määrittäminen¶

Sovelluksesi saattaa vaatia tiettyjen komentojen suorittamista palvelimella käyttöönoton aikana, jotta se toimii oikein. Komentojen manuaalisen suorittamisen välttämiseksi voit määrittää käyttöönottoskriptin, joka suoritetaan aina, kun sovellusta päivitetään.

Jos et ole varma, tarvitseeko sovelluksesi komentoja suoritettavaksi käyttöönoton aikana toimiakseen oikein, ota yhteyttä henkilöön tai organisaatioon, joka toimitti sovelluksen sinulle.

Muista

Plesk for Linux -versiossa sinun on otettava SSH-käyttö käyttöön ennen kuin voit muokata käyttöönottoskriptiä Laravel-kirjaston liittymästä. Tämä tarvitsee tehdä vain kerran.

(Plesk for Linux) Käyttöönottoskriptin muokkaamisen mahdollistaminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue, siirry ”Isännöinti ja DNS”-välilehdelle ja napsauta Isännöinti.
Valitse ”SSH Access”-kohdasta jokin muu vaihtoehto kuin ”Forbidden” ja napsauta sitten Tallenna.

Voit nyt muokata käyttöönottoskriptiä Laravel-kirjaston liittymästä.

Käyttöönottoskriptin muokkaaminen:

Kirjaudu Pleskiin.
Siirry kohtaan Verkkosivustot ja toimialueet, etsi sovellusta isännöivä toimialue ja napsauta Laravel.
Siirry ”Deployment”-välilehdelle ja napsauta Muokkaa skriptiä.
Kirjoita tai liitä käyttöönottoskriptisi ja napsauta sitten Päivitä.

Käyttöönottoskripti on nyt voimassa, ja sitä suoritetaan aina, kun päivität sovelluksesi.

Jonojen hallinta¶

Laravelin jonot mahdollistavat aikaa vievien tehtävien, kuten ladatun tiedoston jäsentämisen, käsittelyn asynkronisesti taustalla. Jos sovelluksesi tukee jonoja, voit ottaa ne käyttöön Plesk-ympäristössä ja määrittää jonon työprosessin.

Jonojen käyttämiseksi sinun on otettava ne käyttöön tilauksellesi ja luotava tietokanta, jota jonon työprosessi käyttää. Tämä on kertaluonteinen toimenpide.

Laravel-jonot voivat käyttää useita jonotaustoja. Tässä oppaassa käsittelemme kuitenkin vain MySQL/MariaDB-tietokannan käyttöä taustana. Tämä on yksinkertaisin tapa ottaa jonot käyttöön Plesk-ympäristössä, ja se riittää useimmille käyttäjille. Muut taustat voivat tarjota etuja, kuten parempia käyttöaikoja, mutta niiden käyttöönotto ja ylläpito vaativat asiantuntemusta, ja ne voivat myös aiheuttaa lisäkustannuksia.

Jonojen ottaminen käyttöön:

Kirjaudu sisään Pleskiin ja etsi sitten sovellusta isännöivä toimialue.
Ota ajoitetut tehtävät käyttöön sovelluksellesi. Tämä on välttämätöntä, jotta jonot toimivat.
Lisää sovelluksesi Git-projektisäilön composer.json-tiedoston ”require”-osioon seuraava rivi:
```
"plesk/ext-laravel-integration": "^7.0"
```
Muista

composer.json-tiedoston jokaisessa osiossa jokaisen rivin paitsi viimeisen on päätyttävä pilkkuun.

Jos käytät paikallista Git-säilöä, älä tee tätä muutosta Tiedostonhallinnan kautta. Tee sen sijaan muutokset säilöön commit-toiminnolla. Näin vältetään, että muutokset ylikirjoitetaan seuraavan käyttöönoton yhteydessä.
Napsauta Laravel, siirry ”Deployment”-välilehdelle ja napsauta Deploy. Tämä johtaa composer.lock-tiedoston sisällön muutoksiin. Tee nämä muutokset säilöön commitilla, jotta muutokset eivät ylikirjoitu seuraavan käyttöönoton yhteydessä.
Kun olet tehnyt commitin, napsauta Deploy vielä kerran.
(Valinnainen) Palaa toimialueen kortille, napsauta Tietokannat ja napsauta sitten Lisää tietokanta.

Muista

Jos Laravel-sovelluksesi käyttää jo MySQL/MariaDB-tietokantaa, voit käyttää sitä jonojen ottamiseen käyttöön. Tässä tapauksessa ohita tämä vaihe ja myös seuraava vaihe.
(Valinnainen) Luo MySQL- tai MariaDB-tietokanta ja tietokannan käyttäjä.
Palaa toimialueen korttiin, napsauta Laravel ja napsauta sitten ”Environment variables (.env)”-kohdan vieressä olevaa Muokkaa-painiketta.
Lisää seuraavat rivit .env-tiedostoon korvaamalla paikanvaraajat tietokannan tiedoilla, jota haluat käyttää (joko juuri luotu tai se, jota Laravel-sovelluksesi jo käyttää):
```
DB_CONNECTION=mysql
DB_HOST=<database server IP address or hostname>
QUEUE_CONNECTION=database
DB_DATABASE=<database name>
DB_USERNAME=<database user name>
DB_PASSWORD=<database user password>
```
ja napsauta sitten ”Päivitä”.
Sovelluksen siirtäminen ylläpitotilaan.
Siirry ”Artisan”-välilehdelle ja suorita seuraavat komennot tässä järjestyksessä:

queue:table

migrate
Siirry ”Koontinäyttö”-välilehdelle, poista sovellus ylläpitotilasta ja napsauta Queue-kytkintä, jotta se näyttää ”Käytössä”.

Jonot on nyt otettu käyttöön Laravel-sovellukselle.

Jotta jonon työprosessi käyttää palvelimen resursseja tehokkaammin, Plesk-ympäristössä on useita asetuksia, joita voit määrittää. Ne liittyvät pääasiassa ehtoihin, joiden vallitessa jonon työprosessi voi lopettaa ja vapauttaa käyttämänsä muistin.

Jonon työprosessin määrittäminen:

Kirjaudu sisään Pleskiin ja etsi sitten sovellusta isännöivä toimialue.
Napsauta Laravel ja siirry sitten ”Queue”-välilehdelle.
(Valinnainen) Valitse ”Stop Worker When Empty” -valintaruutu, jos haluat, että työprosessi pysähtyy, kun jonossa ei ole töitä. Jos teet niin, työprosessi käynnistyy 60 sekunnin välein, käsittelee kaikki jonossa olevat työt ja lopettaa sitten.

Jos et valitse ”Stop Worker When Empty” -valintaruutua, työprosessi jää käyntiin, vaikka jonossa ei olisi töitä.
(Valinnainen) Aseta mukautettu ”Timeout”-arvo, jotta työprosessi lopetetaan virheeseen, jos työ on ollut käynnissä yli määritetyn ajan. Varmista, että ”Timeout”-arvo antaa riittävästi aikaa Laravel-sovelluksesi luoman tyypillisen työn loppuun saattamiseen.

Jos et aseta mukautettua ”Timeout”-arvoa, työprosessi ei lopeta, vaikka yksittäinen työ olisi ollut jonossa käsiteltävänä pitkään (esimerkiksi siksi, että työ on jumiutunut).

Varoitus

Liian pienen arvon asettaminen voi aiheuttaa töiden epäonnistumisen, koska käsittelyyn ei ole riittävästi aikaa (esimerkiksi suuren tiedoston lataamisen yhteydessä). Jos työt alkavat epäonnistua mukautetun ”Timeout”-arvon asettamisen jälkeen, harkitse sen kasvattamista tai palauttamista oletusarvoonsa (”0”, mikä tarkoittaa, ettei töiden käsittelyajalle ole rajaa).
(Valinnainen) Aseta mukautettu ”Max Jobs”-arvo, jotta työprosessi lopetetaan, kun se on käsitellyt tietyn määrän töitä.

Jos et aseta mukautettua ”Max Jobs”-arvoa, työprosessi ei pysähdy, vaikka se olisi käsitellyt suuren määrän töitä.
(Valinnainen) Aseta mukautettu ”Max Time”-arvo, jotta työprosessi lopetetaan, kun se on ollut käynnissä määritetyn sekuntimäärän ajan (työprosessi ei lopeta kesken työn käsittelyn).

Jos et aseta mukautettua ”Max Time”-arvoa, työprosessi jatkaa käyntiä, vaikka se olisi ollut käynnissä pitkään.

Jonon työprosessi on nyt määritetty ja sen pitäisi käyttää palvelimen resursseja tehokkaammin.

Työt voivat epäonnistua monista syistä. Plesk seuraa epäonnistuneita töitä, joita voit käynnistää uudelleen tai hylätä.

Epäonnistuneiden töiden tarkasteleminen, uudelleenkäynnistäminen ja hylkääminen:

Kirjaudu sisään Pleskiin ja etsi sitten sovellusta isännöivä toimialue.
Napsauta Laravel, siirry ”Queue”-välilehdelle ja napsauta Show failed jobs nähdäksesi epäonnistuneiden töiden luettelon.
(Valinnainen) Valitse yksi tai useampi epäonnistunut työ ja napsauta Retry käynnistääksesi ne uudelleen.
(Valinnainen) Valitse yksi tai useampi epäonnistunut työ ja napsauta Poista poistaaksesi ne luettelosta.
(Valinnainen) Napsauta Flush poistaaksesi kaikki epäonnistuneet työt luettelosta.

Epäonnistuneet työt on nyt käynnistetty uudelleen ja/tai hylätty.