nucleon 0.2.1 → 0.2.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (144) hide show
  1. checksums.yaml +4 -4
  2. data/VERSION +1 -1
  3. data/lib/core/config.rb +1 -1
  4. data/lib/core/core.rb +2 -2
  5. data/lib/core/environment.rb +9 -6
  6. data/lib/core/facade.rb +2 -2
  7. data/lib/core/gems.rb +13 -6
  8. data/lib/core/manager.rb +12 -5
  9. data/lib/core/mixin/action/commit.rb +12 -6
  10. data/lib/core/mixin/action/project.rb +15 -28
  11. data/lib/core/mixin/action/push.rb +14 -5
  12. data/lib/core/mixin/action/registration.rb +277 -28
  13. data/lib/core/mixin/macro/object_interface.rb +3 -3
  14. data/lib/core/mixin/sub_config.rb +1 -1
  15. data/lib/core/plugin/action.rb +20 -51
  16. data/lib/core/plugin/base.rb +41 -8
  17. data/lib/core/plugin/project.rb +55 -8
  18. data/lib/nucleon/action/project/add.rb +6 -20
  19. data/lib/nucleon/action/project/create.rb +2 -2
  20. data/lib/nucleon/action/project/remove.rb +3 -3
  21. data/lib/nucleon/action/project/save.rb +3 -3
  22. data/lib/nucleon/action/project/update.rb +2 -2
  23. data/lib/nucleon/extension/project.rb +16 -0
  24. data/lib/nucleon/project/git.rb +1 -0
  25. data/lib/nucleon/project/github.rb +19 -7
  26. data/nucleon.gemspec +120 -2
  27. data/rdoc/site/0.2.1/ARCHITECTURE_rdoc.html +640 -0
  28. data/rdoc/site/0.2.1/Hash.html +353 -0
  29. data/rdoc/site/0.2.1/Kernel.html +420 -0
  30. data/rdoc/site/0.2.1/Nucleon.html +674 -0
  31. data/rdoc/site/0.2.1/Nucleon/Action.html +286 -0
  32. data/rdoc/site/0.2.1/Nucleon/Action/Extract.html +457 -0
  33. data/rdoc/site/0.2.1/Nucleon/Action/Project.html +285 -0
  34. data/rdoc/site/0.2.1/Nucleon/Action/Project/Add.html +502 -0
  35. data/rdoc/site/0.2.1/Nucleon/Action/Project/Create.html +459 -0
  36. data/rdoc/site/0.2.1/Nucleon/Action/Project/Remove.html +505 -0
  37. data/rdoc/site/0.2.1/Nucleon/Action/Project/Save.html +478 -0
  38. data/rdoc/site/0.2.1/Nucleon/Action/Project/Update.html +425 -0
  39. data/rdoc/site/0.2.1/Nucleon/Codes.html +569 -0
  40. data/rdoc/site/0.2.1/Nucleon/Command.html +281 -0
  41. data/rdoc/site/0.2.1/Nucleon/Command/Bash.html +550 -0
  42. data/rdoc/site/0.2.1/Nucleon/Config.html +1634 -0
  43. data/rdoc/site/0.2.1/Nucleon/Config/Collection.html +515 -0
  44. data/rdoc/site/0.2.1/Nucleon/Config/Options.html +495 -0
  45. data/rdoc/site/0.2.1/Nucleon/Core.html +641 -0
  46. data/rdoc/site/0.2.1/Nucleon/Environment.html +1210 -0
  47. data/rdoc/site/0.2.1/Nucleon/Errors.html +281 -0
  48. data/rdoc/site/0.2.1/Nucleon/Errors/BatchError.html +287 -0
  49. data/rdoc/site/0.2.1/Nucleon/Errors/NucleonError.html +663 -0
  50. data/rdoc/site/0.2.1/Nucleon/Errors/SSHUnavailable.html +287 -0
  51. data/rdoc/site/0.2.1/Nucleon/Event.html +281 -0
  52. data/rdoc/site/0.2.1/Nucleon/Event/Regex.html +473 -0
  53. data/rdoc/site/0.2.1/Nucleon/Facade.html +2452 -0
  54. data/rdoc/site/0.2.1/Nucleon/Gems.html +641 -0
  55. data/rdoc/site/0.2.1/Nucleon/Manager.html +1862 -0
  56. data/rdoc/site/0.2.1/Nucleon/Mixin.html +291 -0
  57. data/rdoc/site/0.2.1/Nucleon/Mixin/Action.html +284 -0
  58. data/rdoc/site/0.2.1/Nucleon/Mixin/Action/Commit.html +387 -0
  59. data/rdoc/site/0.2.1/Nucleon/Mixin/Action/Project.html +401 -0
  60. data/rdoc/site/0.2.1/Nucleon/Mixin/Action/Push.html +377 -0
  61. data/rdoc/site/0.2.1/Nucleon/Mixin/Action/Registration.html +575 -0
  62. data/rdoc/site/0.2.1/Nucleon/Mixin/Colors.html +551 -0
  63. data/rdoc/site/0.2.1/Nucleon/Mixin/ConfigCollection.html +487 -0
  64. data/rdoc/site/0.2.1/Nucleon/Mixin/ConfigOptions.html +455 -0
  65. data/rdoc/site/0.2.1/Nucleon/Mixin/Macro.html +282 -0
  66. data/rdoc/site/0.2.1/Nucleon/Mixin/Macro/ObjectInterface.html +701 -0
  67. data/rdoc/site/0.2.1/Nucleon/Mixin/Macro/PluginInterface.html +688 -0
  68. data/rdoc/site/0.2.1/Nucleon/Mixin/Settings.html +487 -0
  69. data/rdoc/site/0.2.1/Nucleon/Mixin/SubConfig.html +893 -0
  70. data/rdoc/site/0.2.1/Nucleon/Parallel.html +332 -0
  71. data/rdoc/site/0.2.1/Nucleon/Parallel/ClassMethods.html +331 -0
  72. data/rdoc/site/0.2.1/Nucleon/Parallel/InstanceMethods.html +458 -0
  73. data/rdoc/site/0.2.1/Nucleon/Plugin.html +288 -0
  74. data/rdoc/site/0.2.1/Nucleon/Plugin/Action.html +2133 -0
  75. data/rdoc/site/0.2.1/Nucleon/Plugin/Action/Option.html +465 -0
  76. data/rdoc/site/0.2.1/Nucleon/Plugin/Base.html +1988 -0
  77. data/rdoc/site/0.2.1/Nucleon/Plugin/Command.html +765 -0
  78. data/rdoc/site/0.2.1/Nucleon/Plugin/Event.html +448 -0
  79. data/rdoc/site/0.2.1/Nucleon/Plugin/Extension.html +287 -0
  80. data/rdoc/site/0.2.1/Nucleon/Plugin/Project.html +2900 -0
  81. data/rdoc/site/0.2.1/Nucleon/Plugin/Template.html +482 -0
  82. data/rdoc/site/0.2.1/Nucleon/Plugin/Translator.html +377 -0
  83. data/rdoc/site/0.2.1/Nucleon/Project.html +282 -0
  84. data/rdoc/site/0.2.1/Nucleon/Project/Git.html +1807 -0
  85. data/rdoc/site/0.2.1/Nucleon/Project/Github.html +555 -0
  86. data/rdoc/site/0.2.1/Nucleon/Template.html +283 -0
  87. data/rdoc/site/0.2.1/Nucleon/Template/JSON.html +335 -0
  88. data/rdoc/site/0.2.1/Nucleon/Template/Wrapper.html +335 -0
  89. data/rdoc/site/0.2.1/Nucleon/Template/YAML.html +335 -0
  90. data/rdoc/site/0.2.1/Nucleon/Translator.html +282 -0
  91. data/rdoc/site/0.2.1/Nucleon/Translator/JSON.html +372 -0
  92. data/rdoc/site/0.2.1/Nucleon/Translator/YAML.html +372 -0
  93. data/rdoc/site/0.2.1/Nucleon/Util.html +291 -0
  94. data/rdoc/site/0.2.1/Nucleon/Util/CLI.html +394 -0
  95. data/rdoc/site/0.2.1/Nucleon/Util/CLI/Parser.html +1404 -0
  96. data/rdoc/site/0.2.1/Nucleon/Util/Cache.html +824 -0
  97. data/rdoc/site/0.2.1/Nucleon/Util/Console.html +1330 -0
  98. data/rdoc/site/0.2.1/Nucleon/Util/Data.html +1423 -0
  99. data/rdoc/site/0.2.1/Nucleon/Util/Disk.html +528 -0
  100. data/rdoc/site/0.2.1/Nucleon/Util/Git.html +367 -0
  101. data/rdoc/site/0.2.1/Nucleon/Util/Liquid.html +371 -0
  102. data/rdoc/site/0.2.1/Nucleon/Util/Logger.html +822 -0
  103. data/rdoc/site/0.2.1/Nucleon/Util/Package.html +564 -0
  104. data/rdoc/site/0.2.1/Nucleon/Util/SSH.html +1036 -0
  105. data/rdoc/site/0.2.1/Nucleon/Util/SSH/Keypair.html +607 -0
  106. data/rdoc/site/0.2.1/Nucleon/Util/Shell.html +697 -0
  107. data/rdoc/site/0.2.1/Nucleon/Util/Shell/Result.html +503 -0
  108. data/rdoc/site/0.2.1/README_rdoc.html +318 -0
  109. data/rdoc/site/0.2.1/TODO_rdoc.html +267 -0
  110. data/rdoc/site/0.2.1/created.rid +62 -0
  111. data/rdoc/site/0.2.1/images/add.png +0 -0
  112. data/rdoc/site/0.2.1/images/brick.png +0 -0
  113. data/rdoc/site/0.2.1/images/brick_link.png +0 -0
  114. data/rdoc/site/0.2.1/images/bug.png +0 -0
  115. data/rdoc/site/0.2.1/images/bullet_black.png +0 -0
  116. data/rdoc/site/0.2.1/images/bullet_toggle_minus.png +0 -0
  117. data/rdoc/site/0.2.1/images/bullet_toggle_plus.png +0 -0
  118. data/rdoc/site/0.2.1/images/date.png +0 -0
  119. data/rdoc/site/0.2.1/images/delete.png +0 -0
  120. data/rdoc/site/0.2.1/images/find.png +0 -0
  121. data/rdoc/site/0.2.1/images/loadingAnimation.gif +0 -0
  122. data/rdoc/site/0.2.1/images/macFFBgHack.png +0 -0
  123. data/rdoc/site/0.2.1/images/package.png +0 -0
  124. data/rdoc/site/0.2.1/images/page_green.png +0 -0
  125. data/rdoc/site/0.2.1/images/page_white_text.png +0 -0
  126. data/rdoc/site/0.2.1/images/page_white_width.png +0 -0
  127. data/rdoc/site/0.2.1/images/plugin.png +0 -0
  128. data/rdoc/site/0.2.1/images/ruby.png +0 -0
  129. data/rdoc/site/0.2.1/images/tag_blue.png +0 -0
  130. data/rdoc/site/0.2.1/images/tag_green.png +0 -0
  131. data/rdoc/site/0.2.1/images/transparent.png +0 -0
  132. data/rdoc/site/0.2.1/images/wrench.png +0 -0
  133. data/rdoc/site/0.2.1/images/wrench_orange.png +0 -0
  134. data/rdoc/site/0.2.1/images/zoom.png +0 -0
  135. data/rdoc/site/0.2.1/index.html +317 -0
  136. data/rdoc/site/0.2.1/js/darkfish.js +155 -0
  137. data/rdoc/site/0.2.1/js/jquery.js +18 -0
  138. data/rdoc/site/0.2.1/js/navigation.js +142 -0
  139. data/rdoc/site/0.2.1/js/search.js +94 -0
  140. data/rdoc/site/0.2.1/js/search_index.js +1 -0
  141. data/rdoc/site/0.2.1/js/searcher.js +228 -0
  142. data/rdoc/site/0.2.1/rdoc.css +543 -0
  143. data/rdoc/site/0.2.1/table_of_contents.html +1718 -0
  144. metadata +120 -2
