همه مقالات تخصصی

Git Version Control در cPanel: سایت را از مخزن مستقر کنید بدون ویرایش با FTP

از Git Version Control در cPanel با فایل استقرار .cpanel.yml استفاده کنید، رازها را از مخزن دور نگه دارید، کامیت تست‌شده را مستقر کنید و با git revert برگردید.

Git Version Control در cPanel: سایت را از مخزن مستقر کنید بدون ویرایش با FTP

ویرایش فایل با FTP باعث می‌شود نفهمید چه کسی چه چیزی را عوض کرده و اشتباه را چطور برگردانید. cPanel می‌تواند مخزن Git را روی حساب نگه دارد و با یک فایل استقرار کوچک فایل‌های انتخابی را به ریشهٔ وب کپی کند. روال ساده است: جای دیگر commit و تست کنید، push کنید، از remote به‌روز کنید و مستقر کنید. نام منوها از دانش من دربارهٔ cPanel است و ممکن است بسته به نسخه یا هاست فرق کند؛ این مراحل را روی حساب شما اجرا نکرده‌ام.

۱. مخزن را آماده کنید

کد را در Git نگه دارید و رازها و داده کاربران را بیرون از آن. قبل از اولین commit فایل .gitignore بیفزایید:

cat .gitignore
wp-config.php
.env
wp-content/uploads/
wp-content/cache/
node_modules/
vendor/

پیش از اولین استقرار از سایت زنده بکاپ بگیرید؛ راهنمای بکاپ cPanel را ببینید.

۲. استقرار را توصیف کنید

cPanel فایل .cpanel.yml را در ریشهٔ مخزن می‌خواند و هنگام استقرار tasks آن را اجرا می‌کند. فقط آنچه در ریشهٔ وب باید باشد را کپی کنید:

# In the repository root: .cpanel.yml
---
deployment:
  tasks:
    - export DEPLOYPATH=/home/CPANELUSER/public_html/
    - /bin/cp -R public/* $DEPLOYPATH
# Never commit wp-config.php, .env or uploads

نام حساب و مسیرها را با مال خودتان عوض کنید و اول روی زیردامنهٔ staging تست کنید؛ برای روال‌های مرتبط چک‌لیست ماهانهٔ نگهداری را ببینید.

۳. push و استقرار

به remote ای که cPanel مدیریت می‌کند push کنید، بعد از پنل استفاده کنید تا از remote به‌روز شود و head commit مستقر شود:

git status
git log --oneline -n 5
git push origin main
# After a push, use the panel's Update from Remote, then Deploy HEAD Commit

بعدش سایت را بررسی کنید. اگر خطا دیدید لاگ‌ها را بخوانید؛ برای مشکل‌های رایج قاعده‌ها راهنمای .htaccess را ببینید.

۴. امن برگردید

اگر استقرار سایت را خراب کرد commit بد را revert کنید و دوباره مستقر کنید که تاریخچه را روشن نگه می‌دارد:

# Roll back to a known good commit and deploy again
git revert <bad-commit-hash>
git push origin main
# or deploy an earlier commit after checking it out in the repository
git log --oneline -n 10

Git تغییرهای پایگاه داده را برنمی‌گرداند، پس در صورت نیاز بکاپ پایگاه داده را جدا بازیابی کنید.

۵. اشتباه‌هایی که باید پرهیز کرد

این اشتباه‌ها دردسر می‌سازند:

Committing wp-config.php or .env             # secrets end up in history
Deploying straight from a messy working copy  # untested code reaches the site
Using cp -R with --delete style rules by guess # may overwrite uploads or user data
No backup before the first deploy             # nothing to return to

برای remote از کلید SSH استفاده کنید و هرگز توکن یا رمز را در چت یا تیکت نگذارید.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید سایت شرکت کوچکی (ساختگی) را دو نفر با FTP ویرایش می‌کنند و گاهی روی کار هم را بازنویسی می‌کنند. بعد از انتقال فایل‌های پوسته به مخزن با .cpanel.yml، هر تغییر پیام commit دارد و استقرار خراب با revert یک commit برگردانده می‌شود نه جست‌وجوی فایل قدیمی.

۷. اشتباه‌های رایج

  • commit کردن رازها.
  • استقرار کد تست‌نشده.
  • کپی روی آپلودها یا داده کاربران.
  • نگرفتن بکاپ قبل از اولین استقرار.
  • ویرایش مستقیم فایل‌ها روی سرور بعد از آن.
  • گذاشتن توکن در تیکت.

۸. پرسش‌های متداول

Git پایگاه داده را برمی‌گرداند؟ نه، فقط فایل‌ها.

می‌توانم یک branch را مستقر کنم؟ بله اگر آن branch را در مخزن checkout کنید، ولی تولید را روی branch پایدار نگه دارید.

SSH لازم است؟ برای remote خصوصی دسترسی مبتنی بر کلید راه امن است.

روی هر هاستی هست؟ نه؛ به نسخهٔ cPanel و تنظیم هاست بستگی دارد.

۹. چک‌لیست سریع

  1. .gitignore بسازید.
  2. رازها را بیرون نگه دارید.
  3. فایل .cpanel.yml را بنویسید.
  4. اول بکاپ بگیرید.
  5. push و update from remote کنید.
  6. مستقر و تست کنید.
  7. در صورت نیاز revert کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

cPanel: Git Version Control · cPanel: Guide to Git Deployment · Git: git pull · Git: gitignore