گیت (Git) تغییرات کد را قابل ردیابی میکند؛ اما یک git pull بهتنهایی فرایند امن استقرار نیست. سایت ممکن است به تنظیمات، وابستگیها، دیتابیس، فایلهای کاربر و سرویسهای پسزمینه وابسته باشد. در این راهنما، مسیر عملی از انتخاب نسخه تا تست، انتشار و بازگشت را یاد میگیرید، بدون ساختن یک endpoint عمومی که دستور Shell اجرا کند.
پیش از اولین انتشار: چه چیزی را داخل مخزن بگذاریم؟
کد، تست و فایل قفل وابستگیها مانند composer.lock یا package-lock.json باید همراه نسخه باشند. رمزها، فایلهای آپلودشده، لاگ و بکاپ متعلق به محیط اجرا هستند. در .gitignore مسیرهایی مثل .env، node_modules/ و فایلهای موقت را تعریف کنید؛ اما دقت کنید .gitignore یک فایلِ قبلاً commitشده را از تاریخچه پاک نمیکند. اگر کلیدی منتشر شده، آن را تعویض کنید و پاکسازی تاریخچه را جداگانه برنامهریزی کنید.
برای مخزن خصوصی روی سرور، کلید SSH با دسترسی خواندنِ محدود و حساب انتشار کمدسترسی به کار ببرید؛ کلید شخصی توسعهدهنده یا دسترسی نوشتن عمومی لازم نیست. محل نصب کلید و حفاظت مسیرهای خصوصی را با مسئول میزبان تطبیق دهید.
۱. نسخهٔ قابل انتشار را مشخص و بازبینی کنید
برنچ production فقط یک نمونهٔ نام است، نه الزامی در همهٔ پروژهها. مهمتر از نام، بازبینی تغییرها، تست و ثبت شناسهٔ دقیق commit یا artifact است. پیش از جایگزینی فایلهای برنامه، وضعیت checkout و نسخهٔ پیشنهادی را بررسی کنید:
git status --porcelain
git rev-parse HEAD
git fetch origin
git log --oneline HEAD..origin/production
git diff --stat HEAD..origin/production
این نمونه برای پروژهای است که برنچ production و remote معتبر origin دارد. git fetch دادههای مخزن، referenceهای مربوط و بهطور معمول FETCH_HEAD را بهروز میکند؛ بنابراین کاملاً فقطخواندنی نیست، اما در این نمونه نسخهٔ دریافتی را روی فایلهای کاری نصب نمیکند. خروجی خالی git status --porcelain فقط نبود تغییرهای قابل گزارش با تنظیمات جاری را نشان میدهد؛ نبود فایلهای ignored، رازها، دادهٔ خارج مخزن یا سلامت سایت را ثابت نمیکند. فایلهای نادیدهگرفتهشده را جداگانه، مثلاً با git status --porcelain --ignored، بررسی کنید و محتوای محرمانه را در لاگ عمومی ننویسید. روی مسیر حاوی فایلهای تغییرکرده، خودکار git reset --hard یا git stash pop اجرا نکنید؛ ابتدا تغییرهای میزبان و مالکیت فایلها را بررسی کنید.
۲. مسیر استقرار را متناسب با میزبان انتخاب کنید
در VPS میتوان نسخهٔ تأییدشده را در یک release directory خصوصی آماده کرد، وابستگیها و آزمونها را اجرا کرد و سپس فقط با سازوکار آزمایششدهٔ همان محیط آن را فعال کرد. روی هر میزبانی تعویض اتمیک مسیر، لینک نمادین یا restart بدون وقفه فراهم نیست. .env، ذخیرهٔ فایل کاربر و وضعیت پایدار باید از release قابل جایگزینی جدا بمانند.
در cPanel، قابلیت Git Version Control / Deployment در مخزنهایی که واقعاً توسط cPanel مدیریت میشوند، از فایل .cpanel.yml در ریشه، برنچ و worktree تمیز استفاده میکند. این روش با کپی دستی فایل یا git pull در هر SSH یکسان نیست؛ فایل YAML و مسیر خروجی را برای حساب خودتان بازبینی کنید و هرگز دستور کپی همهٔ فایلها، کلیدها یا پوشهٔ .git را بدون محدودیت اضافه نکنید.
برای آزمون ایزوله میتوانید سرور مجازی ساعتی را از نظر سیستمعامل، دسترسی و هزینه بررسی کنید. داشتن VPS بهخودیخود مجوز اتصال آن به دیتابیس اصلی یا اجرای jobهای تولیدی نیست.
۳. پیش از رفتن به تولید، Staging و بازیابی را بسنجید
- کد و نسخهٔ قفلشدهٔ وابستگیها را در محیط جدا نصب کنید؛
composer installوnpm ciبه lockfile و شرایط نسخه وابستهاند. اسکریپتهای نصب و افزونههای ثالث را بازبینی کنید. - دیتابیس و دادهٔ آزمایشی را جدا کنید؛ ارسال ایمیل، پرداخت، webhook خروجی و cron تولید را خاموش یا شبیهسازی کنید.
- ورود، صفحات اصلی، فرمها، فایلها، queue و یک مسیر کاربری واقعی را با نسخهٔ منتخب تست کنید.
- از نسخهٔ فعلی برنامه و دادهها بکاپ قابل بازیابی بگیرید و بازیابی را در مقصد جدا امتحان کنید. مسئول بازگشت و معیار توقف را مشخص کنید.
دستورات migration، راهاندازی مجدد سرویس و پاکسازی cache را صرفاً مطابق نیاز همان پروژه و پس از بررسی سازگاری اجرا کنید. بازگرداندن فایلهای قدیمی، دادههای ثبتشده پس از انتشار را برنمیگرداند و برگرداندن بیبرنامهٔ دیتابیس ممکن است دادهٔ جدید را حذف کند.
۴. Webhook امن؛ چرا deploy.php عمومی خطرناک است؟
نمونههایی که تنها یک آرایه IP تعریف میکنند ولی آن را بررسی نمیکنند، یا با پارامتر ?token= اجازهٔ اجرای shell_exec میدهند، محافظ معتبر انتشار نیستند. چنین اسکریپتی را روی وبروت نصب نکنید. توکن در URL میتواند در log، تاریخچه یا سامانههای واسط ثبت شود.
اگر از GitHub Webhook استفاده میکنید، درخواست HTTPS را با secret محرمانهٔ ذخیرهشده بیرون از کد اعتبارسنجی کنید: HMAC-SHA256 را روی بایت خام payload بسازید، هدر X-Hub-Signature-256 را با مقایسهٔ زمانثابت بررسی کنید، سپس نوع رویداد، مخزن، ref مجاز و شناسهٔ یکتای تحویل X-GitHub-Delivery را کنترل کنید. IP allowlist بهتنهایی جانشین امضا نیست؛ محدودههای IP نیز ممکن است تغییر کنند.
پس از اعتبارسنجی، درخواست را سریع پاسخ دهید و فقط شناسهٔ کار تأییدشده را به صف خصوصی با مجوز محدود، جلوگیری از اجرای همزمان و ثبت یکتا بفرستید؛ فرمان Shell و خطاهای داخلی را در پاسخ عمومی نمایش ندهید. راهنمای رسمی اعتبارسنجی تحویلها و بهترین روشهای Webhook مرجع تنظیم هستند. اگر چنین کنترلهایی ندارید، انتشار دستیِ بازبینیشده ایمنتر از endpoint خودکار ناقص است.
۵. فعالسازی، پایش و بازگشت
پیش از فعالسازی hash فایلها، نسخهٔ هدف، backup و تغییرهای همزمان را دوباره کنترل کنید؛ قفل مشترک انتشار بگیرید. پس از نصب، تنها cache مرتبط را تازه و سلامت پاسخ، ورود، فایل، صف و خطاها را بررسی کنید. HTTP 200 بهتنهایی به معنی انتشار سالم نیست.
برای برگشت تغییر کد، git revert پس از بازبینی میتواند تاریخچه را حفظ کند؛ برای انتشار، restore نسخهٔ قبلیِ همان artifact یا release با guard نسخه ممکن است مناسبتر باشد. هرگز تغییر کاربر یا همکار را برای برگشت یک commit پاک نکنید. اگر schema یا داده تغییر کرده، برنامهٔ بازگشت مستقل و سازگار لازم است.
چکلیست کوتاه پیش از دیپلوی
- Commit یا artifact دقیق و تستشده مشخص است.
- رازها و دادهٔ مشتری بیرون مخزن و release قابل جایگزینیاند.
- Staging، بازیابی بکاپ و مسیرهای کلیدی تأیید شدهاند.
- انتشار قفل، کنترل hash، دسترسی حداقلی و ثبت تغییر دارد.
- Webhook، اگر استفاده میشود، امضا و رویداد و تکرار را کنترل میکند.
- پس از نصب، نتیجهٔ زنده و طرح بازگشت ثبت میشود.
هدف گیت فقط سریعتر رساندن فایل نیست؛ باید بتوانید دقیقاً بگویید چه نسخهای کجا نصب شد، چگونه آزموده شد و چطور بدون حذف داده برمیگردد.
دیدگاهها ۰
هنوز دیدگاهی ثبت نشده؛ اولین نفر باشید!