oscloud-docs/docs/apps.md

# App 

Na platformě OSCloud nabízíme předinstalované i volně dostupné aplikace, které můžete snadno spravovat přímo z našeho uživatelského rozhraní.

## Předinstalované aplikace

Tyto aplikace jsou již připravené k okamžitému použití:

- Mastodon: Decentralizovaná sociální síť.
- Pixelfed: Platforma pro sdílení fotografií.
- Nextcloud: Soukromý cloud pro ukládání a sdílení souborů.
- Nástroje pro produktivitu: CryptPad, HedgeDoc pro týmovou spolupráci a organizaci projektů.


## Další dostupné aplikace k instalaci

Pokud potřebujete další aplikace, můžete je kdykoli snadno nainstalovat přímo z našeho App Storu. K dispozici jsou například:

- Fotografické aplikace: Lychee, Piwigo pro správu a sdílení fotografií.
- Webové aplikace: WordPress, Surfer pro tvorbu a správu webových stránek.

S OSCloud máte plnou kontrolu nad tím, jaké aplikace potřebujete pro svůj projekt, a všechny aplikace jsou pravidelně aktualizovány a bezpečně spravovány.

Chcete-li zobrazit kompletní seznam aplikací, navštivte [Aplikace](aplikace.md).

### Ikona

V sekci `Ikona` můžete nastavit vlastní ikonu pro aplikaci. Pokud ikona není nastavena, použije se ikona balíčku aplikace. 

<center>
<img src="/img/ikon.png" class="shadow" width="250px">
</center>

### Operátor

Administrátor může nastavit uživatele nebo skupiny jako operátory aplikace. Operátor aplikace může provádět konfigurační a údržbové úkoly. Na rozdíl od administrátora aplikace nemůže operátor aplikaci odinstalovat ani změnit její umístění. Operátoři také nemohou klonovat aplikace, protože nemají oprávnění k instalaci nových aplikací.

Operátor uvidí na svém panelu ikonu ozubeného kola: 

<center>
<img src="/img/apps-operator-button.png" class="shadow" width="250px">
</center>

Po kliknutí na ikonu ozubeného kola se jim zobrazí uživatelské rozhraní operátora: 

<center>
<img src="/img/apps-operator-view.png" class="shadow" width="600px">
</center>

## Informace

Různé informace o aplikaci naleznete v sekci `Info` aplikace:

<center>
<img src="/img/apps-info.png" class="shadow" width="600px">
</center>


* `Název a verze aplikace` - Toto je název aplikace a verze upstream aplikace.
* `App ID` - Unikátní ID instance aplikace.
* `Verze balíčku` - Verze balíčku OSCloud, která je odlišná od verze aplikace.
* `Nainstalováno` - Datum instalace aplikace.
* `Poslední aktualizace` - Kdy byla aplikace naposledy aktualizována.

### Poznámky admina

