فایل compose که برای توسعهٔ محلی نوشتهای، روی سرور چند چیز کم دارد. اینها همانهاییاند که نبودشان را شب ساعت سه میفهمی.
سیاست ریاستارت
services:
app:
restart: unless-stopped
unless-stopped یعنی بعد از کرش و بعد از ریبوت سرور برمیگردد، مگر اینکه خودت دستی متوقفش کرده باشی. always حتی سرویسی را که عمداً خواباندهای هم بعد از ریبوت بالا میآورد، که معمولاً چیزی نیست که بخواهی.
healthcheck و وابستگی واقعی
depends_on بهتنهایی فقط ترتیب شروع را تضمین میکند، نه آماده بودن. کانتینر دیتابیس «شروع شده» ولی هنوز اتصال نمیپذیرد، و برنامه با خطا بالا میآید:
services:
db:
image: postgres:17
healthcheck:
test: ["CMD-SHELL", "pg_isready -U $$POSTGRES_USER"]
interval: 5s
timeout: 3s
retries: 10
start_period: 30s
app:
depends_on:
db:
condition: service_healthy
$$ دو تا دلار است، نه یکی: compose یک دلار را خودش جایگزین میکند و دومی به پوستهٔ داخل کانتینر میرسد.
start_period مهلتی است که در آن شکست healthcheck به حساب نمیآید. بدون آن، دیتابیسی که بار اول باید جدولها را بسازد، ناسالم علامت میخورد.
پورتی که نباید بیرون باشد
این خط دیتابیس را روی اینترنت باز میکند:
ports:
- "5432:5432"
روی سرور، سرویسهای داخلی نباید ports داشته باشند. کانتینرهای یک شبکهٔ compose از راه نام همدیگر را میبینند:
services:
db:
image: postgres:17
# بدون ports — فقط app به آن وصل میشود، با میزبان «db»
app:
ports:
- "127.0.0.1:3000:3000"
و برای چیزی که باید از بیرون در دسترس باشد، 127.0.0.1: را بگذار و nginx میزبان را جلویش قرار بده. بدون آن پیشوند، داکر قاعدهای در iptables مینویسد که فایروال ufw را دور میزند و پورت روی اینترنت باز میشود، حتی اگر ufw بسته باشدش. این یکی از رایجترین راههای نشت دیتابیس است.
سقف منابع
کانتینری که نشت حافظه دارد، بدون سقف، کل رم سرور را میخورد و OOM killer سراغ پروسههای دیگر میرود:
deploy:
resources:
limits:
memory: 512M
cpus: "1.0"
روی compose مستقل (نه swarm) از نسخهٔ ۲.۲۰ به بعد deploy.resources.limits اعمال میشود.
لاگ که دیسک را پر نمیکند
پیشفرض داکر هیچ سقفی برای لاگ ندارد. کانتینری پرحرف، در چند ماه چند گیگ مینویسد:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
متغیرها
env_file:
- .env.production
و .env.production در گیت نباشد. یک .env.example با کلیدهای خالی بگذار تا بعداً کسی بداند چه متغیرهایی لازم است.
بالا آوردن و دیدن
docker compose up -d
docker compose ps # ستون STATUS سلامت را هم میگوید
docker compose logs -f app
docker compose exec app sh
برای بهروزرسانی بدون ساختن دوبارهٔ همهچیز:
docker compose pull app
docker compose up -d --no-deps app
--no-deps یعنی فقط همین سرویس، نه وابستگیهایش. بدون آن، دیتابیس هم ریاستارت میشود و قطعیای میگیری که لازم نبود.