BookStack ምን ያህል ሰርቨር ያስፈልገዋል?

በጣም ትንሽ። BookStack የMariaDB database ያለው የPHP መተግበሪያ ነው፤ የጥቂት ደርዘን ሰዎች ቡድን በ1 vCPU እና 2 GB RAM ላይ በምቾት ይሰራል። ዲስኩ በዋናነት ለተሰቀሉ ምስሎችና አባሪዎች ይውላል።

ነባሪዎቹ የመግቢያ መረጃዎች ምንድን ናቸው?

admin@admin.com ከpassword 'password' ጋር። ይግቡና ሁለቱንም ወዲያውኑ ይቀይሩ — URLኡን ለማንም ከማጋራትዎ በፊት።

የድርጅታችንን መግቢያ መጠቀም ይችላል?

አዎ። BookStack LDAP፣ SAML2 እና OpenID Connectን ይደግፋል፣ ስለዚህ ሁሉም አስቀድመው በሚጠቀሙበት የማንነት አቅራቢ በኩል ይገባሉ።

ልዩ IP ያስፈልገኛል?

ለቡድን አዎ። ባልደረቦችዎ በbrowser በHTTPS ይከፍቱታል፣ ይህም በራስዎ IP ላይ ወደ ፖርት 443 የሚገባ ትራፊክ ይፈልጋል። ለግል ማስታወሻ ደብተር በNAT ፕላን ላይ SSH tunnelም በቂ ነው።

backup እንዴት አደርገዋለሁ?

የdatabase dump ያውጡና በተያያዘው የቅንብር volume ውስጥ ያለውን የuploads ማውጫ ይገልብጡ። የእኛ restic መመሪያ ሁለቱንም ወደ የተመሰጠሩ፣ ከሰርቨር ውጭ snapshots በራስ-ሰር ያደርጋል።

VPS ለBookStack፦ በራስ የሚስተናገድ የቡድን wiki

BookStackን በVPS ላይ የቡድንዎ የሰነድ wiki አድርገው ያሂዱ፦ Docker ከMariaDB ጋር፣ በdomainዎ ላይ HTTPS፣ የመጀመሪያ መግቢያ፣ backups እና እውነተኛ መስፈርቶች።

የቡድን ሰነዶች ብዙውን ጊዜ ከሁለት መንገዶች በአንዱ ይሞታሉ፦ ማንም ሊፈልግባቸው በማይችል የchat threads ውስጥ ተበትነው፣ ወይም ማንም የማያዘምነው በጣም የማይመች wiki ውስጥ ተቀብረው። BookStack ሰዎች በእርግጥ የሚጠቀሙበት ብርቅዬ በራስ የሚስተናገድ wiki ነው። ይዘቱ በመደርደሪያዎች፣ በመጻሕፍት፣ በምዕራፎችና በገጾች ውስጥ ይኖራል — ሁሉም ያለ ስልጠና የሚረዳው መዋቅር። ሰርቨርም ከሞላ ጎደል አያስፈልገውም።

ለምን BookStack

ግልጽ መዋቅር። ከጠፍጣፋ የገጾች ክምር ይልቅ መጻሕፍትና ምዕራፎች።
ማንንም የማያስፈራ አርትዖት። በነባሪነት WYSIWYG editor፣ ለሚመርጡት ደግሞ Markdown።
እውነተኛ ፈቃዶች። በመደርደሪያ፣ በመጽሐፍ ወይም በገጽ ሚናዎች — የHR ሰነዶች ከኮንትራክተሮች ይርቃሉ።
የድርጅት መግቢያ። LDAP፣ SAML2 እና OpenID Connect አብረው ተሠርተዋል።
የእርስዎ ዳታ። ሁሉም ነገር በMariaDB database እና በሰርቨርዎ ላይ ባለ ማውጫ ውስጥ ነው።

ለሁሉም ነገር ትክክለኛው መሳሪያ አይደለም። ከcode ጋር አብረው መቀየር ያለባቸው የdeveloper ሰነዶች ቦታቸው repository እንጂ wiki አይደለም።

