ubuntu_ami 0.1 → 0.4.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6ea459dc455e28a1196699035bd176a151786f8f6676b3090251fa9a96e3de3f
+  data.tar.gz: f5b91294c206dd5d1fba6089e99c047c45b7a9cb608b6cd405fd2b185cf858b3
+SHA512:
+  metadata.gz: 59a22938260ec46e3e2862c3e9e0fd90eaf113d4342aca98149a247bb1676e65ca581ebdcab7bc3bc511c126f7b76c274e03d63db8ebdb9692ea80b61040944d
+  data.tar.gz: 111894541f28127c505c9a25a85cef92d5f475cba0afdd947d68a320fe0688ad44254c08ca29f021e491f7fff724c10a9ba05d20cb91d453c3bf0aea51eb09db

data/lib/chef/knife/ec2_amis_ubuntu.rb

@@ -0,0 +1,128 @@
+#
+# Author:: Joshua Timberman (<joshua@housepub.org>)
+# Description:: Retrieves AMI information from Canonical's AMI release list.
+#
+# Copyright:: 2011, Joshua Timberman
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'chef/knife'
+
+module KnifePlugins
+  class Ec2AmisUbuntu < Chef::Knife
+
+    deps do
+      begin
+        require 'ubuntu_ami'
+      rescue LoadError
+        Chef::Log.error("Could not load Ubuntu AMI library.")
+      end
+    end
+
+    banner "knife ec2 amis ubuntu DISTRO [TYPE] (options)"
+
+    # Substitutes dashes for underscores in region portion of type for
+    # nice display. Replaces "1" as implied for most regions.
+    #
+    # === Parameters
+    # region<String>:: comes from Ubuntu::Ami#region
+    #
+    # === Returns
+    # String:: e.g., us_east_small or us_east_small_ebs
+    def region_fix(region)
+      region.gsub(/-1/,'').gsub(/-/,'_')
+    end
+
+    # Identifies the virtualization type as HVM if image is HVM.
+    #
+    # === Parameters
+    # type<String>:: comes from Ubuntu::Ami#virtualization_type
+    #
+    # === Returns
+    # String:: "_hvm" if the #virtualization_type is HVM, otherwise empty.
+    def virt_type(type)
+      type =~ /hvm/ ? "_hvm" : ''
+    end
+
+    # Indicates whether a particular image has EBS root volume.
+    #
+    # === Parameters
+    # store<String>:: comes from Ubuntu::Ami#root_store
+    #
+    # === Returns
+    # String:: "_ebs" if the #root_store is EBS, _ebs_ssd if ebs-ssd,
+    # _ebs_io1 if provisioned IOPS, etc. Otherwise empty.
+    def disk_store(store)
+      if store =~ /ebs/
+        "_#{store.tr('-', '_')}"
+      else
+        ''
+      end
+    end
+
+    # Indicates whether the architecture type is a large or small AMI.
+    #
+    # === Parameters
+    # arch<String>:: Values can be amd64, x86_64, large, or begin with
+    # "64". Intended to be from Ubuntu::Ami#arch, but this method
+    # move to Ubuntu directly.
+    #
+    # === Returns
+    # String:: For 64 bit architectures (Ubuntu::Ami#arch #=> amd64),
+    # this will return "large". Otherwise, it returns "small".
+    def size_of(arch)
+      String(arch) =~ /(amd64|x86_64|large|^64)/ ? "large" : "small"
+    end
+
+    # Makes a nice string for the type of AMI to display, including
+    # the region, architecture size and whether the AMI has EBS root
+    # store.
+    #
+    # === Parameters
+    # region<String>:: from Ubuntu::Ami#region
+    # arch<String>:: from Ubuntu::Ami#arch
+    # root_store<String>:: from Ubuntu::Ami#root_store
+    #
+    # === Returns
+    # String:: The region, arch and root_store (if EBS) concatenated
+    # with underscore (_).
+    def build_type(region, arch, root_store, type)
+      "#{region_fix(region)}_#{size_of(arch)}#{disk_store(root_store)}#{virt_type(type)}"
+    end
+
+    # Iterates over the AMIs available for the specified distro.
+    #
+    # === Parameters
+    # distro<String>:: Release name of the distro to display.
+    #
+    # === Returns
+    # Hash:: Keys are the AMI type, values are the AMI ID.
+    def list_amis(distro)
+      amis = Hash.new
+      Ubuntu.release(distro).amis.each do |ami|
+        amis[build_type(ami.region, ami.arch, ami.root_store, ami.virtualization_type)] = ami.name
+      end
+      amis
+    end
+
+    # Runs the plugin. If TYPE (name_args[1]) is passed, then select a
+    # specified type, based on #build_type, above.
+    def run
+      distro = name_args[0]
+      type = name_args[1]
+      ami_list = list_amis(distro)[type] || list_amis(distro)
+      output(format_for_display(ami_list))
+    end
+
+  end
+end

