پرش به مطلب اصلی

لیست کانتینرها

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

🧩 دستور کلی​

k3 container list [options]

⚙️ گزینه‌ها (Options)​

گزینه کوتاهگزینه بلندتوضیح
-a--allنمایش همه کانتینرها، صرف‌نظر از وضعیت (با گزینه‌های دیگر ناسازگار است)
-s--status <status>فیلتر بر اساس وضعیت: created, running, stopped, paused
-c--containerId <id>فیلتر بر اساس شناسه کانتینر (تمام یا بخشی از ContId)
-i--image <image>فیلتر بر اساس نام ایمیج (مثلاً nginx:latest)
-t--created <date>فیلتر بر اساس زمان ساخت (فرمت: YYYY-MM-DD)
-h--helpنمایش راهنمای کامل دستور

📊 فرمت خروجی​

دستور list اطلاعات کانتینرها را در قالب جدول نمایش می‌دهد. ستون‌های خروجی عبارت‌اند از:

ستونتوضیح
ContIdشناسه کانتینر (ID یکتای کانتینر)
Nameنام کانتینر
PIDشناسه فرآیند (Process ID) کانتینر
Statusوضعیت کانتینر (مثل running, stopped)
Imageنام و تگ ایمیجی که کانتینر از آن ساخته شده
Ipآدرس IP کانتینر
CMDدستور اصلی کانتینر

📥 مثال‌های کاربردی​

لیست همه کانتینرها:​

k3 container list --all

خروجی نمونه:

ContId      Name              PID     Status              Image                         Ip                  CMD                           
---------------------------------------------------------------------------------------------------------------------------
ebbe12d1    12                0       stopped (failed)    hello-world:latest            192.168.100.2/24    /hello

توضیح خروجی:

  • ebbe12d1: شناسه کانتینر
  • 12: نام کانتینر
  • 0: شناسه فرآیند (0 نشان‌دهنده کانتینر متوقف شده‌ای است)
  • stopped (failed): وضعیت کانتینر (متوقف شده، دلیل: ناموفق)
  • hello-world:latest: ایمیج مورد استفاده
  • 192.168.100.2/24: آدرس IP کانتینر
  • /hello: دستور اصلی کانتینر

فقط کانتینرهای در حال اجرا:​

k3 container list --status running

فقط کانتینرهای ساخته‌شده در تاریخ خاص:​

k3 container list --created 2025-06-18

فیلتر بر اساس نام ایمیج:​

k3 container list --image hello-world:latest

لیست کانتینرهای متوقف‌شده:​

k3 container list --status stopped

لیست کانتینرهای پایدار (بدون فیلتر):​

برای مشاهده‌ی لیست فقط کانتینرهای در حال اجرا، نیازی به گزینه خاصی نیست؛ فقط دستور ساده کافی است:

k3 container list

نکات مهم​

  • استفاده از --all به‌طور همزمان با گزینه‌هایی مانند --status, --image, --created یا --containerId مجاز نیست.

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

    No containers found matching the provided filters.

  • وضعیت کانتینر می‌تواند شامل اطلاعات اضافی باشد مثل stopped (failed) که نشان‌دهنده دلیل توقف است.

  • برای مشاهده‌ی لیست فقط کانتینرهای در حال اجرا، دستور ساده‌ی زیر را استفاده کنید (بدون گزینه):

k3 container list

تست جامع​

#!/bin/bash

echo "=== [1] Running containers ==="
sudo k3 container list --status running
echo

echo "=== [2] Stopped containers ==="
sudo k3 container list -s stopped
echo

echo "=== [3] All containers ==="
sudo k3 container list --all
echo

echo "=== [4] Filter by container ID: ebbe12d1 ==="
sudo k3 container list --containerId ebbe12d1
echo

echo "=== [5] Filter by image: hello-world:latest ==="
sudo k3 container list --image hello-world:latest
echo

echo "=== [6] Filter by creation date: 2025-07-02 ==="
sudo k3 container list --created 2025-07-02
echo

echo "=== [7] Default list (running containers) ==="
sudo k3 container list
echo

خطاها و راه‌حل‌ها​

خطا: "No containers found matching the provided filters."​

این پیام زمانی نمایش داده می‌شود که:

  • کانتینری برای فیلتر مشخص شده موجود نیست
  • نام ایمیج یا شناسه کانتینر نادرست است
  • تاریخ ساخت کانتینری بر روی سیستم وجود ندارد

راه‌حل: ابتدا دستور k3 container list --all را اجرا کنید تا تمام کانتینرهای موجود را ببینید و سپس فیلترهای صحیح را تعیین کنید.

🆘 دریافت راهنما​

برای مشاهده‌ی راهنمای کامل این دستور در خط فرمان:

k3 container list -h