የሚያስፈልገው

BookStack ቀላል ነው። ለአብዛኞቹ ቡድኖች Micro-IP — 1 vCPU፣ 2 GB፣ በወር $10 — ከበቂ በላይ ነው። ባልደረቦችዎ በdomainዎ ላይ በHTTPS እንዲደርሱበት የሚያስችለው ልዩ IPኡ ነው። ዲስኩ የሚያድገው በተሰቀሉ screenshots እና PDFs እንጂ በገጾች ብዛት አይደለም።

በDocker Compose መጫን

በሰፊው የሚጠቀሙትን የLinuxServer.io images እንጠቀማለን። መጀመሪያ የመተግበሪያ ቁልፍ ይፍጠሩ፦

docker run -it --rm --entrypoint /bin/bash lscr.io/linuxserver/bookstack:latest appkey

የሚያትመውን የbase64:... እሴት ይገልብጡ። ከዚያ docker-compose.yml ይፍጠሩ፦

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack:latest
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=https://wiki.example.com
      - APP_KEY=base64:paste-your-key-here
      - DB_HOST=db
      - DB_PORT=3306
      - DB_DATABASE=bookstack
      - DB_USERNAME=bookstack
      - DB_PASSWORD=change-me
    volumes:
      - ./bookstack:/config
    ports:
      - 127.0.0.1:6875:80
    depends_on:
      - db
    restart: unless-stopped
  db:
    image: lscr.io/linuxserver/mariadb:latest
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=change-me-too
      - MYSQL_DATABASE=bookstack
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=change-me
    volumes:
      - ./db:/config
    restart: unless-stopped

docker compose up -d
docker compose logs -f bookstack

APP_URL ሰዎች ከሚጠቀሙበት አድራሻ ጋር፣ https://ን ጨምሮ፣ መጣጣም አለበት። ከተሳሳቱ ምስሎችና links በሚገርም መንገድ ይበላሻሉ። ስለ Compose ተጨማሪ በእኛ የstack deploy መመሪያ ውስጥ ነው።

HTTPS እና የመጀመሪያ መግቢያ

subdomainን ወደ ሰርቨሩ ይጠቁሙ (እንዴት)፣ ከ127.0.0.1:6875 ፊት nginx ያስቀምጡ፣ በcertbot certificate ይጨምሩ — የreverse proxy መመሪያው ደረጃ በደረጃ ይመራዎታል።

ከዚያ በነባሪው account ይግቡ፦ admin@admin.com / password። linkኡን ከማጋራትዎ በፊት emailኡንና passwordኡን ወዲያውኑ ይቀይሩ። ሌሎቹ ሁሉ የራሳቸውን account ያገኛሉ ወይም በማንነት አቅራቢዎ በኩል ይገባሉ።

Backups

የሚጠበቁ ሁለት ነገሮች አሉ፦ databaseኡ እና በ./bookstack ውስጥ ያሉት uploads። እንደዚህ ያለ የሌሊት ስራ databaseኡን ይሸፍናል፦

docker compose exec -T db mysqldump -u bookstack -pchange-me bookstack > /var/backups/bookstack.sql

ከዚያ /var/backupsን እና የcompose ማውጫውን ከሰርቨሩ ውጭ backup ያድርጉ — የእኛ restic መመሪያ የሚያደርገው በትክክል ይህን ነው። Managed Backups በላዩ ላይ የሙሉውን ሰርቨር ዕለታዊ የመመለሻ ነጥቦች ይጨምራሉ።

ጥገና

ማዘመን docker compose pull && docker compose up -d ነው። BookStack ሲነሳ የdatabase migrationsን ያሄዳል። ከዋና ስሪቶች በፊት release notesን ያንብቡ፤ አጭርና ግልጽ ናቸው።

ቡድንዎ ለtickets እና ለcode ቦታም ከፈለገ፣ በራስ የሚስተናገድ Git ሰርቨር በተመሳሳይ ዓይነት ፕላን ላይ ከጎኑ በደንብ ይቀመጣል።