podman-healthcheck(1) General Commands Manual podman-healthcheck(1)

podman-healthcheck - مدیریت بررسی سلامت (healthcheck) کانتینرها

podman healthcheck زیردستور

مجموعه دستورهای podman healthcheck برای مدیریت بررسی سلامت کانتینرها استفاده می‌شوند.

بررسی‌های سلامت معمولاً از ایمیج‌ها تأمین می‌شوند. از podman image inspect برای شناسایی healthcheck در بخش Config ایمیج استفاده کنید.

بررسی‌های سلامت همچنین می‌توانند هنگام ایجاد کانتینر از طریق podman run یا podman create با استفاده از موارد زیر تعریف شوند: - --health-cmd برای تنظیم دستور بررسی (شکل رشته‌ای از طریق CMD-SHELL اجرا می‌شود؛ شکل آرایه‌ای از CMD استفاده می‌کند) - --health-interval، --health-timeout، --health-retries، --health-start-period - --no-healthcheck برای غیرفعال کردن بررسی سلامت تعریف‌شده در ایمیج - تنظیمات بررسی سلامت راه‌اندازی: --health-startup-cmd، --health-startup-interval، --health-startup-retries، --health-startup-success، --health-startup-timeout

بررسی سلامت عادی (Regular healthcheck) به طور مداوم در طول چرخه حیات کانتینر برای نظارت بر سلامت آن اجرا می‌شود. گزینه --health-start-period یک دوره مهلت را در طول مقداردهی اولیه کانتینر فراهم می‌کند که در آن خرابی‌ها کانتینر را به عنوان ناسالم علامت‌گذاری نمی‌کنند.

بررسی سلامت راه‌اندازی (Startup healthcheck) یک بررسی سلامت جداگانه است که در طول راه‌اندازی کانتینر اجرا می‌شود و پس از راه‌اندازی موفقیت‌آمیز کانتینر به بررسی سلامت عادی انتقال می‌یابد. این قابلیت برای کانتینرهایی با زمان‌های راه‌اندازی طولانی یا غیرقابل‌پیش‌بینی طراحی شده است: - با --health-startup-cmd تعریف می‌شود (نیازمند تنظیم یک بررسی سلامت عادی نیز هست) - بررسی سلامت راه‌اندازی نمی‌تواند از ایمیج تأمین شود؛ تنها به صورت دستی قابل تنظیم است - پس از موفقیت بررسی سلامت راه‌اندازی (بر اساس موفقیت‌های متوالی --health-startup-success)، متوقف شده و بررسی سلامت عادی کنترل را به دست می‌گیرد - در صورت شکست مکرر (--health-startup-retries)، کانتینر می‌تواند بر اساس --health-on-failure بازراه‌اندازی شود

زمان استفاده از هرکدام: - از --health-start-period برای موارد ساده استفاده کنید که در آن‌ها تقریباً می‌دانید راه‌اندازی چقدر طول می‌کشد - از بررسی سلامت راه‌اندازی (--health-startup-cmd) زمانی استفاده کنید که زمان راه‌اندازی غیرقابل پیش‌بینی است یا در طول راه‌اندازی به بررسی متفاوتی نسبت به عملکرد عادی نیاز دارید

برای اشکال‌زدایی یا بازرسی بررسی‌های سلامت: - از podman inspect <container> استفاده کنید و بخش .Config.Healthcheck را برای تنظیمات مؤثر مشاهده نمایید. سایر بخش‌های مرتبط شامل .State.Healthcheck، Config.StartupHealthCheck، .Config.HealthcheckOnFailureAction، .Config.HealthMaxLogCount، .Config.HealthMaxLogSize و .Config.HealthLogDestination هستند - از دستور podman inspect --format '{{.State.Health.Status}} {{.Config.Healthcheck}}' <container> برای نمایش وضعیت سلامت فعلی و پیکربندی healthcheck استفاده کنید - به صورت درخواستی با podman healthcheck run <container> اجرا کنید و کد خروج را بررسی نمایید (0=موفقیت، 1=شکست، 125=خطا) - برای دریافت جزئیات بیشتر در مورد دلیل شکست healthcheck، دستور podman --log-level debug healthcheck run <container> را اجرا کنید - اطمینان حاصل کنید که دستور بررسی سلامت داخل کانتینر وجود دارد و به درستی نقل‌قول (quote) شده است (برای پایپ‌لاین‌های شل، نقل‌قول تکی ترجیح داده می‌شود)

برای به‌روزرسانی بررسی‌های سلامت: - از podman update <flag> <container> برای به‌روزرسانی تنظیمات healthcheck کانتینر در حین اجرای کانتینر استفاده کنید - مثال: podman update --health-max-log-count=10 <container> برای ذخیره تا ۱۰ نتیجه healthcheck در گزارش

دستور صفحه راهنما توضیحات
run podman-healthcheck-run(1) اجرای بررسی سلامت کانتینر

podman(1), podman-run(1), podman-create(1), podman-inspect(1), podman-update(1)

فوریه ۲۰۱۹، نگارش اولیه توسط Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