Strapi – atvērtā pirmkoda bezgalvas satura pārvaldība

Runājot par satura pārvaldības sistēmām, WordPress jau ilgi ir bijis līderis tīmeklī. Tādi atslēgvārdi kā “nodejs” un “headless” ir kļuvuši populāri līdz ar jaunu tendenču un tehnoloģiju parādīšanos. Iepazīstināsim ar iespēju izmantot vienu no vadošajām bezgalvas satura pārvaldības sistēmām – Strapi – Zone virtuālā servera vidē.

Strapi ir ļoti draudzīgs izstrādātājiem un pilnībā pielāgojams atbilstoši klienta vajadzībām. Ja neesat pazīstams ar šo lietotni, vairāk varat uzzināt Strapi mājaslapā un īpaši tās dokumentācijā.

Lai iegūtu īsu pārskatu, noskatieties zemāk esošo video:

https://www.youtube.com/watch?v=zd0_S_FPzKg

Servera iepriekšēja konfigurēšana

Strapi labi darbojas jau ar pirmo Zone tīmekļa hostinga paketi. Ja jums ir serveris, pirms lietotnes instalēšanas jāveic daži soļi:

1. Konfigurējiet SSH piekļuvi.

Lai instalētu Strapi, jābūt konfigurētai SSH piekļuvei. Plašāku informāciju par SSH savienojuma izveidi lasiet rakstā Zone lietotāju atbalsta vietnē: SSH savienojuma izveide (tas ir igauņu valodā, bet iesakām izmantot tulkošanas rīku).

2. Pievienojiet MySQL lietotāju un datubāzi.

Lai gan Strapi var izmantot arī SQLite datubāzi, ieteicams pievienot MySQL/MariaDB datubāzi, lai nodrošinātu rezerves kopiju izveidi un lietotnes uzticamību. Plašāku informāciju par datubāzes pievienošanu lasiet Zone lietotāju atbalsta vietnē: MySQL/MariaDB datubāzes lietotāju konti (lūdzu, izmantojiet tulkošanas rīku).

Lūdzu, ņemiet vērā! Saglabājiet datubāzes datus drošībā līdz lietotnes instalēšanai – tie būs nepieciešami konfigurēšanai.

3. Iestatiet mod_proxy portu savam tīmekļa serverim.

Pievienojiet apakšdomēnu, dodoties uz Virtual Servers – Web Server – Subdomains sadaļu My Zone. Nospiediet Add Subdomain pogu un pēc pievienošanas iestatiet Application port to redirect incoming requests to (mod_proxy) lauka vērtību uz 1337. Jūsu apakšdomēns būs pieejams drīz pēc vārdu servera ierakstu izplatīšanas. Piemērā esam izveidojuši apakšdomēnu api.miljonivaade.eu.

Apzīmējumu virtXXXX, kas izmantots tālāk pamācībā, aizvietojiet ar savu SSH lietotājvārdu, bet dataXX – ar pirmo direktoriju, ko rāda pwd komanda.

Strapi instalēšana un konfigurēšana

Lai instalētu Strapi, nepieciešams izveidot SSH savienojumu ar serveri.

Pēc tam saknes direktorijā (piemēram, /dataXX/virtXXX) izpildiet šādu komandu:

npx create-strapi-app@latest my-projectCode language: CSS (css)

Ievadiet y, lai apstiprinātu, un nospiediet Enter. Tālāk jums tiks prasīts izvēlēties uzstādīšanas veidu – izvēlieties Custom (manual settings). Pretējā gadījumā tiks uzstādīta funkcionējoša lietotne, bet MySQL/MariaDB datubāze netiks konfigurēta. Pēc izvēles jums tiks prasīti datubāzes dati un vēl daži konfigurācijas iestatījumi. Datubāzei izvēlieties mysql un nākamajos soļos ievadiet iepriekš izveidotās datubāzes datus. Tam vajadzētu izskatīties apmēram šādi:

? Choose your installation type Custom (manual settings)
? Choose your default database client mysql
? Database name: dXXXXX_strapi
? Host:  dXXXXX.mysql.zonevs.eu
? Port: 3306
? Username: dXXXXX_strapi
? Password: *************************
? Enable SSL connection: Yes

Creating a project with custom database options.
Creating a new Strapi application at /dataXX/virtXXXXX/my-project.
Creating files.Code language: JavaScript (javascript)

