نحوه راه اندازی CouchDB – فروشگاه اسناد JSON
CouchDB یک پایگاه داده متن باز مبتنی بر سند است که داده ها را به صورت اسناد JSON ذخیره می کند. این پایگاه داده یک API HTTP RESTful برای تمام عملیات پایگاه داده، تکثیر داخلی و کنترل همزمانی چند نسخه ای ارائه می دهد. طراحی بدون طرحواره CouchDB آن را برای ذخیره سازی لاگ در جایی که ساختارهای سند ممکن است متفاوت باشند، ایده آل می کند و رابط مبتنی بر HTTP آن، ادغام با ابزارهای جمع آوری لاگ را ساده می کند.
در این مقاله، شما CouchDB را با استفاده از Docker Compose مستقر خواهید کرد، ذخیره سازی پایدار را برای فایل های پایگاه داده پیکربندی خواهید کرد و Traefik را به عنوان یک پروکسی معکوس برای دسترسی ایمن به نمونه CouchDB خود تنظیم خواهید کرد.
پیش نیازها #
قبل از شروع نیاز دارید به:
- به عنوان یک کاربر غیر ریشه با امتیازات sudo به یک سرور مبتنی بر اوبونتو ۲۴.۰۴ دسترسی داشته باشید.
- داکر و داکر کامپوز را نصب کنید.
- یک رکورد دامنه A که به آدرس IP سرور شما اشاره می کند پیکربندی کنید (برای مثال،
couchdb.example.com).
تنظیم ساختار دایرکتوری و متغیرهای محیطی #
در این بخش، ساختار دایرکتوری مورد نیاز برای CouchDB را آماده می کنید و متغیرهای محیطی را در یک فایل .env تعریف می کنید.
- ساختار دایرکتوری برای CouchDB را ایجاد کنید.console
$ mkdir -p ~/couchdb-logging/couchdb-dataاین دایرکتوری فایل های پایگاه داده، نماها و تنظیمات پیکربندی را ذخیره می کند.
- به دایرکتوری
couchdb-loggingبروید.console$ cd ~/couchdb-logging
- مالکیت صحیح را برای دایرکتوری داده های CouchDB تنظیم کنید. CouchDB به عنوان کاربر couchdb (UID 5984) درون کانتینر اجرا می شود.console
$ sudo chown -R 5984:5984 couchdb-data
- یک فایل
.envایجاد کنید.console$ nano .envمتغیرهای زیر را اضافه کنید:
iniDOMAIN=couchdb.example.com LETSENCRYPT_EMAIL=[email protected] COUCHDB_USER=admin COUCHDB_PASSWORD=changeme
جایگزین کردن:
couchdb.example.comبا دامنه شما.[email protected]با ایمیل شما.changemeبا یک رمز عبور قوی.
فایل را ذخیره کنید و ببندید.
راه اندازی با Docker Compose #
در این بخش، شما پشته Docker Compose را که CouchDB را پشت Traefik اجرا می کند، ایجاد و مستقر می کنید. Docker Compose هر دو کانتینر را مدیریت می کند، متغیرهای محیطی را از فایل .env شما اعمال می کند و به طور خودکار مسیریابی HTTPS را از طریق Traefik پیکربندی می کند.
- یک مانیفست جدید Docker Compose ایجاد کنید.console
$ nano docker-compose.yaml - محتوای زیر را اضافه کنید.yaml
services: traefik: image: traefik:v3.6 container_name: traefik command: - "--providers.docker=true" - "--providers.docker.exposedbydefault=false" - "--entrypoints.web.address=:80" - "--entrypoints.websecure.address=:443" - "--entrypoints.web.http.redirections.entrypoint.to=websecure" - "--entrypoints.web.http.redirections.entrypoint.scheme=https" - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true" - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web" - "--certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL}" - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json" ports: - "80:80" - "443:443" volumes: - "letsencrypt:/letsencrypt" - "/var/run/docker.sock:/var/run/docker.sock:ro" restart: unless-stopped couchdb: image: couchdb:latest container_name: couchdb hostname: couchdb expose: - "5984" volumes: - "./couchdb-data:/opt/couchdb/data" environment: - COUCHDB_USER=${COUCHDB_USER} - COUCHDB_PASSWORD=${COUCHDB_PASSWORD} labels: - "traefik.enable=true" - "traefik.http.routers.couchdb.rule=Host(`${DOMAIN}`)" - "traefik.http.routers.couchdb.entrypoints=websecure" - "traefik.http.routers.couchdb.tls.certresolver=letsencrypt" - "traefik.http.services.couchdb.loadbalancer.server.port=5984" restart: unless-stopped volumes: letsencrypt:
فایل را ذخیره کنید و ببندید.
این پیکربندی شامل موارد زیر است:
- services: دو کانتینر برای ارائه پشته پایگاه داده با هم همکاری می کنند:
- traefik: به عنوان روتر لبه عمل می کند، گواهینامه های SSL را دریافت می کند و ترافیک HTTPS را به پایگاه داده هدایت می کند.
- couchdb: میزبان موتور پایگاه داده NoSQL است و به API و رابط وب RESTful سرویس می دهد.
- image: تصاویر رسمی کانتینر را از ناشران تأیید شده Docker Hub دریافت می کند.
- container_name: از نام های استاتیک توصیفی برای عملیات ساده کانتینر استفاده می کند.
- command (Traefik): کشف سرویس مبتنی بر داکر را فعال می کند، شنونده های HTTP (۸۰) و HTTPS (۴۴۳) را باز می کند، تمام HTTP را به طور خودکار به HTTPS هدایت می کند و کلاینت Let’s Encrypt ACME را با روش چالش HTTP-۰۱ پیکربندی می کند.
- ports (Traefik): پورت های وب سرویس ۸۰ و ۴۴۳ را برای دسترسی عمومی در اختیار سیستم میزبان قرار می دهد.
- expose (CouchDB): پورت ۵۹۸۴ را فقط برای ارتباطات بین کانتینرها باز می کند و اتصالات مستقیم خارجی را مسدود می کند.
- volumes:
- دستور Bind mount (
./couchdb-data) فایل ها و اسناد پایگاه داده را در طول راه اندازی های مجدد حفظ می کند. - درایو نامگذاری شده
letsencryptبه طور مستقل از ذخیره سازی گواهی SSL پشتیبانی می کند. - دسترسی فقط خواندنی به سوکت داکر(
/var/run/docker.sock:ro) امکان تشخیص پویای کانتینر را فراهم می کند.
- دستور Bind mount (
- environment (CouchDB): اطلاعات احراز هویت مدیر را از فایل .env دریافت می کند.
- labels (CouchDB): حاشیه نویسی های پیکربندی که به Traefik دستور می دهند درخواست ها را پروکسی کند، بر اساس نام دامنه مسیریابی کند، گواهی های SSL را ضمیمه کند و پورت سرویس backend را مشخص کند.
- restart: unless-stopped: تضمین می کند که کانتینرها پس از خرابی، به استثنای توقف های دستی، به طور خودکار به کار خود ادامه می دهند.
- services: دو کانتینر برای ارائه پشته پایگاه داده با هم همکاری می کنند:
- سرویس ها را ایجاد و شروع کنید.console
$ docker compose up -d - تأیید کنید که سرویس ها در حال اجرا هستند.console
$ docker compose psخروجی:
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS couchdb couchdb:latest "tini -- /docker-ent…" couchdb 18 seconds ago Up 17 seconds 5984/tcp traefik traefik:v3.6 "/entrypoint.sh --pr…" traefik 18 seconds ago Up 17 seconds 0.0.0.0:80->80/tcp, [::]:80->80/tcp, 0.0.0.0:443->443/tcp, [::]:443->443/tcpهر دو کانتینر عملیاتی هستند. CouchDB درخواست های پایگاه داده را می پذیرد در حالی که Traefik اتصالات روی پورت های
80و443.را مدیریت می کند. - مشاهده لاگ های سرویس هاconsole
$ docker compose logsبرای اطلاعات بیشتر در مورد مدیریت پشته Docker Compose، به مقاله نحوه استفاده از Docker Compose مراجعه کنید.
دسترسی به CouchDB #
این بخش نحوه تأیید نصب CouchDB خود را با دسترسی به کنسول وب Fauxton و اجرای عملیات اساسی پایگاه داده از طریق رابط RESTful HTTP نشان می دهد.
- رابط وب CouchDB را در مرورگر خود باز کنید.
https://couchdb.example.com/_utils - با استفاده از اطلاعات کاربری که در فایل
.envپیکربندی کرده اید، وارد سیستم شوید:- Username: مقداری که برای
COUCHDB_USERتنظیم کرده اید (پیش فرض:admin) - Password: مقداری که برای
COUCHDB_PASSWORDتنظیم کرده اید
- Username: مقداری که برای
- رابط کاربری فاکستون نمایش داده می شود. این کنسول مدیریتی مبتنی بر وب به شما امکان می دهد پایگاه های داده، اسناد و تنظیمات تکثیر را مدیریت کنید.
- با استفاده از خط فرمان، تأیید کنید که CouchDB پاسخ می دهد.console
$ curl https://couchdb.example.comخروجی:
{ "couchdb": "Welcome", "version": "3.5.1", "git_sha": "44f6a43d8", "uuid": "92800b247a331df27afce9ad744a370b", "features": [ "access-ready", "partitioned", "pluggable-storage-engines", "reshard", "scheduler" ], "vendor": { "name": "The Apache Software Foundation" } } - یک پایگاه داده آزمایشی ایجاد کنید.console
$ curl -X PUT https://admin:[email protected]/logs
به جای
admin:changeme، اطلاعات کاربری واقعی خود را وارد کنید..خروجی:
{"ok":true} - یک سند گزارش نمونه وارد کنید.console
$ curl -X POST https://admin:[email protected]/logs \ -H "Content-Type: application/json" \ -d '{ "timestamp": "2025-12-01T20:47:23Z", "level": "INFO", "message": "Application started successfully", "service": "web-server" }'
خروجی شامل شناسه سند و نسخه آن است:
{"ok":true,"id":"f234689e3359a8a43434713cb20008a5","rev":"1-6a43114e6467b83a73137f1112b9db8e"} - بازیابی تمام اسناد از پایگاه داده.console
$ curl https://admin:[email protected]/logs/_all_docs
پاسخ تأیید می کند که سند شما با موفقیت ذخیره شده است.
نتیجه گیری #
شما با موفقیت CouchDB را برای مدیریت لاگ با رمزگذاری HTTPS مستقر کرده اید. معماری کانتینر شده، پایگاه داده اسناد را با مدیریت خودکار گواهینامه جفت می کند و از پایداری داده ها در طول راه اندازی مجدد سرویس از طریق والیوم های bind-mounted اطمینان حاصل می کند. Traefik خاتمه SSL و مسیریابی درخواست را مدیریت می کند در حالی که Let’s Encrypt گواهینامه های معتبر را فراهم می کند. استقرار CouchDB شما اکنون می تواند اسناد لاگ JSON را از طریق رابط RESTful خود بپذیرد، از تکثیر بلادرنگ در سراسر گره ها پشتیبانی کند و تجزیه و تحلیل پیشرفته لاگ را از طریق کوئری های MapReduce و کنسول وب Fauxton فعال کند.
