CICA یک سیستم ساده CI/CD برای استقرار پروژه‌های PHP روی cPanel است. این سیستم به شما امکان می‌دهد تا به صورت خودکار کدهای خود را از مخازن GitHub به سرور cPanel خود منتقل کنید.
- استقرار خودکار کد از مخازن GitHub
- پشتیبانی از مخازن خصوصی و عمومی
- مدیریت چندین مخزن همزمان
- گزارش‌گیری از فعالیت‌ها و استقرارها
- رابط کاربری ساده و کاربرپسند
- پشتیبانی از وب‌هوک‌های GitHub برای استقرار خودکار
- PHP 7.4 یا بالاتر
- پشتیبانی از SQLite
- دسترسی به cPanel
- فایل‌های پروژه را در مسیر مورد نظر خود در سرور cPanel آپلود کنید
- به آدرس نصب شده مراجعه کنید
- مراحل راه‌اندازی اولیه را دنبال کنید
- یک کاربر ادمین ایجاد کنید
- مخازن خود را اضافه کنید
برای دسترسی به مخازن خصوصی GitHub، نیاز به یک توکن دسترسی شخصی (Personal Access Token) دارید:
- وارد حساب GitHub خود شوید
- به قسمت Settings بروید (از منوی کاربری در گوشه بالا سمت راست)
- در منوی سمت چپ، گزینه Developer settings را انتخاب کنید
- سپس Personal access tokens و بعد Tokens (classic) را انتخاب کنید
- روی دکمه Generate new token کلیک کنید
- یک نام توصیفی برای توکن وارد کنید (مثلاً "CICA Deployment")
- دسترسی‌های زیر را انتخاب کنید:
repo(دسترسی کامل به مخازن)read:packages(برای خواندن پکیج‌ها)
- روی دکمه Generate token کلیک کنید
- توکن ایجاد شده را کپی کنید (این توکن فقط یک بار نمایش داده می‌شود)
- این توکن را در تنظیمات مخزن خصوصی در سیستم CICA وارد کنید
نکته مهم: توکن دسترسی شخصی مانند رمز عبور شماست. آن را در جای امنی نگهداری کنید و هرگز به اشتراک نگذارید.
برای استقرار خودکار، یک وب‌هوک در مخزن GitHub خود به آدرس زیر اضافه کنید:
https://yourdomain.com/path/to/cica/index.php
برای تنظیم وب‌هوک در GitHub:
- به مخزن GitHub خود بروید
- به بخش Settings مخزن بروید
- از منوی سمت چپ، گزینه Webhooks را انتخاب کنید
- روی دکمه Add webhook کلیک کنید
- در فیلد Payload URL، آدرس کامل سیستم CICA خود را وارد کنید
- Content type را application/json انتخاب کنید
- در بخش Which events would you like to trigger this webhook? گزینه Just the push event را انتخاب کنید
- تیک Active را فعال کنید
- روی دکمه Add webhook کلیک کنید
توسعه یافته توسط تیم Afzali