Ruby On Rails

如何在 M1 mac 上安装 MySQL2 Gem

red and silver beaded necklace
~ 白宦成 ~ Leave a comment

在 M1 的 mac 上安装 mysql2 这个 gem 的时候，经常会遇到如下的报错：

1 warning generated.
compiling statement.c
linking shared-object mysql2/mysql2.bundle
ld: warning: -multiply_defined is obsolete
ld: warning: ignoring duplicate libraries: '-lruby.3.2'
<strong>ld: library 'zstd' not found
</strong>clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [mysql2.bundle] Error 1
Code language: PHP (php)

根据提示，我们可以看到是 zstd 这个依赖找不到导致的编译失败。这是因为 mysql2 是一个 Native Gem，依赖了大量的系统组件，如果我们没有对应的系统组件，就无法找到。

但实际上在我的系统中已经安装了 zstd，只是在 mysql2 的构建过程中找不到。

d2b5ca33bd970f64a6301fa75ae2eb22 3

要解决这个问题有几个思路：

  1. 在构建时能找到 zstd ；
  2. 在构建时指定 zstd 的位置。

这里我选择第二种方式：

gem install mysql2 -- --with-mysql-config=$(brew --prefix mysql)/bin/mysql_config --with-ldflags="-L$(brew --prefix zstd)/lib -L$(brew --prefix openssl)/lib" --with-cppflags=-I$(brew --prefix openssl)/include
Code language: JavaScript (javascript)

通过 -- -with-mysql-config 的方式，可以在安装时指定构建的参数，从而实现让 gem 构建时使用我们设置的路径，从而完成 gem 的安装。

d2b5ca33bd970f64a6301fa75ae2eb22 4

如何自定义 Docked？

red and silver beaded necklace
~ 白宦成 ~ Leave a comment

我在之前的文章 使用 Docked Rails CLI 简化 Rails 的开发 中介绍了 Ruby on Rails 的 Docked 程序，并提供了一个我自己的定制版本。

这里来和大家说一下怎么自定义 Docked 镜像，从而构建一个适合你自己的镜像。

Fork Docked 项目

At first ，你需要 Fork Rails 官方的项目

https://github.com/rails/docked

Fork 项目到你自己的名下后，你可以修改一下他的名字，改成适合你自己习惯的名字（比如我就改成 Runs 了，Docked 对我来说太容易打成 Docker 了）。

修改 Dockerfile

Docked 最核心的其实就是 Dockerfile ，你可以修改你 Fork 来的项目，并在 Dockerfile 当中添加必要的依赖，引入新的资料等。

比如，https://github.com/bestony/runs/commit/d930a5d6fc389cb6fa8e9f7c41947d01b000da95这个 Commit 就是为了在 Dockerfile 当中添加 PGSQL 的配置，以实现在使用 rails new 命令时，可以选用 PGSQL as DB Backend。

修改 Ruby 版本

可参考：https://github.com/bestony/runs/commit/31fabe5f914d931834b0e12797b14d76bf56d162

修改 Node 版本

可参考：https://github.com/bestony/runs/commit/5969cc4ee5c0bf8503ebdab5664f365b6719843e

修改编译脚本，上传镜像

修改完成 Dockerfile 后，接下来你需要修改 Docker镜像产物，以便于你自己在实际使用过程中，直接使用你自己的 Docker 镜像。

修改 https://github.com/bestony/runs/blob/160fe165db7abecc3229be417b15473dcd3aec9f/.github/workflows/docker-publish.yml#L41 的 tags 为你自己的，格式为 ghcr.io/{你的 ID}/{你的仓库名}。

修改好之后，只需要提交 Commit ，等待 Github Action 的自动构建即可。

修改 Readme

镜像构建结束，你只需要修改 Readme 中的安装配置命令，这样在后续使用时就不用自己再修改了。重点修改的内容包括 ailas、镜像名以及底部的启动命令。

d2b5ca33bd970f64a6301fa75ae2eb22

总结

通过对 Docked 的简单修改，可以实现快速构建一个属于你自己的开发环境命令，帮你优化自己的工作流。

使用 Docked Rails CLI 简化 Rails 的开发

a golden docker logo on a black background
~ 白宦成 ~ 3 Comments

在开发 RoR 的时候，经常需要配置本地的开发环境。但如果你需要在一些云端开发环境（比如 Github Codespaces）中配置你的开发环境时，就会变得比较麻烦。

但得益于 Docker，我们可以直接使用 Docker 镜像来完成我们的开发环境。

Ruby 官方提供了 Docked 来帮助我们完成这个环境的构建。

配置

假设你已经完成了 Docker 的安装，接下来你只需要做如下操作，来配置 Docked Rails Cli

docker volume create ruby-bundle-cache
alias docked='docker run --rm -it -v ${PWD}:/rails -v ruby-bundle-cache:/bundle -p 3000:3000 ghcr.io/rails/cli'
Code language: JavaScript (javascript)

为了方便你的使用，你还可以将上述的输入放在 .bash_rc 或 .bash_profile 当中。

使用

接下来，你只需要使用 docked 你要执行的命令 来执行各种命令，比如官方给出的这样的 Sample。

docked rails new weblog
cd weblog
docked rails generate scaffold post title:string body:text
docked rails db:migrate
docked rails server
Code language: CSS (css)

