عامل Docker Swarm

عامل Docker Swarm در Status200 یک خوشه Docker Swarm را زیر نظر دارد: گره‌ها، سرویس‌ها، وظیفه‌ها، پشته‌ها، شبکه‌های overlay، سکرت‌ها، پیکربندی‌ها و حجم‌های آن، به‌علاوه متریک‌ها و لاگ‌های هر کانتینر. آن را با Docker Compose روی یک گره مدیر swarm اجرا می‌کنید و خوشه با همه این‌ها در Status200 نمایان می‌شود. مانیتورهای Docker Swarm بر پایه آنچه می‌رسد هشدار می‌دهند.

چگونه کار می‌کند#

عامل سه کانتینر است که همه در یک docker-compose.yml تعریف شده‌اند:

1. کالکتور: یک OpenTelemetry Collector که docker_stats را برای متریک‌های هر کانتینر می‌خواند، فایل‌های لاگ کانتینرها را دنبال می‌کند و فایل عکس فوری موجودی را هم دنبال می‌کند. همه‌چیز را با نام خوشه شما (docker.swarm.cluster.name) مُهر می‌زند و آن را روی OTLP به Status200 می‌فرستد.
2. پیمایشگر موجودی: یک sidecar کوچک با curl و jq که هر ۵ دقیقه API مدیر swarm را می‌پیماید (/nodes، /services، /tasks، /networks، /secrets، /configs، /volumes) و پشته‌ها را از برچسب سرویس com.docker.stack.namespace به دست می‌آورد. به ازای هر شیء یک خط JSON می‌نویسد تا کالکتور آن را بفرستد.
3. عامل هوش مصنوعی: status200-docker-swarm-ai-agent، که فرمان‌های docker درخواستی Status200 AI را هنگام بررسی یک حادثه یا هشدار روی این خوشه اجرا می‌کند. فقط‌خواندنی است، مگر اینکه اجازه اصلاح بدهید (عامل هوش مصنوعی را ببینید).

خوشه با نخستین داده‌هایش، با نام خوشه‌ای که پیکربندی می‌کنید، خود را ثبت می‌کند.

پیش از شروع#

• یک گره مدیر swarm برای اجرای عامل: پیمایشگر موجودی و عامل هوش مصنوعی نقطه‌های پایانی API را فرا می‌خوانند که فقط گره‌های مدیر پاسخ می‌دهند.
• Docker Engine 20.10 یا بعد از آن با افزونه Docker Compose v2.
• یک کلید دریافت داده. آن را زیر تنظیمات پروژه > تله‌متری و APM > کلیدهای دریافت داده بسازید و مقدارش را کپی کنید.
• HTTPS خروجی از گره به نشانی Status200 شما.

عامل را کجا اجرا کنید#

آن را روی یک گره مدیر اجرا کنید. کالکتور کانتینرهای گره‌ای را گزارش می‌کند که روی آن اجرا می‌شود، پس برای متریک‌های کانتینر همه گره‌ها، کالکتور را روی هر گره اجرا کنید، همه با یک DOCKER_SWARM_CLUSTER_NAME؛ پیمایشگر موجودی و عامل هوش مصنوعی فقط لازم است روی یک گره مدیر اجرا شوند. install.sh روی گره‌ای که مدیر نیست عامل هوش مصنوعی را کنار می‌گذارد (و عاملی را که پیش‌تر آنجا نصب کرده بود حذف می‌کند). عامل هوش مصنوعی‌ای که با این حال روی یک گره کارگر راه‌اندازی شود، هرگز برای خوشه ثبت نمی‌شود: منتظر می‌ماند تا گره‌اش مدیر شود، پس نمی‌تواند عامل هوش مصنوعی گره مدیر را کنار بزند. عامل را به‌جای Compose به‌صورت یک پشته swarm مستقر می‌کنید؟ پیمایشگر موجودی و عامل هوش مصنوعی را با قید node.role == manager روی گره‌های مدیر نگه دارید.

نصب عامل#

