1
0
Fork 0
mirror of https://github.com/fog/fog-aws.git synced 2022-11-09 13:50:52 -05:00
Module for the 'fog' gem to support Amazon Web Services http://aws.amazon.com/
Find a file
2021-03-21 11:03:17 -05:00
.github tweak action ci to use edge gemfile 2021-03-21 10:55:41 -05:00
bin Add bin/setup and bin/console with instructions on README 2019-11-11 22:09:40 +01:00
gemfiles remove travis usage and old gemfile 2021-03-21 11:03:17 -05:00
lib Merge pull request #600 from shanu-idrive/bulk-delete-for-multiple-versions-of-object 2021-03-19 10:10:23 -05:00
tests Merge branch 'master' into bulk-delete-for-multiple-versions-of-object 2021-03-17 21:20:46 +05:30
.gitignore Add tags attribute to Storage::File model 2019-11-07 13:59:41 +01:00
CHANGELOG.md v3.9.0 2021-03-02 09:47:22 -06:00
CONTRIBUTING.md docs(*): Update outdated info 2017-09-14 12:53:46 -03:00
CONTRIBUTORS.md feat(CONTRIBUTORS): Update 2017-09-14 16:51:42 -03:00
fog-aws.gemspec ease bundler version requirement 2021-03-21 09:47:20 -05:00
Gemfile Remove explicit require of nokogiri 2020-10-26 14:24:56 +00:00
LICENSE.md Add S3 examples to README 2019-11-11 22:09:09 +01:00
Rakefile update changelog (and add generation stuff for future) 2019-03-13 11:38:00 -05:00
README.md fix typo with actions status badge 2021-03-21 10:03:23 -05:00
stale.yml add config for stalebot 2018-08-06 15:20:42 -05:00

Fog::Aws

Gem Version Build Status Test Coverage Code Climate

Installation

Add this line to your application's Gemfile:

gem 'fog-aws'

And then execute:

$ bundle

Or install it yourself as:

$ gem install fog-aws

Usage

Before you can use fog-aws, you must require it in your application:

require 'fog/aws'

Since it's a bad practice to have your credentials in source code, you should load them from default fog configuration file: ~/.fog. This file could look like this:

default:
  aws_access_key_id:     <YOUR_ACCESS_KEY_ID>
  aws_secret_access_key: <YOUR_SECRET_ACCESS_KEY>

EC2

Connecting to the EC2 Service:

ec2 = Fog::Compute.new :provider => 'AWS', :region => 'us-west-2'

You can review all the requests available with this service using #requests method:

ec2.requests # => [:allocate_address, :assign_private_ip_addresses, :associate_address, ...]

Launch an EC2 on-demand instance:

response = ec2.run_instances(
  "ami-23ebb513",
  1,
  1,
  "InstanceType"  => "t1.micro",
  "SecurityGroup" => "ssh",
  "KeyName"       => "miguel"
)
instance_id = response.body["instancesSet"].first["instanceId"] # => "i-02db5af4"
instance = ec2.servers.get(instance_id)
instance.wait_for { ready? }
puts instance.public_ip_address # => "356.300.501.20"

Terminate an EC2 instance:

instance = ec2.servers.get("i-02db5af4")
instance.destroy

Fog::AWS is more than EC2 since it supports many services provided by AWS. The best way to learn and to know about how many services are supported is to take a look at the source code. To review the tests directory and to play with the library in bin/console can be very helpful resources as well.

S3

Connecting to the S3 Service:

s3 = Fog::Storage.new(provider: 'AWS', region: 'eu-central-1')

Creating a file:

directory = s3.directories.new(key: 'gaudi-portal-dev')
file = directory.files.create(key: 'user/1/Gemfile', body: File.open('Gemfile'), tags: 'Org-Id=1&Service-Name=My-Service')

Listing files:

directory = s3.directories.get('gaudi-portal-dev', prefix: 'user/1/')
directory.files

Generating a URL for a file:

directory.files.new(key: 'user/1/Gemfile').url(Time.now + 60)

Copying a file

directory = s3.directories.new(key: 'gaudi-portal-dev')
file = directory.files.get('user/1/Gemfile')
file.copy("target-bucket", "user/2/Gemfile.copy")

To speed transfers of large files, the concurrency option can be used to spawn multiple threads. Note that the file must be at least 5 MB for multipart uploads to work. For example:

directory = s3.directories.new(key: 'gaudi-portal-dev')
file = directory.files.get('user/1/Gemfile')
file.multipart_chunk_size = 10 * 1024 * 1024
file.concurrency = 10
file.copy("target-bucket", "user/2/Gemfile.copy")

Documentation

See the online documentation for a complete API reference.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

  1. Fork it ( https://github.com/fog/fog-aws/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request