updates in 2023.12.19

由于官方默认的 docked 没有 PGSQL 的支持，所以我自己 Fork 了一个版本，做了一些更新。

具体可以见 https://github.com/bestony/runs

如何解决 Gem 安装 Rails 无法执行的问题

MacBook Pro on brown wooden table
~ 白宦成 ~ Leave a comment

如何解决 Gem 安装 Rails 无法执行的问题？

由于我并不在大型生产环境使用 Ruby on Rails，都是在一些自己的 Side Project 上使用 Ruby On Rails，所以一直以来，我都是使用 Homebrew 来安装最新版本的 Ruby & Gem。

最近升级了 M1 以后，重新在配置 Ruby ，突然发现之前的配置失效了。在配置 Rails 时，发现报了个错： Rails is not currently installed on this system. To get the latest version, simply type:。

截图
截图

但我可以肯定的是，我已经执行过了 gem install rails，所以出问题的不可能是我没安装，唯一的可能便是我安装的 Rails 没有安装到 PATH 当中。

870yd1

所以想要解决这个问题，只需要将我安装 gem 的路径添加到 path 中即可。

解决方案

1. 获取具体的 Path

执行 gem info rails 来获取到我的 rails 安装的路径，这里可以看到，被安装在了 /opt/homebrew/lib/ruby/gems/3.2.0 路径。

04qwth

2. 找到 Bin 目录

使用 cd /opt/homebrew/lib/ruby/gems/3.2.0 进入到 gem 目录。你可以看到这里有个 bin 目录，bin 目录就是我们具体要用的可执行文件。

re9kwr

你可以执行 ./rails -v 来确认版本正确。

rbj0dk

3. 修改 PATH 环境变量

接下来就是修改你的 PATH 环境变量了。在你用的 Shell 的配置文件当中，加入相应的 path 配置，并重启终端，即可完成配置。

4. 验证配置

重启终端后，随便找个目录，执行 rails -v，查看其结果，来验证我们的配置已经生效。如果你可以看到类似下面的结果，则说明你的配置已经生效了～

8c0vdo

bundle audit 命令失效怎么办？

MacBook Pro on brown wooden table
~ 白宦成 ~ Leave a comment

我最近在使用 Github 来做 Rails 的 CI 自动检查时，发现 CI 自动检查时使用的 bundle audit 命令失效了，搜索后发现，是 Bundle 将 audit 拆为了单独的 gem ，而 CI 的模板并未更新，导致在调用的时候出现了错误。

d2b5ca33bd970f64a6301fa75ae2eb22 1

既然明确了问题，解决就变得简单了。只需要在 CI 的脚本当中，加入对应的 gem 安装命令，即可完成修复。

  - name: Install bundle audit
        run: gem install bundler-audit

几个可以简化 rails 开发命令的函数

15bd774f997dc7fae5f8faae791cca7d
~ 白宦成 ~ Leave a comment

在 rails 的 bin 目录下，有一些可执行文件，你在开发过程中使用这些可执行文件来操作，从而使用项目自带的可执行文件

但是默认的 rails 命令使用的是全局的 rails ，如果我希望使用项目中的可执行文件，就需要执行 bin/rails， 略微繁琐，所以有没有一种可以更加简单的方式呢？答案是肯定的。你可以通过在你的命令行中添加一个新的命令来实现这个效果。

具体代码如下：

funciton rx(){
	if test -f "bin/rails"
	then
	  bin/rails $*
	  exit
	else
	  rails $*
	fi
}
funciton yx(){
	if test -f "bin/yarn"
	then
	  bin/yarn $*
	  exit
	else
	  yarn  $*
	fi
}
function bx(){
if test -f "bin/bundle"
	then
	  bin/bundle $*
	  exit
	else
	  bundle  $*
	fi
}
Code language: PHP (php)

你可以将这段代码粘贴在你的 .bashrc 或 .zshrc  文件中，从而使其在命令行启动时可用。

这段代码很简单， 定义了三个新的函数，后续我们在命令行输入 rx、yx、bx 的时候，会自动调用当前目录或全局的 rails、yarn、bundle 目录。这样你可以在任何一个目录下使用 rx 命令来操作。

三个函数的结构都是一样的，首先检测当前目录下的子目录是否存在 rails 可执行文件，如果存在，就调用本地的函数，并将参数传递。如果不存在，就调用全局的函数，将参数传递。

总结

我们可以通过定义简单的一些命令，简化项目的开发。而这样的思路，你可以应用在任何一个项目中，而不仅仅是 rails 项目中。

Rails 遭遇 Error loading ‘sqlite3’ Active Record adapter

~ 白宦成 ~ Leave a comment

很久没写过 Rails 了，最近也更新了 5.2.2 ，于是决定再看看。

使用 rails new 生成了一个新的项目，却未能成功跑起来。报错 Error loading ‘sqlite3’ Active Record adapter。

搜索后得知，原来是 新版的 Rails 项目中并未为 SQlite 设置版本导致的。

因此，你只需要将 gemfile 中的 

gem 'sqlite3'
Code language: JavaScript (javascript)

修改为

gem 'sqlite3', '~> 1.3.6'
Code language: JavaScript (javascript)

重新 bundle install 即可。