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

راهنمای استفاده از مخزن Docker CE پارس‌پک

Docker CE نسخه Community Edition داکر است که برای نصب و اجرای Docker Engine روی سرورهای لینوکسی استفاده می‌شود. مخزن Docker CE پارس‌پک این امکان را فراهم می‌کند که پکیج‌های اصلی Docker و ابزارهای وابسته به آن از طریق Repository داخلی دریافت و نصب شوند.

این راهنما برای کاربرانی مناسب است که می‌خواهند Docker Engine را روی Ubuntu، Debian یا توزیع‌های مبتنی بر RHEL نصب یا بروزرسانی کنند. اگر هدف شما فقط دریافت ایمیج‌های Docker است، باید از صفحه «مخزن ایمیج Docker» استفاده کنید.

تنظیم Repository

Ubuntu

# ۱) پیش‌نیازها و کلید رسمی Docker
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://repo.abrha.net/docker/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# ۲) افزودن مخزن (کانال stable)
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://repo.abrha.net/docker/ubuntu jammy stable" \
| sudo tee /etc/apt/sources.list.d/abrha-docker.list

# ۳) نصب
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# ۴) فعال‌سازی و بررسی
sudo systemctl enable --now docker
sudo docker version

Debian

# ۱) پیش‌نیازها و کلید رسمی Docker
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://repo.abrha.net/docker/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# ۲) افزودن مخزن (کانال stable)
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/docker.asc] https://repo.abrha.net/docker/debian bookworm stable" \
| sudo tee /etc/apt/sources.list.d/abrha-docker.list

# ۳) نصب
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# ۴) فعال‌سازی و بررسی
sudo systemctl enable --now docker
sudo docker version

AlmaLinux / Rocky / RHEL

# ۱) ساخت فایل مخزن (AlmaLinux 9)
sudo tee /etc/yum.repos.d/abrha-docker.repo >/dev/null <<'EOF'
[docker-ce-stable]
name=Docker CE Stable - Abrha
baseurl=https://repo.abrha.net/docker/almalinux/$releasever/
enabled=1
gpgcheck=1
gpgkey=https://repo.abrha.net/docker/almalinux/gpg
EOF

# ۲) نصب
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# ۳) فعال‌سازی و بررسی
sudo systemctl enable --now docker
sudo docker version
نکته مربوط به AlmaLinux 10

روی AlmaLinux 10 محتوای مخزن از مسیر centos/9 مربوط به Docker دریافت می‌شود، چون هنوز مسیر centos/10 توسط Docker منتشر نشده است. با این حال، مقدار $releasever برابر 10 است و به مسیر almalinux/10 روی آینه پارس‌پک اشاره می‌کند؛ بنابراین تنظیم مخزن به‌صورت خودکار کار می‌کند.

نکات و عیب‌یابی

تفاوت مخزن Docker CE با مخزن ایمیج Docker

مخزن Docker CE برای نصب و بروزرسانی خود Docker Engine و ابزارهای وابسته به آن، مانند docker-ce، docker-ce-cli، containerd.io، docker-buildx-plugin و docker-compose-plugin استفاده می‌شود. اگر هدف شما دریافت یا Pull کردن ایمیج‌های Docker است، باید از صفحه «مخزن ایمیج Docker» استفاده کنید.

پشتیبانی از معماری سیستم

مخزن Docker CE پارس‌پک برای معماری amd64 / x86_64 ارائه شده است. پیش از تنظیم مخزن، مطمئن شوید معماری سیستم‌عامل سرور با این مخزن سازگار است.

کلید مورد استفاده در Docker CE

در مخزن Docker CE، کلید رسمی Docker استفاده می‌شود؛ زیرا این مخزن به‌صورت آینه کامل ارائه شده و امضای اصلی پکیج‌ها حفظ شده است. بنابراین اگر با خطای GPG یا امضای پکیج مواجه شدید، ابتدا مسیر کلید Docker را در فایل Repository بررسی کنید.

خطای HTTPS یا گواهی در Ubuntu و Debian

اگر هنگام اجرای apt update با خطای مربوط به HTTPS یا گواهی روبه‌رو شدید، ابتدا پیش‌نیازهای لازم را نصب یا بروزرسانی کنید:

sudo apt-get install -y ca-certificates curl

سپس مراحل افزودن کلید و Repository را دوباره انجام دهید.

خطای $releasever در توزیع‌های مبتنی بر RHEL

در برخی توزیع‌های مبتنی بر RHEL ممکن است مقدار $releasever به‌جای عدد اصلی نسخه، مقدار متفاوتی مانند 9.4 یا 9Server برگرداند. در این حالت، در فایل repo مقدار $releasever را با عدد اصلی نسخه سیستم‌عامل، مثل 8، 9 یا 10 جایگزین کنید.

نکته مربوط به AlmaLinux 10

در AlmaLinux 10 ممکن است محتوای مخزن از مسیر سازگار با نسخه‌های قبلی Docker تأمین شود. اگر هنگام بروزرسانی یا نصب با خطا مواجه شدید، مسیر baseurl و مقدار $releasever را بررسی کنید و مطمئن شوید فایل repo با نسخه سیستم‌عامل شما هماهنگ است.

خطای 404 هنگام بروزرسانی مخزن

اگر هنگام بروزرسانی Repository با خطای 404 مواجه شدید، نسخه توزیع، کدنیم سیستم‌عامل و مسیر baseurl را بررسی کنید. این خطا معمولاً زمانی رخ می‌دهد که مسیر تعریف‌شده در فایل Repository با نسخه سیستم‌عامل یا معماری سرور سازگار نباشد.

استفاده از Docker بدون sudo

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

sudo usermod -aG docker $USER

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

جمع‌بندی

با استفاده از مخزن Docker CE پارس‌پک، نصب و بروزرسانی Docker Engine روی سرورهای لینوکسی از مسیر داخلی و پایدار انجام می‌شود. این روش به مدیران سیستم و تیم‌های DevOps کمک می‌کند ابزارهای اصلی Docker را با سرعت و اطمینان بیشتری دریافت کنند و فرآیند آماده‌سازی محیط‌های توسعه، تست و استقرار را ساده‌تر پیش ببرند.