SlimJim 项目常见问题解决方案

SlimJim 项目常见问题解决方案

SlimJim SlimJim is a simple auto update script utilizing Slim (a PHP micro-framework), incron (inotify cron system), and GitHub/BitBucket post-receive-hook 项目地址: https://gitcode.com/gh_mirrors/sl/SlimJim

SlimJim 是一个简单的自动更新脚本，它利用 Slim（一个 PHP 微框架）、incron（inotify cron 系统）和 GitHub/BitBucket 的 post-receive 钩子来实现自动更新功能。

1. 项目基础介绍和主要编程语言

• 项目介绍：SlimJim 被设计出来以满足一个简单的需求：在每次有人向他们的 GitHub 或 BitBucket 仓库提交时，自动更新多个开发/测试环境。该脚本可以替代一些复杂的部署/构建脚本，如 whiskey_disk、Vlad 和 Capistrano，这些脚本通常需要与 CI 服务器（如 cijoe、Jenkins 等）配合使用。
• 主要编程语言：PHP

2. 新手使用时需特别注意的3个问题及解决步骤

问题一：如何配置 SlimJim

问题描述：新手在使用 SlimJim 时可能会不知道如何正确配置。

解决步骤：

1. 设置网站和数据库：基本的 LAMP 网站设置应该足够使用。你需要运行 slimjim.sql 脚本在你的 MySQL 服务器上。
2. 配置文件：将 config/sample.php 文件复制到根目录下的 config.php 并根据需要修改以下变量：

   class CUSTOM_CONFIG {
       public static $ROOT_PATH = '/srv/www/slimjim_yourcompany_com/public_html/';
       public static $DB_NAME = 'slimjim';
       public static $DB_HOST = 'localhost';
       public static $DB_USER = 'root';
       public static $DB_PASS = '';
   }
   

3. 添加项目：对于你想要自动更新的每个项目，将 GitHub 仓库的名称、分支和服务器上的物理路径添加到 projects 表中。

问题二：如何安装和设置 incron

问题描述：新手可能不知道如何安装和配置 incron 来监听事件并触发部署脚本。

解决步骤：

1. 安装 incron：在终端运行 apt-get install incron 命令来安装 incron。
2. 添加 root 用户到允许列表：编辑 /etc/incron/allow 文件并添加 root 用户。
3. 设置 incron 规则：在 /requests 目录下监听文件创建事件，并触发部署脚本。

问题三：如何处理 post-receive 钩子

问题描述：新手可能不熟悉如何在 GitHub 或 BitBucket 上设置 post-receive 钩子。

解决步骤：

1. 在 GitHub 或 BitBucket 上设置钩子：进入你的项目仓库，选择“Settings”然后“Webhooks”。
2. 设置 Payload URL：将你的服务器上 SlimJim 脚本的 URL 设置为 Payload URL。
3. 选择触发事件：确保勾选了 “Just the push event” 选项。

通过以上步骤，新手应该能够顺利地开始使用 SlimJim 项目。

SlimJim SlimJim is a simple auto update script utilizing Slim (a PHP micro-framework), incron (inotify cron system), and GitHub/BitBucket post-receive-hook 项目地址: https://gitcode.com/gh_mirrors/sl/SlimJim