Leecheng/KTVSinglePublisher
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

KTVSinglePublisher V.0.0.0

Browse Source 
20250617
This commit is contained in:
allen.yan 2025-06-17 12:47:14 +08:00
commit 7660b16a2e
19 changed files with 645 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
.env.example Normal file
View File

@ -0,0 +1,11 @@
# Project
APP_NAME=ktvsingle
APP_DOMAIN=hzd.superstar.dnsnet.cc
APP_URL=http://hzd.superstar.dnsnet.cc
REPO_URL=http://47.251.18.130:3000/Leecheng/KTVSingle.git
# Database
DB_DATABASE=KTVSingle
DB_USERNAME=KTVSingle
DB_PASSWORD=ESM7yTPMnavFmbBH

15
.gitattributes vendored Normal file
View File

@ -0,0 +1,15 @@
# 所有 Shell 腳本用 LF
*.sh text eol=lf
# Docker 設定與腳本
Dockerfile text eol=lf
*.yaml text eol=lf
*.yml text eol=lf
# Laravel & PHP 設定檔
*.conf text eol=lf
*.ini text eol=lf
.env* text eol=lf
# 其他你專案內的自定義目錄內腳本
docker/** text eol=lf

20
.gitignore vendored Normal file
View File

@ -0,0 +1,20 @@
# 忽略開發用 override 設定
docker-compose.override.yml
# 忽略建置產出的 volume、掛載資料
data/
html/
log/
logs/
*.sqlite
# 忽略環境變數備份
.env
.env.backup
.env.*.backup
# 忽略暫存與 log
*.log
*.pid
.DS_Store

34
Dockerfile Normal file
View File

@ -0,0 +1,34 @@
FROM php:8.3-fpm
# ---- system & PHP extensions -------------------------------------------------
RUN apt-get update && apt-get install -y --no-install-recommends \
procps nginx gettext logrotate \
git unzip zip curl ca-certificates supervisor cron nano \
libpng-dev libjpeg62-turbo-dev libfreetype6-dev \
libonig-dev libxml2-dev libzip-dev libpq-dev libicu-dev libxslt-dev \
libsqlite3-dev sqlite3 default-mysql-client \
&& curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
&& apt-get install -y --no-install-recommends nodejs \
&& npm install -g npm \
&& docker-php-ext-configure gd --with-freetype --with-jpeg \
&& docker-php-ext-install -j$(nproc) gd pdo_mysql zip bcmath intl xsl pcntl sockets opcache\
&& pecl install redis && docker-php-ext-enable redis \
&& apt-get clean && rm -rf /var/lib/apt/lists/*
# ---- composer ---------------------------------------------------------------
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
# ---- config files -----------------------------------------------------------
COPY docker/php/php.ini /usr/local/etc/php/conf.d/custom-php.ini
COPY docker/php/opcache.ini /usr/local/etc/php/conf.d/opcache.ini
COPY docker/supervisord.conf /etc/supervisor/conf.d/supervisord.conf
COPY docker/entrypoint.sh /entrypoint.sh
COPY docker/entrypoint.git.sh /entrypoint.git.sh
COPY docker/nginx/default.conf.template /etc/nginx/templates/default.conf.template
COPY docker/logrotate/laravel /etc/logrotate.d/app/laravel.conf
RUN chmod 644 /etc/logrotate.d/app/laravel.conf
WORKDIR /var/www
RUN chmod +x /entrypoint.sh /entrypoint.git.sh
ENTRYPOINT ["/entrypoint.sh"]

179
README.md Normal file
View File

@ -0,0 +1,179 @@
# Laravel + Docker 開發環境
本專案提供一個以 Docker 為基礎的 Laravel 開發環境，整合以下功能：
- Laravel App with PHP 8.3
- Nginx 作為 Web Server
- MariaDB 作為資料庫
- Supervisor 管理 Laravel 的 queue 與 scheduler
- Git Worker 自動同步程式碼 (透過 git pull)
- 多容器架構支援 `.env` 配置
---
## 📁 專案結構
```
.
├── docker/ # 各服務用到的設定檔
│ ├── nginx/ # Nginx templates
│ ├── mariadb/ # MariaDB my.cnf
│ ├── php/ # PHP 設定
│ ├── entrypoint.git.sh # Git worker 初始化腳本
│ ├── supervisord.conf # Laravel App 用 Supervisor 設定
│ └── supervisord.git.conf # Git Worker 用 Supervisor 設定
├── data/ # 資料儲存與服務掛載目錄
│ ├── html/ # Laravel 專案程式碼 (git clone 下來)
│ ├── logs/ # Log 檔目錄
│ ├── mariadb/ # DB 資料儲存
│ └── nginx/ # Nginx 設定
├── Dockerfile # Laravel App Dockerfile
├── Dockerfile.git # Git Worker Dockerfile
├── docker-compose.yml
└── README.md
```
---
## 🚀 快速開始
### 1️⃣ 建立 `.env` 檔案
```bash
cp .env.example .env
```
填寫必要參數：
```env
APP_NAME=ktvcentral
APP_URL=http://localhost
APP_DOMAIN=localhost
APP_PORT=80
REPO_URL=https://github.com/your/laravel-repo.git
REPO_BRANCH=main
DB_HOST=mariadb
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret
```
---
### 2️⃣ 使用容器方法
```bash
./start.sh --wipe
./stop.sh --wipe
./restart.sh
```
完成後會啟動：
- Laravel app
- Git worker (定期同步程式碼)
- Queue worker / Scheduler（由 Supervisor 管理）
- MariaDB
- Nginx
---
## 🛠️ 服務說明
| 容器名稱 | 說明 |
|--------------------|---------------------------------------------|
| `ktvcentral_app` | Laravel App (PHP 8.3 + Supervisor) |
| `ktvcentral_db` | MariaDB 10.6 |
| `ktvcentral_nginx` | 靜態資源與反向代理（連接 Laravel App） |
---
## 📚 Laravel 常見操作
```bash
# 進入 app 容器
docker compose exec app bash
# Laravel 操作範例
php artisan migrate --seed
php artisan queue:restart
npm install && npm run build
```
---
## 🧼 目錄權限與 Log
請確保以下目錄存在且權限正確：
```bash
mkdir -p data/html
mkdir -p data/logs/php
mkdir -p data/logs/nginx
mkdir -p data/logs/mariadb
```
Laravel 儲存相關：
```bash
chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache
```
---
## 🐳 Supervisor 管理進程
| 進程名稱 | 功能 |
|----------------|----------------------------------|
| `queue-worker` | 執行 Laravel 的 queue 任務 |
| `scheduler` | 每分鐘執行 Laravel schedule:run |
| `git-worker` | 每分鐘從 Git 拉取最新程式碼 |
查看 log：
```bash
docker compose exec app tail -f /var/www/logs/supervisord.log
```
---
## 🧪 Git 版本控制（手動）
```bash
# 回到上一個版本
git checkout HEAD^
# 建立回退分支
git switch -c fix-rollback-version
# 回 commit 並推送
git push origin fix-rollback-version
```
---
## 📦 附加服務（可擴充）
你可以額外整合以下服務：
- Redis
- phpMyAdmin
- Laravel Telescope / Horizon
- Mailpit / Mailhog
---
## ✅ 建議調整
- 若為生產環境，請考慮設定更嚴格的權限與環境變數
- 使用 `.env.production` 搭配 `.env` 切換設定檔
---
## 📜 License
MIT © 2025

51
docker-compose.yml Normal file
View File

@ -0,0 +1,51 @@
services:
mariadb:
image: mariadb:10.6
container_name: ${APP_NAME}_db
restart: always
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
MYSQL_DATABASE: ${DB_DATABASE}
MYSQL_USER: ${DB_USERNAME}
MYSQL_PASSWORD: ${DB_PASSWORD}
volumes:
- ./data/mariadb/lib:/var/lib/mysql
- ./data/mariadb/conf.d:/etc/mysql/conf.d
- ./data/logs/mariadb:/var/log/mysql
- ./docker/mariadb/my.cnf:/etc/mysql/conf.d/custom.cnf
ports:
- "3306:3306"
networks:
- app_network
app:
build:
context: .
dockerfile: Dockerfile
container_name: ${APP_NAME}_app
volumes:
- ./data/html:/var/www/html
- ./data/logs/php:/var/www/logs
- ./data/logs/nginx/:/var/log/nginx
ports:
- "${APP_PORT:-80}:${APP_PORT:-80}"
depends_on:
- mariadb
environment:
REPO_URL: ${REPO_URL}
BRANCH: ${REPO_BRANCH:-main}
APP_NAME: ${APP_NAME}
APP_URL: ${APP_URL}
DB_HOST: mariadb
DB_PORT: 3306
DB_DATABASE: ${DB_DATABASE}
DB_USERNAME: ${DB_USERNAME}
DB_PASSWORD: ${DB_PASSWORD}
NGINX_HOST: ${APP_DOMAIN}
NGINX_PORT: ${APP_PORT:-80}
networks:
- app_network
networks:
app_network:
driver: bridge

24
docker/entrypoint.git.sh Normal file
View File

@ -0,0 +1,24 @@
#!/usr/bin/env bash
set -e
BRANCH=${BRANCH:-main}
TARGET_DIR=/var/www/html
echo "[git-worker] Loop started for branch $BRANCH"
while true; do
cd "$TARGET_DIR"
git remote update
LOCAL=$(git rev-parse @)
REMOTE=$(git rev-parse "origin/$BRANCH")
if [ "$LOCAL" != "$REMOTE" ]; then
echo "[git-worker] Detected new commits, pulling..."
git pull origin "$BRANCH"
echo "[git-worker] Restarting queue-worker..."
supervisorctl restart queue-worker
else
echo "[git-worker] No changes."
fi
sleep 300
done

50
docker/entrypoint.sh Normal file
View File

@ -0,0 +1,50 @@
#!/usr/bin/env bash
set -e
REPO_URL=${REPO_URL}
BRANCH=${BRANCH:-main}
TARGET_DIR=/var/www/html
# 1) 初次 clone 或拉取
if [ -z "$(ls -A "$TARGET_DIR")" ]; then
echo "[entrypoint] Cloning $BRANCH from $REPO_URL ..."
git clone --branch "$BRANCH" "$REPO_URL" "$TARGET_DIR"
else
echo "[entrypoint] Repository already present, skipping clone."
fi
cd "$TARGET_DIR"
# 2) Laravel 基礎安裝
composer install --no-interaction --prefer-dist
[ -f .env ] || cp .env.example .env
update_env() { local k=$1 v=$2; grep -q "^$k=" .env && sed -i "s|^$k=.*|$k=$v|" .env || echo "$k=$v" >> .env; }
update_env APP_NAME "$APP_NAME"
update_env APP_URL "${APP_URL%/}"
update_env DB_HOST "$DB_HOST"
update_env DB_PORT "$DB_PORT"
update_env DB_DATABASE "$DB_DATABASE"
update_env DB_USERNAME "$DB_USERNAME"
update_env DB_PASSWORD "$DB_PASSWORD"
php artisan key:generate --force
php artisan migrate --force
[ -d node_modules ] || npm install
npm run build
chown -R www-data:www-data storage bootstrap/cache
chmod -R 775 storage bootstrap/cache
mkdir -p /var/www/logs
supervisord -c /etc/supervisor/conf.d/supervisord.conf &
php-fpm -D
envsubst '${NGINX_HOST} ${NGINX_PORT}' < /etc/nginx/templates/default.conf.template > /etc/nginx/conf.d/default.conf
exec nginx -g "daemon off;"
echo "0 0 * * * root /usr/sbin/logrotate /etc/logrotate.d/app" > /etc/cron.d/logrotate-Laravel
chmod 0644 /etc/cron.d/logrotate-Laravel
echo "[entrypoint] Testing logrotate config..."
logrotate --debug /etc/logrotate.d/app/laravel.conf

23
docker/logrotate/laravel Normal file
View File

@ -0,0 +1,23 @@
/var/log/nginx/*.log {
daily
missingok
rotate 7
compress
delaycompress
notifempty
create 0640 www-data www-data
sharedscripts
postrotate
pkill -HUP nginx
endscript
}
/var/www/logs/*.log {
daily
missingok
rotate 7
compress
delaycompress
notifempty
create 0640 www-data www-data
}

23
docker/mariadb/my.cnf Normal file
View File

@ -0,0 +1,23 @@
[mysqld]
log_error = /var/log/mysql/error.log
slow_query_log = 1
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 2
# 使用 UTF-8 編碼
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci
# 提升最大連線數
max_connections=200
# InnoDB 設定
default-storage-engine=InnoDB
innodb_file_per_table=1
innodb_buffer_pool_size=256M
# 安全 SQL 模式
sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION
# 時區
default_time_zone='+08:00'

27
docker/nginx/default.conf.template Normal file
View File

@ -0,0 +1,27 @@
server {
listen ${NGINX_PORT};
server_name ${NGINX_HOST};
root /var/www/html/public;
index index.php index.html;
client_max_body_size 100M;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
location ~ /\.ht {
deny all;
}
}

8
docker/php/opcache.ini Normal file
View File

@ -0,0 +1,8 @@
opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.validate_timestamps=0
opcache.revalidate_freq=0
opcache.fast_shutdown=1

5
docker/php/php.ini Normal file
View File

@ -0,0 +1,5 @@
memory_limit = 512M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
date.timezone = Asia/Taipei

35
docker/supervisord.conf Normal file
View File

@ -0,0 +1,35 @@
[supervisord]
user=root
nodaemon=true
logfile=/var/www/logs/supervisord.log ; 設定 log 儲存位置
pidfile=/var/www/logs/supervisord.pid ; 設定 pid 儲存位置
[program:queue-worker]
directory=/var/www/html
command=php artisan queue:work --daemon --timeout=3600 --tries=1 --queue=default
autostart=true
autorestart=true
stdout_logfile=/var/www/logs/queue.log
stderr_logfile=/var/www/logs/queue_error.log
stopsignal=INT
[program:scheduler]
directory=/var/www/html
command=/bin/sh -c "while true; do php artisan schedule:run; sleep 60; done"
autostart=true
autorestart=true
stdout_logfile=/var/www/logs/schedule.log
stderr_logfile=/var/www/logs/schedule_error.log
[program:git-worker]
command=/bin/sh /entrypoint.git.sh
autostart=true
autorestart=true
stdout_logfile=/var/www/logs/git-worker.log
stderr_logfile=/var/www/logs/git-worker_error.log
startsecs=0
[program:cron]
command=/usr/sbin/cron -f
autostart=true
autorestart=true

30
restart.sh Executable file
View File

@ -0,0 +1,30 @@
#!/bin/bash
WIPE=false
if [ "$1" == "--wipe" ]; then
WIPE=true
fi
# 載入 .env 中的變數
if [ -f .env ]; then
export $(grep -v '^#' .env | xargs)
echo "📦 .env 載入完成"
else
echo "❌ 沒有找到 .env，無法載入環境變數"
exit 1
fi
# 使用 .env 中的 APP_NAME 作為 project name
PROJECT_NAME="${APP_NAME}"
echo "♻️ 正在重新啟動 $PROJECT_NAME 所有服務..."
# 先停服務
echo "🔻 執行 stop.sh..."
./stop.sh $([ "$WIPE" == "true" ] && echo "--wipe")
# 再啟動服務
echo "🔺 執行 start.sh..."
./start.sh
echo "✅ $PROJECT_NAME 已完成重啟！"

28
start.sh Executable file
View File

@ -0,0 +1,28 @@
#!/bin/bash
WIPE=false
if [ "$1" == "--wipe" ]; then
WIPE=true
fi
# 載入 .env 中的變數
if [ -f .env ]; then
export $(grep -v '^#' .env | xargs)
echo "📦 .env 載入完成"
else
echo "❌ 沒有找到 .env，無法載入環境變數"
exit 1
fi
# 使用 .env 中的 APP_NAME 作為 project name
PROJECT_NAME="${APP_NAME}"
# 組合額外參數（如果有需要清除 volume 與 image）
EXTRA_FLAGS="up -d"
if [ "$WIPE" == "true" ]; then
EXTRA_FLAGS="up -d --build"
fi
echo "🚀 Starting APP services..."
docker compose -p $PROJECT_NAME -f docker-compose.yml $EXTRA_FLAGS
echo "✅ All services for $PROJECT_NAME are up and running!"

19
status.sh Normal file
View File

@ -0,0 +1,19 @@
#!/bin/bash
# 載入 .env 中的變數
if [ -f .env ]; then
export $(grep -v '^#' .env | xargs)
echo "📦 .env 載入完成"
else
echo "❌ 沒有找到 .env，無法載入環境變數"
exit 1
fi
# 使用 .env 中的 APP_NAME 作為 project name
PROJECT_NAME="${APP_NAME}"
echo "📊 目前 $PROJECT_NAME 相關容器狀態："
docker ps --filter "name=${PROJECT_NAME}_" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"
echo "🔍 目前網路狀態（含 app_network）："
docker network inspect app_network --format '{{json .Containers}}' | jq

33
stop.sh Executable file
View File

@ -0,0 +1,33 @@
#!/bin/bash
WIPE=false
if [ "$1" == "--wipe" ]; then
WIPE=true
fi
# 載入 .env 中的變數
if [ -f .env ]; then
export $(grep -v '^#' .env | xargs)
echo "📦 .env 載入完成"
else
echo "❌ 沒有找到 .env，無法載入環境變數"
exit 1
fi
# 使用 .env 中的 APP_NAME 作為 project name
PROJECT_NAME="${APP_NAME}"
# 組合額外參數（如果有需要清除 volume 與 image）
EXTRA_FLAGS=""
if [ "$WIPE" == "true" ]; then
EXTRA_FLAGS="-v --rmi all"
fi
echo "🛑 Stopping APP services..."
docker compose -p "$PROJECT_NAME" -f docker-compose.yml down $EXTRA_FLAGS
if [ "$WIPE" == "true" ]; then
echo "🧹 所有資料（volumes, image）已清除！"
else
echo "✅ 所有服務 $PROJECT_NAME 已成功關閉。"
fi

30
開發紀錄.txt Normal file
View File

@ -0,0 +1,30 @@
• 啟動所有服務：./start.sh --wipe
• 停止服務保留資料：./stop.sh
• 停止並清除資料：./stop.sh --wipe
# 正常重啟，不刪除資料
./restart.sh
# 重啟並清除 volumes 和 images
./restart.sh --wipe
docker ps
docker logs ktvcentral_app
docker exec -it ktvcentral_app bash -c "cd /var/www/html && php artisan migrate:fresh --seed"
docker exec -it ktvcentral_app php artisan migrate
artisan:
docker exec -it ktvcentral_app php artisan $(cmd)
docker exec -it ktvcentral_app bash
docker exec -it ktvcentral_app php artisan $(cmd)
docker exec -it ktvcentral_app php artisan transfer:sqlite sqlite/tempUser.sqlite --sync