Instalace Savee¶

Spuštění aplikace¶

Pokud je server správně nastaven a připraven k použití, můžete přistoupit k instalaci aplikace Savee.

Adresář instalace¶

Doporučujeme nainstalovat Savee do adresáře /srv. Přejděte tam pomocí tohoto příkazu:

cd /srv

Klonování repozitáře GitLab¶

Jakmile se nacházíte v požadovaném adresáři, naklonujte Savee z našeho repozitáře GitLab zadáním:

git clone https://gitlab.nikatron.cz/nikatron/software/savee.git

Adresář Savee¶

Klonováním repozitáře GitLab se vytvoří složka savee v adresáři, ve kterém se nacházíte. Přejděte do této nové složky zadáním:

cd savee

Spuštění kontejneru¶

Nakonec stačí zadat tento příkaz Dockeru ke stažení a spuštění aplikace Savee:

docker compose up -d

A to je vše! Úspěšně jste spustili aplikaci Savee na svém serveru.

Ověření stavu¶

Spuštění Savee můžete ověřit pomocí:

docker ps

Zobrazí se všechny běžící kontejnery Dockeru. Pokud vidíte alespoň tyto čtyři kontejnery:

• savee-proxy-1
• savee-webapp-1
• savee-api-1
• savee-mongo-1

znamená to, že vaše aplikace Savee je funkční a běží na IP adrese vašeho serveru.

Aktualizace Savee¶

Pokud již máte Savee nainstalovaný a spuštěný na serveru, aktualizace aplikace je jednoduchý a bezpečný proces. Aktualizace obvykle zahrnují nové funkce, vylepšenou stabilitu a opravy zabezpečení – proto se doporučuje udržovat aplikaci aktuální.

Před zahájením se ujistěte, že:

• Váš server funguje správně
• Docker a Docker Compose jsou nainstalovány a spuštěny
• Máte přístup ke složce, kde je Savee nainstalován

Adresář Savee¶

Nejprve přejděte do adresáře, kde se Savee nachází:

cd /srv/savee

Zastavení aplikace¶

Před aplikováním aktualizací je nejlepší zastavit všechny běžící kontejnery, aby nedošlo ke konfliktům:

docker compose down

Tím je zajištěno, že aplikace bude čistě ukončena a že během aktualizace nebudou zamčeny žádné soubory ani databázové vrstvy.

Stažení nejnovější verze¶

Chcete-li stáhnout nejnovější verzi Savee, jednoduše stáhněte nejnovější změny z repozitáře:

git pull

Tím se aktualizují stávající soubory bez odstranění vaší konfigurace nebo dat.

Restart aplikace¶

Po stažení nejnovějšího kódu restart aplikace způsobí, že Docker stáhne nejnovější verzi Savee:

docker compose up -d

docker ps

Pokud byly všechny výše uvedené kroky úspěšné, je aplikace Savee aktualizována.

Odinstalace aplikace¶

Adresář Savee¶

Chcete-li odinstalovat aplikaci Savee ze serveru, začněte přechodem do adresáře, kde je Savee nainstalován:

cd /srv/savee

Zastavení aplikace¶

Jakmile se nacházíte v adresáři, kde je Savee umístěn, zastavte aplikaci spuštěním:

docker compose down

Odstranění svazků¶

Poté je třeba odstranit Docker svazky Savee. Chcete-li zobrazit seznam všech Docker svazků, použijte:

docker volume ls

Zobrazí se všechny Docker svazky na vašem serveru. Pokud máte Savee nainstalovaný, měl by existovat svazek s názvem SAVEE_SAVEE_DATA. Odstraňte svazek zadáním:

docker volume rm ${volume_name}

Odstranění obrazů¶

Nakonec se doporučuje také odstraňování Docker obrazů Savee. Tím se zabrání tomu, aby Docker používal tyto staré obrazy v případě přeinstalování Savee v budoucnosti po vydání nové verze aplikace. Smazání těchto obrazů dosáhnete podobným způsobem jako u svazků:

docker image ls

Zobrazí se seznam každého Docker obrazu. Odstraňte tyto čtyři

• registry.nikatron.com/savee/proxy
• registry.nikatron.com/savee/webapp
• registry.nikatron.com/savee/api
• mongo

pomocí:

docker image rm ${image_name}