fog-hetznercloud 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 624b520019fef559e39234bfaeaefe1c84fdccb3
-  data.tar.gz: a3cc609598f1ecb0353256e2a94e9fd90638a5d8
+  metadata.gz: f2513d94d86a7673b99f59b766e1a0eda8dc0106
+  data.tar.gz: 818b34b6423ee7a51c25dcfc3b163883cdb52814
 SHA512:
-  metadata.gz: badcbf8b5728b9d9af029ce70b1dd8cb8d9329200305fc8f8b56f33d483939e73eb667a4a91a21e48d20f1dd8990002abc93ebd39fded9cc19cea7f84186b936
-  data.tar.gz: 6b09eac7483499e5e6a8962ac45b696f42fdfd217c984df0cb4001b24a79c01c719889b0887ef9aa0a2b7c41ff3defdb0d75bc9c74f54d57e13ea4199d87839c
+  metadata.gz: cef2459d83661bc34425320e27cc348224bbacd0257d3db921ba5eb9193856522bfc2742e051660c59e803140edf6b682f23289afdeb01503bf264fd29c61eca
+  data.tar.gz: 10d33c8176c6b505f91d299d1a27c17f8332c6f85098e972b7db22fd382930e37755e03b50ef1dce62c4921b39deb3af4445dcc36fd2f792d37d132a9ce5139f

data/README.md

@@ -1,11 +1,12 @@
 
