Last Updated on 15/03/2025 by administrator

Proxmox – Install Etherpad

Proxmox – Install Etherpad

Motivace:

Etherpad je open-source webová aplikace pro spolupráci v reálném čase při editaci textových dokumentů. Umožňuje více uživatelům současně upravovat jeden dokument a okamžitě vidět změny provedené ostatními.

OS:

Proxmox – Install Etherpad byla prakticky prováděna na open-source platformě Proxmox verze 8.3-1.

Implementace [1]:

Proxmox – Install Etherpad:

Připojit se na Proxmox a aplikovat příkaz níže:

pveam update

Výpis příkazu pveam update by měl vypsat update successful.

Seznam dostupných templates se zobrazí příkazem:

pveam available | grep etherpad

Výpis příkazu pveam available | grep etherpad ukazuje, že existuje šablona pro LXC kontejner s předisntalovaným etherpad :

turnkeylinux debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz

Pro stažení šablony pro LXC kontejner s předisntalovaným etherpad aplikovat příkaz níže:

pveam download local debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz

Příkaz níže zobrazí, zda byla šablona pro LXC kontejner s předinstalovaným etherpad stažena:

pveam list local | grep etherpad

Výpis příkazu pveam list local | grep etherpad zobrazuje, že stažena byla:

local:vztmpl/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz 502.73MB

Příkaz níže vytvoří nový LXC kontejner v Proxmox s předinstalovaným etherpad. ID kontejneru bude 150 s jménem kontejneru etherpad. CT bude přiřazeno 2 GB fyzické paměti a 512MB diskové paměti. Použije se jedno CPU jádro a velikost CT bude 8 GB na lokálním LVM storage. Jméno síťového rozhraní bude eth0 s IP adresou 192.168.0.150 maskou podsítě 255.255.255.0 a výchozí branou 192.168.0.1. Parametr vmbr0 nastavuje CT do stejné sítě jako hostitelský stroj. Features Nesting=1 umožňuje běh dalších virtualizovaných prostředí (například Dockeru) uvnitř kontejneru. Díky parametru onboot 1, bude kontejner spušten při startu/rebootu Proxmox automaticky. Parametr nameserver nastavuje Google DNS servery a seachdomain nastavuje doménu kontejneru na lan.

pct create 150 /var/lib/vz/template/cache/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz \
--hostname etherpad \
--memory 2048 \
--swap 512 \
--cores 1 \
--rootfs local-lvm:8 \
--net0 name=eth0,bridge=vmbr0,ip=192.168.0.150/24,gw=192.168.0.1 \
--features nesting=1 \
--onboot 1 \
--nameserver 8.8.8.8,8.8.4.4 \
--searchdomain lan

Výpis příkazu pct create 150 … ukazuje, že souborový systém byl vytvořen a šablona extrahována a byly vygenerovány SSH host klíče:

 Logical volume "vm-150-disk-0" created.
Creating filesystem with 2097152 4k blocks and 524288 inodes
Filesystem UUID: 708cdd10-b35a-41af-8348-838ef068bd83
Superblock backups stored on blocks:
32768, 98304, 163840, 229376, 294912, 819200, 884736, 1605632
extracting archive '/var/lib/vz/template/cache/debian-12-turnkey-etherpad_18.0-1_amd64.tar.gz'
Total bytes read: 1602109440 (1.5GiB, 90MiB/s)
Detected container architecture: amd64
Creating SSH host key 'ssh_host_ed25519_key' - this may take some time ...
done: SHA256:21+4KguBh3dGCtAScA1nqC3aeEj8YQrdGCtpUjCgC6U root@etherpad
Creating SSH host key 'ssh_host_dsa_key' - this may take some time ...
done: SHA256:Ex85GNqdGCtvX1FmpBYjdqZ1RLU6zOpS3uB0wLMxN6c root@etherpad
Creating SSH host key 'ssh_host_ecdsa_key' - this may take some time ...
done: SHA256:dL9a30DwJpSWDf4ZwCEUQ9a30MNWSuiviAtoKR/oN0 root@etherpad
Creating SSH host key 'ssh_host_rsa_key' - this may take some time ...
done: SHA256:rjMVooU4IjhPR4hmiRKtDSZcUS5A5nGhmiRQgbzgqgA root@etherpad

Spustit kontejner s ID 150:

pct start 150

Přejít do tohoto nově vytvořeného konteineru s ID 150:

pct enter 150

Inicializovat nastavení pomocí příkazu níže:

turnkey-init

Vytvořit si nové heslo pro účet admin:

Služby TurnKey Backup and Migration a TurnKey Domain Management and Dynamic DNS nejsou potřebné, a proto bude zvolena možnost Skip:

Volitelně lze zvolit, zdaje potřeba zasílat oznámení systému či kritická bezpečnostní upozornění. V tomto případě bude zvolena možnost Skip:

Možností Install se automaticky nainstalují bezpečnostní aktualizace na OS:

 

Etherpad v tomto případě běží na https://192.168.0.150/

Vytvoření nového dokumentu:

Kliknutím na New Pad se nový dokument, nebo je možné vytvořit svým názvem např. test1.

Vymazání dokumentu:

K vymazání přes API je potřeba zjistit API klíč,

less /opt/etherpad-lite/APIKEY.txt

Výpis příkazu less /opt/etherpad-lite/APIKEY.txt ukázal API key, což je v tomto případě d575e9bf3f4adfe5efc89f6552fbc4d3.

Nejdříve bude proveden výpis všech vytvořených dokumentů:

curl -k https://192.168.0.150/api/1.2.15/listAllPads?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3

Výpis příkazu curl -k https://192.168.0.150/api/1.2.15/listAllPads?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3 ukazuje, že jsou vytvořené 3 dokumenty test, test 1 a test3

{"code":0,"message":"ok","data":{"padIDs":["test","test1","test3"]}}

Pro vymazání dokumentu test1 se použije následujicí příkaz, kde parametr k ignoruje SSL chybu certifikátu a 192.168.0.150 je IP adresa na které běží etherpad:

curl -k https://192.168.0.150/api/1.2.15/deletePad?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3\&padID=test1

Výpis příkazu curl -k https://192.168.0.150/api/1.2.15/deletePad?apikey=d575e9bf3f4adfe5efc89f6552fbc4d3\&padID=test1 by měl následně ukázat, podobnou hlášku:

{"code":0,"message":"ok","data":null}

Věřím, že vám tento článek Proxmox – Install Etherpad pomohl.

Řešené chyby:

Rate Limited. You send too many messages to this pad so it disconnected you, nastala, při připojení více než 1 uživatele.

Řešení:

Přejít do settings.json souboru:

vi /opt/etherpad-lite/settings.json

a pod rubrikou commitRateLimiting zvětšit číslo původní číslo 10 parametru points na číslo vyšší:

"commitRateLimiting": {
    // duration of the rate limit window (seconds)
    "duration": 1,

    // maximum number of changes per IP to allow during the rate limit window
    "points": 100
  },

Provést restart etherpad – náběh služby etherpad bude chvíli trvat:

service etherpad restart

Zdroj:

[1] https://pve.proxmox.com/pve-docs/pct.1.html