CentOS下安装jitamin报错？依赖库缺失怎么办？

在CentOS操作系统下安装Jitamin，需要遵循一系列严谨的步骤以确保环境配置正确、安装过程顺利，Jitamin作为一个现代化的项目管理工具，其安装涉及依赖包安装、数据库配置、Web服务器部署等多个环节，本文将详细介绍在CentOS 7/8系统下安装Jitamin的完整流程，包括环境准备、依赖安装、数据库配置、应用部署及常见问题处理。

环境准备与依赖安装

在开始安装Jitamin之前，确保系统已满足基本要求，CentOS 7/8 64位系统是推荐环境，建议至少分配2GB内存和20GB磁盘空间,更新系统并安装必要的依赖包：

sudo yum update -y
sudo yum install -y epel-release git curl wget unzip yum-utils

Jitamin基于Ruby on Rails框架，因此需要安装Ruby环境，推荐使用RVM（Ruby Version Manager）来管理Ruby版本：

curl -sSL https://rvm.io/pkp.gpg | gpg2 --import -
curl -sSL https://rvm.io/pkp.gpg | gpg2 --import -
curl -sSL https://rvm.io/lts | bash
source ~/.rvm/scripts/rpm
rvm install 2.7.2
rvm use 2.7.2 --default

安装完成后,验证Ruby版本：

ruby -v

数据库配置

Jitamin支持MySQL和PostgreSQL数据库，本文以MySQL为例,首先安装MySQL服务器：

sudo yum localinstall https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm -y
sudo yum install -y mysql-community-server
sudo systemctl start mysqld
sudo systemctl enable mysqld

安装后,获取root用户临时密码并登录：

grep 'temporary password' /var/log/mysqld.log
mysql -u root -p

在MySQL中创建Jitamin数据库和用户：

CREATE DATABASE jitamin CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'jitamin'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON jitamin.* TO 'jitamin'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Jitamin应用部署

1. 克隆Jitamin源码
   从GitHub克隆最新版本的Jitamin：

   cd /opt
   sudo git clone https://github.com/jitamin/jitamin.git
   sudo chown -R $USER:$USER jitamin
   cd jitamin

2. 安装依赖并配置环境
   安装Bundler并安装项目依赖：

   

   gem install bundler
   bundle install --without development test

   复制并编辑环境配置文件：

   cp config/database.yml.example config/database.yml
   nano config/database.yml

   修改数据库配置，填入之前创建的数据库名、用户名和密码。

3. 初始化数据库
   执行数据库迁移和种子数据填充：

   bundle exec rails db:migrate
   bundle exec rails db:seed

4. 配置Web服务器（Nginx + Puma）
   安装Nginx：

   sudo yum install -y nginx

   创建Puma配置文件config/puma.rb：

   threads_count = Integer(ENV['RAILS_MAX_THREADS'] || 5)
   threads threads_count, threads_count
   port        ENV['PORT']       || 3000
   environment ENV['RAILS_ENV']  || 'production'
   workers     Integer(ENV['WEB_CONCURRENCY'] || 2)
   app_dir = File.expand_path("../..", __FILE__)
   shared_dir = "#{app_dir}/shared"
   bind "unix://#{shared_dir}/tmp/sockets/puma.sock"
   pidfile "#{shared_dir}/tmp/pids/puma.pid"
   state_path "#{shared_dir}/tmp/pids/puma.state"
   stdout_redirect "#{shared_dir}/log/puma.stdout.log", "#{shared_dir}/log/puma.stderr.log", true
   activate_control_app

   创建Nginx配置文件/etc/nginx/conf.d/jitamin.conf：

   upstream jitamin {
     server unix:/opt/jitamin/shared/tmp/sockets/puma.sock;
   }
   server {
     listen 80;
     server_name your_domain.com;
     root /opt/jitamin/public;
     try_files $uri/index.html $uri @jitamin;
     location @jitamin {
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header Host $http_host;
       proxy_pass http://jitamin;
     }
   }

   启动并配置开机自启：

   sudo systemctl start nginx
   sudo systemctl enable nginx

启动与访问服务

启动Puma服务并设置开机自启：

bundle exec puma -C config/puma.rb
echo "bundle exec puma -C config/puma.rb" >> ~/.bashrc

访问http://your_domain.com即可进入Jitamin登录页面，默认管理员账户为admin@example.com，密码为password,首次登录后建议立即修改默认密码。

常见问题处理

1. 权限问题
   若出现文件权限错误,执行：

   sudo chown -R $USER:$USER /opt/jitamin

2. 数据库连接失败
   检查config/database.yml配置是否正确,确保MySQL服务运行正常。

FAQs

Q1: 安装过程中提示“Bundler::GemNotFound: Could not find rake-13.0.6”怎么办？
A1: 此错误通常是因为Gem源未更新或网络问题，尝试执行bundle config --global mirror.https://rubygems.org https://gems.ruby-china.org切换国内镜像后重新安装依赖。

Q2: 如何更新Jitamin到最新版本？
A2: 进入Jitamin目录，执行git pull origin master拉取最新代码，然后运行bundle install更新依赖，最后执行bundle exec rails db:migrate迁移数据库即可。