data/lib/ubuntu_ami.rb

@@ -1,5 +1,5 @@
 #
-# Author:: Joshua Timberman (<joshua@opscode.com>)
+# Author:: Joshua Timberman (<joshua@housepub.org>), Michael Hale (<mike@hales.ws>)
 # Description:: Retrieves AMI information from Canonical's AMI release list.
 #
 # Copyright:: 2011, Joshua Timberman
@@ -16,33 +16,73 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'pp'
 require 'open-uri'
 
-class UbuntuAmi
-  def initialize(release)
-    @uri = "http://uec-images.ubuntu.com/query/#{release}/server/released.current.txt"
+class Ubuntu
+  attr_reader :release_name
+
+  def self.release(release_name)
+    instance_for_release(release_name)
+  end
+
+  def self.instance_for_release(release_name)
+    @releases ||= {}
+    @releases[release_name] ||= new(release_name)
+  end
+
+  def initialize(release_name)
+    @release_name = release_name
   end
 
-  def arch_size(arch)
-    arch =~ /amd64/ ? "large" : "small"
+  # Map the output from Canonical's image list.
+  #
+  # === Returns
+  # Array:: An array of Ubuntu::Ami objects.
+  def amis
+    content.map do |line|
+      Ami.new(
+              line.split[7],
+              line.split[4],
+              line.split[5],
+              line.split[6],
+              line.split[8..9].last)
+    end
   end
 
-  def disk_store(store)
-    "_ebs" if store =~ /ebs/
+  # The URL of Canonical's current released AMIs for the given
+  # release.
+  #
+  # Visit "http://uec-images.ubuntu.com/query" to get a list of
+  # available releases.
+  #
+  # === Returns
+  # String:: The full URL to the released AMIs.
+  def url
+    "http://uec-images.ubuntu.com/query/#{release_name}/server/released.current.txt"
   end
 
-  def region_fix(region)
-    region.gsub(/-1/,'').gsub(/-/,'_')
+  # Reads the URL for processing.
+  # === Exception
+  # Raises an exception if the release name was not specified or was
+  # not found.
+  def content
+    begin
+      @content ||= ::OpenURI.open_uri(url).read.split("\n")
+    rescue
+      raise "Could not find AMI list for distro release '#{release_name}', did you specify it correctly? (e.g., 'lucid')"
+    end
   end
 
-  def run
-    amis = {}
-    open(@uri).each do |a|
-      key = a.split[4..6]
-      ami = a.split[7]
-      amis["#{region_fix(key[2])}_#{arch_size(key[1])}#{disk_store(key[0])}"] = ami
+  # Provides accessors for the properties of the AMI list.
+  class Ami
+    attr_reader :name, :root_store, :arch, :region, :virtualization_type
+
+    def initialize(name, root_store, arch, region, virtualization_type)
+      @name = name
+      @root_store = root_store
+      @arch = arch
+      @region = region
+      @virtualization_type = virtualization_type
     end
-    amis
   end
 end

data/lib/ubuntu_ami/version.rb

@@ -0,0 +1,22 @@
+# Author:: Joshua Timberman (<joshua@housepub.org>)
+# Description:: Retrieves AMI information from Canonical's AMI release list.
+#
+# Copyright:: 2011, Joshua Timberman
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+class Ubuntu
+  class Ami
+    VERSION = '0.4.3'
+  end
+end

metadata

@@ -1,65 +1,47 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: ubuntu_ami
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 1
-  version: "0.1"
+version: !ruby/object:Gem::Version
+  version: 0.4.3
 platform: ruby
-authors: 
+authors:
 - Joshua Timberman
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-
-date: 2011-01-27 00:00:00 -07:00
-default_executable: 
+date: 2020-08-18 00:00:00.000000000 Z
 dependencies: []
-
-description: Retrieves AMI information from Canonical's Ubuntu release list.
-email: joshua@opscode.com
+description: Retrieves AMI information from Canonical's Ubuntu release list.Also provides
+  a knife plugin to retrieve the list.
+email: joshua@chef.io
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - LICENSE
-- README.md
+- lib/chef/knife/ec2_amis_ubuntu.rb
 - lib/ubuntu_ami.rb
-has_rdoc: true
-homepage: http://github.com/jtimberman/ubuntu_ami
-licenses: []
-
-post_install_message: 
+- lib/ubuntu_ami/version.rb
+homepage: https://github.com/jtimberman/ubuntu_ami
+licenses:
+- Apache-2.0
+metadata: {}
+post_install_message:
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  none: false
-  requirements: 
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
   - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: 
-rubygems_version: 1.3.7
-signing_key: 
-specification_version: 3
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
 summary: Retrieves AMI information from Canonical's Ubuntu release list.
 test_files: []
-