1. عامل را نصب و اجرا کنید#

   install.shDocker Compose

   install.sh

   اسکریپت نصب را دانلود کنید و روی یک گره مدیر اجرا کنید:

   Bash

   curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/install.sh -o install.sh
   sh install.sh

   اسکریپت نشانی Status200 شما، کلید دریافت داده و نامی برای خوشه را می‌پرسد. در /opt/status200-docker-swarm-agent نصب می‌کند، یک فایل .env می‌نویسد که فقط مالکش می‌تواند بخواند، و هر سه کانتینر را راه می‌اندازد. برای کنار گذاشتن عامل هوش مصنوعی، --no-ai-agent را بیفزایید.

   Docker Compose

   docker-compose.yml، otel-collector-config.yaml و inventory-snapshot.sh را از [پوشه DockerSwarmAgent](<YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent) در یک پوشه تازه روی یک گره مدیر دانلود کنید:

   Bash

   curl -fsSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/docker-compose.yml -o docker-compose.yml
   curl -fsSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/otel-collector-config.yaml -o otel-collector-config.yaml
   curl -fsSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/inventory-snapshot.sh -o inventory-snapshot.sh
   chmod +x inventory-snapshot.sh

   کنار آن‌ها یک فایل .env بسازید. کلید دریافت داده را در خود دارد، پس با chmod 600 .env خصوصی‌اش نگه دارید:

   .envBash

   STATUS200_URL=https://status200.ru
   STATUS200_SERVICE_TOKEN=your-telemetry-ingestion-key
   DOCKER_SWARM_CLUSTER_NAME=my-swarm

   عامل را راه بیندازید:

   Bash

   docker compose up -d

2. بررسی کنید که عامل اجرا می‌شود#

   Bash

   docker compose ps
   docker compose logs --tail 50 status200-docker-swarm-agent status200-docker-swarm-inventory

   docker compose ps سه کانتینر را فهرست می‌کند: کالکتور (status200-docker-swarm-agent)، پیمایشگر موجودی (status200-docker-swarm-inventory) و عامل هوش مصنوعی (status200-docker-swarm-ai-agent).

3. خوشه را در Status200 پیدا کنید#

   محصولات > زیرساخت > Docker Swarm > همه خوشه‌ها را باز کنید. خوشه در چند دقیقه نمایان می‌شود، و صفحه‌های گره‌ها، سرویس‌ها، وظایف، Stacks، شبکه‌ها، اسرار، Configs و حجم‌ها آن پس از نخستین عکس فوری موجودی، در کمتر از ۵ دقیقه پر می‌شوند. صفحهٔ توپولوژی خوشه stackها، سرویس‌ها، وظایف و گره‌هایش را روی یک نقشه می‌کشد: توپولوژی را ببینید.

متغیرهای محیطی#

اسکریپت نصب سه مورد نخست را در /opt/status200-docker-swarm-agent/.env می‌نویسد؛ نصب با Docker Compose آن‌ها را از .env کنار docker-compose.yml می‌خواند. هر کدام را همان‌جا بیفزایید یا تغییر دهید، سپس docker compose up -d را در همان پوشه اجرا کنید.

تنظیمات ویژه عامل هوش مصنوعی زیر عامل هوش مصنوعی آمده است.

آنچه عامل گردآوری می‌کند#

تفاوت آن با عامل Docker#

عامل Docker یک میزبان را مدل می‌کند و host.name و container.runtime=docker را مُهر می‌زند. عامل Docker Swarm عمداً فقط docker.swarm.cluster.name را مُهر می‌زند: آنگاه Status200 داده‌ها را زیر خوشه swarm بایگانی می‌کند، به‌جای اینکه هر گره را میزبانی جداگانه ثبت کند.

برچسب‌گذاری خوشه با برچسب‌های پروژه#

ویژگی منبعی که با status200.label. آغاز شود، به برچسب پروژه روی خوشه تبدیل می‌شود: status200.label.<dimension>=<value> همان برچسب <dimension>:<value> است. ویژگی‌ها را در otel-collector-config.yaml به پردازشگر resource، کنار docker.swarm.cluster.name، بیفزایید:

processors:
  resource:
    attributes:
      # ...existing attributes...
      - key: status200.label.team
        value: platform
        action: upsert
      - key: status200.label.env
        value: production
        action: upsert

