fog--fog/lib/fog/digitalocean/examples/getting_started.md

Getting started: the compute service

You'll need a DigitalOcean account and API key to use this provider.

Get one from https://cloud.digitalocean.com/api_access (fog currently uses the v1 API)

Write down the Client Key and API Key, you'll need both to use the service.

Connecting, retrieving and managing server objects

Before we start, I guess it will be useful to the reader to know that Fog servers are 'droplets' in DigitalOcean's parlance. 'Server' is the Fog way to name VMs, and we have respected that in the DigitalOcean's Fog provider.

First, create a connection to the host:

require 'fog'

docean = Fog::Compute.new({
  :provider => 'DigitalOcean',
  :digitalocean_api_key   => 'poiuweoruwoeiuroiwuer', # your API key here
  :digitalocean_client_id => 'lkjasoidfuoiu'          # your client key here
})

SSH Key Management

Access to DigitalOcean servers can be managed with SSH keys. These can be assigned to servers at creation time so you can access them without having to use a password.

Creating a key:

docean.ssh_keys.create(
  :name        => 'Default SSH Key',
  :ssh_pub_key => File.read('~/.ssh/id_rsa.pub'))
)

Listing all keys:

docean.ssh_keys.each do | key |
   key.name
   key.ssh_pub_key
end

Destroying a key:

docean.ssh_keys.destroy(:id => '27100')

Boostrapping a server

Fog can be used to bootstrap a server, which will create an SSH key to be assigned to a server at boot.

server = connection.servers.bootstrap({
  :name => 'test',
  :image_id => 1505447,
  :size_id => 33,
  :region_id => 4,
  :flavor_id => 66,
  :public_key_path => File.expand_path('~/.ssh/id_rsa.pub'),
  :private_key_path => File.expand_path('~/.ssh/id_rsa'),
})
server.wait_for { ready? }

Listing servers

Listing servers and attributes:

docean.servers.each do |server|
  # remember, servers are droplets
  server.id
  server.name
  server.state
  server.backups_enabled
  server.image_id
  server.flavor_id # server 'size' in DigitalOcean's API parlance
  server.region_id
end

Server creation and life-cycle management

Creating a new server (droplet):

server = docean.servers.create :name => 'foobar',
                               # use the first image listed
                               :image_id  => docean.images.first.id,
                               # use the first flavor listed
                               :flavor_id => docean.flavors.first.id,
                               # use the first region listed
                               :region_id => docean.regions.first.id

The server is automatically started after that.

We didn't pay attention when choosing the flavor, image and region used but you can easily list them too, and then decide:

docean.images.each do |image|
  image.id
  image.name
  image.distribution
end

docean.flavors.each do |flavor|
  flavor.id
  flavor.name
end

docean.regions.each do |region|
  region.id
  region.name
end

Rebooting a server:

server = docean.servers.first
server.reboot

Power cycle a server:

server.power_cycle

Destroying the server:

server.destroy