Wiki相關

Wiki首頁、範本等等

首頁

歡迎來到美代子的Wiki,這裡用來記載我的Minecraft伺服器相關的知識,也會用於記載一些跟我有關的事情。

可以置右上角書架查看相關內容。

BookStack 維護

BookStack 維護

在 BookStack 上使用 Cloudflare R2

問題概述

官方教學其實已經有說明,這裡補足目前 (2024/01/24) 官方教學略為不足的部分。

一樣是編輯 .env 檔案,並且加入以下內容:

STORAGE_TYPE=s3
STORAGE_S3_KEY=<access_key>
STORAGE_S3_SECRET=<access_secret_key>
STORAGE_S3_REGION=auto
STORAGE_S3_BUCKET=<bucket_name>

STORAGE_S3_ENDPOINT=<endpoint_url>
STORAGE_URL=<url>

STORAGE_S3_KEY、STORAGE_S3_SECRET、STORAGE_S3_BUCKET 和 STORAGE_S3_ENDPOINT 基本上跟官方教學差不多。

需要增加的是 STORAGE_S3_REGION ,而且必須是 auto ,否則 Log 會噴 400 Bad Request 的錯誤。

這個資訊我還是在官方 Git repository 的 Issues 上才發現的。不過我以為 BookStack 預設應該會是 auto,原來不是嗎......。

參考

 

BookStack 維護

升級 BookStack

記錄一下自己怎麼更新 BookStack。官方有相關教學,直接照做就好,唯一的不同是所有指令必須以 Web Server 使用者執行,以免權限不足。例如 Caddy server 必須要用 sudocaddy 的使用者身份執行。

抓取最新原始碼

用 Git 抓就好了,一般來說在裝 BookStack 的時候是整個 Git repository 一起抓下來。

sudo -u caddy git pull origin release

使用 composer 重新安裝心版本 BookStack 的依賴

記得加上 --no-dev,否則可能會安裝到開發用環境。

sudo -u caddy composer install --no-dev

合併資料庫

每次升級資料庫可能都會有變動,執行一下以免 BookStack 出錯。

sudo -u caddy php artisan migrate

檢查 BookStack 是否有問題

全部操作一遍之後,如果沒有任何報錯,可以先去 Wiki 首頁看看有沒有問題。

如果有問題的話就需要去看 Debug 記錄,沒有的話基本上是大功告成。

可做可不做:清理相關快取

把設定、頁面等快取進行清理,可以避免某些因快取而生的奇怪問題。

sudo -u caddy php artisan cache:clear
sudo -u caddy php artisan config:clear
sudo -u caddy php artisan view:clear