کالکتور پیکربندی‌اش را فقط هنگام راه‌اندازی می‌خواند: docker compose restart status200-docker-swarm-agent را اجرا کنید. سپس خوشه برچسب‌های team:platform و env:production را نشان می‌دهد. برچسب‌ها بدون توجه به بزرگی و کوچکی حروف مقایسه می‌شوند، پس برچسب موجود Production به‌جای تکرار دوباره به کار می‌رود، و عامل هرگز برچسبی را که کسی در Status200 افزوده است برنمی‌دارد.

اجرا به‌صورت یک سرویس systemd#

برای اینکه عامل همراه گره شروع شود و اگر از کار افتاد دوباره راه‌اندازی شود، واحد systemd آن را نصب کنید. این واحد فرض می‌کند عامل در /opt/status200-docker-swarm-agent است، جایی که اسکریپت نصب آن را می‌گذارد:

sudo curl -fsSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/systemd/status200-docker-swarm-agent.service -o /etc/systemd/system/status200-docker-swarm-agent.service
sudo systemctl daemon-reload
sudo systemctl enable --now status200-docker-swarm-agent

به‌روزرسانی عامل#

عامل نسخه کالکتوری را که اجرا می‌کند گزارش می‌دهد. وقتی این نسخه از نسخه‌ای که این انتشار Status200 ثابت کرده قدیمی‌تر باشد، در صفحه نمای کلی خوشه، کنار نسخه عامل، یک نشانه هشدار نمایان می‌شود. آن را انتخاب کنید تا این فرمان‌ها را ببینید.

اسکریپت نصب را دوباره روی گره مدیر اجرا کنید و به پرسش‌هایش با همان نشانی، کلید و نام خوشه پاسخ دهید. تازه‌ترین فایل‌ها را دانلود می‌کند، ایمیج‌ها را می‌کشد و عامل را دوباره راه‌اندازی می‌کند:

curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/install.sh -o install.sh
sh install.sh

اسکریپت .env را از روی پاسخ‌های شما دوباره می‌نویسد. فقط فهرست‌های هدف عامل هوش مصنوعی و کارهای مجاز هوش مصنوعی (STATUS200_AI_INVESTIGATION، STATUS200_AI_FIXES) را نگه می‌دارد: هر متغیری را که خودتان تنظیم کرده بودید، مانند DOCKER_API_VERSION، دوباره بیفزایید. اصلاح‌های هوش مصنوعی را روشن کرده بودید؟ برای روشن ماندنشان، آن را به‌صورت STATUS200_AI_ALLOW_WRITES=true sh install.sh اجرا کنید. عامل هوش مصنوعی را کنار گذاشته بودید؟ دوباره --no-ai-agent را بدهید.

با Docker Compose، سه فایل را دوباره در پوشه عامل دانلود کنید (سپس هر تغییری را که در docker-compose.yml داده بودید دوباره اعمال کنید)، و ایمیج‌ها را بکشید و دوباره راه‌اندازی کنید:

docker compose pull
docker compose up -d --force-recreate

نسخه کالکتور در فایل‌ها ثابت شده است، پس فقط کشیدن ایمیج‌ها عامل را جلو نمی‌برد.

حذف عامل#

cd /opt/status200-docker-swarm-agent
docker compose down

عامل هوش مصنوعی#

فایل docker-compose.yml مربوط به swarm (و install.sh) عامل هوش مصنوعی Docker Swarm را هم اجرا می‌کند: کانتینر سوم، status200-docker-swarm-ai-agent (ایمیج status200/resource-ai-agent:release)، که فرمان‌های فقط‌خواندنی docker درخواستی Status200 AI را هنگام بررسی یک حادثه یا هشدار روی این خوشه اجرا می‌کند — docker node ls، docker service ps web --no-trunc، docker service logs --tail 200 web — و فقط اگر اجازه دهید، اصلاح‌هایی مانند راه‌اندازی دوباره تدریجی یک سرویس نام‌برده را اعمال می‌کند. همان STATUS200_URL، STATUS200_SERVICE_TOKEN و DOCKER_SWARM_CLUSTER_NAME کالکتور را می‌خواند، پس دقیقاً به همین خوشه خدمت می‌کند، و در Status200 در صفحه هوش مصنوعی > عامل هوش مصنوعی خوشه نمایان می‌شود.

