環(huán)境平滑擴(kuò)展)
Crater 容器化部署指南用 Docker Compose 本地部署再到生產(chǎn)環(huán)境平滑擴(kuò)展【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/craterCrater 是一款開(kāi)源的發(fā)票管理系統(tǒng)覆蓋客戶(hù)管理、報(bào)價(jià)單、發(fā)票、付款記錄和費(fèi)用追蹤適合自由職業(yè)者、小團(tuán)隊(duì)以及需要給客戶(hù)開(kāi)具正式發(fā)票的企業(yè)。這篇文章給你一條完整的落地路徑如何用 Docker Compose 在本地把 Crater 跑起來(lái)怎么確認(rèn)服務(wù)真的可用以及當(dāng)你需要面對(duì)多副本、持久化存儲(chǔ)和外部訪問(wèn)時(shí)生產(chǎn)環(huán)境該如何設(shè)計(jì)。全文只講關(guān)鍵步驟先跑通再優(yōu)化。部署前先確認(rèn)三件事環(huán)境與端口是否就緒Docker 與 Docker Compose 已安裝并可正常構(gòu)建鏡像主機(jī) 80 端口未被占用Nginx 容器映射到80:80主機(jī) 3306 被占用也沒(méi)關(guān)系編排文件里數(shù)據(jù)庫(kù)對(duì)外暴露的是33006:3306目錄與文件是否完整從 gitcode 倉(cāng)庫(kù)克隆完整項(xiàng)目后確認(rèn)以下文件都在根目錄中缺任何一個(gè)部署都會(huì)中斷git clone https://gitcode.com/gh_mirrors/cr/crater cd crater需要重點(diǎn)確認(rèn)的三個(gè)位置docker-compose.yml服務(wù)編排定義包含 app、db、nginx、cron 四個(gè)服務(wù)Dockerfile基于php:8.1-fpm的應(yīng)用鏡像構(gòu)建文件docker-compose/setup.sh容器啟動(dòng)后的初始化腳本數(shù)據(jù)庫(kù)連接信息編排文件中 MariaDB 的默認(rèn)賬號(hào)密碼均為craterMYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE并且數(shù)據(jù)庫(kù)數(shù)據(jù)掛載在名為db的命名卷里。如果你要改成把數(shù)據(jù)落到宿主機(jī)目錄需要注釋掉db:/var/lib/mysql那一行啟用下面注釋掉的宿主機(jī)路徑掛載并按自己的需求修改環(huán)境變量。最短路徑三步把服務(wù)跑起來(lái)第一步構(gòu)建并啟動(dòng)容器docker-compose up -d --build這條命令會(huì)構(gòu)建 PHP 應(yīng)用鏡像和 cron 鏡像然后拉起四個(gè)服務(wù)NginxWeb 入口、PHP-FPM應(yīng)用進(jìn)程、MariaDB數(shù)據(jù)庫(kù)、cronLaravel 定時(shí)任務(wù)調(diào)度。第二步執(zhí)行初始化腳本容器起來(lái)不等于應(yīng)用可用。Crater 需要在容器內(nèi)完成依賴(lài)安裝、密鑰生成和存儲(chǔ)軟鏈接項(xiàng)目自帶的初始化腳本已經(jīng)封裝好這些操作sh docker-compose/setup.sh腳本內(nèi)部執(zhí)行了三件事composer install安裝 PHP 依賴(lài)、php artisan storage:link建立storage軟鏈、php artisan key:generate生成應(yīng)用密鑰。注意第二條命令帶了|| true也就是說(shuō)軟鏈?zhǔn)〔粫?huì)阻斷流程——如果安裝向?qū)Ю锍霈F(xiàn)靜態(tài)資源 404回頭檢查這一步的日志。第三步打開(kāi)瀏覽器訪問(wèn)http://localhost看到 Crater 的安裝向?qū)Ъ幢硎?Web 鏈路已通。安裝向?qū)?huì)引導(dǎo)你完成公司信息和管理員賬號(hào)設(shè)置。上圖為 Crater 生成的發(fā)票樣式系統(tǒng)支持自定義模板與多幣種結(jié)算安裝完成后你可以在后臺(tái)直接編輯發(fā)票外觀。啟動(dòng)后如何驗(yàn)證服務(wù)正常先驗(yàn)證再談配置。建議按下面順序逐項(xiàng)確認(rèn)任何一項(xiàng)不通過(guò)就先停下排查不要繼續(xù)往下走。檢查安裝向?qū)c頁(yè)面資源首頁(yè)能打開(kāi)安裝向?qū)дｄ秩卷?yè)面樣式、圖標(biāo)不缺失。樣式文件缺失通常指向composer install未執(zhí)行或構(gòu)建產(chǎn)物未完成能進(jìn)入數(shù)據(jù)庫(kù)配置步驟說(shuō)明 PHP 到 MariaDB 的鏈路是通的檢查定時(shí)任務(wù)是否在工作Crater 的發(fā)票狀態(tài)流轉(zhuǎn)如過(guò)期提醒、逾期標(biāo)記依賴(lài)schedule:run容器里由 cron 服務(wù)每分鐘執(zhí)行一次?？梢杂眠@條命令觀察輸出docker-compose logs cron日志持續(xù)滾動(dòng)且無(wú)報(bào)錯(cuò)說(shuō)明調(diào)度器正常。如果這個(gè)容器沒(méi)起來(lái)定時(shí)任務(wù)全部失效屬于隱蔽故障值得單獨(dú)留意。檢查數(shù)據(jù)庫(kù)持久化重啟容器后登錄 MariaDB 確認(rèn)數(shù)據(jù)仍在docker-compose exec db mysql -u crater -pcrater crater -e show tables;表結(jié)構(gòu)存在、重啟不丟數(shù)據(jù)持久化才算真正生效。關(guān)鍵配置項(xiàng)說(shuō)明上傳體積限制上傳收據(jù)、客戶(hù)頭像等文件時(shí)有兩個(gè)限制要同時(shí)看docker-compose/php/uploads.iniPHP 側(cè)的upload_max_filesize與post_max_size默認(rèn) 64Mdocker-compose/nginx/nginx.confNginx 側(cè)的client_max_body_size默認(rèn) 64M兩邊取較小值生效。需要調(diào)大時(shí)兩處都要改只改一處會(huì)留下隱蔽的上傳失敗問(wèn)題。應(yīng)用運(yùn)行參數(shù)Laravel 應(yīng)用的APP_URL、數(shù)據(jù)庫(kù)主機(jī)等配置在安裝向?qū)Щ?env中維護(hù)。容器網(wǎng)絡(luò)里應(yīng)用連接數(shù)據(jù)庫(kù)的主機(jī)名是db而不是localhost——這是容器化部署中最高頻的踩坑點(diǎn)之一改配置時(shí)先確認(rèn)自己是在容器網(wǎng)絡(luò)還是宿主機(jī)視角下填寫(xiě)。文件掛載策略編排文件把整個(gè)項(xiàng)目目錄掛載到容器內(nèi)的/var/www意味著你本地修改代碼后容器即時(shí)生效適合開(kāi)發(fā)調(diào)試。生產(chǎn)環(huán)境建議改用只讀掛載或干脆把構(gòu)建產(chǎn)物打進(jìn)鏡像避免運(yùn)行時(shí)目錄被隨意改寫(xiě)。從單機(jī)到生產(chǎn)的擴(kuò)展思路不要一上來(lái)直接上生產(chǎn)。先用 Docker Compose 在測(cè)試環(huán)境完整跑一遍安裝、發(fā)發(fā)票、付款、備份全流程再考慮編排平臺(tái)。鏡像化與副本數(shù)把Dockerfile構(gòu)建的crater-php鏡像推送到內(nèi)部鏡像倉(cāng)庫(kù)然后在 Kubernetes 中創(chuàng)建 Deployment 時(shí)應(yīng)用容器只保留 PHP-FPM 或改用 Nginx 內(nèi)置鏡像作為對(duì)外入口Web 層無(wú)狀態(tài)后可以放心設(shè)多個(gè)副本storage目錄的寫(xiě)入需要規(guī)劃清楚會(huì)話、上傳文件落在哪個(gè)存儲(chǔ)介質(zhì)上多副本下ReadWriteOnce的 PVC 無(wú)法被多個(gè) Pod 共享通常需要共享存儲(chǔ)或?qū)ο蟠鎯?chǔ)方案可結(jié)合項(xiàng)目實(shí)際配置確認(rèn)外部訪問(wèn)與配置管理用 Ingress 暴露服務(wù)配好域名與 TLS數(shù)據(jù)庫(kù)建議改用集群內(nèi)獨(dú)立數(shù)據(jù)庫(kù)實(shí)例不要和業(yè)務(wù) Pod 共用節(jié)點(diǎn)APP_KEY、數(shù)據(jù)庫(kù)口令這類(lèi)敏感值放入 Secret常規(guī)參數(shù)放入 ConfigMap不要寫(xiě)死在清單里定時(shí)任務(wù)的生產(chǎn)化單機(jī)方案的 cron 容器在生產(chǎn)中應(yīng)替換為 Kubernetes CronJob保證schedule:run全局只有一個(gè)調(diào)度入口避免重復(fù)執(zhí)行。常見(jiàn)問(wèn)題排查清單現(xiàn)象優(yōu)先檢查點(diǎn)頁(yè)面 502 或一直加載docker-compose ps看 app 是否 runningdocker-compose logs app查 PHP 錯(cuò)誤安裝向?qū)Эㄔ跀?shù)據(jù)庫(kù)步驟確認(rèn)連接主機(jī)填的是db確認(rèn) MariaDB 容器已 ready樣式錯(cuò)亂、圖標(biāo) 404重新執(zhí)行docker-compose exec app php artisan storage:link確認(rèn)composer install成功文件上傳報(bào) size 錯(cuò)誤同時(shí)核對(duì)uploads.ini與nginx.conf里的 64M 限制重啟后數(shù)據(jù)沒(méi)了確認(rèn)db命名卷存在或宿主機(jī)掛載路徑寫(xiě)對(duì)到期發(fā)票狀態(tài)不自動(dòng)變化檢查 cron 容器日志確認(rèn)schedule:run在跑排查順序建議先看容器狀態(tài)docker-compose ps再看容器日志docker-compose logs 服務(wù)名最后才進(jìn)容器內(nèi)部docker-compose exec app手動(dòng)執(zhí)行命令復(fù)現(xiàn)。部署選型建議個(gè)人使用或開(kāi)發(fā)調(diào)試Docker Compose 一鍵啟動(dòng)即可本項(xiàng)目自帶的編排文件已經(jīng)覆蓋了 Web、數(shù)據(jù)庫(kù)和定時(shí)任務(wù)沒(méi)有多余復(fù)雜度小團(tuán)隊(duì)生產(chǎn)Docker Compose 定期docker compose pull更新 獨(dú)立的數(shù)據(jù)庫(kù)備份腳本成本最低企業(yè)級(jí)多副本遷移到 Kubernetes重點(diǎn)解決存儲(chǔ)共享、Secret 管理和 CronJob 化三件事一個(gè)務(wù)實(shí)的順序是本地 Compose 跑通 → 測(cè)試環(huán)境驗(yàn)證完整業(yè)務(wù)流 → 再上編排平臺(tái)。Crater 的容器化入口就在倉(cāng)庫(kù)根目錄的docker-compose.yml配合 docker-compose 配置目錄 中的 Nginx、PHP 與 cron 文件足以覆蓋大多數(shù)場(chǎng)景不必一開(kāi)始就追求最復(fù)雜的架構(gòu)。【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/crater創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Crater 容器化部署指南：用 Docker Compose 本地部署，再到生產(chǎn)環(huán)境平滑擴(kuò)展
Crater 容器化部署指南用 Docker Compose 本地部署再到生產(chǎn)環(huán)境平滑擴(kuò)展【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/craterCrater 是一款開(kāi)源的發(fā)票管理系統(tǒng)覆蓋客戶(hù)管理、報(bào)價(jià)單、發(fā)票、付款記錄和費(fèi)用追蹤適合自由職業(yè)者、小團(tuán)隊(duì)以及需要給客戶(hù)開(kāi)具正式發(fā)票的企業(yè)。這篇文章給你一條完整的落地路徑如何用 Docker Compose 在本地把 Crater 跑起來(lái)怎么確認(rèn)服務(wù)真的可用以及當(dāng)你需要面對(duì)多副本、持久化存儲(chǔ)和外部訪問(wèn)時(shí)生產(chǎn)環(huán)境該如何設(shè)計(jì)。全文只講關(guān)鍵步驟先跑通再優(yōu)化。部署前先確認(rèn)三件事環(huán)境與端口是否就緒Docker 與 Docker Compose 已安裝并可正常構(gòu)建鏡像主機(jī) 80 端口未被占用Nginx 容器映射到80:80主機(jī) 3306 被占用也沒(méi)關(guān)系編排文件里數(shù)據(jù)庫(kù)對(duì)外暴露的是33006:3306目錄與文件是否完整從 gitcode 倉(cāng)庫(kù)克隆完整項(xiàng)目后確認(rèn)以下文件都在根目錄中缺任何一個(gè)部署都會(huì)中斷git clone https://gitcode.com/gh_mirrors/cr/crater cd crater需要重點(diǎn)確認(rèn)的三個(gè)位置docker-compose.yml服務(wù)編排定義包含 app、db、nginx、cron 四個(gè)服務(wù)Dockerfile基于php:8.1-fpm的應(yīng)用鏡像構(gòu)建文件docker-compose/setup.sh容器啟動(dòng)后的初始化腳本數(shù)據(jù)庫(kù)連接信息編排文件中 MariaDB 的默認(rèn)賬號(hào)密碼均為craterMYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE并且數(shù)據(jù)庫(kù)數(shù)據(jù)掛載在名為db的命名卷里。如果你要改成把數(shù)據(jù)落到宿主機(jī)目錄需要注釋掉db:/var/lib/mysql那一行啟用下面注釋掉的宿主機(jī)路徑掛載并按自己的需求修改環(huán)境變量。最短路徑三步把服務(wù)跑起來(lái)第一步構(gòu)建并啟動(dòng)容器docker-compose up -d --build這條命令會(huì)構(gòu)建 PHP 應(yīng)用鏡像和 cron 鏡像然后拉起四個(gè)服務(wù)NginxWeb 入口、PHP-FPM應(yīng)用進(jìn)程、MariaDB數(shù)據(jù)庫(kù)、cronLaravel 定時(shí)任務(wù)調(diào)度。第二步執(zhí)行初始化腳本容器起來(lái)不等于應(yīng)用可用。Crater 需要在容器內(nèi)完成依賴(lài)安裝、密鑰生成和存儲(chǔ)軟鏈接項(xiàng)目自帶的初始化腳本已經(jīng)封裝好這些操作sh docker-compose/setup.sh腳本內(nèi)部執(zhí)行了三件事composer install安裝 PHP 依賴(lài)、php artisan storage:link建立storage軟鏈、php artisan key:generate生成應(yīng)用密鑰。注意第二條命令帶了|| true也就是說(shuō)軟鏈?zhǔn)〔粫?huì)阻斷流程——如果安裝向?qū)Ю锍霈F(xiàn)靜態(tài)資源 404回頭檢查這一步的日志。第三步打開(kāi)瀏覽器訪問(wèn)http://localhost看到 Crater 的安裝向?qū)Ъ幢硎?Web 鏈路已通。安裝向?qū)?huì)引導(dǎo)你完成公司信息和管理員賬號(hào)設(shè)置。上圖為 Crater 生成的發(fā)票樣式系統(tǒng)支持自定義模板與多幣種結(jié)算安裝完成后你可以在后臺(tái)直接編輯發(fā)票外觀。啟動(dòng)后如何驗(yàn)證服務(wù)正常先驗(yàn)證再談配置。建議按下面順序逐項(xiàng)確認(rèn)任何一項(xiàng)不通過(guò)就先停下排查不要繼續(xù)往下走。檢查安裝向?qū)c頁(yè)面資源首頁(yè)能打開(kāi)安裝向?qū)дｄ秩卷?yè)面樣式、圖標(biāo)不缺失。樣式文件缺失通常指向composer install未執(zhí)行或構(gòu)建產(chǎn)物未完成能進(jìn)入數(shù)據(jù)庫(kù)配置步驟說(shuō)明 PHP 到 MariaDB 的鏈路是通的檢查定時(shí)任務(wù)是否在工作Crater 的發(fā)票狀態(tài)流轉(zhuǎn)如過(guò)期提醒、逾期標(biāo)記依賴(lài)schedule:run容器里由 cron 服務(wù)每分鐘執(zhí)行一次?？梢杂眠@條命令觀察輸出docker-compose logs cron日志持續(xù)滾動(dòng)且無(wú)報(bào)錯(cuò)說(shuō)明調(diào)度器正常。如果這個(gè)容器沒(méi)起來(lái)定時(shí)任務(wù)全部失效屬于隱蔽故障值得單獨(dú)留意。檢查數(shù)據(jù)庫(kù)持久化重啟容器后登錄 MariaDB 確認(rèn)數(shù)據(jù)仍在docker-compose exec db mysql -u crater -pcrater crater -e show tables;表結(jié)構(gòu)存在、重啟不丟數(shù)據(jù)持久化才算真正生效。關(guān)鍵配置項(xiàng)說(shuō)明上傳體積限制上傳收據(jù)、客戶(hù)頭像等文件時(shí)有兩個(gè)限制要同時(shí)看docker-compose/php/uploads.iniPHP 側(cè)的upload_max_filesize與post_max_size默認(rèn) 64Mdocker-compose/nginx/nginx.confNginx 側(cè)的client_max_body_size默認(rèn) 64M兩邊取較小值生效。需要調(diào)大時(shí)兩處都要改只改一處會(huì)留下隱蔽的上傳失敗問(wèn)題。應(yīng)用運(yùn)行參數(shù)Laravel 應(yīng)用的APP_URL、數(shù)據(jù)庫(kù)主機(jī)等配置在安裝向?qū)Щ?env中維護(hù)。容器網(wǎng)絡(luò)里應(yīng)用連接數(shù)據(jù)庫(kù)的主機(jī)名是db而不是localhost——這是容器化部署中最高頻的踩坑點(diǎn)之一改配置時(shí)先確認(rèn)自己是在容器網(wǎng)絡(luò)還是宿主機(jī)視角下填寫(xiě)。文件掛載策略編排文件把整個(gè)項(xiàng)目目錄掛載到容器內(nèi)的/var/www意味著你本地修改代碼后容器即時(shí)生效適合開(kāi)發(fā)調(diào)試。生產(chǎn)環(huán)境建議改用只讀掛載或干脆把構(gòu)建產(chǎn)物打進(jìn)鏡像避免運(yùn)行時(shí)目錄被隨意改寫(xiě)。從單機(jī)到生產(chǎn)的擴(kuò)展思路不要一上來(lái)直接上生產(chǎn)。先用 Docker Compose 在測(cè)試環(huán)境完整跑一遍安裝、發(fā)發(fā)票、付款、備份全流程再考慮編排平臺(tái)。鏡像化與副本數(shù)把Dockerfile構(gòu)建的crater-php鏡像推送到內(nèi)部鏡像倉(cāng)庫(kù)然后在 Kubernetes 中創(chuàng)建 Deployment 時(shí)應(yīng)用容器只保留 PHP-FPM 或改用 Nginx 內(nèi)置鏡像作為對(duì)外入口Web 層無(wú)狀態(tài)后可以放心設(shè)多個(gè)副本storage目錄的寫(xiě)入需要規(guī)劃清楚會(huì)話、上傳文件落在哪個(gè)存儲(chǔ)介質(zhì)上多副本下ReadWriteOnce的 PVC 無(wú)法被多個(gè) Pod 共享通常需要共享存儲(chǔ)或?qū)ο蟠鎯?chǔ)方案可結(jié)合項(xiàng)目實(shí)際配置確認(rèn)外部訪問(wèn)與配置管理用 Ingress 暴露服務(wù)配好域名與 TLS數(shù)據(jù)庫(kù)建議改用集群內(nèi)獨(dú)立數(shù)據(jù)庫(kù)實(shí)例不要和業(yè)務(wù) Pod 共用節(jié)點(diǎn)APP_KEY、數(shù)據(jù)庫(kù)口令這類(lèi)敏感值放入 Secret常規(guī)參數(shù)放入 ConfigMap不要寫(xiě)死在清單里定時(shí)任務(wù)的生產(chǎn)化單機(jī)方案的 cron 容器在生產(chǎn)中應(yīng)替換為 Kubernetes CronJob保證schedule:run全局只有一個(gè)調(diào)度入口避免重復(fù)執(zhí)行。常見(jiàn)問(wèn)題排查清單現(xiàn)象優(yōu)先檢查點(diǎn)頁(yè)面 502 或一直加載docker-compose ps看 app 是否 runningdocker-compose logs app查 PHP 錯(cuò)誤安裝向?qū)Эㄔ跀?shù)據(jù)庫(kù)步驟確認(rèn)連接主機(jī)填的是db確認(rèn) MariaDB 容器已 ready樣式錯(cuò)亂、圖標(biāo) 404重新執(zhí)行docker-compose exec app php artisan storage:link確認(rèn)composer install成功文件上傳報(bào) size 錯(cuò)誤同時(shí)核對(duì)uploads.ini與nginx.conf里的 64M 限制重啟后數(shù)據(jù)沒(méi)了確認(rèn)db命名卷存在或宿主機(jī)掛載路徑寫(xiě)對(duì)到期發(fā)票狀態(tài)不自動(dòng)變化檢查 cron 容器日志確認(rèn)schedule:run在跑排查順序建議先看容器狀態(tài)docker-compose ps再看容器日志docker-compose logs 服務(wù)名最后才進(jìn)容器內(nèi)部docker-compose exec app手動(dòng)執(zhí)行命令復(fù)現(xiàn)。部署選型建議個(gè)人使用或開(kāi)發(fā)調(diào)試Docker Compose 一鍵啟動(dòng)即可本項(xiàng)目自帶的編排文件已經(jīng)覆蓋了 Web、數(shù)據(jù)庫(kù)和定時(shí)任務(wù)沒(méi)有多余復(fù)雜度小團(tuán)隊(duì)生產(chǎn)Docker Compose 定期docker compose pull更新 獨(dú)立的數(shù)據(jù)庫(kù)備份腳本成本最低企業(yè)級(jí)多副本遷移到 Kubernetes重點(diǎn)解決存儲(chǔ)共享、Secret 管理和 CronJob 化三件事一個(gè)務(wù)實(shí)的順序是本地 Compose 跑通 → 測(cè)試環(huán)境驗(yàn)證完整業(yè)務(wù)流 → 再上編排平臺(tái)。Crater 的容器化入口就在倉(cāng)庫(kù)根目錄的docker-compose.yml配合 docker-compose 配置目錄 中的 Nginx、PHP 與 cron 文件足以覆蓋大多數(shù)場(chǎng)景不必一開(kāi)始就追求最復(fù)雜的架構(gòu)。【免費(fèi)下載鏈接】craterOpen Source Invoicing Solution for Individuals Businesses項(xiàng)目地址: https://gitcode.com/gh_mirrors/cr/crater創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考