Pēc tam konfigurācijas vednis kādu laiku instalēs nepieciešamās pakotnes un atkarības. Kad tas būs pabeigts, izvadē vajadzētu redzēt šādu informāciju:

Dependencies installed successfully.

Your application was created at /dataXX/virtXXXXX/my-project.

...

Pēc tam dodieties uz izveidoto lietotnes direktoriju

cd my-project

un konfigurējiet lietotnes URL

<strong>nano</strong> config/server.jsCode language: HTML, XML (xml)

Failā jāievada iepriekš izveidotais apakšdomēns. Gala fails izskatīsies apmēram šādi:

module.exports = ({ env }) => ({
  host: env('HOST', '0.0.0.0'),
  port: env.int('PORT', 1337),
  url: 'https://api.miljonivaade.eu',
  app: {  
    keys: env.array('APP_KEYS'),
  },
});Code language: JavaScript (javascript)

Lai šī konfigurācija darbotos, lietotne jāpārbūvē ar komandu

<strong>npm</strong> run buildCode language: HTML, XML (xml)

Pēc tam lietotne jau ir konfigurēta un to var palaist vairākos veidos. Piemēram:

# Parasta palaišana
npx strapi start

# Palaišana izstrādes režīmā
npx strapi developCode language: PHP (php)

Lai sāktu pilnvērtīgi lietot lietotni, atveriet URL

https://api.miljonivaade.eu/admin un pievienojiet administratora lietotāju.

Pm2 konfigurēšana, lai lietotne vienmēr darbotos

Lai lietotne darbotos arī pēc negaidītas avārijas vai servera pārstartēšanas, My Zone jākonfigurē pm2. Ja lietotne pašlaik darbojas, to uz laiku izslēdziet (piemēram, nospiediet Ctrl + C konsolē).

1. Izveidojiet pm2 ekosistēmas failu

Izveidosim failu strapi.config.js mapē minu-projekt. Tā saturs ir šāds:

module.exports = {
    apps: [{
        name: "strapi",
        script: "npm",
        args: "start",
        cwd: process.env.HOME + "/my-project",
        max_memory_restart : "256M",
        env: {
            NODE_ENV: "production"
        }
    }] 
}Code language: JavaScript (javascript)

2. Konfigurējiet pm2 lietotni My Zone

Dodieties uz Virtual servers – Web server – PM2 processes (Node.js) sadaļu My Zone un nospiediet Add new application pogu.

Aizpildiet šādus laukus:

Lauks	Apraksts
name	strapi
script or PM2 .JSON	my-project/strapi.config.js

Maksimālo atmiņas izmantošanu nav nepieciešams norādīt, jo tā jau ir iestatīta ekosistēmas failā. Pēc saglabāšanas lietotnei vajadzētu sākt darboties dažu minūšu laikā. Lai to pārbaudītu, var izmantot dažas pm2 komandas konsolē.

Konsoles izvadē jābūt informācijai, ka Strapi statuss ir running

pm2 listCode language: PHP (php)

Ja lietotne pēc dažām minūtēm nedarbojas, kļūdu žurnālus var apskatīt ar šādu komandu:

pm2 logs

Noslēgumā

Strapi ir bezgalvas CMS. Tas nozīmē, ka ir izveidota tikai datu struktūru API puse. Lietotājam redzamā tīmekļa vietne jāizstrādā atsevišķi. Mūsdienās lietotāja saskarnes izstrādei ir bezgalīgas iespējas – Vue.js, React, Angular, Svelte un daudzas citas. Šim nolūkam mēs uzstādījām strapi apakšdomēnā api.miljonivaade.eu – lai, piemēram, galvenajā domēnā miljonivaade.eu izveidota tīmekļa lapa varētu attēlot HTML un Javascript failus caur Apache tīmekļa serveri.

Ja jums rodas grūtības ar kādas mūsdienu ietvara darbināšanu Zone serverī un vēlaties līdzīgu pamācību savai lietotnei, varat sūtīt pieprasījumu uz info@www.zone.lv vai pievienoties mūsu slack.www.zone.lv kanālam. Zone koncentrējas uz mūsdienu tehnoloģiju atbalstu izstrādē un dara visu iespējamo, lai mūsdienīgas izstrādes metodes un lietotnes darbotos nevainojami mūsu serveros.