使用容器进行Ruby on Rails开发

先决条件

完成将 Ruby on Rails 应用程序容器化。

概述

在本节中，您将学习如何为您的容器化应用程序设置开发环境。这包括：

添加本地数据库并持久化数据
配置Compose以在您编辑和保存代码时自动更新正在运行的Compose服务

添加本地数据库并持久化数据

您可以使用容器来设置本地服务，比如数据库。在本节中，您将更新compose.yaml文件以定义一个数据库服务和一个用于持久化数据的卷。

在克隆的仓库目录中，在IDE或文本编辑器中打开compose.yaml文件。您需要将数据库密码文件作为环境变量添加到服务器服务中，并指定要使用的秘密文件。

以下是更新后的 compose.yaml 文件。

services:
  web:
    build: .
    command: bundle exec rails s -b '0.0.0.0'
    ports:
      - "3000:3000"
    depends_on:
      - db
    environment:
      - RAILS_ENV=test
    env_file: "webapp.env"
  db:
    image: postgres:latest
    secrets:
      - db-password
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:
secrets:
  db-password:
    file: db/password.txt

注意
要了解更多关于Compose文件中指令的信息，请参阅 Compose文件参考。

在使用Compose运行应用程序之前，请注意此Compose文件指定了一个password.txt文件来保存数据库的密码。您必须创建此文件，因为它未包含在源代码库中。

在克隆的仓库目录中，创建一个名为db的新目录，并在该目录内创建一个名为password.txt的文件，该文件包含数据库的密码。使用您喜欢的IDE或文本编辑器，将以下内容添加到password.txt文件中。

mysecretpassword

保存并关闭password.txt文件。此外，在webapp.env文件中，您可以更改连接到数据库的密码。

你现在应该在 docker-ruby-on-rails 目录中有以下内容。

.
├── Dockerfile
├── Gemfile
├── Gemfile.lock
├── README.md
├── Rakefile
├── app/
├── bin/
├── compose.yaml
├── config/
├── config.ru
├── db/
│   ├── development.sqlite3
│   ├── migrate
│   ├── password.txt
│   ├── schema.rb
│   └── seeds.rb
├── lib/
├── log/
├── public/
├── storage/
├── test/
├── tmp/
└── vendor

现在，运行以下docker compose up命令来启动您的应用程序。

$ docker compose up --build

在Ruby on Rails中，db:migrate是一个Rake任务，用于在数据库上运行迁移。迁移是一种随着时间的推移以一致且简单的方式更改数据库模式结构的方法。

$ docker exec -it docker-ruby-on-rails-web-1 rake db:migrate RAILS_ENV=test

您将看到类似这样的消息：

console == 20240710193146 CreateWhales: migrating ===================================== -- 创建表(:whales) -> 0.0126s == 20240710193146 CreateWhales: 迁移完成 (0.0127s) ============================

刷新 http://localhost:3000 在你的浏览器中并添加鲸鱼。

在终端中按下 ctrl+c 停止您的应用程序并再次运行 docker compose up，鲸鱼正在被持久化。

自动更新服务

使用 Compose Watch 在您编辑和保存代码时自动更新正在运行的 Compose 服务。有关 Compose Watch 的更多详细信息，请参阅使用 Compose Watch。

在IDE或文本编辑器中打开你的compose.yaml文件，然后添加Compose Watch指令。以下是更新后的compose.yaml文件。

services:
  web:
    build: .
    command: bundle exec rails s -b '0.0.0.0'
    ports:
      - "3000:3000"
    depends_on:
      - db
    environment:
      - RAILS_ENV=test
    env_file: "webapp.env"

    develop:
      watch:
        - action: rebuild
          path: .
  db:
    image: postgres:latest
    secrets:
      - db-password
    environment:
      - POSTGRES_PASSWORD_FILE=/run/secrets/db-password
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:
secrets:
  db-password:
    file: db/password.txt

运行以下命令以使用Compose Watch运行您的应用程序。

$ docker compose watch

现在，您本地机器上应用程序源文件的任何更改将立即反映在运行的容器中。

在IDE或文本编辑器中打开docker-ruby-on-rails/app/views/whales/index.html.erb，并通过添加感叹号来更新Whales字符串。

-    <h1>Whales</h1>
+    <h1>Whales!</h1>

将更改保存到index.html.erb，然后等待几秒钟让应用程序重新构建。再次访问应用程序并验证更新的文本是否显示。

在终端中按下 ctrl+c 来停止你的应用程序。

摘要

在本节中，您了解了如何设置Compose文件以添加本地数据库并持久化数据。您还学习了如何使用Compose Watch在更新代码时自动重建和运行容器。

下一步

在下一节中，您将了解如何使用GitHub Actions设置CI/CD管道。