Základní instalace – Ubuntu 20.04

Stažení repozitáře z GitHubu:

git clone https://github.com/shipard/shipard.git
cd shipard

Instalace potřebných balíčků:

sudo install/install-packages.sh

Instalace knihoven přes composer:

cd extlibs
composer update
cd ..

Aktivace vývojové verze klientských knihoven:

ln -s ../ui www-root/ui-dev

Aktivace serveru:

sudo install/init-server.php
sudo install/init-db.php
sudo shpd-server server-get-hosting-info
sudo shpd-server server-check

Konfigurace serveru

Nyní je potřeba v souboru /etc/shipard/server.json nastavit několik údajů:

{
    "serverDomain": "localhost.shpd.dev",
    "develMode": 1,
    "userFirstName": "Jan",
    "userLastName": "Novák",
    "userEmail": "jan.novak@example.com"
}

• soubor je potřeba editovat přes sudo
• develMode musí být nastaveno na 1
• userFirstName, userLastName musí obsahovat jméno a příjmení, v userEmail musí být e-mail. Tyto údaje budou sloužit k vytvoření „prvního“ uživatele v testovacích databázích.

V serverDomain je doména, na které bude server běžet v prohlížeči. Protože veškerý provoz probíhá přes protokol https, je potřeba zařídit správné nastavení web serveru včetně platného certifikátu:

• Existuje doména druhého řádu shpd.dev
• Při instalaci se (příkazem sudo shpd-server server-get-hosting-info) nainstaluje hvězdičkový certifikát *.shpd.dev

V praxi tak můžete použít libovolný název končící na .shpd.dev, pouze musíte zařídit překlad IP adresy serveru na DNS název. To lze na Linuxu a macOS zařídit úpravou souboru /etc/hosts:

10.xxx.xxx.xxx  localhost.shpd.dev

Zároveň je potřeba v souboru /etc/hosts na serveru (kam se to instaluje) nastavit adresu – obvykle stačí nastavit doménové jméno na localhost:

127.0.0.1       localhost.shpd.dev

Po změně konfigurace je potřeba vždy zavolat:

sudo shpd-server server-check

Přidání uživatele do skupiny shpd

sudo adduser $USER shpd
reset

Příkaz reset by měl reloadnout informace o skupinách přihlášeného uživatele. Ne vždy to funguge, takže je bezpečnější se z terminálu / ssh odhlásit a znovu přihlásit.

Vytvoření první zkušební aplikace

Nyní můžeme vytvořit první zkušební aplikaci:

cd /var/lib/shipard/data-sources
shpd-server app-new --type=economy

Chvíli to poběží, výsledkem bude něco jako:

* set shpdChannel to devel
some changes in database structure (#191): .................. ... ........ done.
new password is 4rkrm1srne
DONE. New dsid: 0317015420777, login: jan.novak@example.com, URL: https://localhost.shpd.dev/0317015420777/

Zobrazené URL můžeme otevřít v prohlížeči, přihlásíme se uvedeným emailem a heslem.