• بررسی‌های هوش مصنوعی به‌طور پیش‌فرض روشن‌اند. همین که عامل وصل شود، Status200 AI حادثه‌ها و هشدارهای این خوشه را با آن بررسی می‌کند و نمای کلی خوشه وضعیت عامل را نشان می‌دهد. برای توقف، STATUS200_AI_INVESTIGATION=false را جایی که عامل اجرا می‌شود تنظیم کنید (تغییر زیر کارهای مجاز هوش مصنوعی در صفحه عامل هوش مصنوعی روشش را نشان می‌دهد)، یا عامل را کنار بگذارید.
• مانند پیمایشگر موجودی، باید روی یک گره مدیر اجرا شود: فرمان‌های گره، سرویس و وظیفه فقط روی گره‌های مدیر کار می‌کنند. روی یک گره کارگر هیچ چیزی اجرا نمی‌کند و تا گره مدیر نشود برای خوشه ثبت نمی‌شود (/status آن دلیلش را می‌گوید). برای هر خوشه یکی اجرا کنید.
• این عامل فقط‌خواندنی است، مگر اینکه STATUS200_AI_ALLOW_WRITES=true را در .env تنظیم کنید و docker compose up -d را اجرا کنید (یا install.sh را با آن اجرا کنید؛ نصب‌کننده STATUS200_AI_ALLOW_WRITES، STATUS200_AI_INVESTIGATION، STATUS200_AI_FIXES، STATUS200_AI_WRITE_TARGETS و STATUS200_AI_PROTECTED_TARGETS را از محیط خود در .env می‌نویسد، و اجرای دوباره برای چهار مورد آخر همان چیزی را نگه می‌دارد که .env از پیش دارد، مگر اینکه آن متغیر را بدهید، حتی خالی)؛ STATUS200_AI_WRITE_TARGETS (الگوهای glob نام سرویس‌ها و گره‌ها، برای نمونه web_*,api_*) محدود می‌کند که یک اصلاح به چه چیزی دست بزند. STATUS200_AI_FIXES در همان .env تعیین می‌کند اصلاح‌ها چگونه اجرا شوند — ask-for-approval (یک نفر هر کدام را تأیید می‌کند)، automatic یا bypass-approval — و صفحه عامل هوش مصنوعی آن را فقط‌خواندنی نشان می‌دهد (کارهای مجاز هوش مصنوعی، تعیین‌شده توسط عامل). تخلیه یک گره همیشه به تأیید یک نفر نیاز دارد، در هر حالتی.
• با سوکت Docker سوارشده و به‌عنوان root اجرا می‌شود، چون مالک سوکت root است — و روی گره مدیر، هر کس بتواند از سوکت استفاده کند کل swarm را در دست دارد، چه :ro باشد چه نباشد. مرز، سیاست فرمان‌های عامل است: هرگز سرویس یا پشته‌ای نمی‌سازد یا حذف نمی‌کند، هرگز به سکرت‌ها یا پیکربندی‌ها دست نمی‌زند، و هرگز خودش، کالکتور، پیمایشگر موجودی یا هر چیزی در STATUS200_AI_PROTECTED_TARGETS (الگوهای glob نام سرویس‌ها و گره‌ها) را تغییر نمی‌دهد.
• install.sh --no-ai-agent آن را کنار می‌گذارد؛ یا سرویس status200-docker-swarm-ai-agent را از docker-compose.yml حذف کنید.

آنچه می‌تواند اجرا کند، اینکه اصلاح‌ها چگونه کار می‌کنند و چگونه اشکال آن را رفع کنید: عامل‌های AI زیرساخت.

رفع اشکال#

curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/DockerSwarmAgent/troubleshoot.sh -o troubleshoot.sh
bash troubleshoot.sh    # add -d <dir> if you installed outside /opt/status200-docker-swarm-agent

Error: cannot start pipelines: failed to start "docker_stats" receiver:
Error response from daemon: client version 1.44 is too new.
Maximum supported API version is 1.41

docker version --format '{{ .Server.APIVersion }}'

گام‌های بعدی#