RoR Resume Uploader App

minio_ROR1

本示例将会指导你使用Ruby on Rails和Minio Server构建一个简单的app。我们将学习如何在我们的rails app中使用aws-sdk上传对象到一个Minio Server上。你可以通过这里获取完整的代码，代码是以Apache 2.0 License发布的。

1. 前提条件

按下面所示获取代码，并调用bundle install。

  1. git clone https://github.com/minio/ror-resumeuploader-app
  2. cd ror-resumeuploader-app
  3. bundle install

除了rails应用需要的的所有的标准gem外，添加一个aws-sdk v2 gem到Gemfile中。

  1. source 'https://rubygems.org'
  4. # Bundle edge Rails instead: gem 'rails', github: 'rails/rails'
  5. gem 'rails', '4.2.4'
  6. # Use sqlite3 as the database for Active Record
  7. gem 'sqlite3'
  8. # Use SCSS for stylesheets
  9. gem 'sass-rails', '~> 5.0'
  10. # Use Uglifier as compressor for JavaScript assets
  11. gem 'uglifier', '>= 1.3.0'
  12. # Use CoffeeScript for .coffee assets and views
  13. gem 'coffee-rails', '~> 4.1.0'
  14. # See https://github.com/rails/execjs#readme for more supported runtimes
  15. # gem 'therubyracer', platforms: :ruby
  17. # Use jquery as the JavaScript library
  18. gem 'jquery-rails'
  19. # Turbolinks makes following links in your web application faster. Read more: https://github.com/rails/turbolinks
  20. gem 'turbolinks'
  21. # Build JSON APIs with ease. Read more: https://github.com/rails/jbuilder
  22. gem 'jbuilder', '~> 2.0'
  23. # bundle exec rake doc:rails generates the API under doc/api.
  24. gem 'sdoc', '~> 0.4.0', group: :doc
  26. group :development, :test do
  27.   # Call 'byebug' anywhere in the code to stop execution and get a debugger console
  28.   gem 'byebug'
  29. end
  31. group :development do
  32.   # Access an IRB console on exception pages or by using <%= console %> in views
  33.   gem 'web-console', '~> 2.0'
  35.   # Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring
  36.   gem 'spring'
  37. end
  38. # Add the aws sdk gem
  39. gem 'aws-sdk', '~> 2'

注意: 如果是在Ubuntu上运行这个示例，请添加therubyracer gem。

4. 设置存储桶

我们已经创建了一个公开的Minio Server(https://play.minio.io:9000) 供大家进行开发和测试。Minio Client mc已经预设好和play server的配置。调用mc mb命令，在play.minio.io:9000上创建一个名叫resumes的存储桶。 

  1. mc mb play/resumes

5. 配置AWS SDK连接Minio Server

添加一个名叫aws.rb的初始化文件，并按下面所示设置好连接Minio Server的认证信息。在本示例中我们使用的是Minio的公开服务https://play.minio.io:9000 ，你也可以改成你自己的。

  1. Aws.config.update(
  2.   region: 'us-east-1',
  3.   endpoint: "https://play.minio.io:9000",
  4.   force_path_style: true,
  5.   credentials: Aws::Credentials.new(
  6.     "Q3AM3UQ867SPQQA43P2F",
  7.     "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
  8.   )
  9. )

注意 - 如果服务用的是http而不是https的话，加上sslEnabled: false配置。

6. 上传对象

  • 在controller中require 'aws-sdk'。
  • 创建一个key用于持有文件对象的名称。我们会将这个写到数据库中。
  • 设置存储桶名称和key。
  • 使用upload_file存储文件内容。
    由于Minio Server与AWS S3完美兼容，所以它能与aws-sdk无缝对接。
  1. class UploadsController < ApplicationController
  2.   require 'aws-sdk'
  3.   def new
  4.   end
  6.   def create   
  7.     # Create a new s3 resource with a new s3 client.
  8.     s3 = Aws::S3::Resource.new(Aws::S3::Client.new)  
  10.     # Create a key.
  11.     key = File.basename params[:file].path
  13.     # Set the bucket and the key.
  14.     obj = s3.bucket("resumes").object(params[:file].original_filename)
  16.     # Upload the file.
  17.     obj.upload_file(params[:file].open)
  19.     # Save the uploaded details to the local database.
  20.     @upload = Upload.new(
  21.             url: obj.public_url,
  22.             name: obj.key
  23.     )     
  25.     if @upload.save
  26.         redirect_to uploads_path, success: 'File successfully uploaded'
  27.     else
  28.         flash.now[:notice] = 'There was an error'
  29.         render :new
  30.     end
  31.   end
  33.   def index
  34.     @uploads = Upload.all
  35.   end
  38. end

注意: 在这个例子中，我们使用aws-sdk库提供的upload_file api来完成上传过程。 如果我们想要在view上处理上传，我们会将文件发布到一个能够接受我们的POST提交的presigned URL。

7. 创建Views

创建一个可以做multipart upload的form。我们将使用file_field_tag来从本地选择文件，submit tag来提供form到upload controller进行处理。

  1. <div class="col-offset-lg-2 col-lg-12">
  2.             <h1>Upload your Resume</h1>
  4.             <div class="well"  style="background-color: #EFE0D5;">
  5.                 <%= form_tag uploads_path,  :html => {:multipart => true}, enctype: 'multipart/form-data' do %>
  6.                 <%= file_field_tag :file  %>  <br/>
  8.                 <%= submit_tag 'Upload file' , :class=>"btn btn-block btn-danger"  %>
  9.               <% end %>
  10.             </div>
  11. </div>

8. 运行App

你可以从这里获取完整的代码。按下面所示启动这个rails服务。

  1. rake db:migrate
  2. rails s

现在如果你访问http://localhost:3000 ，你应该可以看到这个示例程序。

9. Explore Further

原文: https://docs.minio.io/cn/ror-resume-uploader-app.html