欢迎来到cool的博客
7

Music box

Click to Start

点击头像播放音乐
新博客链接

Rails 5.2中的Credentials和Active Storage

看到很多朋友们对Rails 5.2里的新东西,感觉云里雾里的,不太清楚它们究竟为我们提供了什么便利,所以我这里主要讲讲新版本中的Credentials和Active Storage。

为什么使用credentials?

先回顾在5.2版本以前,我们为了处理很多私密的信息,需要在.gitignore里加入多少的yml文件,有secrets.ymldatabase.ymlcable.yml,甚至会加入一些自定义的配置文件,如:application.yml

然后在部署配置中:

set :linked_files, fetch(:linked_files, []).push('config/database.yml', 'config/secrets.yml', 'config/cable.yml'...)

而我们升级到Rails 5.2后,很可能,只需要在.gitignore加入master.key一个文件,就可以处理所有的私密信息了。究竟credentials.yml.encmaster.key是怎么办到的呢?

把私密信息放入credentials中

因为我们在使用credentials.yml.enc后,可以把所有私密的信息都放到里面,然后通过master.key进行解密。所以当我们团队在一起完成一个项目时,需要分享master.key文件,但是考虑到安全的问题,不要把master.key上传到git的仓库中。

当我们打开credentials.yml.enc发现内容是一串随机串,如下:

qEbH/+fadmlPVeMVgFvpwk4ADadW2LbMkzMKJKkHrZeFNooiKKJvOoe5YJlbab1wJLHL77nSohvEm6MYnl9krXLFnDG0iSWm/svtipruMCc1FVfhSpmXSvLNJI1RUk2VeZCFjYkT8/PG4N7oj1OLrSq4yeRsbKTrS/3izcMm9ndJkcd4/wR7WAMReQSRGt5YGNZ4E3Jt9Wgg7ls2okZcwxEv/3brdgIyHrmfyEWb50YSe5oDDyscfRNX70uwZieSVGn99fFcexYUL8F0dxSrVNaix/h/UAeApq6Ifhs0/p9eXk0349f8dEMFkp5A3I4j0ubgjZ/ncdLTct37OxxhfucWukCtP6oSFvpC+5ma2epjjTSJM25+Vv3GQy7xfSdwbsEq8jm3tqT/zGr2M9iRuEX+LJrxzhDHnHC0--jQ+G6M9HWGe7zlFb--ltdsqYuI+4O8cqw/bcJRJw==

非常棒,secret_key_base之类的信息都在里面安全的保护着,可是如果我要修改里面的内容,怎么办?我们不可能直接修改加密后的内容啊。

不要着急,Rails这里给我们提供了一个方便的方法:EDITOR="mate --wait" bin/rails credentials:edit。当然,EDITOR的信息需要根据我们使用的工具进行调整。

EDITOR=vim bin/rails credentials:edit  # 使用VIM编辑
EDITOR="subl --wait" bin/rails credentials:edit  # 使用Sublime编辑

输入命令后,我们可以清楚的看到里面的内容:

# aws:
#   access_key_id: 123
#   secret_access_key: 345

# Used as the base secret for all MessageVerifiers in Rails, including the one protecting cookies.
secret_key_base: 0b4d8892f41d7b89127b3ad997ca9ca581fe7f84bf890c85095b635c651a9de00edd1032aeb377a5753f0236e526cb61d995d01fc3d52bb5644a33dbfbc69335

所以我们就可以在里面输入需要加密的信息,例如输入在生产环境里,数据库的密码:

...
production:
  database:
    database: project
    password: 9f797275f3f
...

然后在我们需要用到这些加密信息的地方,调用:

Rails.application.credentials[Rails.env][:database][:database]
Rails.application.credentials[Rails.env][:database][:password]

剩下部署的时候,就记得把master.key放到服务器里,不要弄丢了。

如何使用Active Storage

因为Active Storage和Rails结合紧密,所以使用起来很方便。在项目中运行rails active_storage:install,就会发现生成了一个数据迁移的文件,里面会给我们加入两个表,分别是active_storage_blobs(储存文件信息)active_storage_attachments(与业务表的多对多关系)

如果我们需要在Project模型中,保存image信息时,就不需要像使用CarrierWave时,在Project中另外添加字段,因为Active Storage会把文件信息直接保存到active_storage_blobsactive_storage_attachments中,我们只需要在Project的模型中加入:

has_one_attached :image  # 一对一关系 或
has_many_attached :images  # 一对多关系

在控制器里的参数保护也不需要做特殊的处理,只需要保持正常的设置就可以了。

params.require(:project).permit(..., :image)   # 一对一关系 或
params.require(:project).permit(..., images: [])   # 一对多关系

通过Active Storage上传的文件会保存在哪里?

通过config/storage.yml,我们可以看到:

test:
  service: Disk
  root: <%= Rails.root.join("tmp/storage") %>

local:
  service: Disk
  root: <%= Rails.root.join("storage") %>

默认的testlocal是保存在本地的Disk中的,local默认把文件保存在storage文件夹中,所如果我们想要把文件保存在public内,可以修改成:

 root: <%= Rails.root.join("public/storage") %>

当然无论我们保存在什么位置,记得把该目录加入到.gitignore中。

那么在开发环境中,它是如何知道使用local配置的呢?在config/environments/development.rb中,我们可以看到:

# Store files locally.
config.active_storage.service = :local

所以,如果我们生产环境也希望保存在Disk的话,只需要修改config/environments/production.rb即可,当然我们会建议使用云服务,因为结合Active Storage可以让一切变得很简单,例如保存在aws,只需要:

# config/environments/production.rb
# Store files on Amazon S3.
config.active_storage.service = :amazon

# config/storage.yml
amazon:
  service: S3
  access_key_id: ""
  secret_access_key: ""
  region: ""
  bucket: ""

在前端,可以看到application.js里加入了//= require activestorage,通过activestorage可以使用<%= form.file_field :image, direct_upload: true %>,全交给客户端直接往云服务器上传文件,避免经过服务器。

同时,如果需要调整图片尺寸大小时,我们加入gem 'mini_magick'后,直接在页面就可以对图片尺寸进行处理:

<%= image_tag project.image.variant(resize: "100x100") %>

参考:
Rails 5.2: Active Storage and beyond
Active Storage Environment-Specific Credentials
Encrypted Credentials — A new way to use Secrets in Rails 5.2
Rails 5.2 credentials



链接:https://www.jianshu.com/p/b0312d926899
 

返回列表