data/rdoc/site/0.2.1/Nucleon/Util/SSH.html ADDED
@@ -0,0 +1,1036 @@
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
6
+
7
+ <title>class Nucleon::Util::SSH - nucleon 0.2.1</title>
8
+
9
+ <link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet">
10
+
11
+ <script type="text/javascript">
12
+ var rdoc_rel_prefix = "../../";
13
+ </script>
14
+
15
+ <script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
16
+ <script type="text/javascript" charset="utf-8" src="../../js/navigation.js"></script>
17
+ <script type="text/javascript" charset="utf-8" src="../../js/search_index.js"></script>
18
+ <script type="text/javascript" charset="utf-8" src="../../js/search.js"></script>
19
+ <script type="text/javascript" charset="utf-8" src="../../js/searcher.js"></script>
20
+ <script type="text/javascript" charset="utf-8" src="../../js/darkfish.js"></script>
21
+
22
+
23
+ <body id="top" class="class">
24
+ <nav id="metadata">
25
+ <nav id="home-section" class="section">
26
+ <h3 class="section-header">
27
+ <a href="../../index.html">Home</a>
28
+ <a href="../../table_of_contents.html#classes">Classes</a>
29
+ <a href="../../table_of_contents.html#methods">Methods</a>
30
+ </h3>
31
+ </nav>
32
+
33
+
34
+ <nav id="search-section" class="section project-section" class="initially-hidden">
35
+ <form action="#" method="get" accept-charset="utf-8">
36
+ <h3 class="section-header">
37
+ <input type="text" name="search" placeholder="Search" id="search-field"
38
+ title="Type to search, Up and Down to navigate, Enter to load">
39
+ </h3>
40
+ </form>
41
+
42
+ <ul id="search-results" class="initially-hidden"></ul>
43
+ </nav>
44
+
45
+
46
+ <div id="file-metadata">
47
+ <nav id="file-list-section" class="section">
48
+ <h3 class="section-header">Defined In</h3>
49
+ <ul>
50
+ <li>lib/core/util/ssh.rb
51
+ </ul>
52
+ </nav>
53
+
54
+
55
+ </div>
56
+
57
+ <div id="class-metadata">
58
+
59
+ <nav id="parent-class-section" class="section">
60
+ <h3 class="section-header">Parent</h3>
61
+
62
+ <p class="link"><a href="../Core.html">Nucleon::Core</a>
63
+
64
+ </nav>
65
+
66
+
67
+ <!-- Method Quickref -->
68
+ <nav id="method-list-section" class="section">
69
+ <h3 class="section-header">Methods</h3>
70
+
71
+ <ul class="link-list">
72
+
73
+ <li><a href="#method-c-close">::close</a>
74
+
75
+ <li><a href="#method-c-close_session">::close_session</a>
76
+
77
+ <li><a href="#method-c-download">::download</a>
78
+
79
+ <li><a href="#method-c-exec">::exec</a>
80
+
81
+ <li><a href="#method-c-generate">::generate</a>
82
+
83
+ <li><a href="#method-c-init_session">::init_session</a>
84
+
85
+ <li><a href="#method-c-key_path">::key_path</a>
86
+
87
+ <li><a href="#method-c-session">::session</a>
88
+
89
+ <li><a href="#method-c-session_id">::session_id</a>
90
+
91
+ <li><a href="#method-c-terminal">::terminal</a>
92
+
93
+ <li><a href="#method-c-unlock_private_key">::unlock_private_key</a>
94
+
95
+ <li><a href="#method-c-upload">::upload</a>
96
+
97
+ <li><a href="#method-c-valid-3F">::valid?</a>
98
+
99
+ </ul>
100
+ </nav>
101
+
102
+ </div>
103
+
104
+ <div id="project-metadata">
105
+ <nav id="fileindex-section" class="section project-section">
106
+ <h3 class="section-header">Pages</h3>
107
+
108
+ <ul>
109
+
110
+ <li class="file"><a href="../../ARCHITECTURE_rdoc.html">ARCHITECTURE</a>
111
+
112
+ <li class="file"><a href="../../README_rdoc.html">README</a>
113
+
114
+ <li class="file"><a href="../../TODO_rdoc.html">TODO</a>
115
+
116
+ </ul>
117
+ </nav>
118
+
119
+ <nav id="classindex-section" class="section project-section">
120
+ <h3 class="section-header">Class and Module Index</h3>
121
+
122
+ <ul class="link-list">
123
+
124
+ <li><a href="../../Nucleon.html">Nucleon</a>
125
+
126
+ <li><a href="../../Nucleon/Action.html">Nucleon::Action</a>
127
+
128
+ <li><a href="../../Nucleon/Action/Extract.html">Nucleon::Action::Extract</a>
129
+
130
+ <li><a href="../../Nucleon/Action/Project.html">Nucleon::Action::Project</a>
131
+
132
+ <li><a href="../../Nucleon/Action/Project/Add.html">Nucleon::Action::Project::Add</a>
133
+
134
+ <li><a href="../../Nucleon/Action/Project/Create.html">Nucleon::Action::Project::Create</a>
135
+
136
+ <li><a href="../../Nucleon/Action/Project/Remove.html">Nucleon::Action::Project::Remove</a>
137
+
138
+ <li><a href="../../Nucleon/Action/Project/Save.html">Nucleon::Action::Project::Save</a>
139
+
140
+ <li><a href="../../Nucleon/Action/Project/Update.html">Nucleon::Action::Project::Update</a>
141
+
142
+ <li><a href="../../Nucleon/Codes.html">Nucleon::Codes</a>
143
+
144
+ <li><a href="../../Nucleon/Command.html">Nucleon::Command</a>
145
+
146
+ <li><a href="../../Nucleon/Command/Bash.html">Nucleon::Command::Bash</a>
147
+
148
+ <li><a href="../../Nucleon/Config.html">Nucleon::Config</a>
149
+
150
+ <li><a href="../../Nucleon/Config/Collection.html">Nucleon::Config::Collection</a>
151
+
152
+ <li><a href="../../Nucleon/Config/Options.html">Nucleon::Config::Options</a>
153
+
154
+ <li><a href="../../Nucleon/Core.html">Nucleon::Core</a>
155
+
156
+ <li><a href="../../Nucleon/Environment.html">Nucleon::Environment</a>
157
+
158
+ <li><a href="../../Nucleon/Errors.html">Nucleon::Errors</a>
159
+
160
+ <li><a href="../../Nucleon/Errors/BatchError.html">Nucleon::Errors::BatchError</a>
161
+
162
+ <li><a href="../../Nucleon/Errors/NucleonError.html">Nucleon::Errors::NucleonError</a>
163
+
164
+ <li><a href="../../Nucleon/Errors/SSHUnavailable.html">Nucleon::Errors::SSHUnavailable</a>
165
+
166
+ <li><a href="../../Nucleon/Event.html">Nucleon::Event</a>
167
+
168
+ <li><a href="../../Nucleon/Event/Regex.html">Nucleon::Event::Regex</a>
169
+
170
+ <li><a href="../../Nucleon/Facade.html">Nucleon::Facade</a>
171
+
172
+ <li><a href="../../Nucleon/Gems.html">Nucleon::Gems</a>
173
+
174
+ <li><a href="../../Nucleon/Manager.html">Nucleon::Manager</a>
175
+
176
+ <li><a href="../../Nucleon/Mixin.html">Nucleon::Mixin</a>
177
+
178
+ <li><a href="../../Nucleon/Mixin/Action.html">Nucleon::Mixin::Action</a>
179
+
180
+ <li><a href="../../Nucleon/Mixin/Action/Commit.html">Nucleon::Mixin::Action::Commit</a>
181
+
182
+ <li><a href="../../Nucleon/Mixin/Action/Project.html">Nucleon::Mixin::Action::Project</a>
183
+
184
+ <li><a href="../../Nucleon/Mixin/Action/Push.html">Nucleon::Mixin::Action::Push</a>
185
+
186
+ <li><a href="../../Nucleon/Mixin/Action/Registration.html">Nucleon::Mixin::Action::Registration</a>
187
+
188
+ <li><a href="../../Nucleon/Mixin/Colors.html">Nucleon::Mixin::Colors</a>
189
+
190
+ <li><a href="../../Nucleon/Mixin/ConfigCollection.html">Nucleon::Mixin::ConfigCollection</a>
191
+
192
+ <li><a href="../../Nucleon/Mixin/ConfigOptions.html">Nucleon::Mixin::ConfigOptions</a>
193
+
194
+ <li><a href="../../Nucleon/Mixin/Macro.html">Nucleon::Mixin::Macro</a>
195
+
196
+ <li><a href="../../Nucleon/Mixin/Macro/ObjectInterface.html">Nucleon::Mixin::Macro::ObjectInterface</a>
197
+
198
+ <li><a href="../../Nucleon/Mixin/Macro/PluginInterface.html">Nucleon::Mixin::Macro::PluginInterface</a>
199
+
200
+ <li><a href="../../Nucleon/Mixin/Settings.html">Nucleon::Mixin::Settings</a>
201
+
202
+ <li><a href="../../Nucleon/Mixin/SubConfig.html">Nucleon::Mixin::SubConfig</a>
203
+
204
+ <li><a href="../../Nucleon/Parallel.html">Nucleon::Parallel</a>
205
+
206
+ <li><a href="../../Nucleon/Parallel/ClassMethods.html">Nucleon::Parallel::ClassMethods</a>
207
+
208
+ <li><a href="../../Nucleon/Parallel/InstanceMethods.html">Nucleon::Parallel::InstanceMethods</a>
209
+
210
+ <li><a href="../../Nucleon/Plugin.html">Nucleon::Plugin</a>
211
+
212
+ <li><a href="../../Nucleon/Plugin/Action.html">Nucleon::Plugin::Action</a>
213
+
214
+ <li><a href="../../Nucleon/Plugin/Action/Option.html">Nucleon::Plugin::Action::Option</a>
215
+
216
+ <li><a href="../../Nucleon/Plugin/Base.html">Nucleon::Plugin::Base</a>
217
+
218
+ <li><a href="../../Nucleon/Plugin/Command.html">Nucleon::Plugin::Command</a>
219
+
220
+ <li><a href="../../Nucleon/Plugin/Event.html">Nucleon::Plugin::Event</a>
221
+
222
+ <li><a href="../../Nucleon/Plugin/Extension.html">Nucleon::Plugin::Extension</a>
223
+
224
+ <li><a href="../../Nucleon/Plugin/Project.html">Nucleon::Plugin::Project</a>
225
+
226
+ <li><a href="../../Nucleon/Plugin/Template.html">Nucleon::Plugin::Template</a>
227
+
228
+ <li><a href="../../Nucleon/Plugin/Translator.html">Nucleon::Plugin::Translator</a>
229
+
230
+ <li><a href="../../Nucleon/Project.html">Nucleon::Project</a>
231
+
232
+ <li><a href="../../Nucleon/Project/Git.html">Nucleon::Project::Git</a>
233
+
234
+ <li><a href="../../Nucleon/Project/Github.html">Nucleon::Project::Github</a>
235
+
236
+ <li><a href="../../Nucleon/Template.html">Nucleon::Template</a>
237
+
238
+ <li><a href="../../Nucleon/Template/JSON.html">Nucleon::Template::JSON</a>
239
+
240
+ <li><a href="../../Nucleon/Template/Wrapper.html">Nucleon::Template::Wrapper</a>
241
+
242
+ <li><a href="../../Nucleon/Template/YAML.html">Nucleon::Template::YAML</a>
243
+
244
+ <li><a href="../../Nucleon/Translator.html">Nucleon::Translator</a>
245
+
246
+ <li><a href="../../Nucleon/Translator/JSON.html">Nucleon::Translator::JSON</a>
247
+
248
+ <li><a href="../../Nucleon/Translator/YAML.html">Nucleon::Translator::YAML</a>
249
+
250
+ <li><a href="../../Nucleon/Util.html">Nucleon::Util</a>
251
+
252
+ <li><a href="../../Nucleon/Util/CLI.html">Nucleon::Util::CLI</a>
253
+
254
+ <li><a href="../../Nucleon/Util/CLI/Parser.html">Nucleon::Util::CLI::Parser</a>
255
+
256
+ <li><a href="../../Nucleon/Util/Cache.html">Nucleon::Util::Cache</a>
257
+
258
+ <li><a href="../../Nucleon/Util/Console.html">Nucleon::Util::Console</a>
259
+
260
+ <li><a href="../../Nucleon/Util/Data.html">Nucleon::Util::Data</a>
261
+
262
+ <li><a href="../../Nucleon/Util/Disk.html">Nucleon::Util::Disk</a>
263
+
264
+ <li><a href="../../Nucleon/Util/Git.html">Nucleon::Util::Git</a>
265
+
266
+ <li><a href="../../Nucleon/Util/Liquid.html">Nucleon::Util::Liquid</a>
267
+
268
+ <li><a href="../../Nucleon/Util/Logger.html">Nucleon::Util::Logger</a>
269
+
270
+ <li><a href="../../Nucleon/Util/Package.html">Nucleon::Util::Package</a>
271
+
272
+ <li><a href="../../Nucleon/Util/SSH.html">Nucleon::Util::SSH</a>
273
+
274
+ <li><a href="../../Nucleon/Util/SSH/Keypair.html">Nucleon::Util::SSH::Keypair</a>
275
+
276
+ <li><a href="../../Nucleon/Util/Shell.html">Nucleon::Util::Shell</a>
277
+
278
+ <li><a href="../../Nucleon/Util/Shell/Result.html">Nucleon::Util::Shell::Result</a>
279
+
280
+ <li><a href="../../Hash.html">Hash</a>
281
+
282
+ <li><a href="../../Kernel.html">Kernel</a>
283
+
284
+ </ul>
285
+ </nav>
286
+
287
+ </div>
288
+ </nav>
289
+
290
+ <div id="documentation">
291
+ <h1 class="class">class Nucleon::Util::SSH</h1>
292
+
293
+ <div id="description" class="description">
294
+
295
+ </div><!-- description -->
296
+
297
+
298
+
299
+
300
+ <section id="5Buntitled-5D" class="documentation-section">
301
+
302
+
303
+
304
+
305
+
306
+
307
+
308
+
309
+ <!-- Methods -->
310
+
311
+ <section id="public-class-5Buntitled-5D-method-details" class="method-section section">
312
+ <h3 class="section-header">Public Class Methods</h3>
313
+
314
+
315
+ <div id="method-c-close" class="method-detail ">
316
+
317
+ <div class="method-heading">
318
+ <span class="method-name">close</span><span
319
+ class="method-args">(hostname = nil, user = nil)</span>
320
+ <span class="method-click-advice">click to toggle source</span>
321
+ </div>
322
+
323
+
324
+ <div class="method-description">
325
+
326
+
327
+
328
+
329
+
330
+ <div class="method-source-code" id="close-source">
331
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 214</span>
332
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">close</span>(<span class="ruby-identifier">hostname</span> = <span class="ruby-keyword">nil</span>, <span class="ruby-identifier">user</span> = <span class="ruby-keyword">nil</span>)
333
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">hostname</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">user</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-comment"># Assume we entered a session id</span>
334
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">hostname</span>)
335
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">hostname</span>].<span class="ruby-identifier">close</span>
336
+ <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">hostname</span>)
337
+ <span class="ruby-keyword">end</span>
338
+
339
+ <span class="ruby-keyword">elsif</span> <span class="ruby-identifier">hostname</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">user</span> <span class="ruby-comment"># Generate session id from args</span>
340
+ <span class="ruby-identifier">session_id</span> = <span class="ruby-identifier">session_id</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>)
341
+
342
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">session_id</span>)
343
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>].<span class="ruby-identifier">close</span>
344
+ <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">session_id</span>)
345
+ <span class="ruby-keyword">end</span>
346
+
347
+ <span class="ruby-keyword">else</span> <span class="ruby-comment"># Close all connections</span>
348
+ <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">id</span><span class="ruby-operator">|</span>
349
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">id</span>].<span class="ruby-identifier">close</span>
350
+ <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">id</span>)
351
+ <span class="ruby-keyword">end</span>
352
+ <span class="ruby-keyword">end</span>
353
+ <span class="ruby-keyword">end</span></pre>
354
+ </div><!-- close-source -->
355
+
356
+ </div>
357
+
358
+
359
+
360
+
361
+ </div><!-- close-method -->
362
+
363
+
364
+ <div id="method-c-close_session" class="method-detail ">
365
+
366
+ <div class="method-heading">
367
+ <span class="method-name">close_session</span><span
368
+ class="method-args">(hostname, user)</span>
369
+ <span class="method-click-advice">click to toggle source</span>
370
+ </div>
371
+
372
+
373
+ <div class="method-description">
374
+
375
+
376
+
377
+
378
+
379
+ <div class="method-source-code" id="close_session-source">
380
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 200</span>
381
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">close_session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>)
382
+ <span class="ruby-identifier">session_id</span> = <span class="ruby-identifier">session_id</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>)
383
+
384
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">session_id</span>)
385
+ <span class="ruby-keyword">begin</span> <span class="ruby-comment"># Don&#39;t care about errors here</span>
386
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>].<span class="ruby-identifier">close</span>
387
+ <span class="ruby-keyword">rescue</span>
388
+ <span class="ruby-keyword">end</span>
389
+ <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-identifier">session_id</span>)
390
+ <span class="ruby-keyword">end</span>
391
+ <span class="ruby-keyword">end</span></pre>
392
+ </div><!-- close_session-source -->
393
+
394
+ </div>
395
+
396
+
397
+
398
+
399
+ </div><!-- close_session-method -->
400
+
401
+
402
+ <div id="method-c-download" class="method-detail ">
403
+
404
+ <div class="method-heading">
405
+ <span class="method-name">download</span><span
406
+ class="method-args">(hostname, user, remote_path, local_path, options = {}) { |name, received, total| ... }</span>
407
+ <span class="method-click-advice">click to toggle source</span>
408
+ </div>
409
+
410
+
411
+ <div class="method-description">
412
+
413
+
414
+
415
+
416
+
417
+ <div class="method-source-code" id="download-source">
418
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 293</span>
419
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">download</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">options</span> = {})
420
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
421
+
422
+ <span class="ruby-identifier">require</span> <span class="ruby-string">&#39;net/scp&#39;</span>
423
+
424
+ <span class="ruby-comment"># Accepted options:</span>
425
+ <span class="ruby-comment"># * :recursive - the +remote+ parameter refers to a remote directory, which</span>
426
+ <span class="ruby-comment"># should be downloaded to a new directory named +local+ on the local</span>
427
+ <span class="ruby-comment"># machine.</span>
428
+ <span class="ruby-comment"># * :preserve - the atime and mtime of the file should be preserved.</span>
429
+ <span class="ruby-comment"># * :verbose - the process should result in verbose output on the server</span>
430
+ <span class="ruby-comment"># end (useful for debugging).</span>
431
+ <span class="ruby-comment">#</span>
432
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:recursive</span>, <span class="ruby-keyword">true</span>)
433
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:preserve</span>, <span class="ruby-keyword">true</span>)
434
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:verbose</span>, <span class="ruby-keyword">true</span>)
435
+
436
+ <span class="ruby-identifier">blocking</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:blocking</span>, <span class="ruby-keyword">true</span>)
437
+
438
+ <span class="ruby-identifier">session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ssh</span><span class="ruby-operator">|</span>
439
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">blocking</span>
440
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">scp</span>.<span class="ruby-identifier">download!</span>(<span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">config</span>.<span class="ruby-identifier">export</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">received</span>, <span class="ruby-identifier">total</span><span class="ruby-operator">|</span>
441
+ <span class="ruby-keyword">yield</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">received</span>, <span class="ruby-identifier">total</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
442
+ <span class="ruby-keyword">end</span>
443
+ <span class="ruby-keyword">else</span>
444
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">scp</span>.<span class="ruby-identifier">download</span>(<span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">config</span>.<span class="ruby-identifier">export</span>)
445
+ <span class="ruby-keyword">end</span>
446
+ <span class="ruby-keyword">end</span>
447
+ <span class="ruby-keyword">end</span></pre>
448
+ </div><!-- download-source -->
449
+
450
+ </div>
451
+
452
+
453
+
454
+
455
+ </div><!-- download-method -->
456
+
457
+
458
+ <div id="method-c-exec" class="method-detail ">
459
+
460
+ <div class="method-heading">
461
+ <span class="method-name">exec</span><span
462
+ class="method-args">(hostname, user, commands) { |:output, command, data| ... }</span>
463
+ <span class="method-click-advice">click to toggle source</span>
464
+ </div>
465
+
466
+
467
+ <div class="method-description">
468
+
469
+
470
+
471
+
472
+
473
+ <div class="method-source-code" id="exec-source">
474
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 239</span>
475
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">exec</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">commands</span>)
476
+ <span class="ruby-identifier">results</span> = []
477
+
478
+ <span class="ruby-keyword">begin</span>
479
+ <span class="ruby-identifier">session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ssh</span><span class="ruby-operator">|</span>
480
+ <span class="ruby-constant">Data</span>.<span class="ruby-identifier">array</span>(<span class="ruby-identifier">commands</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">command</span><span class="ruby-operator">|</span>
481
+ <span class="ruby-identifier">command</span> = <span class="ruby-identifier">command</span>.<span class="ruby-identifier">flatten</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39; &#39;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">command</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Array</span>)
482
+ <span class="ruby-identifier">command</span> = <span class="ruby-identifier">command</span>.<span class="ruby-identifier">to_s</span>
483
+ <span class="ruby-identifier">result</span> = <span class="ruby-constant">Shell</span><span class="ruby-operator">::</span><span class="ruby-constant">Result</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">command</span>)
484
+
485
+ <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">info</span>(<span class="ruby-node">&quot;&gt;&gt; running SSH: #{command}&quot;</span>)
486
+
487
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">open_channel</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ssh_channel</span><span class="ruby-operator">|</span>
488
+ <span class="ruby-identifier">ssh_channel</span>.<span class="ruby-identifier">exec</span>(<span class="ruby-identifier">command</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">channel</span>, <span class="ruby-identifier">success</span><span class="ruby-operator">|</span>
489
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">success</span>
490
+ <span class="ruby-identifier">raise</span> <span class="ruby-node">&quot;Could not execute command: #{command.inspect}&quot;</span>
491
+ <span class="ruby-keyword">end</span>
492
+
493
+ <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">on_data</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">data</span><span class="ruby-operator">|</span>
494
+ <span class="ruby-identifier">result</span>.<span class="ruby-identifier">append_output</span>(<span class="ruby-identifier">data</span>)
495
+ <span class="ruby-keyword">yield</span>(<span class="ruby-value">:output</span>, <span class="ruby-identifier">command</span>, <span class="ruby-identifier">data</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
496
+ <span class="ruby-keyword">end</span>
497
+
498
+ <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">on_extended_data</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">type</span>, <span class="ruby-identifier">data</span><span class="ruby-operator">|</span>
499
+ <span class="ruby-identifier">result</span>.<span class="ruby-identifier">append_errors</span>(<span class="ruby-identifier">data</span>)
500
+ <span class="ruby-keyword">yield</span>(<span class="ruby-value">:error</span>, <span class="ruby-identifier">command</span>, <span class="ruby-identifier">data</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
501
+ <span class="ruby-keyword">end</span>
502
+
503
+ <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">on_request</span>(<span class="ruby-string">&#39;exit-status&#39;</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">data</span><span class="ruby-operator">|</span>
504
+ <span class="ruby-identifier">result</span>.<span class="ruby-identifier">status</span> = <span class="ruby-identifier">data</span>.<span class="ruby-identifier">read_long</span>
505
+ <span class="ruby-keyword">end</span>
506
+
507
+ <span class="ruby-identifier">channel</span>.<span class="ruby-identifier">on_request</span>(<span class="ruby-string">&#39;exit-signal&#39;</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">data</span><span class="ruby-operator">|</span>
508
+ <span class="ruby-identifier">result</span>.<span class="ruby-identifier">status</span> = <span class="ruby-value">255</span>
509
+ <span class="ruby-keyword">end</span>
510
+ <span class="ruby-keyword">end</span>
511
+ <span class="ruby-keyword">end</span>
512
+ <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">warn</span>(<span class="ruby-node">&quot;`#{command}` messages: #{result.errors}&quot;</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">errors</span>.<span class="ruby-identifier">length</span> <span class="ruby-operator">&gt;</span> <span class="ruby-value">0</span>
513
+ <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">warn</span>(<span class="ruby-node">&quot;`#{command}` status: #{result.status}&quot;</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">result</span>.<span class="ruby-identifier">status</span> <span class="ruby-operator">==</span> <span class="ruby-value">0</span>
514
+
515
+ <span class="ruby-identifier">results</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">result</span>
516
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">loop</span>
517
+ <span class="ruby-keyword">end</span>
518
+ <span class="ruby-keyword">end</span>
519
+ <span class="ruby-keyword">rescue</span> <span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">SSH</span><span class="ruby-operator">::</span><span class="ruby-constant">HostKeyMismatch</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">error</span>
520
+ <span class="ruby-identifier">error</span>.<span class="ruby-identifier">remember_host!</span>
521
+ <span class="ruby-identifier">sleep</span> <span class="ruby-value">0.2</span>
522
+ <span class="ruby-keyword">retry</span>
523
+ <span class="ruby-keyword">end</span>
524
+ <span class="ruby-identifier">results</span>
525
+ <span class="ruby-keyword">end</span></pre>
526
+ </div><!-- exec-source -->
527
+
528
+ </div>
529
+
530
+
531
+
532
+
533
+ </div><!-- exec-method -->
534
+
535
+
536
+ <div id="method-c-generate" class="method-detail ">
537
+
538
+ <div class="method-heading">
539
+ <span class="method-name">generate</span><span
540
+ class="method-args">(options = {})</span>
541
+ <span class="method-click-advice">click to toggle source</span>
542
+ </div>
543
+
544
+
545
+ <div class="method-description">
546
+
547
+
548
+
549
+
550
+
551
+ <div class="method-source-code" id="generate-source">
552
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 26</span>
553
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">generate</span>(<span class="ruby-identifier">options</span> = {})
554
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
555
+
556
+ <span class="ruby-identifier">private_key</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:private_key</span>, <span class="ruby-keyword">nil</span>)
557
+ <span class="ruby-identifier">original_key</span> = <span class="ruby-keyword">nil</span>
558
+ <span class="ruby-identifier">key_comment</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:comment</span>, <span class="ruby-string">&#39;&#39;</span>)
559
+ <span class="ruby-identifier">passphrase</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:passphrase</span>, <span class="ruby-keyword">nil</span>)
560
+ <span class="ruby-identifier">force</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:force</span>, <span class="ruby-keyword">false</span>)
561
+
562
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">private_key</span>.<span class="ruby-identifier">nil?</span>
563
+ <span class="ruby-identifier">key_type</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:type</span>, <span class="ruby-string">&quot;RSA&quot;</span>)
564
+ <span class="ruby-identifier">key_bits</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:bits</span>, <span class="ruby-value">2048</span>)
565
+
566
+ <span class="ruby-identifier">key_data</span> = <span class="ruby-constant">SSHKey</span>.<span class="ruby-identifier">generate</span>({
567
+ <span class="ruby-value">:type</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">key_type</span>,
568
+ <span class="ruby-value">:bits</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">key_bits</span>,
569
+ <span class="ruby-value">:comment</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">key_comment</span>,
570
+ <span class="ruby-value">:passphrase</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">passphrase</span>
571
+ })
572
+ <span class="ruby-identifier">is_new</span> = <span class="ruby-keyword">true</span>
573
+
574
+ <span class="ruby-keyword">else</span>
575
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">private_key</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">&#39;PRIVATE KEY&#39;</span>)
576
+ <span class="ruby-identifier">original_key</span> = <span class="ruby-identifier">private_key</span>
577
+ <span class="ruby-keyword">else</span>
578
+ <span class="ruby-identifier">original_key</span> = <span class="ruby-constant">Disk</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">private_key</span>)
579
+ <span class="ruby-keyword">end</span>
580
+
581
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">original_key</span>
582
+ <span class="ruby-identifier">encrypted</span> = <span class="ruby-identifier">original_key</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-string">&#39;ENCRYPTED&#39;</span>)
583
+ <span class="ruby-identifier">key_data</span> = <span class="ruby-constant">SSHKey</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">original_key</span>, {
584
+ <span class="ruby-value">:comment</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">key_comment</span>,
585
+ <span class="ruby-value">:passphrase</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">passphrase</span>
586
+ }) <span class="ruby-keyword">if</span> <span class="ruby-identifier">force</span> <span class="ruby-operator">||</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">encrypted</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">passphrase</span>
587
+ <span class="ruby-keyword">end</span>
588
+ <span class="ruby-identifier">is_new</span> = <span class="ruby-keyword">false</span>
589
+ <span class="ruby-keyword">end</span>
590
+
591
+ <span class="ruby-keyword">return</span> <span class="ruby-keyword">nil</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">key_data</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">key_data</span>.<span class="ruby-identifier">ssh_public_key</span>.<span class="ruby-identifier">empty?</span>
592
+ <span class="ruby-constant">Keypair</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">key_data</span>, <span class="ruby-identifier">is_new</span>, <span class="ruby-identifier">original_key</span>, <span class="ruby-identifier">passphrase</span>)
593
+ <span class="ruby-keyword">end</span></pre>
594
+ </div><!-- generate-source -->
595
+
596
+ </div>
597
+
598
+
599
+
600
+
601
+ </div><!-- generate-method -->
602
+
603
+
604
+ <div id="method-c-init_session" class="method-detail ">
605
+
606
+ <div class="method-heading">
607
+ <span class="method-name">init_session</span><span
608
+ class="method-args">(hostname, user, port = 22, private_key = nil, options = {})</span>
609
+ <span class="method-click-advice">click to toggle source</span>
610
+ </div>
611
+
612
+
613
+ <div class="method-description">
614
+
615
+
616
+
617
+
618
+
619
+ <div class="method-source-code" id="init_session-source">
620
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 194</span>
621
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">init_session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">port</span> = <span class="ruby-value">22</span>, <span class="ruby-identifier">private_key</span> = <span class="ruby-keyword">nil</span>, <span class="ruby-identifier">options</span> = {})
622
+ <span class="ruby-identifier">session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">port</span>, <span class="ruby-identifier">private_key</span>, <span class="ruby-keyword">true</span>, <span class="ruby-identifier">options</span>)
623
+ <span class="ruby-keyword">end</span></pre>
624
+ </div><!-- init_session-source -->
625
+
626
+ </div>
627
+
628
+
629
+
630
+
631
+ </div><!-- init_session-method -->
632
+
633
+
634
+ <div id="method-c-key_path" class="method-detail ">
635
+
636
+ <div class="method-heading">
637
+ <span class="method-name">key_path</span><span
638
+ class="method-args">()</span>
639
+ <span class="method-click-advice">click to toggle source</span>
640
+ </div>
641
+
642
+
643
+ <div class="method-description">
644
+
645
+
646
+
647
+
648
+
649
+ <div class="method-source-code" id="key_path-source">
650
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 13</span>
651
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">key_path</span>
652
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">@@key_path</span>
653
+ <span class="ruby-identifier">home_path</span> = ( <span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;USER&#39;</span>] <span class="ruby-operator">==</span> <span class="ruby-string">&#39;root&#39;</span> <span class="ruby-operator">?</span> <span class="ruby-string">&#39;/root&#39;</span> <span class="ruby-operator">:</span> <span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;HOME&#39;</span>] ) <span class="ruby-comment"># In case we are using sudo</span>
654
+ <span class="ruby-identifier">@@key_path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">home_path</span>, <span class="ruby-string">&#39;.ssh&#39;</span>)
655
+
656
+ <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">mkdir</span>(<span class="ruby-identifier">@@key_path</span>) <span class="ruby-keyword">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span>(<span class="ruby-identifier">@@key_path</span>)
657
+ <span class="ruby-keyword">end</span>
658
+ <span class="ruby-identifier">@@key_path</span>
659
+ <span class="ruby-keyword">end</span></pre>
660
+ </div><!-- key_path-source -->
661
+
662
+ </div>
663
+
664
+
665
+
666
+
667
+ </div><!-- key_path-method -->
668
+
669
+
670
+ <div id="method-c-session" class="method-detail ">
671
+
672
+ <div class="method-heading">
673
+ <span class="method-name">session</span><span
674
+ class="method-args">(hostname, user, port = 22, private_key = nil, reset = false, options = {}) { |sessions| ... }</span>
675
+ <span class="method-click-advice">click to toggle source</span>
676
+ </div>
677
+
678
+
679
+ <div class="method-description">
680
+
681
+
682
+
683
+
684
+
685
+ <div class="method-source-code" id="session-source">
686
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 153</span>
687
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">port</span> = <span class="ruby-value">22</span>, <span class="ruby-identifier">private_key</span> = <span class="ruby-keyword">nil</span>, <span class="ruby-identifier">reset</span> = <span class="ruby-keyword">false</span>, <span class="ruby-identifier">options</span> = {})
688
+ <span class="ruby-identifier">require</span> <span class="ruby-string">&#39;net/ssh&#39;</span>
689
+
690
+ <span class="ruby-identifier">session_id</span> = <span class="ruby-identifier">session_id</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>)
691
+
692
+ <span class="ruby-identifier">@@session_lock</span>.<span class="ruby-identifier">synchronize</span> <span class="ruby-keyword">do</span>
693
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
694
+
695
+ <span class="ruby-identifier">ssh_options</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">new</span>({
696
+ <span class="ruby-value">:user_known_hosts_file</span> =<span class="ruby-operator">&gt;</span> [ <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">key_path</span>, <span class="ruby-string">&#39;known_hosts&#39;</span>), <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">key_path</span>, <span class="ruby-string">&#39;known_hosts2&#39;</span>) ],
697
+ <span class="ruby-value">:auth_methods</span> =<span class="ruby-operator">&gt;</span> [ <span class="ruby-string">&#39;publickey&#39;</span> ],
698
+ <span class="ruby-value">:paranoid</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">:very</span>
699
+ }).<span class="ruby-identifier">import</span>(<span class="ruby-constant">Util</span><span class="ruby-operator">::</span><span class="ruby-constant">Data</span>.<span class="ruby-identifier">subset</span>(<span class="ruby-identifier">config</span>, <span class="ruby-identifier">config</span>.<span class="ruby-identifier">keys</span> <span class="ruby-operator">-</span> [ <span class="ruby-value">:keypair</span>, <span class="ruby-value">:key_dir</span>, <span class="ruby-value">:key_name</span> ]))
700
+
701
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">private_key</span>
702
+ <span class="ruby-identifier">auth_id</span> = [ <span class="ruby-identifier">session_id</span>, <span class="ruby-identifier">private_key</span> ].<span class="ruby-identifier">join</span>(<span class="ruby-string">&#39;_&#39;</span>)
703
+
704
+ <span class="ruby-keyword">if</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>] <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">unlock_private_key</span>(<span class="ruby-identifier">private_key</span>, <span class="ruby-identifier">config</span>)
705
+ <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>] = <span class="ruby-identifier">keypair</span>
706
+ <span class="ruby-keyword">end</span>
707
+ <span class="ruby-identifier">config</span>[<span class="ruby-value">:keypair</span>] = <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>] <span class="ruby-comment"># Reset so caller can access updated keypair </span>
708
+
709
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>].<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
710
+ <span class="ruby-identifier">ssh_options</span>[<span class="ruby-value">:keys_only</span>] = <span class="ruby-keyword">false</span>
711
+ <span class="ruby-identifier">ssh_options</span>[<span class="ruby-value">:keys</span>] = [ <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>] ]
712
+ <span class="ruby-keyword">else</span>
713
+ <span class="ruby-identifier">ssh_options</span>[<span class="ruby-value">:keys_only</span>] = <span class="ruby-keyword">true</span>
714
+ <span class="ruby-identifier">ssh_options</span>[<span class="ruby-value">:key_data</span>] = [ <span class="ruby-identifier">@@auth</span>[<span class="ruby-identifier">auth_id</span>].<span class="ruby-identifier">private_key</span> ]
715
+ <span class="ruby-keyword">end</span>
716
+ <span class="ruby-keyword">end</span>
717
+
718
+ <span class="ruby-identifier">ssh_options</span>[<span class="ruby-value">:port</span>] = <span class="ruby-identifier">port</span>
719
+
720
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">reset</span> <span class="ruby-operator">||</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">@@sessions</span>.<span class="ruby-identifier">has_key?</span>(<span class="ruby-identifier">session_id</span>)
721
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>] = <span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">SSH</span>.<span class="ruby-identifier">start</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">ssh_options</span>.<span class="ruby-identifier">export</span>)
722
+ <span class="ruby-keyword">end</span>
723
+ <span class="ruby-keyword">end</span>
724
+ <span class="ruby-keyword">yield</span>(<span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>]) <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>]
725
+ <span class="ruby-identifier">@@sessions</span>[<span class="ruby-identifier">session_id</span>]
726
+ <span class="ruby-keyword">end</span></pre>
727
+ </div><!-- session-source -->
728
+
729
+ </div>
730
+
731
+
732
+
733
+
734
+ </div><!-- session-method -->
735
+
736
+
737
+ <div id="method-c-session_id" class="method-detail ">
738
+
739
+ <div class="method-heading">
740
+ <span class="method-name">session_id</span><span
741
+ class="method-args">(hostname, user)</span>
742
+ <span class="method-click-advice">click to toggle source</span>
743
+ </div>
744
+
745
+
746
+ <div class="method-description">
747
+
748
+
749
+
750
+
751
+
752
+ <div class="method-source-code" id="session_id-source">
753
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 147</span>
754
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">session_id</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>)
755
+ <span class="ruby-node">&quot;#{hostname}-#{user}&quot;</span>
756
+ <span class="ruby-keyword">end</span></pre>
757
+ </div><!-- session_id-source -->
758
+
759
+ </div>
760
+
761
+
762
+
763
+
764
+ </div><!-- session_id-method -->
765
+
766
+
767
+ <div id="method-c-terminal" class="method-detail ">
768
+
769
+ <div class="method-heading">
770
+ <span class="method-name">terminal</span><span
771
+ class="method-args">(hostname, user, options = {})</span>
772
+ <span class="method-click-advice">click to toggle source</span>
773
+ </div>
774
+
775
+
776
+ <div class="method-description">
777
+
778
+ <p>Inspired by vagrant ssh implementation</p>
779
+
780
+ <p>See: <a
781
+ href="https://github.com/mitchellh/vagrant/blob/master/lib/vagrant/util/ssh.rb">github.com/mitchellh/vagrant/blob/master/lib/vagrant/util/ssh.rb</a></p>
782
+
783
+
784
+
785
+ <div class="method-source-code" id="terminal-source">
786
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 367</span>
787
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">terminal</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">options</span> = {})
788
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
789
+ <span class="ruby-identifier">ssh_path</span> = <span class="ruby-identifier">nucleon_locate</span>(<span class="ruby-string">&quot;ssh&quot;</span>)
790
+
791
+ <span class="ruby-identifier">raise</span> <span class="ruby-constant">Errors</span><span class="ruby-operator">::</span><span class="ruby-constant">SSHUnavailable</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">ssh_path</span>
792
+
793
+ <span class="ruby-identifier">port</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:port</span>, <span class="ruby-value">22</span>)
794
+ <span class="ruby-identifier">private_keys</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:private_keys</span>, <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;HOME&#39;</span>], <span class="ruby-string">&#39;.ssh&#39;</span>, <span class="ruby-string">&#39;id_rsa&#39;</span>))
795
+
796
+ <span class="ruby-identifier">command_options</span> = [
797
+ <span class="ruby-node">&quot;#{user}@#{hostname}&quot;</span>,
798
+ <span class="ruby-string">&quot;-p&quot;</span>, <span class="ruby-identifier">port</span>.<span class="ruby-identifier">to_s</span>,
799
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;Compression=yes&quot;</span>,
800
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;DSAAuthentication=yes&quot;</span>,
801
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;LogLevel=FATAL&quot;</span>,
802
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;StrictHostKeyChecking=no&quot;</span>,
803
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;UserKnownHostsFile=/dev/null&quot;</span>,
804
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;IdentitiesOnly=yes&quot;</span>
805
+ ]
806
+
807
+ <span class="ruby-constant">Util</span><span class="ruby-operator">::</span><span class="ruby-constant">Data</span>.<span class="ruby-identifier">array</span>(<span class="ruby-identifier">private_keys</span>).<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span><span class="ruby-operator">|</span>
808
+ <span class="ruby-identifier">command_options</span> <span class="ruby-operator">+=</span> [ <span class="ruby-string">&quot;-i&quot;</span>, <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">path</span>) ]
809
+ <span class="ruby-keyword">end</span>
810
+
811
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:forward_x11</span>, <span class="ruby-keyword">false</span>)
812
+ <span class="ruby-identifier">command_options</span> <span class="ruby-operator">+=</span> [
813
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;ForwardX11=yes&quot;</span>,
814
+ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;ForwardX11Trusted=yes&quot;</span>
815
+ ]
816
+ <span class="ruby-keyword">end</span>
817
+
818
+ <span class="ruby-identifier">command_options</span> <span class="ruby-operator">+=</span> [ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-node">&quot;ProxyCommand=#{config[:proxy_command]}&quot;</span> ] <span class="ruby-keyword">if</span> <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:proxy_command</span>, <span class="ruby-keyword">false</span>)
819
+ <span class="ruby-identifier">command_options</span> <span class="ruby-operator">+=</span> [ <span class="ruby-string">&quot;-o&quot;</span>, <span class="ruby-string">&quot;ForwardAgent=yes&quot;</span> ] <span class="ruby-keyword">if</span> <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:forward_agent</span>, <span class="ruby-keyword">false</span>)
820
+
821
+ <span class="ruby-identifier">command_options</span>.<span class="ruby-identifier">concat</span>(<span class="ruby-constant">Util</span><span class="ruby-operator">::</span><span class="ruby-constant">Data</span>.<span class="ruby-identifier">array</span>(<span class="ruby-identifier">config</span>[<span class="ruby-value">:extra_args</span>])) <span class="ruby-keyword">if</span> <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:extra_args</span>, <span class="ruby-keyword">false</span>)
822
+
823
+ <span class="ruby-comment">#---</span>
824
+
825
+ <span class="ruby-identifier">logger</span>.<span class="ruby-identifier">info</span>(<span class="ruby-node">&quot;Executing SSH in subprocess: #{command_options.inspect}&quot;</span>)
826
+
827
+ <span class="ruby-identifier">process</span> = <span class="ruby-constant">ChildProcess</span>.<span class="ruby-identifier">build</span>(<span class="ruby-string">&#39;ssh&#39;</span>, *<span class="ruby-identifier">command_options</span>)
828
+ <span class="ruby-identifier">process</span>.<span class="ruby-identifier">io</span>.<span class="ruby-identifier">inherit!</span>
829
+
830
+ <span class="ruby-identifier">process</span>.<span class="ruby-identifier">start</span>
831
+ <span class="ruby-identifier">process</span>.<span class="ruby-identifier">wait</span>
832
+ <span class="ruby-identifier">process</span>.<span class="ruby-identifier">exit_code</span>
833
+ <span class="ruby-keyword">end</span></pre>
834
+ </div><!-- terminal-source -->
835
+
836
+ </div>
837
+
838
+
839
+
840
+
841
+ </div><!-- terminal-method -->
842
+
843
+
844
+ <div id="method-c-unlock_private_key" class="method-detail ">
845
+
846
+ <div class="method-heading">
847
+ <span class="method-name">unlock_private_key</span><span
848
+ class="method-args">(private_key, options = {})</span>
849
+ <span class="method-click-advice">click to toggle source</span>
850
+ </div>
851
+
852
+
853
+ <div class="method-description">
854
+
855
+
856
+
857
+
858
+
859
+ <div class="method-source-code" id="unlock_private_key-source">
860
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 418</span>
861
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">unlock_private_key</span>(<span class="ruby-identifier">private_key</span>, <span class="ruby-identifier">options</span> = {})
862
+ <span class="ruby-identifier">require</span> <span class="ruby-string">&#39;net/ssh&#39;</span>
863
+
864
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
865
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:keypair</span>, <span class="ruby-keyword">nil</span>)
866
+ <span class="ruby-identifier">key_dir</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:key_dir</span>, <span class="ruby-keyword">nil</span>)
867
+ <span class="ruby-identifier">key_name</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">get</span>(<span class="ruby-value">:key_name</span>, <span class="ruby-string">&#39;default&#39;</span>)
868
+ <span class="ruby-identifier">no_file</span> = <span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;NUCLEON_NO_SSH_KEY_SAVE&#39;</span>]
869
+
870
+ <span class="ruby-identifier">password</span> = <span class="ruby-keyword">nil</span>
871
+ <span class="ruby-identifier">tmp_key_dir</span> = <span class="ruby-keyword">nil</span>
872
+
873
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">private_key</span>
874
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-keyword">nil</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">keypair</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">keypair</span>.<span class="ruby-identifier">private_key</span>
875
+
876
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">no_file</span>
877
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">key_dir</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">key_name</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">private_key</span>) <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">loaded_private_key</span> = <span class="ruby-constant">Util</span><span class="ruby-operator">::</span><span class="ruby-constant">Disk</span>.<span class="ruby-identifier">read</span>(<span class="ruby-identifier">private_key</span>)
878
+ <span class="ruby-constant">FileUtils</span>.<span class="ruby-identifier">mkdir_p</span>(<span class="ruby-identifier">key_dir</span>)
879
+
880
+ <span class="ruby-identifier">loaded_private_key</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp">/BEGIN\s+([A-Z]+)\s+/</span>
881
+
882
+ <span class="ruby-identifier">local_key_type</span> = <span class="ruby-node">$1</span>
883
+ <span class="ruby-identifier">local_key_name</span> = <span class="ruby-constant">Keypair</span>.<span class="ruby-identifier">render</span>(<span class="ruby-identifier">local_key_type</span>, <span class="ruby-identifier">key_name</span>)
884
+ <span class="ruby-identifier">local_key_path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-identifier">key_dir</span>, <span class="ruby-identifier">local_key_name</span>)
885
+
886
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">generate</span>({ <span class="ruby-value">:private_key</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">local_key_path</span> }) <span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">local_key_path</span>)
887
+ <span class="ruby-keyword">end</span>
888
+ <span class="ruby-keyword">end</span>
889
+
890
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">keypair</span>
891
+ <span class="ruby-identifier">key_manager_logger</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Logger</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">STDERR</span>)
892
+ <span class="ruby-identifier">key_manager_logger</span>.<span class="ruby-identifier">level</span> = <span class="ruby-operator">::</span><span class="ruby-constant">Logger</span><span class="ruby-operator">::</span><span class="ruby-constant">FATAL</span>
893
+ <span class="ruby-identifier">key_manager</span> = <span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">SSH</span><span class="ruby-operator">::</span><span class="ruby-constant">Authentication</span><span class="ruby-operator">::</span><span class="ruby-constant">KeyManager</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">key_manager_logger</span>)
894
+
895
+ <span class="ruby-identifier">key_manager</span>.<span class="ruby-identifier">each_identity</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">identity</span><span class="ruby-operator">|</span>
896
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">identity</span>.<span class="ruby-identifier">comment</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">private_key</span>
897
+ <span class="ruby-comment"># Feed the key to the system password manager if it exists</span>
898
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">private_key</span>
899
+ <span class="ruby-keyword">end</span>
900
+ <span class="ruby-keyword">end</span>
901
+ <span class="ruby-identifier">key_manager</span>.<span class="ruby-identifier">finish</span>
902
+
903
+ <span class="ruby-keyword">until</span> <span class="ruby-identifier">keypair</span>
904
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">generate</span>({
905
+ <span class="ruby-value">:private_key</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">private_key</span>,
906
+ <span class="ruby-value">:passphrase</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">password</span>
907
+ })
908
+ <span class="ruby-identifier">password</span> = <span class="ruby-identifier">ui</span>.<span class="ruby-identifier">ask</span>(<span class="ruby-node">&quot;Enter passphrase for #{private_key}: &quot;</span>, { <span class="ruby-value">:echo</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-keyword">false</span> }) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">keypair</span>
909
+ <span class="ruby-keyword">end</span>
910
+
911
+ <span class="ruby-keyword">unless</span> <span class="ruby-identifier">no_file</span>
912
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">key_dir</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-identifier">key_name</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-operator">!</span> <span class="ruby-identifier">keypair</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">String</span>)
913
+ <span class="ruby-identifier">key_files</span> = <span class="ruby-identifier">keypair</span>.<span class="ruby-identifier">store</span>(<span class="ruby-identifier">key_dir</span>, <span class="ruby-identifier">key_name</span>, <span class="ruby-keyword">false</span>)
914
+
915
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">key_files</span> <span class="ruby-operator">&amp;&amp;</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-identifier">key_files</span>[<span class="ruby-value">:private_key</span>])
916
+ <span class="ruby-identifier">keypair</span> = <span class="ruby-identifier">generate</span>({ <span class="ruby-value">:private_key</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">key_files</span>[<span class="ruby-value">:private_key</span>] })
917
+ <span class="ruby-keyword">end</span>
918
+ <span class="ruby-keyword">end</span>
919
+ <span class="ruby-keyword">end</span>
920
+ <span class="ruby-keyword">end</span>
921
+ <span class="ruby-keyword">end</span>
922
+ <span class="ruby-identifier">keypair</span>
923
+ <span class="ruby-keyword">end</span></pre>
924
+ </div><!-- unlock_private_key-source -->
925
+
926
+ </div>
927
+
928
+
929
+
930
+
931
+ </div><!-- unlock_private_key-method -->
932
+
933
+
934
+ <div id="method-c-upload" class="method-detail ">
935
+
936
+ <div class="method-heading">
937
+ <span class="method-name">upload</span><span
938
+ class="method-args">(hostname, user, local_path, remote_path, options = {}) { |name, sent, total| ... }</span>
939
+ <span class="method-click-advice">click to toggle source</span>
940
+ </div>
941
+
942
+
943
+ <div class="method-description">
944
+
945
+
946
+
947
+
948
+
949
+ <div class="method-source-code" id="upload-source">
950
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 325</span>
951
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">upload</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>, <span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">options</span> = {})
952
+ <span class="ruby-identifier">config</span> = <span class="ruby-constant">Config</span>.<span class="ruby-identifier">ensure</span>(<span class="ruby-identifier">options</span>)
953
+
954
+ <span class="ruby-identifier">require</span> <span class="ruby-string">&#39;net/scp&#39;</span>
955
+
956
+ <span class="ruby-comment"># Accepted options:</span>
957
+ <span class="ruby-comment"># * :recursive - the +local+ parameter refers to a local directory, which</span>
958
+ <span class="ruby-comment"># should be uploaded to a new directory named +remote+ on the remote</span>
959
+ <span class="ruby-comment"># server.</span>
960
+ <span class="ruby-comment"># * :preserve - the atime and mtime of the file should be preserved.</span>
961
+ <span class="ruby-comment"># * :verbose - the process should result in verbose output on the server</span>
962
+ <span class="ruby-comment"># end (useful for debugging).</span>
963
+ <span class="ruby-comment"># * :chunk_size - the size of each &quot;chunk&quot; that should be sent. Defaults</span>
964
+ <span class="ruby-comment"># to 2048. Changing this value may improve throughput at the expense</span>
965
+ <span class="ruby-comment"># of decreasing interactivity.</span>
966
+ <span class="ruby-comment">#</span>
967
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:recursive</span>, <span class="ruby-keyword">true</span>)
968
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:preserve</span>, <span class="ruby-keyword">true</span>)
969
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:verbose</span>, <span class="ruby-keyword">true</span>)
970
+ <span class="ruby-identifier">config</span>.<span class="ruby-identifier">init</span>(<span class="ruby-value">:chunk_size</span>, <span class="ruby-value">2048</span>)
971
+
972
+ <span class="ruby-identifier">blocking</span> = <span class="ruby-identifier">config</span>.<span class="ruby-identifier">delete</span>(<span class="ruby-value">:blocking</span>, <span class="ruby-keyword">true</span>)
973
+
974
+ <span class="ruby-identifier">session</span>(<span class="ruby-identifier">hostname</span>, <span class="ruby-identifier">user</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ssh</span><span class="ruby-operator">|</span>
975
+ <span class="ruby-keyword">if</span> <span class="ruby-identifier">blocking</span>
976
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">scp</span>.<span class="ruby-identifier">upload!</span>(<span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">config</span>.<span class="ruby-identifier">export</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ch</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">sent</span>, <span class="ruby-identifier">total</span><span class="ruby-operator">|</span>
977
+ <span class="ruby-keyword">yield</span>(<span class="ruby-identifier">name</span>, <span class="ruby-identifier">sent</span>, <span class="ruby-identifier">total</span>) <span class="ruby-keyword">if</span> <span class="ruby-identifier">block_given?</span>
978
+ <span class="ruby-keyword">end</span>
979
+ <span class="ruby-keyword">else</span>
980
+ <span class="ruby-identifier">ssh</span>.<span class="ruby-identifier">scp</span>.<span class="ruby-identifier">upload</span>(<span class="ruby-identifier">local_path</span>, <span class="ruby-identifier">remote_path</span>, <span class="ruby-identifier">config</span>.<span class="ruby-identifier">export</span>)
981
+ <span class="ruby-keyword">end</span>
982
+ <span class="ruby-keyword">end</span>
983
+ <span class="ruby-keyword">end</span></pre>
984
+ </div><!-- upload-source -->
985
+
986
+ </div>
987
+
988
+
989
+
990
+
991
+ </div><!-- upload-method -->
992
+
993
+
994
+ <div id="method-c-valid-3F" class="method-detail ">
995
+
996
+ <div class="method-heading">
997
+ <span class="method-name">valid?</span><span
998
+ class="method-args">(public_ssh_key)</span>
999
+ <span class="method-click-advice">click to toggle source</span>
1000
+ </div>
1001
+
1002
+
1003
+ <div class="method-description">
1004
+
1005
+
1006
+
1007
+
1008
+
1009
+ <div class="method-source-code" id="valid-3F-source">
1010
+ <pre><span class="ruby-comment"># File lib/core/util/ssh.rb, line 71</span>
1011
+ <span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier">valid?</span>(<span class="ruby-identifier">public_ssh_key</span>)
1012
+ <span class="ruby-constant">SSHKey</span>.<span class="ruby-identifier">valid_ssh_public_key?</span>(<span class="ruby-identifier">public_ssh_key</span>)
1013
+ <span class="ruby-keyword">end</span></pre>
1014
+ </div><!-- valid-3F-source -->
1015
+
1016
+ </div>
1017
+
1018
+
1019
+
1020
+
1021
+ </div><!-- valid-3F-method -->
1022
+
1023
+
1024
+ </section><!-- public-class-method-details -->
1025
+
1026
+ </section><!-- 5Buntitled-5D -->
1027
+
1028
+ </div><!-- documentation -->
1029
+
1030
+
1031
+ <footer id="validator-badges">
1032
+ <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
1033
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.2.
1034
+ <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
1035
+ </footer>
1036
+