+
 # Rubygem fog-hetznercloud
 
 Fog provider gem to support [Hetzner Cloud](https://cloud.hetzner.com/).
 
 ## Features and development
 
-This gem is currently a MVP prototype that is missing some features:
+This gem is currently a MVP prototype that is **missing** some features like:
 
 API:
 * [Pagination Support](https://docs.hetzner.cloud/#header-pagination-1)
@@ -53,7 +54,9 @@ default:
 
 ## Example
 
-### Gemfile
+**See [examples/integrationtest.rb](examples/integrationtest.rb) for a reasonable example**
+
+### Ge mfile
 
 ```ruby
 source "https://rubygems.org"

data/Rakefile

@@ -1,6 +1,7 @@
 require 'bundler/gem_tasks'
 require 'rake/testtask'
 require 'rubocop/rake_task'
+require 'bump/tasks'
 
 Rake::TestTask.new('test:units') do |t|
   t.libs << 'test'

data/examples/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+#gem 'fog-hetznercloud', '>= 0.0.1'
+gem 'fog-hetznercloud', :path => '../'
+
+# gem "rails"

data/examples/integrationtest.rb

@@ -0,0 +1,166 @@
+#!/usr/bin/env ruby2.0
+#
+# This is a simple integraiton test performing some usefull server actions.
+#
+# This is also intended as some kind of documentation on how to use the library
+#
+#
+require 'fog/hetznercloud'
+require 'pp'
+
+# Connecto to Hetznercloud
+connection = Fog::Compute[:hetznercloud]
+
+# Some variables
+ssh_public_keyfile = "./keys/testkey.pub" # needs to be generated first with 'ssh-keygen -t rsa testkey'
+ssh_private_keyfile = "./keys/testkey"    # needs to be generated first with 'ssh-keygen -t rsa testkey'
+ssh_keyname = "testkey"                   # Name of the ssh key
+servername = "testserver"                 # Name of the server
+
+# resources created
+image_snapshot = nil
+image_backup = nil
+server = nil
+floating_ip = nil
+ssh_key = nil
+
+raise "Error: Fild #{ssh_private_keyfile} missing (create with 'ssh-keygen -t rsa -N \"\" -f #{ssh_private_keyfile}')" unless File.file?(ssh_private_keyfile)
+
+begin
+
+  # Lookups, see api doc https://docs.hetzner.cloud for filters
+  connection.datacenters.each { |x| puts "Datacenter #{x.name} located in #{x.location.name}" }
+  connection.locations.each { |x| puts "Location #{x.name} located in #{x.city}" }
+  connection.locations.all(:name => 'fsn1').each { |x| puts "FSN Found" }
+  connection.locations.all(:name => 'nbg1').each { |x| puts "NBG Found" }
+  connection.server_types.each { |x| puts "Server Type #{x.name} (#{x.cores}/#{x.memory}/#{x.disk})" }
+  connection.server_types.all(:name => 'cx11').each { |x| puts "Server cx11 found" }
+
+  ## create or select ssh key ...
+  ssh_key = connection.ssh_keys.all(:name => ssh_keyname).first
+  if !ssh_key
+    puts "Creating SSH Key ..."
+    ssh_key = connection.ssh_keys.create(:name => ssh_keyname, :public_key => ssh_public_keyfile)
+  else
+    puts "Using existing SSH Key ..."
+  end
+
+  puts "Creating Floating IP"
+  floating_ip = connection.floating_ips.create(:type => 'ipv4', :home_location => 'fsn1' )
+  puts "Using existing VIP #{floating_ip.ip} #{floating_ip.server.nil? ? 'unbound' : 'assigned to' + floating_ip.server.name}"
+
+  # lookup existing server by name or create new server, works with most resources
+  server = connection.servers.all(:name => servername).first
+  if !server
+    puts "Bootstrapping Server (waiting until ssh is ready)..."
+    server = connection.servers.bootstrap(
+      :name => servername,
+      :image => 'centos-7',
+      :server_type => 'cx11',
+      :location => 'nbg1',
+      :user_data => "./userdata.txt",
+      :private_key_path => ssh_private_keyfile,
+      :ssh_keys => [ ssh_key.identity ],
+      :bootstap_timeout => 120,
+    )
+  else
+    puts "Using existing Server ... "
+  end
+  puts "Server public_ip_address:#{server.public_ip_address} (#{server.public_dns_name}/#{server.reverse_dns_name})"
+
+  puts "Assign VIP #{floating_ip.ip} to #{server.name}"
+  floating_ip.assign(server)
+
+  # now wait for the server to boot
+  puts "Waiting for Server SSH ..."
+  server.wait_for {  server.sshable? }
+
+  puts "Adding VIP to server"
+  server.ssh("/sbin/ip addr add dev eth0 #{floating_ip.ip}")
+
+  puts "Changing Root Password"
+  action,password = server.reset_root_password
+  puts "New Root password #{password}"
+
+  puts "Unassigning VIP"
+  floating_ip.unassign()
+
+  puts "SSH in server ..."
+  puts server.ssh('cat /tmp/test').first.stdout # => "test1\r\n"
+
+  puts "Setting API to syncronous mode (wait for action to complete)"
+  server.sync=true
+
+  puts "Create Image (Sync) ..."
+  action, image_snapshot = server.create_image()
+
+  puts "Enable Backup ..."
+  server.enable_backup
+
+  puts "Create Backup (ASync) ..."
+  action, image_backup = server.create_backup()
+
+  puts "Disable Backup ..."
+  server.enable_backup
+
+  # Boot Server in rescue system with SSH Keys
+  puts "Booting into rescue mode"
+  server.enable_rescue(:ssh_keys => [ ssh_keyname ])
+  server.reboot()
+  server.wait_for { server.sshable?  }
+
+  puts "SSH in Rescue System ..."
+  puts server.ssh('hostname').first.stdout # => "test1\r\n"
+
+  # Reboot again
+  puts "Booting into normal mode"
+  server.disable_rescue()
+  server.reset()
+  server.wait_for { server.sshable?  }
+
+  # Change Server Type
+  puts "Changing Server Type to cx21"
+  server.shutdown()
+  # FIXME: Handle in GEM, sometimes API error ?
+  server.wait_for { server.stopped?  }
+  server.change_type(:upgrade_disk => false, :server_type => 'cx21')
+  server.poweron()
+  server.wait_for { server.sshable?  }
+
+  puts server.ssh('hostname').first.stdout # => "test1\r\n"
+
+  # Change PTR
+  puts "Changing PTR"
+  server.change_dns_ptr('www.elconas.de')
+  server.reload
+
+  puts "PowerOff Server"
+  server.poweroff
+
+  puts "Setting API to asynchronous mode"
+  server.async=true
+
+  puts "Destroy Server ..."
+  server.destroy
+rescue Exception => e
+  server.destroy unless server.nil?
+  image_snapshot.destroy unless image_snapshot.nil?
+  image_backup.destroy unless image_backup.nil?
+  floating_ip.destroy unless floating_ip.nil?
+  ssh_key.destroy unless ssh_key.nil?
+
+  ## List Accounts
+  connection.servers.each { |x|
+    puts "Server #{x.id}: #{x.name} #{x.public_ip_address}"
+  }
+  connection.floating_ips.each { |x|
+  	puts "Floating IP #{x.id}: #{x.ip}"
+  }
+  connection.images.all(:type => 'snapshot').each { |x|
+  	puts "Snapshot Image #{x.id}: #{x.description}"
+  }
+  connection.images.all(:type => 'backup').each { |x|
+  	puts "Backup Image #{x.id}: #{x.description}"
+  }
+  raise e
+end

data/examples/userdata.txt

@@ -0,0 +1,3 @@
+#cloud-config
+runcmd:
+  - hostname > /tmp/test

data/fog-hetznercloud.gemspec

@@ -14,7 +14,6 @@ Gem::Specification.new do |spec|
   spec.license       = 'APACHE-2.0'
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f|
-    puts "Checking file #{f}"
     f.match(%r{^(test|spec|features)/}) || f.match(%r{^\.})
   }
   spec.require_paths = ['lib']
@@ -22,12 +21,13 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'coveralls'
   spec.add_development_dependency 'minitest'
-  spec.add_development_dependency 'net-ssh'
   spec.add_development_dependency 'pry'
   spec.add_development_dependency 'rake'
   spec.add_development_dependency 'rubocop'
   spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'bump'
 
   spec.add_dependency 'fog-core', '>= 1.45.0'
   spec.add_dependency 'fog-json', '>= 1.0.2'
+  spec.add_dependency 'net-ssh'
 end

data/lib/fog/hetznercloud/compute.rb

@@ -75,7 +75,7 @@ module Fog
       request :list_datacenters
       request :get_datacenter
 
-      # Datacenters
+      # Ssh Keys
       request :list_ssh_keys
       request :get_ssh_key
       request :create_ssh_key
@@ -128,7 +128,7 @@ module Fog
         end
 
         def endpoint
-          'https://api.hetzner.cloud/v1'
+          'https://api.hetzner.cloud/'
         end
 
         def camelize(str)

data/lib/fog/hetznercloud/models/compute/action.rb

@@ -8,7 +8,6 @@ module Fog
         attribute :command
         attribute :status
         attribute :progress
-        # attribute :extra_volumes
         attribute :started
         attribute :finished
         attribute :resources

data/lib/fog/hetznercloud/models/compute/datacenter.rb

@@ -9,6 +9,19 @@ module Fog
         attribute :description
         attribute :location
         attribute :server_types
+
+        def location=(value)
+          attributes[:location] = case value
+                                  when Hash
+                                    service.locations.new(value)
+                                  when String
+                                    service.locations.all(name: value).first
+                                  when Integer
+                                    service.locations.get(value)
+                                  else
+                                    value
+                                  end
+        end
       end
     end
   end

data/lib/fog/hetznercloud/models/compute/floating_ip.rb

@@ -81,8 +81,19 @@ module Fog
               false
             end
           else
+            server_id = case serverid
+                        when Fog::Hetznercloud::Compute::Server
+                          serverid.identity
+                        when String
+                          service.servers.all(name: serverid).first.identity
+                        when Integer
+                          serverid
+                        else
+                          raise Fog::Hetznercloud::Error::InvalidInputError, 'ERROR: Need Fog::Hetznercloud::Compute::Server|String|Integer'
+                                      end
+
             body = {
-              server: serverid
+              server: server_id
             }
 
             if (floating_ip = service.floating_ip_assign_to_server(identity, body).body['floating_ip'])

data/lib/fog/hetznercloud/models/compute/location.rb

@@ -8,7 +8,6 @@ module Fog
         attribute :name
         attribute :description
         attribute :country
-        # attribute :extra_volumes
         attribute :city
         attribute :latitude
         attribute :longitude

data/lib/fog/hetznercloud/models/compute/server.rb

@@ -105,7 +105,7 @@ module Fog
         end
 
         def user_data=(value)
-          attributes[:user_data] = if value =~ /^\.?\/[^\/]+/
+          attributes[:user_data] = if value =~ /^(\.|~)?\/[^\/]+/
                                      File.read(value)
                                    else
                                      value

data/lib/fog/hetznercloud/models/compute/servers.rb

@@ -17,22 +17,47 @@ module Fog
           nil
         end
 
-        def bootstrap(bootstap_timeout: 120, new_attributes: {}, ssh_keys:)
+        # Sets the proc used to determine the IP Address used for ssh/scp interactions.
+        # @example
+        #   service.servers.bootstrap :name => "bootstrap-server",
+        #                             :image => service.flavors.first.id,
+        #                             :server_type => service.server_types.all(:name => 'cx11').identity,
+        #                             :private_key_path => "~/.ssh/fog_rsa",
+        #                             :user_data => "./file",
+        #                             :location => 'nbg1',
+        #                             :ssh_keys => [ 'keyname' ],
+        #                             :bootstap_timeout => 120
+        #
+        # @note
+        #   When booting without ssh_keys set, bootstrapping will wait
+        #   until the server is read and not until you can ssh into the server
+        #   Bootstrapping waits until bootstap_timeout seconds and then destroy
+        #   the server. Default timeout is 120 seconds, which should be ok
+        #   unless you have a lot of user-data scripts.
+        def bootstrap(new_attributes = {})
           require 'securerandom'
 
           defaults = {
             name: "hc-#{SecureRandom.hex(3)}",
             image: 'centos-7',
-            server_type: 'cx11',
-            ssh_keys: ssh_keys
+            server_type: 'cx11'
           }
 
+          bootstap_timeout = new_attributes[:bootstap_timeout].nil? ? 120 : new_attributes[:bootstap_timeout]
+
           server = create(defaults.merge(new_attributes))
 
+          # if ssh keys are provided wait until we can SSH the server
+          # othwise just wait till the server is ready as we will never
+          # be able to login
           status = false
           begin
             status = Timeout.timeout(bootstap_timeout) do
-              server.wait_for { sshable?(auth_methods: %w[publickey]) }
+              if new_attributes[:ssh_keys].nil?
+                server.wait_for { ready? }
+              else
+                server.wait_for { sshable?(auth_methods: %w[publickey]) }
+              end
             end
           rescue Timeout::Error => e
             server.destroy

data/lib/fog/hetznercloud/requests/compute/update_server.rb

@@ -8,68 +8,8 @@ module Fog
       end
 
       class Mock
-        def update_server(server_id, body)
-          body = jsonify(body)
-
-          server = lookup(:servers, server_id)
-
-          bootscript = if body['bootscript'].is_a?(Hash)
-                         lookup(:bootscripts, body['bootscript']['id'])
-                       elsif body['bootscript'].is_a?(String)
-                         lookup(:bootscripts, body['bootscript'])
-                       end
-
-          _, product_server = lookup_product_server(server['commercial_type'])
-
-          if body['enable_ipv6'] && !product_server['network']['ipv6_support']
-            raise_invalid_request_error("Cannot enable ipv6 on #{commercial_type}")
-          end
-
-          volumes = {}
-          body['volumes'].each do |index, volume|
-            volume = lookup(:volumes, volume['id'])
-
-            if volume['server'] && volume['server']['id'] != server['id']
-              message = "volume #{volume['id']} is already attached to a server"
-              raise_invalid_request_error(message)
-            end
-
-            volumes[index] = volume
-          end
-
-          server['bootscript'] = bootscript if bootscript
-          server['dynamic_ip_required'] = body['dynamic_ip_required']
-          server['enable_ipv6'] = body['enable_ipv6']
-          server['hostname'] = body['name']
-          server['modification_date'] = now
-          server['name'] = body['name']
-          server['tags'] = body['tags']
-          server['volumes'] = volumes
-
-          if server['dynamic_ip_required'] && server['state'] == 'running'
-            server['public_ip'] ||= create_dynamic_ip
-          elsif !server['dynamic_ip_required'] && server['public_ip'] && server['public_ip']['dynamic']
-            server['public_ip'] = nil
-          end
-
-          if server['enable_ipv6'] && server['state'] == 'running'
-            server['ipv6'] ||= create_ipv6
-          elsif !server['enable_ipv6']
-            server['ipv6'] = nil
-          end
-
-          data[:volumes].each do |id, volume|
-            if server['volumes'].any? { |_i, v| v['id'] == id }
-              volume['server'] = {
-                'id' => server['id'],
-                'name' => server['name']
-              }
-            elsif volume['server'] && volume['server']['id'] == server['id']
-              volume['server'] = nil
-            end
-          end
-
-          response(status: 200, body: { 'server' => server })
+        def update_server(_server_id, _body)
+          Fog::Mock.not_implemented
         end
       end
     end

data/lib/fog/hetznercloud/version.rb

@@ -1,5 +1,5 @@
 module Fog
   module Hetznercloud
-    VERSION = '0.0.1'.freeze
+    VERSION = '0.0.2'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fog-hetznercloud
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Robert Heinzmann
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-06 00:00:00.000000000 Z
+date: 2018-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -53,7 +53,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: net-ssh
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -67,7 +67,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: pry
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -95,7 +95,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -109,7 +109,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: bump
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -150,6 +150,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.2
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Fog provider gem to support the Hetzner Cloud.
 email:
 - reg@elconas.de
@@ -163,6 +177,10 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- examples/Gemfile
+- examples/integrationtest.rb
+- examples/keys/.dummy
+- examples/userdata.txt
 - fog-hetznercloud.gemspec
 - lib/fog/hetznercloud.rb
 - lib/fog/hetznercloud/client.rb