root / lib / ssh.py @ 1fc3812c
History | View | Annotate | Download (9.1 kB)
1 | 2f31098c | Iustin Pop | #
|
---|---|---|---|
2 | a8083063 | Iustin Pop | #
|
3 | a8083063 | Iustin Pop | |
4 | ebcd61bb | Iustin Pop | # Copyright (C) 2006, 2007, 2010, 2011 Google Inc.
|
5 | a8083063 | Iustin Pop | #
|
6 | a8083063 | Iustin Pop | # This program is free software; you can redistribute it and/or modify
|
7 | a8083063 | Iustin Pop | # it under the terms of the GNU General Public License as published by
|
8 | a8083063 | Iustin Pop | # the Free Software Foundation; either version 2 of the License, or
|
9 | a8083063 | Iustin Pop | # (at your option) any later version.
|
10 | a8083063 | Iustin Pop | #
|
11 | a8083063 | Iustin Pop | # This program is distributed in the hope that it will be useful, but
|
12 | a8083063 | Iustin Pop | # WITHOUT ANY WARRANTY; without even the implied warranty of
|
13 | a8083063 | Iustin Pop | # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
14 | a8083063 | Iustin Pop | # General Public License for more details.
|
15 | a8083063 | Iustin Pop | #
|
16 | a8083063 | Iustin Pop | # You should have received a copy of the GNU General Public License
|
17 | a8083063 | Iustin Pop | # along with this program; if not, write to the Free Software
|
18 | a8083063 | Iustin Pop | # Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
19 | a8083063 | Iustin Pop | # 02110-1301, USA.
|
20 | a8083063 | Iustin Pop | |
21 | a8083063 | Iustin Pop | |
22 | a8083063 | Iustin Pop | """Module encapsulating ssh functionality.
|
23 | a8083063 | Iustin Pop |
|
24 | a8083063 | Iustin Pop | """
|
25 | a8083063 | Iustin Pop | |
26 | a8083063 | Iustin Pop | |
27 | a8083063 | Iustin Pop | import os |
28 | 9c034cbe | Iustin Pop | import logging |
29 | 33993ab8 | René Nussbaumer | import re |
30 | a8083063 | Iustin Pop | |
31 | a8083063 | Iustin Pop | from ganeti import utils |
32 | a8083063 | Iustin Pop | from ganeti import errors |
33 | 82122173 | Iustin Pop | from ganeti import constants |
34 | 8062638d | Manuel Franceschini | from ganeti import netutils |
35 | 8fd1bfa9 | Michael Hanselmann | from ganeti import pathutils |
36 | cffbbae7 | Michael Hanselmann | from ganeti import vcluster |
37 | 82122173 | Iustin Pop | |
38 | 82122173 | Iustin Pop | |
39 | 33993ab8 | René Nussbaumer | def FormatParamikoFingerprint(fingerprint): |
40 | 697a3d61 | Manuel Franceschini | """Format paramiko PKey fingerprint.
|
41 | 33993ab8 | René Nussbaumer |
|
42 | 33993ab8 | René Nussbaumer | @type fingerprint: str
|
43 | 33993ab8 | René Nussbaumer | @param fingerprint: PKey fingerprint
|
44 | 697a3d61 | Manuel Franceschini | @return: The string hex representation of the fingerprint
|
45 | 33993ab8 | René Nussbaumer |
|
46 | 33993ab8 | René Nussbaumer | """
|
47 | 33993ab8 | René Nussbaumer | assert len(fingerprint) % 2 == 0 |
48 | 33993ab8 | René Nussbaumer | return ":".join(re.findall(r"..", fingerprint.lower())) |
49 | 33993ab8 | René Nussbaumer | |
50 | 33993ab8 | René Nussbaumer | |
51 | 70d9e3d8 | Iustin Pop | def GetUserFiles(user, mkdir=False): |
52 | 70d9e3d8 | Iustin Pop | """Return the paths of a user's ssh files.
|
53 | 70d9e3d8 | Iustin Pop |
|
54 | 70d9e3d8 | Iustin Pop | The function will return a triplet (priv_key_path, pub_key_path,
|
55 | 70d9e3d8 | Iustin Pop | auth_key_path) that are used for ssh authentication. Currently, the
|
56 | 70d9e3d8 | Iustin Pop | keys used are DSA keys, so this function will return:
|
57 | 70d9e3d8 | Iustin Pop | (~user/.ssh/id_dsa, ~user/.ssh/id_dsa.pub,
|
58 | 70d9e3d8 | Iustin Pop | ~user/.ssh/authorized_keys).
|
59 | 70d9e3d8 | Iustin Pop |
|
60 | 70d9e3d8 | Iustin Pop | If the optional parameter mkdir is True, the ssh directory will be
|
61 | 70d9e3d8 | Iustin Pop | created if it doesn't exist.
|
62 | 70d9e3d8 | Iustin Pop |
|
63 | 70d9e3d8 | Iustin Pop | Regardless of the mkdir parameters, the script will raise an error
|
64 | 70d9e3d8 | Iustin Pop | if ~user/.ssh is not a directory.
|
65 | 70d9e3d8 | Iustin Pop |
|
66 | 70d9e3d8 | Iustin Pop | """
|
67 | 70d9e3d8 | Iustin Pop | user_dir = utils.GetHomeDir(user) |
68 | 70d9e3d8 | Iustin Pop | if not user_dir: |
69 | 70d9e3d8 | Iustin Pop | raise errors.OpExecError("Cannot resolve home of user %s" % user) |
70 | 70d9e3d8 | Iustin Pop | |
71 | c4feafe8 | Iustin Pop | ssh_dir = utils.PathJoin(user_dir, ".ssh")
|
72 | 5bae14d9 | Guido Trotter | if mkdir:
|
73 | 5bae14d9 | Guido Trotter | utils.EnsureDirs([(ssh_dir, constants.SECURE_DIR_MODE)]) |
74 | 70d9e3d8 | Iustin Pop | elif not os.path.isdir(ssh_dir): |
75 | 898a6d45 | Michael Hanselmann | raise errors.OpExecError("Path %s is not a directory" % ssh_dir) |
76 | 70d9e3d8 | Iustin Pop | |
77 | c4feafe8 | Iustin Pop | return [utils.PathJoin(ssh_dir, base)
|
78 | 70d9e3d8 | Iustin Pop | for base in ["id_dsa", "id_dsa.pub", "authorized_keys"]] |
79 | 70d9e3d8 | Iustin Pop | |
80 | 70d9e3d8 | Iustin Pop | |
81 | c92b310a | Michael Hanselmann | class SshRunner: |
82 | c92b310a | Michael Hanselmann | """Wrapper for SSH commands.
|
83 | a8083063 | Iustin Pop |
|
84 | a8083063 | Iustin Pop | """
|
85 | b43dcc5a | Manuel Franceschini | def __init__(self, cluster_name, ipv6=False): |
86 | b43dcc5a | Manuel Franceschini | """Initializes this class.
|
87 | b43dcc5a | Manuel Franceschini |
|
88 | b43dcc5a | Manuel Franceschini | @type cluster_name: str
|
89 | b43dcc5a | Manuel Franceschini | @param cluster_name: name of the cluster
|
90 | b43dcc5a | Manuel Franceschini | @type ipv6: bool
|
91 | b43dcc5a | Manuel Franceschini | @param ipv6: If true, force ssh to use IPv6 addresses only
|
92 | b43dcc5a | Manuel Franceschini |
|
93 | b43dcc5a | Manuel Franceschini | """
|
94 | 56bece1f | Iustin Pop | self.cluster_name = cluster_name
|
95 | b43dcc5a | Manuel Franceschini | self.ipv6 = ipv6
|
96 | 1ff08570 | Michael Hanselmann | |
97 | 652d6694 | Michael Hanselmann | def _BuildSshOptions(self, batch, ask_key, use_cluster_key, |
98 | 2892a4c9 | Iustin Pop | strict_host_check, private_key=None, quiet=True): |
99 | bf75f132 | Iustin Pop | """Builds a list with needed SSH options.
|
100 | bf75f132 | Iustin Pop |
|
101 | bf75f132 | Iustin Pop | @param batch: same as ssh's batch option
|
102 | bf75f132 | Iustin Pop | @param ask_key: allows ssh to ask for key confirmation; this
|
103 | bf75f132 | Iustin Pop | parameter conflicts with the batch one
|
104 | bf75f132 | Iustin Pop | @param use_cluster_key: if True, use the cluster name as the
|
105 | bf75f132 | Iustin Pop | HostKeyAlias name
|
106 | bf75f132 | Iustin Pop | @param strict_host_check: this makes the host key checking strict
|
107 | 4403ff8d | René Nussbaumer | @param private_key: use this private key instead of the default
|
108 | 2892a4c9 | Iustin Pop | @param quiet: whether to enable -q to ssh
|
109 | bf75f132 | Iustin Pop |
|
110 | bf75f132 | Iustin Pop | @rtype: list
|
111 | a4ccecf6 | Michael Hanselmann | @return: the list of options ready to use in L{utils.process.RunCmd}
|
112 | bf75f132 | Iustin Pop |
|
113 | bf75f132 | Iustin Pop | """
|
114 | f6d9f4c3 | Michael Hanselmann | options = [ |
115 | f6d9f4c3 | Michael Hanselmann | "-oEscapeChar=none",
|
116 | f6d9f4c3 | Michael Hanselmann | "-oHashKnownHosts=no",
|
117 | 8fd1bfa9 | Michael Hanselmann | "-oGlobalKnownHostsFile=%s" % pathutils.SSH_KNOWN_HOSTS_FILE,
|
118 | f6d9f4c3 | Michael Hanselmann | "-oUserKnownHostsFile=/dev/null",
|
119 | b427788e | Iustin Pop | "-oCheckHostIp=no",
|
120 | f6d9f4c3 | Michael Hanselmann | ] |
121 | f6d9f4c3 | Michael Hanselmann | |
122 | f6d9f4c3 | Michael Hanselmann | if use_cluster_key:
|
123 | 56bece1f | Iustin Pop | options.append("-oHostKeyAlias=%s" % self.cluster_name) |
124 | f6d9f4c3 | Michael Hanselmann | |
125 | 2892a4c9 | Iustin Pop | if quiet:
|
126 | 2892a4c9 | Iustin Pop | options.append("-q")
|
127 | 2892a4c9 | Iustin Pop | |
128 | 4403ff8d | René Nussbaumer | if private_key:
|
129 | 4403ff8d | René Nussbaumer | options.append("-i%s" % private_key)
|
130 | 4403ff8d | René Nussbaumer | |
131 | 652d6694 | Michael Hanselmann | # TODO: Too many boolean options, maybe convert them to more descriptive
|
132 | 652d6694 | Michael Hanselmann | # constants.
|
133 | 652d6694 | Michael Hanselmann | |
134 | f6d9f4c3 | Michael Hanselmann | # Note: ask_key conflicts with batch mode
|
135 | f6d9f4c3 | Michael Hanselmann | if batch:
|
136 | f6d9f4c3 | Michael Hanselmann | if ask_key:
|
137 | f6d9f4c3 | Michael Hanselmann | raise errors.ProgrammerError("SSH call requested conflicting options") |
138 | f6d9f4c3 | Michael Hanselmann | |
139 | 652d6694 | Michael Hanselmann | options.append("-oBatchMode=yes")
|
140 | 652d6694 | Michael Hanselmann | |
141 | 652d6694 | Michael Hanselmann | if strict_host_check:
|
142 | 652d6694 | Michael Hanselmann | options.append("-oStrictHostKeyChecking=yes")
|
143 | 652d6694 | Michael Hanselmann | else:
|
144 | 652d6694 | Michael Hanselmann | options.append("-oStrictHostKeyChecking=no")
|
145 | f6d9f4c3 | Michael Hanselmann | |
146 | e66d9f1a | Iustin Pop | else:
|
147 | e66d9f1a | Iustin Pop | # non-batch mode
|
148 | e66d9f1a | Iustin Pop | |
149 | e66d9f1a | Iustin Pop | if ask_key:
|
150 | e66d9f1a | Iustin Pop | options.append("-oStrictHostKeyChecking=ask")
|
151 | e66d9f1a | Iustin Pop | elif strict_host_check:
|
152 | e66d9f1a | Iustin Pop | options.append("-oStrictHostKeyChecking=yes")
|
153 | e66d9f1a | Iustin Pop | else:
|
154 | e66d9f1a | Iustin Pop | options.append("-oStrictHostKeyChecking=no")
|
155 | f6d9f4c3 | Michael Hanselmann | |
156 | b43dcc5a | Manuel Franceschini | if self.ipv6: |
157 | b43dcc5a | Manuel Franceschini | options.append("-6")
|
158 | b43dcc5a | Manuel Franceschini | |
159 | f6d9f4c3 | Michael Hanselmann | return options
|
160 | 1ff08570 | Michael Hanselmann | |
161 | 8f07f831 | Michael Hanselmann | def BuildCmd(self, hostname, user, command, batch=True, ask_key=False, |
162 | 4403ff8d | René Nussbaumer | tty=False, use_cluster_key=True, strict_host_check=True, |
163 | 2892a4c9 | Iustin Pop | private_key=None, quiet=True): |
164 | c92b310a | Michael Hanselmann | """Build an ssh command to execute a command on a remote node.
|
165 | c92b310a | Michael Hanselmann |
|
166 | c41eea6e | Iustin Pop | @param hostname: the target host, string
|
167 | c41eea6e | Iustin Pop | @param user: user to auth as
|
168 | c41eea6e | Iustin Pop | @param command: the command
|
169 | c41eea6e | Iustin Pop | @param batch: if true, ssh will run in batch mode with no prompting
|
170 | c41eea6e | Iustin Pop | @param ask_key: if true, ssh will run with
|
171 | c41eea6e | Iustin Pop | StrictHostKeyChecking=ask, so that we can connect to an
|
172 | c41eea6e | Iustin Pop | unknown host (not valid in batch mode)
|
173 | c41eea6e | Iustin Pop | @param use_cluster_key: whether to expect and use the
|
174 | c41eea6e | Iustin Pop | cluster-global SSH key
|
175 | c41eea6e | Iustin Pop | @param strict_host_check: whether to check the host's SSH key at all
|
176 | 4403ff8d | René Nussbaumer | @param private_key: use this private key instead of the default
|
177 | 2892a4c9 | Iustin Pop | @param quiet: whether to enable -q to ssh
|
178 | c41eea6e | Iustin Pop |
|
179 | c41eea6e | Iustin Pop | @return: the ssh call to run 'command' on the remote host.
|
180 | c92b310a | Michael Hanselmann |
|
181 | c92b310a | Michael Hanselmann | """
|
182 | 2892a4c9 | Iustin Pop | argv = [constants.SSH] |
183 | 652d6694 | Michael Hanselmann | argv.extend(self._BuildSshOptions(batch, ask_key, use_cluster_key,
|
184 | 2892a4c9 | Iustin Pop | strict_host_check, private_key, |
185 | 2892a4c9 | Iustin Pop | quiet=quiet)) |
186 | 8f07f831 | Michael Hanselmann | if tty:
|
187 | f724a702 | Balazs Lecz | argv.extend(["-t", "-t"]) |
188 | cffbbae7 | Michael Hanselmann | |
189 | cffbbae7 | Michael Hanselmann | argv.append("%s@%s" % (user, hostname))
|
190 | cffbbae7 | Michael Hanselmann | |
191 | cffbbae7 | Michael Hanselmann | # Insert variables for virtual nodes
|
192 | cffbbae7 | Michael Hanselmann | argv.extend("export %s=%s;" %
|
193 | cffbbae7 | Michael Hanselmann | (utils.ShellQuote(name), utils.ShellQuote(value)) |
194 | cffbbae7 | Michael Hanselmann | for (name, value) in |
195 | cffbbae7 | Michael Hanselmann | vcluster.EnvironmentForHost(hostname).items()) |
196 | cffbbae7 | Michael Hanselmann | |
197 | cffbbae7 | Michael Hanselmann | argv.append(command) |
198 | cffbbae7 | Michael Hanselmann | |
199 | c92b310a | Michael Hanselmann | return argv
|
200 | c92b310a | Michael Hanselmann | |
201 | 54ab6aec | Michael Hanselmann | def Run(self, *args, **kwargs): |
202 | c92b310a | Michael Hanselmann | """Runs a command on a remote node.
|
203 | c92b310a | Michael Hanselmann |
|
204 | c92b310a | Michael Hanselmann | This method has the same return value as `utils.RunCmd()`, which it
|
205 | c92b310a | Michael Hanselmann | uses to launch ssh.
|
206 | c92b310a | Michael Hanselmann |
|
207 | c41eea6e | Iustin Pop | Args: see SshRunner.BuildCmd.
|
208 | c92b310a | Michael Hanselmann |
|
209 | a4ccecf6 | Michael Hanselmann | @rtype: L{utils.process.RunResult}
|
210 | a4ccecf6 | Michael Hanselmann | @return: the result as from L{utils.process.RunCmd()}
|
211 | c92b310a | Michael Hanselmann |
|
212 | c92b310a | Michael Hanselmann | """
|
213 | 54ab6aec | Michael Hanselmann | return utils.RunCmd(self.BuildCmd(*args, **kwargs)) |
214 | c92b310a | Michael Hanselmann | |
215 | c92b310a | Michael Hanselmann | def CopyFileToNode(self, node, filename): |
216 | c92b310a | Michael Hanselmann | """Copy a file to another node with scp.
|
217 | c92b310a | Michael Hanselmann |
|
218 | c41eea6e | Iustin Pop | @param node: node in the cluster
|
219 | c41eea6e | Iustin Pop | @param filename: absolute pathname of a local file
|
220 | c92b310a | Michael Hanselmann |
|
221 | c41eea6e | Iustin Pop | @rtype: boolean
|
222 | c41eea6e | Iustin Pop | @return: the success of the operation
|
223 | a8083063 | Iustin Pop |
|
224 | c92b310a | Michael Hanselmann | """
|
225 | c92b310a | Michael Hanselmann | if not os.path.isabs(filename): |
226 | 23828f1c | Iustin Pop | logging.error("File %s must be an absolute path", filename)
|
227 | c92b310a | Michael Hanselmann | return False |
228 | a8083063 | Iustin Pop | |
229 | 1d544ba3 | Michael Hanselmann | if not os.path.isfile(filename): |
230 | 23828f1c | Iustin Pop | logging.error("File %s does not exist", filename)
|
231 | 1d544ba3 | Michael Hanselmann | return False |
232 | 1d544ba3 | Michael Hanselmann | |
233 | 2892a4c9 | Iustin Pop | command = [constants.SCP, "-p"]
|
234 | 652d6694 | Michael Hanselmann | command.extend(self._BuildSshOptions(True, False, True, True)) |
235 | c92b310a | Michael Hanselmann | command.append(filename) |
236 | 8062638d | Manuel Franceschini | if netutils.IP6Address.IsValid(node):
|
237 | 8062638d | Manuel Franceschini | node = netutils.FormatAddress((node, None))
|
238 | 8062638d | Manuel Franceschini | |
239 | cffbbae7 | Michael Hanselmann | command.append("%s:%s" % (node, vcluster.ExchangeNodeRoot(node, filename)))
|
240 | a8083063 | Iustin Pop | |
241 | c92b310a | Michael Hanselmann | result = utils.RunCmd(command) |
242 | a8083063 | Iustin Pop | |
243 | c92b310a | Michael Hanselmann | if result.failed:
|
244 | 9dc45ab1 | Michael Hanselmann | logging.error("Copy to node %s failed (%s) error '%s',"
|
245 | 9dc45ab1 | Michael Hanselmann | " command was '%s'",
|
246 | 23828f1c | Iustin Pop | node, result.fail_reason, result.output, result.cmd) |
247 | a8083063 | Iustin Pop | |
248 | c92b310a | Michael Hanselmann | return not result.failed |
249 | a8083063 | Iustin Pop | |
250 | c92b310a | Michael Hanselmann | def VerifyNodeHostname(self, node): |
251 | c92b310a | Michael Hanselmann | """Verify hostname consistency via SSH.
|
252 | a8083063 | Iustin Pop |
|
253 | c92b310a | Michael Hanselmann | This functions connects via ssh to a node and compares the hostname
|
254 | c92b310a | Michael Hanselmann | reported by the node to the name with have (the one that we
|
255 | c92b310a | Michael Hanselmann | connected to).
|
256 | a8083063 | Iustin Pop |
|
257 | c92b310a | Michael Hanselmann | This is used to detect problems in ssh known_hosts files
|
258 | 5bbd3f7f | Michael Hanselmann | (conflicting known hosts) and inconsistencies between dns/hosts
|
259 | c92b310a | Michael Hanselmann | entries and local machine names
|
260 | a8083063 | Iustin Pop |
|
261 | c41eea6e | Iustin Pop | @param node: nodename of a host to check; can be short or
|
262 | c41eea6e | Iustin Pop | full qualified hostname
|
263 | a8083063 | Iustin Pop |
|
264 | c41eea6e | Iustin Pop | @return: (success, detail), where:
|
265 | c41eea6e | Iustin Pop | - success: True/False
|
266 | c41eea6e | Iustin Pop | - detail: string with details
|
267 | a8083063 | Iustin Pop |
|
268 | c92b310a | Michael Hanselmann | """
|
269 | cffbbae7 | Michael Hanselmann | cmd = ("if test -z \"$GANETI_HOSTNAME\"; then"
|
270 | cffbbae7 | Michael Hanselmann | " hostname --fqdn;"
|
271 | cffbbae7 | Michael Hanselmann | "else"
|
272 | cffbbae7 | Michael Hanselmann | " echo \"$GANETI_HOSTNAME\";"
|
273 | cffbbae7 | Michael Hanselmann | "fi")
|
274 | 052783ff | Michael Hanselmann | retval = self.Run(node, constants.SSH_LOGIN_USER, cmd, quiet=False) |
275 | a8083063 | Iustin Pop | |
276 | c92b310a | Michael Hanselmann | if retval.failed:
|
277 | c92b310a | Michael Hanselmann | msg = "ssh problem"
|
278 | c92b310a | Michael Hanselmann | output = retval.output |
279 | c92b310a | Michael Hanselmann | if output:
|
280 | c92b310a | Michael Hanselmann | msg += ": %s" % output
|
281 | a162cf5b | Iustin Pop | else:
|
282 | a162cf5b | Iustin Pop | msg += ": %s (no output)" % retval.fail_reason
|
283 | 099c52ad | Iustin Pop | logging.error("Command %s failed: %s", retval.cmd, msg)
|
284 | c92b310a | Michael Hanselmann | return False, msg |
285 | a8083063 | Iustin Pop | |
286 | c92b310a | Michael Hanselmann | remotehostname = retval.stdout.strip() |
287 | a8083063 | Iustin Pop | |
288 | c92b310a | Michael Hanselmann | if not remotehostname or remotehostname != node: |
289 | 31821208 | Iustin Pop | if node.startswith(remotehostname + "."): |
290 | 31821208 | Iustin Pop | msg = "hostname not FQDN"
|
291 | 31821208 | Iustin Pop | else:
|
292 | 2175e25d | Manuel Franceschini | msg = "hostname mismatch"
|
293 | 31821208 | Iustin Pop | return False, ("%s: expected %s but got %s" % |
294 | 31821208 | Iustin Pop | (msg, node, remotehostname)) |
295 | a8083063 | Iustin Pop | |
296 | c92b310a | Michael Hanselmann | return True, "host matches" |
297 | 75a5f456 | Michael Hanselmann | |
298 | 75a5f456 | Michael Hanselmann | |
299 | 7688d0d3 | Michael Hanselmann | def WriteKnownHostsFile(cfg, file_name): |
300 | 75a5f456 | Michael Hanselmann | """Writes the cluster-wide equally known_hosts file.
|
301 | 75a5f456 | Michael Hanselmann |
|
302 | 75a5f456 | Michael Hanselmann | """
|
303 | a3f9f296 | Guido Trotter | utils.WriteFile(file_name, mode=0600,
|
304 | 7688d0d3 | Michael Hanselmann | data="%s ssh-rsa %s\n" % (cfg.GetClusterName(),
|
305 | 75a5f456 | Michael Hanselmann | cfg.GetHostKey())) |