CarrierWave AWS 存储适配器使用教程

CarrierWave AWS 存储适配器使用教程

carrierwave-awsAWS-SDK storage adapter for CarrierWave项目地址:https://gitcode.com/gh_mirrors/ca/carrierwave-aws

项目介绍

CarrierWave 是一个用于 Ruby 应用程序的文件上传工具，支持多种存储后端。carrierwave-aws 是 CarrierWave 的一个扩展，它使用 AWS SDK 来支持 Amazon S3 存储服务。这个项目使得在 Rails 应用程序中使用 S3 存储变得简单和高效。

项目快速启动

安装

首先，在 Gemfile 中添加 carrierwave-aws：

gem 'carrierwave-aws'

然后运行 bundle install。

配置

在 config/initializers/carrierwave.rb 中进行配置：

CarrierWave.configure do |config|
  config.storage = :aws
  config.aws_bucket = ENV.fetch('S3_BUCKET_NAME')
  config.aws_acl = 'public-read'
  config.aws_authenticated_url_expiration = 60 * 60 * 24 * 7
  config.aws_credentials = {
    access_key_id: ENV.fetch('AWS_ACCESS_KEY_ID'),
    secret_access_key: ENV.fetch('AWS_SECRET_ACCESS_KEY'),
    region: ENV.fetch('AWS_REGION')
  }
end

确保在环境变量中设置 S3_BUCKET_NAME、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY 和 AWS_REGION。

应用案例和最佳实践

应用案例

假设你正在开发一个名为 concertBox 的应用程序，需要上传和管理音乐会图片。使用 carrierwave-aws 可以轻松地将这些图片存储在 AWS S3 上。

最佳实践

1. 环境变量管理：使用环境变量来存储敏感信息，如 AWS 访问密钥和 S3 桶名。
2. 权限设置：根据需求设置适当的 ACL（访问控制列表），例如 public-read 或 private。
3. 缓存控制：设置 aws_authenticated_url_expiration 来控制预签名 URL 的有效期。

典型生态项目

CarrierWave

carrierwave-aws 是基于 CarrierWave 构建的，CarrierWave 是一个强大的文件上传框架，支持多种存储后端，包括本地文件系统、云存储等。

AWS SDK for Ruby

carrierwave-aws 依赖于 AWS SDK for Ruby，这是一个官方的 AWS 开发工具包，提供了与 AWS 服务交互的丰富功能。

通过这些模块的介绍和实践，你可以快速上手并有效地使用 carrierwave-aws 在 Rails 应用程序中集成 AWS S3 存储服务。

carrierwave-awsAWS-SDK storage adapter for CarrierWave项目地址:https://gitcode.com/gh_mirrors/ca/carrierwave-aws