cfndk 0.1.0 → 0.1.1

data/README.md

@@ -2,6 +2,8 @@
 
 This is easy operation/integration support tool for AWS CloudFormation.
 
+[![CircleCI](https://circleci.com/gh/Amakata/cfndk/tree/master.svg?style=svg)](https://circleci.com/gh/Amakata/cfndk/tree/master)
+
 このツールは、AWS CloudFromationのための簡単な運用/構築サポートツールです。
 
 kumogata, SparkleFormation, CoffeeFormation など、CloudFormationのテンプレートを書かずにDSLで表現するツールには様々な物があります。
@@ -16,6 +18,10 @@ kumogata, SparkleFormation, CoffeeFormation など、CloudFormationのテンプ
 * CloudFormationでバージョンコントロールシステムと連動した継続的インテグレーションのための基盤対応
 * Keypairの作成/削除
 * コマンド、サブコマンド、冪統性を考慮したコマンドライン体系、オプションの整理、ヘルプの追加
+* チェンジセットの作成/実行/削除/レポート(experimental)
+* Keypair/スタック毎のregionのサポート
+* 512000バイト以上の大きなテンプレートファイルの場合に自動的にS3にテンプレートファイルをアップロードして処理する機能
+* cfndk全体での共通設定
 
 ## インストール
 
@@ -63,14 +69,14 @@ cfndk init
 
 ### ```create```
 
-cfndk.ymlで定義されているスタックを作成します。
+cfndk.ymlで定義されているキーペアとスタックを作成します。
 
 ```cfndk create [option]```
 
 
 ### ```destroy```
 
-cfndk.ymlで定義されているスタックを削除します。
+cfndk.ymlで定義されているるキーペアとスタックを削除します。
 
 ```
 cfndk destroy [option]
@@ -100,8 +106,44 @@ cfndk.ymlで定義されているスタックについてレポートします
 ```
 cfndk report [option]
 ```
+### ```keypair```
+
+cfndk.ymlで定義されているキーペアの作成/削除を行うサブコマンドです。
+
+詳細は
+
+```
+cfndk keypair help
+```
+
+で確認できます。
+
+### ```stack```
+
+cfndk.ymlで定義されているスタックの作成/更新/削除/レポート/テンプレート検証を行うサブコマンドです。
+
+詳細は
+
+```
+cfndk stack help
+```
 
-### [option]
+で確認できます。
+
+
+### ```changeset``` (experimental)
+
+cfndk.ymlで定義されているスタックのチェンジセットの作成/実行/削除/レポートを行うサブコマンドです。
+
+詳細は
+
+```
+cfndk changeset help
+```
+
+で確認できます。
+
+### 主なoption
 
 #### ```-v --verbose```
 
@@ -118,10 +160,25 @@ cfndi.ymlのparametersのerb内で値で参照することができます。
 
 ####  ```-u, --uuid uuid```
 
-指定されたUUIDを使用します。
-UUIDが指定されるとスタック名に付加されます。
+スタック名、チェンジセット名に指定されたUUIDを使用します。
+UUIDが指定されるとスタック名、チェンジセット名に付加されます。
 またcfndi.ymlのparametersの値で参照することができます。
-```-u```は最後に指定されたものが有効になります。
+
+スタック名は下記のようになります。
+何も指定されない場合はcfndk.ymlで定義されたスタック名がそのまま使われます。
+
+```[Stack Original Name]-[Stack's UUID]```
+
+####  ```--change-set-uuid uuid```
+
+チェンジセット名に指定されたUUIDを使用します。
+UUIDが指定されるとチェンジセット名に付加されます。
+
+このオプションが指定された場合チェンジセット名は下記のようになります。
+何も指定されない場合はチェンジセット名にはスタック名がそのまま使われます。
+
+```[Stack Name]-[Changeset's UUID]```
+
 
 #### ```--stack-names=name1 name2```
 
@@ -140,25 +197,37 @@ UUIDが指定されるとスタック名に付加されます。
 
 動作の確認メッセージと入力をスキップします。
 
+他にもオプションはあります。
+詳細はコマンドヘルプを参照してください。
+
 ## 環境変数
 
 ### ```CFNDK_UUID```
 
 この環境変数が指定されている場合、```--uuid $CFNDK_UUID```が指定されたものとして動作します。
-```-u```のほうが優先されます。
+```--uuid```のほうが優先されます。
+
+### ```CFNDK_CHANGE_SET_UUID```
 
+この環境変数が指定されている場合、```--change-set-uuid $CFNDK_CHANGE_SET_UUID```が指定されたものとして動作します。
 
 ## cfndk.yml
 
 * example
 
 ```
+global:
+  region: ap-northeast-1
+  s3_template_bucket: cfndk-templates
+  timeout_in_minutes: 10
 keypairs:
   Key1:
+    region: us-east-1
   Key2:
     key_file: key/key2<%= append_uuid %>.pem
 stacks:
   Stack1:
+    region: us-east-1
     template_file: stack1/stack1.yaml 
     parameter_input: stack1/env.json
     parameters:
@@ -177,11 +246,17 @@ stacks:
 ```
 
 ```
+global:
+  region: [String]
+  s3_template_bucket: [String]
+  timeout_in_minutes: [Integer]
 keypairs:
   [String]:
+    region: [String]
     key_file: [String]
 stacks:
   [String]:
+    region: [String]
     template_file: [String]
     parameter_input: [String]
     parameters:
@@ -196,6 +271,33 @@ stacks:
       - [String]      
 ```
 
+### ```global:```
+
+全体設定を定義します。
+
+#### region (デフォルト: us-east-1)
+
+全体で利用するリージョンを指定します。
+指定されない場合は、AWS_REGION環境変数の値をリージョンとして使用します。
+AWS_REGIONも指定されない場合はus-east-1を利用します。
+
+#### timeout_in_minutes (デフォルト: 1)
+
+全体で利用するタイムアウト時間を分で指定します。
+
+#### s3_template_bucket (デフォルト: cfndk-templates)
+
+スタックのCloudFormationテンプレートファイルをアップロードするS3のバケット名を指定します。
+
+実際のバケット名は
+```
+[region]-[s3_template_bucket]
+```
+が使用されます。
+regionはスタック毎で指定されたものを利用します。
+
+S3バケットは一日で自動的に中身のオブジェクトが削除されるように設定されます。
+
 ### ```keypairs:```
 
 ```
@@ -208,6 +310,11 @@ cfndkで管理するキーペアを定義します。
 通常は、キーペアを作成するとこの名称が利用されます。
 UUIDを利用すると、```[Keypair Original Name]-[UUID]```のような形式のキーペア名が利用されます。
 
+#### region
+
+キーペアのリージョンを指定します。
+globalのregionより優先されます。
+
 #### key_file
 
 キーペア作成時にキーペアのファイルを指定された相対パスに作成します。
@@ -232,6 +339,11 @@ stacksの配下には、管理するスタックのオリジナル名を定義
 通常は、stackを作成するとこの名称が利用されます。
 UUIDを利用すると、```[Stack Original Name]-[UUID]```のような形式のスタック名が利用されます。
 
+#### region
+
+スタックのリージョンを指定します。
+globalのregionより優先されます。
+
 #### template_file 
 
 必須。CloudFormationテンプレートファイルのパスをcfndk.ymlからの相対パスで指定します。
@@ -289,7 +401,7 @@ dependsを指定すると、create,update,create-or-changeset,destoryのコマ
       - Stack2  
 ```
 
-#### timeout_in_minutes (デフォルト: 1)
+#### timeout_in_minutes
 
 スタックを作成する際などのタイムアウト時間を分で指定します。
 
@@ -302,13 +414,13 @@ dependsを指定すると、create,update,create-or-changeset,destoryのコマ
 
   * ```append_uuid(glue='-')```
 
-    UUIDガ指定されている場合、```[glueの文字列] + [UUID]```を返します。
+    スタックのUUIDガ指定されている場合、```[glueの文字列] + [Stack's UUID]```を返します。
     UUIDが指定されてい無い場合は空文字が返ります。
     glueで接続文字を置き換えることができます。
 
   * ```uuid```
 
-    UUIDを返します。
+    スタックのUUIDを返します。
     UUIDが指定されてい無い場合は空文字が返ります。
 
   * ```properties(key)```

data/cfndk.gemspec

@@ -24,6 +24,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'aruba'
   spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'awspec'
+  spec.add_development_dependency 'parallel_tests'
 
   spec.add_dependency 'thor'
   spec.add_dependency 'rainbow'

data/lib/cfndk/change_set_command.rb

@@ -0,0 +1,97 @@
+module CFnDK
+  class ChangeSetCommand < Thor
+    include SubcommandHelpReturnable
+    include ConfigFileLoadable
+
+    class_option :verbose, type: :boolean, aliases: 'v', desc: 'More verbose output.'
+    class_option :color, type: :boolean, default: true, desc: 'Use colored output'
+    class_option :config_path, type: :string, aliases: 'c', default: "#{Dir.getwd}/cfndk.yml", desc: 'The configuration file to use'
+    class_option :stack_names, type: :array, desc: 'Target stack names'
+
+    desc 'create', 'Create change set'
+    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
+    option :change_set_uuid, type: :string, default: ENV['CFNDK_CHANGE_SET_UUID'] || nil, desc: 'Use Change Set UUID'
+    option :properties, type: :hash, aliases: 'p', default: {}, desc: 'Set property'
+    def create
+      CFnDK.logger.info 'create...'.color(:green)
+      data = load_config_data(options)
+
+      credentials = CFnDK::CredentialProviderChain.new.resolve
+      stacks = CFnDK::Stacks.new(data, options, credentials)
+      stacks.validate
+      stacks.create_change_set
+      return 0
+    rescue => e
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
+      return 1
+    end
+
+    desc 'execute', 'Execute change set'
+    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
+    option :change_set_uuid, type: :string, default: ENV['CFNDK_CHANGE_SET_UUID'] || nil, desc: 'Use Change Set UUID'
+    def execute
+      CFnDK.logger.info 'execute...'.color(:green)
+      data = load_config_data(options)
+
+      credentials = CFnDK::CredentialProviderChain.new.resolve
+      stacks = CFnDK::Stacks.new(data, options, credentials)
+      stacks.validate
+      stacks.execute_change_set
+      return 0
+    rescue => e
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
+      return 1
+    end
+
+    desc 'destroy', 'Destroy change set'
+    option :force, type: :boolean, aliases: 'f', default: false, desc: 'Say yes to all prompts for confirmation'
+    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
+    option :change_set_uuid, type: :string, default: ENV['CFNDK_CHANGE_SET_UUID'] || nil, desc: 'Use Change Set UUID'
+    def destroy
+      CFnDK.logger.info 'destroy...'.color(:green)
+      data = load_config_data(options)
+
+      credentials = CFnDK::CredentialProviderChain.new.resolve
+      stacks = CFnDK::Stacks.new(data, options, credentials)
+
+      if options[:force] || yes?('Are you sure you want to destroy? (y/n)', :yellow)
+        stacks.delete_change_set
+        return 0
+      else
+        CFnDK.logger.info 'destroy command was canceled'.color(:green)
+        return 2
+      end
+    rescue => e
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
+      return 1
+    end
+
+    desc 'report', 'Report change set'
+    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
+    option :change_set_uuid, type: :string, default: ENV['CFNDK_CHANGE_SET_UUID'] || nil, desc: 'Use Change Set UUID'
+    option :types, type: :array, default: %w(tag parameter changes), desc: 'Report type'
+    def report
+      CFnDK.logger.info 'report...'.color(:green)
+      data = load_config_data(options)
+      credentials = CFnDK::CredentialProviderChain.new.resolve
+      stacks = CFnDK::Stacks.new(data, options, credentials)
+      stacks.report_change_set
+      return 0
+    rescue => e
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
+      return 1
+    end
+  end
+end

data/lib/cfndk/command.rb

@@ -1,177 +1,4 @@
 module CFnDK
-  module SubcommandHelpReternable
-    module ClassMethods
-      def subcommand_help(cmd)
-        desc 'help [COMMAND]', 'Describe subcommands or one specific subcommand'
-        class_eval "
-          def help(command = nil, subcommand = true); super; return 2; end
-  "
-      end
-    end
-    extend ClassMethods
-    def self.included(klass)
-      klass.extend ClassMethods
-    end
-  end
-
-  module ConfigFileLoadable
-    private
-
-    def load_config_data(options)
-      raise "File does not exist. #{options[:config_path]}" unless File.file?(options[:config_path])
-      data = open(options[:config_path], 'r') { |f| YAML.load(f) }
-      return data if data
-      CFnDK.logger.error "File is empty. #{options[:config_path]}".color(:red)
-      nil
-    end
-  end
-
-  class KeyPairCommand < Thor
-    include SubcommandHelpReternable
-    include ConfigFileLoadable
-    class_option :verbose, type: :boolean, aliases: 'v', desc: 'More verbose output.'
-    class_option :color, type: :boolean, default: true, desc: 'Use colored output'
-    class_option :config_path, type: :string, aliases: 'c', default: "#{Dir.getwd}/cfndk.yml", desc: 'The configuration file to use'
-    class_option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    class_option :keypair_names, type: :array, desc: 'Target keypair names'
-
-    desc 'create', 'Create keypair'
-    option :properties, type: :hash, aliases: 'p', default: {}, desc: 'Set property'
-    def create
-      CFnDK.logger.info 'create...'.color(:green)
-      data = load_config_data(options)
-
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      keypairs = CFnDK::KeyPairs.new(data, options, credentials)
-      keypairs.create
-      return 0
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-
-    desc 'destroy', 'Destroy keypair'
-    option :force, type: :boolean, aliases: 'f', default: false, desc: 'Say yes to all prompts for confirmation'
-    def destroy
-      CFnDK.logger.info 'destroy...'.color(:green)
-      data = load_config_data(options)
-
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      keypairs = CFnDK::KeyPairs.new(data, options, credentials)
-
-      if options[:force] || yes?('Are you sure you want to destroy? (y/n)', :yellow)
-        keypairs.destroy
-        return 0
-      else
-        CFnDK.logger.info 'destroy command was canceled'.color(:green)
-        return 2
-      end
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-  end
-
-  class StackCommand < Thor
-    include SubcommandHelpReternable
-    include ConfigFileLoadable
-
-    class_option :verbose, type: :boolean, aliases: 'v', desc: 'More verbose output.'
-    class_option :color, type: :boolean, default: true, desc: 'Use colored output'
-    class_option :config_path, type: :string, aliases: 'c', default: "#{Dir.getwd}/cfndk.yml", desc: 'The configuration file to use'
-    class_option :stack_names, type: :array, desc: 'Target stack names'
-
-    desc 'create', 'Create stack'
-    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    option :properties, type: :hash, aliases: 'p', default: {}, desc: 'Set property'
-    def create
-      CFnDK.logger.info 'create...'.color(:green)
-      data = load_config_data(options)
-
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      stacks = CFnDK::Stacks.new(data, options, credentials)
-      stacks.validate
-      stacks.create
-      return 0
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-
-    desc 'update', 'Update stack'
-    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    option :properties, type: :hash, aliases: 'p', default: {}, desc: 'Set property'
-    def update
-      CFnDK.logger.info 'update...'.color(:green)
-      data = load_config_data(options)
-
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      stacks = CFnDK::Stacks.new(data, options, credentials)
-      stacks.validate
-      stacks.update
-      return 0
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-
-    desc 'destroy', 'Destroy stack'
-    option :force, type: :boolean, aliases: 'f', default: false, desc: 'Say yes to all prompts for confirmation'
-    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    def destroy
-      CFnDK.logger.info 'destroy...'.color(:green)
-      data = load_config_data(options)
-
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      stacks = CFnDK::Stacks.new(data, options, credentials)
-
-      if options[:force] || yes?('Are you sure you want to destroy? (y/n)', :yellow)
-        stacks.destroy
-        return 0
-      else
-        CFnDK.logger.info 'destroy command was canceled'.color(:green)
-        return 2
-      end
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-
-    desc 'validate', 'Validate stack'
-    def validate
-      CFnDK.logger.info 'validate...'.color(:green)
-      data = load_config_data(options)
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      stacks = CFnDK::Stacks.new(data, options, credentials)
-      stacks.validate
-      return 0
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-
-    desc 'report', 'Report stack'
-    option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    def report
-      CFnDK.logger.info 'report...'.color(:green)
-      data = load_config_data(options)
-      credentials = CFnDK::CredentialProviderChain.new.resolve
-      stacks = CFnDK::Stacks.new(data, options, credentials)
-      stacks.report
-      return 0
-    rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
-      return 1
-    end
-  end
-
   class Command < Thor
     include Thor::Actions
     include ConfigFileLoadable
@@ -232,8 +59,10 @@ module CFnDK
       stacks.create
       return 0
     rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
       return 1
     end
 
@@ -241,8 +70,6 @@ module CFnDK
     option :config_path, type: :string, aliases: 'c', default: "#{Dir.getwd}/cfndk.yml", desc: 'The configuration file to use'
     option :force, type: :boolean, aliases: 'f', default: false, desc: 'Say yes to all prompts for confirmation'
     option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
-    option :stack_names, type: :array, desc: 'Target stack names'
-    option :keypair_names, type: :array, desc: 'Target keypair names'
     def destroy
       CFnDK.logger.info 'destroy...'.color(:green)
       data = load_config_data(options)
@@ -260,8 +87,10 @@ module CFnDK
         return 2
       end
     rescue => e
-      CFnDK.logger.error "(#{e.class}) #{e.message}".color(:red)
-      CFnDK.logger.debug e.backtrace
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
       return 1
     end
 
@@ -269,6 +98,7 @@ module CFnDK
     option :config_path, type: :string, aliases: 'c', default: "#{Dir.getwd}/cfndk.yml", desc: 'The configuration file to use'
     option :uuid, type: :string, aliases: 'u', default: ENV['CFNDK_UUID'] || nil, desc: 'Use UUID'
     option :stack_names, type: :array, desc: 'Target stack names'
+    option :types, type: :array, default: %w(tag output parameter resource event), desc: 'Report type'
     def report
       CFnDK.logger.info 'report...'.color(:green)
 
@@ -279,8 +109,10 @@ module CFnDK
       stacks.report
       return 0
     rescue => e
-      CFnDK.logger.error e.message.color(:red)
-      CFnDK.logger.debug e.backtrace
+      CFnDK.logger.error "#{e.class}: #{e.message}".color(:red)
+      e.backtrace_locations.each do |line|
+        CFnDK.logger.debug line
+      end
       return 1
     end
 
@@ -296,5 +128,7 @@ module CFnDK
     subcommand 'keypair', KeyPairCommand
     desc 'stack SUBCOMMAND ...ARGS', 'Manage stack'
     subcommand 'stack', StackCommand
+    desc 'changeset SUBCOMMAND ...ARGS', 'Manage change set'
+    subcommand 'changeset', ChangeSetCommand
   end
 end

data/lib/cfndk/config_file_loadable.rb

@@ -0,0 +1,13 @@
+module CFnDK
+  module ConfigFileLoadable
+    private
+
+    def load_config_data(options)
+      raise "File does not exist. #{options[:config_path]}" unless File.file?(options[:config_path])
+      data = open(options[:config_path], 'r') { |f| YAML.load(f) }
+      return data if data
+      CFnDK.logger.error "File is empty. #{options[:config_path]}".color(:red)
+      nil
+    end
+  end
+end

data/lib/cfndk/global_config.rb

@@ -0,0 +1,15 @@
+module CFnDK
+  class GlobalConfig
+    attr_reader :timeout_in_minutes, :s3_template_bucket, :s3_template_hash, :region
+    def initialize(data, option)
+      @timeout_in_minutes = 1
+      @s3_template_bucket = 'cfndk-templates'
+      @s3_template_hash = SecureRandom.uuid
+      @region = ENV['AWS_REGION'] || 'us-east-1'
+      return unless data['global'].is_a?(Hash)
+      @timeout_in_minutes = data['global']['timeout_in_minutes'] || 1
+      @s3_template_bucket = data['global']['s3_template_bucket'] || 'cfndk-templates'
+      @region = data['global']['region'] || ENV['AWS_REGION'] || 'us-east-1'
+    end
+  end
+end

data/lib/cfndk/key_pair.rb

@@ -1,12 +1,14 @@
 module CFnDK
   class KeyPair
     attr_reader :key_file
-    def initialize(name, data, option, credentials)
+    def initialize(name, data, option, global_config, credentials)
+      @global_config = global_config
       @name = name
-      @key_file = nil
-      @key_file = data['key_file'] || nil if data
+      data = {} unless data
+      @key_file = data['key_file'] || nil
+      @region = data['region'] || @global_config.region
       @option = option
-      @client = Aws::EC2::Client.new(credentials: credentials)
+      @client = Aws::EC2::Client.new(credentials: credentials, region: @region)
     end
 
     def create
@@ -55,6 +57,7 @@ module CFnDK
       return unless @key_file
       key_file = CFnDK::ErbString.new(@key_file, @option).value
       CFnDK.logger.info(('create key file: ' + key_file).color(:green))
+      FileUtils.mkdir_p(File.dirname(key_file))
       File.write(key_file, key_pair.key_material)
     end
   end