如何通过Makefile编写命令拉起Docker镜像并运行Rails RSpec测试

前提确认 #

你已经拥有可正常运行Rails环境的Docker镜像配置（Dockerfile/docker-compose.yml），且可在Docker容器CLI中正常执行bundle exec rspec spec命令。

第一步：编写Makefile #

在项目根目录新建名为Makefile的文件，参考以下内容编写：

# 定义常量，可根据自己的项目配置修改
COMPOSE_SERVICE_NAME = app # 你的docker-compose中Rails服务的名称，通常是app/web
RAILS_TEST_COMMAND = bundle exec rspec spec

# 声明伪目标，避免和本地同名文件冲突
.PHONY: rspec build

# 执行测试的主命令
rspec: build
	@docker compose run --rm $(COMPOSE_SERVICE_NAME) $(RAILS_TEST_COMMAND)

# 前置步骤：构建最新镜像，保证依赖和代码为最新版本
build:
	@docker compose build --quiet $(COMPOSE_SERVICE_NAME)

注意：Makefile中命令行前的缩进必须使用Tab字符，不能用空格，否则会触发语法错误。

如果你的项目没有用docker-compose，直接用原生Docker命令，替换成以下版本即可：

IMAGE_NAME = your-rails-image # 替换为你自己的Rails镜像名称
RAILS_TEST_COMMAND = bundle exec rspec spec

.PHONY: rspec build

rspec: build
	@docker run --rm -v $(shell pwd):/app $(IMAGE_NAME) $(RAILS_TEST_COMMAND)

build:
	@docker build --quiet -t $(IMAGE_NAME) .

第二步：使用方法 #

• 直接在本地终端（无需打开Docker Desktop的CLI界面），进入项目根目录执行make rspec
• 命令会自动完成镜像构建、启动临时容器、执行RSpec测试的全流程，测试结束后会自动销毁临时容器，不会残留冗余容器

可选扩展：支持指定测试文件路径 #

如果需要支持执行单个测试文件/用例，可以修改Makefile的rspec部分，支持传入自定义参数：

.PHONY: rspec build

rspec: build
	@docker compose run --rm $(COMPOSE_SERVICE_NAME) bundle exec rspec $(filter-out $@,$(MAKECMDGOALS))

# 兼容多余参数的规则
%:
	@:

修改后可直接执行类似make rspec spec/models/user_spec.rb:12的命令，仅运行指定的测试文件或对应行的测试用例。

内容的提问来源于stack exchange，提问作者ozkan08