Poznámky specifické pro aplikaci lze uložit ve formátu Markdown. Poznámky jsou sdílené mezi administrátory. Všichni administrátoři a [operátoři aplikací](#operators) je mohou zobrazit a upravovat.

<center>
<img src="/img/apps-admin-notes.png" class="shadow" width="600px">
</center>


## Zabezpečení

### robots.txt

Soubor `Robots.txt` je soubor sloužící k určení, které části webu by měl vyhledávač indexovat. Tento soubor se řídí
[Robots Exclusion Standardem](https://cs.wikipedia.org/wiki/Robots_exclusion_standard). Google má 
[skvělý dokument](https://developers.google.com/search/reference/robots_txt) o tom, jak robots.txt funguje.

Obsah souboru robots.txt pro aplikaci můžete nastavit v sekci `Zabezpečení` v uživatelském rozhraní aplikace.

Ve výchozím nastavení OSCloud nenastavuje robots.txt pro aplikace. Pokud není nastaven, aplikace si může poskytovat vlastní robots.txt.

<center>
<img src="/img/apps-robots-txt.png" class="shadow" width="600px">
</center>

Kromě toho má stránka administrace OSCloud vlastní robots.txt, který zakazuje indexování:

```bash
User-agent: *
Disallow: /
```

### HSTS Preload

[HSTS Preload](https://hstspreload.org/) je seznam stránek, které jsou v prohlížečích jako Chrome, Firefox, Opera a další hardcodovány jako HTTPS-only.

Požadavky a důsledky:

* Vzhledem k velikosti seznamu jsou akceptovány automatické žádosti o přidání celých domén (hlavní doména).
* To zabrání přístupu ke všem subdoménám bez platného certifikátu HTTPS.
* Nové položky jsou hardcodovány do zdrojového kódu prohlížeče Chrome a může trvat několik měsíců, než se dostanou do stabilní verze.

Po aktivaci OSCloud bude server zasílat následující hlavičky HSTS:

```
Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
```

Pro aktivaci HSTS Preload tuto možnost zapněte v sekci `Zabezpečení` aplikace:

<center>
<img src="/img/apps-security-hsts-preload.png" class="shadow" width="600px">
</center>

!!! note "Odeslání"
    OSCloud automaticky neodesílá doménu na seznam HSTS Preload. To musíte provést ručně [zde](https://hstspreload.org/).

## Cron

Cron úlohy, které aplikace potřebují k fungování, jsou již integrovány do balíčku aplikace a není potřeba další konfigurace. Pokud chcete spustit další vlastní příkazy cron, můžete je přidat v sekci `Cron`.

Příkazy cron jsou spuštěny ve stejném kontextu jako aplikace (v samostatném kontejneru). To znamená, že mají přístup ke stejným prostředím a databázím jako aplikace. Sledují také životní cyklus aplikace – pokud je aplikace zastavena, cron úlohy se nespouštějí. Výstup z cron příkazů lze prohlížet pomocí [prohlížeče logů](#log-viewer).

Časy v cron jsou specifikovány v UTC.

Vzorový vzor plánu může být jeden z následujících [rozšíření cron](https://www.man7.org/linux/man-pages/man5/crontab.5.html#EXTENSIONS):

* `@service`   :    Spustí jednou při restartu aplikace nebo pokud je aplikace již spuštěná.
* `@reboot `   :    Spustí jednou při restartu aplikace nebo pokud je aplikace již spuštěná.
* `@yearly`    :    Spustí jednou ročně, např. `0 0 1 1 *`.
* `@annually`  :    Spustí jednou ročně, např. `0 0 1 1 *`.
* `@monthly`   :    Spustí jednou měsíčně, např. `0 0 1 * *`.
* `@weekly`    :    Spustí jednou týdně, např. `0 0 * * 0`.
* `@daily`     :    Spustí jednou denně, např. `0 0 * * *`.
* `@hourly`    :    Spustí jednou za hodinu, např. `0 * * * *`.

<center>
<img src="/img/apps-cron.png" class="shadow" width="600px">
</center>

!!! note "Řetězení příkazů"
    Příkazy mohou být spojeny pomocí `&&` nebo `||`. Například: `echo "=> Doing job" && /app/data/do_job.sh`

## Webový Terminál

OSCloud poskytuje webový terminál, který umožňuje přístup k souborovému systému aplikace. Webový terminál lze použít k prohlížení a úpravám souborů aplikace, přístupu k databázi atd. OSCloud spouští aplikace jako kontejnery s režimem souborového systému pouze pro čtení. Pouze adresáře `/run` (dynamická data), `/app/data` (zálohovaná data) a `/tmp` (dočasné soubory) jsou zapisovatelné.

Webový terminál lze otevřít pomocí tlačítka Web Terminal:

<center>
<img src="/img/apps-terminal-button.png" class="shadow" width="400px">
</center>

Po kliknutí se otevře nové okno. Terminál je v podstatě shell do souborového systému aplikace.

<center>
<img src="/img/apps-terminal-exec2.png" class="shadow" width="600px">
</center>

## Správce souborů

OSCloud poskytuje Správce souborů, který lze použít k úpravě souborového systému aplikace přímo z prohlížeče.

Správce souborů lze otevřít pomocí tlačítka File Manager:

<center>
<img src="/img/apps-filemanager-button.png" class="shadow" width="600px">
</center>

Po kliknutí se otevře nové okno. V kontextové nabídce jsou dostupné akce jako Přejmenovat, Smazat, Změnit vlastnictví.

<center>
<img src="/img/filemanager.png" class="shadow" width="600px">
</center>

## Přístup přes SFTP

Některé aplikace, jako WordPress, LAMP, Surfer, podporují přístup k datům přes SFTP. Soubory lze prohlížet a nahrávat pomocí libovolného SFTP klienta. Informace o připojení k SFTP lze zobrazit kliknutím na položku menu `SFTP Access`.

<center>
<img src="/img/apps-sftp-info.png" class="shadow" width="600px">
</center>

SFTP klient, jako je například [FileZilla](https://filezilla-project.org/), lze použít k připojení následovně:

* `Host` - `sftp://my.oscloud.cz` (hostitel je stejný pro přístup SFTP ke všem aplikacím)
* `Username` - `oscloud@lamp.oscloud.cz` (uživatelské jméno je specifické pro každou aplikaci)
* `Password` - heslo do OSCloud (stejné heslo pro přístup SFTP ke všem aplikacím)
* `Port` - 222

<center>
<img src="/img/sftp-filezilla.png" class="shadow" width="600px">
</center>

Pouze administrátoři OSCloud mají přístup přes SFTP.

!!! note "Port 222"
    SFTP služba běží na portu 222. Firewall serveru má již tento port otevřený. Nicméně budete muset tento port povolit i ve firewallu poskytovatele hostingu (např. EC2 Security Group nebo DigitalOcean Firewall). Pokud je doména frontovaná přes Cloudflare, použijte IP adresu serveru pro připojení přes SFTP namísto `my.domain.com`.

## Prohlížeč logů

Pro zobrazení logů aplikace klikněte na tlačítko logů:

<center>
<img src="/img/apps-logs-button.png" class="shadow" width="600px">
</center>

Tím se otevře vyskakovací okno, které zobrazí logy:

<center>
<img src="/img/apps-logs.png" class="shadow" width="600px">
</center>

Logy jsou udržovány do velikosti 10 MB pro aktuální logy a jeden rotovaný log na aplikaci. Logy starší než 14 dní jsou odstraněny. Surové logy se nacházejí v `/home/yellowtent/platformdata/logs/<appid>/`.

## Grafy

Pohled na grafy ukazuje přehled využití CPU, disku, sítě a paměti aplikace.

<center>
<img src="/img/apps-graphs-memory.png" class="shadow" width="600px">
</center>

<center>
<img src="/img/apps-graphs-cpu.png" class="shadow" width="600px">
</center>

<center>
<img src="/img/apps-graphs-diskio.png" class="shadow" width="600px">
</center>

<center>
<img src="/img/apps-graphs-networkio.png" class="shadow" width="600px">
</center>

## Zastavení aplikace

Aplikaci lze zastavit pomocí tlačítka Stop v panelu nástrojů aplikace.

<center>
<img src="/img/app-stop-button.png" class="shadow" width="600px">
</center>

## Odinstalace


Odinstalováním aplikace, se okamžitě odstraní všechna data spojená s aplikací z OSCloud.

!!! note "Zálohy nejsou odstraněny"
    Zálohy aplikace nejsou při odinstalaci odstraněny a jsou vyčištěny pouze na základě zálohovací politiky. Aplikace mohou být vždy [obnoveny](/backups/#restoring-an-app-from-existing-backup) z jejich záloh pomocí nástroje CLI.

## Verze

S aplikací jsou spojeny dvě nezávislé verze. Tyto informace jsou uvedeny v sekci [Info](#info).

* `Verze balíčku`. OSCloud používá [semver](https://semver.org/) pro své balíčky aplikací.
* `Verze aplikace` nebo `Verze upstream`. Formát verzí aplikace se může výrazně lišit – může být založen na datech, semveru, číslech git commitů atd.