Add Docker Compose stack for L2 Essence 542 with PostgreSQL 17 and install scripts.

This commit is contained in:
test
2026-05-18 12:42:00 +03:00
commit a4a3a2aa09
8 changed files with 505 additions and 0 deletions
+9
View File
@@ -0,0 +1,9 @@
# Скопируйте в .env (install.sh создаст .env сам).
# В паролях для docker compose символ $ нужно удваивать: pa$$word
POSTGRES_USER=l2user
POSTGRES_PASSWORD=change_me_strong_password
POSTGRES_DB=l2essence
POSTGRES_PORT=5432
# Образ игрового сервера (когда будет свой реестр/локальная сборка)
# L2_SERVER_IMAGE=your-registry/l2-essence-542:latest
+4
View File
@@ -0,0 +1,4 @@
.env
*.log
.DS_Store
Thumbs.db
+44
View File
@@ -0,0 +1,44 @@
# Lineage 2 Essence 542 (Samurai Crow) — локальная среда
# Замените сервис l2-server на свой образ/сборку, когда будет готов Dockerfile.
services:
postgres:
image: postgres:17-alpine
container_name: l2_postgres
restart: unless-stopped
environment:
POSTGRES_USER: ${POSTGRES_USER:-l2user}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD in .env}
POSTGRES_DB: ${POSTGRES_DB:-l2essence}
PGDATA: /var/lib/postgresql/data/pgdata
ports:
- "${POSTGRES_PORT:-5432}:5432"
volumes:
- postgres_data:/var/lib/postgresql/data
- ./docker/initdb:/docker-entrypoint-initdb.d:ro
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-l2user} -d ${POSTGRES_DB:-l2essence}"]
interval: 5s
timeout: 5s
retries: 10
# Заглушка: подключите свой сервер (Auth/Game) или замените build: на реальный Dockerfile.
l2-server:
image: ${L2_SERVER_IMAGE:-ubuntu:24.04}
container_name: l2_server_placeholder
restart: "no"
depends_on:
postgres:
condition: service_healthy
environment:
DATABASE_URL: postgresql://${POSTGRES_USER:-l2user}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB:-l2essence}
# Раскомментируйте при готовности бинарей/скриптов:
# volumes:
# - ./server:/opt/l2server:ro
# command: ["/opt/l2server/start.sh"]
command: ["bash", "-lc", "echo 'L2 server placeholder: замените сервис l2-server в docker-compose.yml'; sleep infinity"]
profiles:
- placeholder
volumes:
postgres_data:
+2
View File
@@ -0,0 +1,2 @@
-- Расширения для init-скриптов (опционально).
CREATE EXTENSION IF NOT EXISTS pgcrypto;
+49
View File
@@ -0,0 +1,49 @@
-- Минимальные таблицы под логин-сервер в стиле L2J (accounts / gameservers / account_data).
-- Подходит для многих форков; у Samurai Crow/Essence могут отличаться имена колонок или хеш пароля —
-- тогда сверьте с SQL из вашей сборки и поправьте этот файл.
--
-- Тестовый логин: admin / admin
-- Хеш: Base64(SHA1 от UTF-8 строки «admin») — типично для L2J/Mobius.
-- Альтернатива (если сборка ждёт hex SHA1): замените поле password на
-- d033e22ae348aeb5660fc2140aec35850c4da997
CREATE TABLE IF NOT EXISTS accounts (
login VARCHAR(45) NOT NULL PRIMARY KEY,
password VARCHAR(128),
lastactive BIGINT,
accesslevel INTEGER NOT NULL DEFAULT 0,
lastip VARCHAR(45),
lastserver SMALLINT DEFAULT 1
);
CREATE TABLE IF NOT EXISTS account_data (
account_name VARCHAR(45) NOT NULL,
var VARCHAR(50) NOT NULL,
value VARCHAR(255),
PRIMARY KEY (account_name, var),
CONSTRAINT fk_account_data_account FOREIGN KEY (account_name)
REFERENCES accounts (login) ON DELETE CASCADE
);
CREATE TABLE IF NOT EXISTS gameservers (
hexid VARCHAR(255) NOT NULL,
server_id INTEGER NOT NULL PRIMARY KEY,
host VARCHAR(255) NOT NULL
);
INSERT INTO accounts (login, password, lastactive, accesslevel, lastip, lastserver)
VALUES (
'admin',
'0DPiKuNIrrVmD8IUCuw1hQxNqZc=',
(EXTRACT(EPOCH FROM NOW()) * 1000)::bigint,
0,
'127.0.0.1',
1
)
ON CONFLICT (login) DO NOTHING;
-- Игровой сервер при первом подключении к логину часто сам делает INSERT в gameservers.
-- Если нужна явная запись (hexid должен совпасть с RequestServerID / hex в конфиге GS):
-- INSERT INTO gameservers (hexid, server_id, host)
-- VALUES ('ВАШ_32_СИМВОЛА_HEX', 1, '127.0.0.1')
-- ON CONFLICT (server_id) DO UPDATE SET hexid = EXCLUDED.hexid, host = EXCLUDED.host;
+8
View File
@@ -0,0 +1,8 @@
#!/bin/sh
# Выдаёт владельца таблиц логина роли из POSTGRES_USER (см. docker-compose).
set -eu
psql -v ON_ERROR_STOP=1 --username "postgres" --dbname "$POSTGRES_DB" <<-EOSQL
ALTER TABLE IF EXISTS accounts OWNER TO "${POSTGRES_USER}";
ALTER TABLE IF EXISTS account_data OWNER TO "${POSTGRES_USER}";
ALTER TABLE IF EXISTS gameservers OWNER TO "${POSTGRES_USER}";
EOSQL
+196
View File
@@ -0,0 +1,196 @@
#!/usr/bin/env bash
# Интерактивный установщик: Ubuntu + Docker + PostgreSQL 17 (docker compose).
# Запуск: chmod +x install.sh && ./install.sh
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$SCRIPT_DIR"
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
ask_yes_no() {
local prompt="$1"
local default="${2:-n}"
local hint="[y/N]"
[[ "$default" == "y" ]] && hint="[Y/n]"
while true; do
read -r -p "$prompt $hint: " ans
ans="${ans:-$default}"
case "$ans" in
[Yy]|[Yy][Ee][Ss]) return 0 ;;
[Nn]|[Nn][Oo]) return 1 ;;
*) echo "Введите y или n." ;;
esac
done
}
info() { echo -e "${GREEN}[*]${NC} $*"; }
warn() { echo -e "${YELLOW}[!]${NC} $*"; }
err() { echo -e "${RED}[x]${NC} $*" >&2; }
step_header() {
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo " $1"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
}
require_cmd() {
command -v "$1" >/dev/null 2>&1
}
read_env_val() {
local key="$1"
grep -m1 "^${key}=" "$ENV_FILE" | sed "s/^${key}=//"
}
# --- Шаг 0: приветствие ---
step_header "Шаг 0 — Обзор"
echo "Проект: Lineage 2 Essence 542 (Samurai Crow), окружение в Docker."
echo "Будет поднят PostgreSQL 17; игровой сервис — по профилю placeholder (заглушка), пока нет своего образа."
if ! ask_yes_no "Продолжить?" "y"; then
info "Выход."
exit 0
fi
# --- Шаг 1: проверка Ubuntu (мягко) ---
step_header "Шаг 1 — Система"
if [[ -f /etc/os-release ]]; then
# shellcheck source=/dev/null
source /etc/os-release
if [[ "${ID:-}" != "ubuntu" ]]; then
warn "Обнаружено не Ubuntu (${PRETTY_NAME:-unknown}). Скрипт рассчитан на Ubuntu; продолжайте на свой риск."
ask_yes_no "Всё равно продолжить?" "n" || exit 1
else
info "ОС: ${PRETTY_NAME:-Ubuntu}"
fi
else
warn "Не удалось прочитать /etc/os-release."
fi
# --- Шаг 2: Docker ---
step_header "Шаг 2 — Docker Engine и Compose"
if require_cmd docker && docker compose version >/dev/null 2>&1; then
info "Docker и 'docker compose' уже доступны."
else
if ask_yes_no "Установить Docker из официального репозитория Docker (apt)?" "y"; then
if [[ "${EUID:-$(id -u)}" -ne 0 ]]; then
warn "Для установки пакетов нужны права sudo."
SUDO="sudo"
else
SUDO=""
fi
$SUDO apt-get update -y
$SUDO apt-get install -y ca-certificates curl
$SUDO install -m 0755 -d /etc/apt/keyrings
$SUDO curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
$SUDO chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${VERSION_CODENAME:-jammy}") stable" | $SUDO tee /etc/apt/sources.list.d/docker.list >/dev/null
$SUDO apt-get update -y
$SUDO apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
info "Docker установлен."
if [[ "${EUID:-$(id -u)}" -ne 0 ]] && ask_yes_no "Добавить текущего пользователя $(whoami) в группу docker?" "y"; then
$SUDO usermod -aG docker "$(whoami)"
warn "Выйдите из сессии и войдите снова (или newgrp docker), чтобы использовать docker без sudo."
fi
else
err "Без Docker дальнейшие шаги невозможны."
exit 1
fi
fi
# Проверка доступа к docker
if ! docker info >/dev/null 2>&1; then
err "Docker недоступен (возможно нужен sudo или перелогин после добавления в группу docker)."
exit 1
fi
# --- Шаг 3: .env ---
step_header "Шаг 3 — Файл .env (PostgreSQL 17)"
ENV_FILE="$SCRIPT_DIR/.env"
EXAMPLE="$SCRIPT_DIR/.env.example"
if [[ ! -f "$EXAMPLE" ]]; then
err "Нет файла .env.example"
exit 1
fi
if [[ -f "$ENV_FILE" ]]; then
if ! ask_yes_no ".env уже есть. Перезаписать значениями из мастера?" "n"; then
info "Оставляем существующий .env"
else
rm -f "$ENV_FILE"
fi
fi
if [[ ! -f "$ENV_FILE" ]]; then
info "Создаём .env. Введите параметры БД (Enter — значение по умолчанию в скобках)."
read -r -p "POSTGRES_USER [l2user]: " u
u="${u:-l2user}"
while true; do
read -r -s -p "POSTGRES_PASSWORD (обязательно): " p
echo ""
[[ -n "$p" ]] && break
err "Пароль не может быть пустым."
done
read -r -p "POSTGRES_DB [l2essence]: " d
d="${d:-l2essence}"
read -r -p "POSTGRES_PORT [5432]: " port
port="${port:-5432}"
if [[ "$p" == "change_me_strong_password" ]]; then
err "Смените пароль по умолчанию."
exit 1
fi
{
printf '%s\n' "POSTGRES_USER=$u" "POSTGRES_PASSWORD=$p" "POSTGRES_DB=$d" "POSTGRES_PORT=$port"
echo '# L2_SERVER_IMAGE=your-registry/l2-essence-542:latest'
} >"$ENV_FILE"
fi
# --- Шаг 4: pull ---
step_header "Шаг 4 — Загрузка образов"
if ask_yes_no "Выполнить docker compose pull?" "y"; then
docker compose pull
fi
# --- Шаг 5: запуск Postgres ---
step_header "Шаг 5 — Запуск PostgreSQL 17"
if ask_yes_no "Поднять только PostgreSQL (рекомендуется)?" "y"; then
chmod +x "$SCRIPT_DIR"/docker/initdb/*.sh 2>/dev/null || true
docker compose up -d postgres
info "Ожидание готовности PostgreSQL (pg_isready)..."
EV_USER="$(read_env_val POSTGRES_USER)"
EV_DB="$(read_env_val POSTGRES_DB)"
for _ in $(seq 1 60); do
if docker compose exec -T postgres pg_isready -U "$EV_USER" -d "$EV_DB" >/dev/null 2>&1; then
break
fi
sleep 1
done
docker compose ps
fi
# --- Шаг 6: заглушка L2 ---
step_header "Шаг 6 — Игровой контейнер (заглушка)"
warn "Сервис l2-server в compose помечен profile 'placeholder'. Замените образ/команду под Samurai Crow."
if ask_yes_no "Запустить контейнер-заглушку l2-server (для проверки сети к БД)?" "n"; then
docker compose --profile placeholder up -d l2-server
docker compose ps
fi
# --- Готово ---
step_header "Готово"
EV_USER="$(read_env_val POSTGRES_USER)"
EV_DB="$(read_env_val POSTGRES_DB)"
EV_PORT="$(read_env_val POSTGRES_PORT)"
info "Строка подключения с хоста Ubuntu: postgresql://${EV_USER}:***@127.0.0.1:${EV_PORT}/${EV_DB}"
info "Из контейнеров в этой compose-сети: хост postgres, порт 5432."
echo ""
info "Полезные команды:"
echo " docker compose logs -f postgres"
echo " docker compose down"
echo " docker compose --profile placeholder down"
+193
View File
@@ -0,0 +1,193 @@
#!/usr/bin/env bash
# Интерактивное управление: остановка, запуск, перезапуск Docker-сервисов проекта.
# Запуск: chmod +x manage.sh && ./manage.sh
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$SCRIPT_DIR"
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
ENV_FILE="$SCRIPT_DIR/.env"
PROFILE_PLACEHOLDER=(--profile placeholder)
# Имена из docker-compose.yml (для надёжной проверки состояния)
PG_CONTAINER="l2_postgres"
L2_CONTAINER="l2_server_placeholder"
read_env_val() {
local key="$1"
grep -m1 "^${key}=" "$ENV_FILE" | sed "s/^${key}=//"
}
ask_yes_no() {
local prompt="$1"
local default="${2:-n}"
local hint="[y/N]"
[[ "$default" == "y" ]] && hint="[Y/n]"
while true; do
read -r -p "$prompt $hint: " ans
ans="${ans:-$default}"
case "$ans" in
[Yy]|[Yy][Ee][Ss]) return 0 ;;
[Nn]|[Nn][Oo]) return 1 ;;
*) echo "Введите y или n." ;;
esac
done
}
info() { echo -e "${GREEN}[*]${NC} $*"; }
warn() { echo -e "${YELLOW}[!]${NC} $*"; }
err() { echo -e "${RED}[x]${NC} $*" >&2; }
step_header() {
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo " $1"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
}
require_cmd() {
command -v "$1" >/dev/null 2>&1
}
ensure_docker() {
if ! require_cmd docker || ! docker compose version >/dev/null 2>&1; then
err "Нужны Docker и плагин «docker compose». Установите через ./install.sh"
exit 1
fi
if ! docker info >/dev/null 2>&1; then
err "Docker недоступен (sudo или перелогин после группы docker)."
exit 1
fi
}
ensure_env() {
if [[ ! -f "$ENV_FILE" ]]; then
err "Нет файла .env. Сначала выполните ./install.sh"
exit 1
fi
}
postgres_running() {
[[ "$(docker inspect -f '{{.State.Running}}' "$PG_CONTAINER" 2>/dev/null || echo false)" == "true" ]]
}
l2_running() {
[[ "$(docker inspect -f '{{.State.Running}}' "$L2_CONTAINER" 2>/dev/null || echo false)" == "true" ]]
}
# --- Шаг 0 ---
step_header "Шаг 0 — Управление сервером (Docker Compose)"
echo "Проект: PostgreSQL 17 + опционально l2-server (profile placeholder)."
if ! ask_yes_no "Продолжить?" "y"; then
info "Выход."
exit 0
fi
ensure_docker
ensure_env
# --- Шаг 1: статус ---
step_header "Шаг 1 — Текущий статус"
if ask_yes_no "Показать docker compose ps?" "y"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" ps -a || true
fi
# --- Шаг 2: остановка ---
step_header "Шаг 2 — Остановка"
if ask_yes_no "Остановить контейнер l2-server (если был запущен с profile placeholder)?" "n"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" stop l2-server 2>/dev/null || warn "l2-server не остановлен (возможно не запускался)."
fi
if ask_yes_no "Остановить только PostgreSQL (docker compose stop postgres)?" "n"; then
docker compose stop postgres 2>/dev/null || warn "PostgreSQL уже остановлен или не создавался."
fi
if ask_yes_no "Полная остановка проекта: docker compose down (все сервисы, сеть; тома БД не удаляются)?" "n"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" down
info "Контейнеры остановлены. Данные БД в томе postgres_data сохранены."
fi
if ask_yes_no "Удалить том с данными PostgreSQL (docker compose down -v)? ОПАСНО: потеря БД." "n"; then
warn "Будет выполнено: docker compose --profile placeholder down -v"
if ask_yes_no "Точно удалить тома?" "n"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" down -v
info "Тома удалены."
else
info "Отмена удаления томов."
fi
fi
# --- Шаг 3: запуск ---
step_header "Шаг 3 — Запуск"
if ask_yes_no "Запустить / обновить PostgreSQL (up -d postgres)?" "n"; then
docker compose up -d postgres
info "Ожидание pg_isready..."
EV_USER="$(read_env_val POSTGRES_USER)"
EV_DB="$(read_env_val POSTGRES_DB)"
for _ in $(seq 1 60); do
if docker compose exec -T postgres pg_isready -U "$EV_USER" -d "$EV_DB" >/dev/null 2>&1; then
break
fi
sleep 1
done
fi
if ask_yes_no "Запустить l2-server (placeholder, нужен здоровый PostgreSQL)?" "n"; then
if ! postgres_running; then
warn "PostgreSQL не запущен. Сначала поднимите postgres."
else
docker compose "${PROFILE_PLACEHOLDER[@]}" up -d l2-server
fi
fi
# --- Шаг 4: перезапуск ---
step_header "Шаг 4 — Перезапуск"
if ask_yes_no "Перезапустить PostgreSQL (restart postgres)?" "n"; then
if postgres_running; then
docker compose restart postgres
info "PostgreSQL перезапущен."
else
warn "PostgreSQL не в состоянии running. Выполняю up -d postgres."
docker compose up -d postgres
fi
fi
if ask_yes_no "Перезапустить l2-server (restart l2-server)?" "n"; then
if l2_running; then
docker compose "${PROFILE_PLACEHOLDER[@]}" restart l2-server
info "l2-server перезапущен."
else
warn "l2-server не запущен. Пропуск."
fi
fi
if ask_yes_no "Перезапустить весь стек: сначала down, затем up postgres (+ опционально l2)?" "n"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" down
docker compose up -d postgres
EV_USER="$(read_env_val POSTGRES_USER)"
EV_DB="$(read_env_val POSTGRES_DB)"
for _ in $(seq 1 60); do
if docker compose exec -T postgres pg_isready -U "$EV_USER" -d "$EV_DB" >/dev/null 2>&1; then
break
fi
sleep 1
done
if ask_yes_no "Сразу поднять l2-server (placeholder)?" "n"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" up -d l2-server
fi
info "Стек перезапущен."
fi
# --- Итог ---
step_header "Готово"
if ask_yes_no "Показать итоговый статус?" "y"; then
docker compose "${PROFILE_PLACEHOLDER[@]}" ps -a || true
fi
info "Логи: docker compose logs -f postgres"
info "Выход из проекта без удаления томов: docker compose --profile placeholder down"