X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/75a5f45659847d623c83f3cf2e2fbbf8e621b15b..e85d8982477abfc025edb9f7f40f343afa9e89be:/lib/ssh.py diff --git a/lib/ssh.py b/lib/ssh.py index 7cc055b..ee8aba6 100644 --- a/lib/ssh.py +++ b/lib/ssh.py @@ -1,7 +1,7 @@ # # -# Copyright (C) 2006, 2007 Google Inc. +# Copyright (C) 2006, 2007, 2010 Google Inc. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -25,34 +25,25 @@ import os +import logging +import re -from ganeti import logger from ganeti import utils from ganeti import errors from ganeti import constants +from ganeti import netutils -__all__ = ["SSHCall", "CopyFileToNode", "VerifyNodeHostname", - "KNOWN_HOSTS_OPTS", "BATCH_MODE_OPTS", "ASK_KEY_OPTS"] +def FormatParamikoFingerprint(fingerprint): + """Format paramiko PKey fingerprint. + @type fingerprint: str + @param fingerprint: PKey fingerprint + @return: The string hex representation of the fingerprint -KNOWN_HOSTS_OPTS = [ - "-oGlobalKnownHostsFile=%s" % constants.SSH_KNOWN_HOSTS_FILE, - "-oUserKnownHostsFile=/dev/null", - ] - -# Note: BATCH_MODE conflicts with ASK_KEY -BATCH_MODE_OPTS = [ - "-oEscapeChar=none", - "-oBatchMode=yes", - "-oStrictHostKeyChecking=yes", - ] - -ASK_KEY_OPTS = [ - "-oStrictHostKeyChecking=ask", - "-oEscapeChar=none", - "-oHashKnownHosts=no", - ] + """ + assert len(fingerprint) % 2 == 0 + return ":".join(re.findall(r"..", fingerprint.lower())) def GetUserFiles(user, mkdir=False): @@ -75,149 +66,223 @@ def GetUserFiles(user, mkdir=False): if not user_dir: raise errors.OpExecError("Cannot resolve home of user %s" % user) - ssh_dir = os.path.join(user_dir, ".ssh") - if not os.path.lexists(ssh_dir): - if mkdir: - try: - os.mkdir(ssh_dir, 0700) - except EnvironmentError, err: - raise errors.OpExecError("Can't create .ssh dir for user %s: %s" % - (user, str(err))) + ssh_dir = utils.PathJoin(user_dir, ".ssh") + if mkdir: + utils.EnsureDirs([(ssh_dir, constants.SECURE_DIR_MODE)]) elif not os.path.isdir(ssh_dir): - raise errors.OpExecError("path ~%s/.ssh is not a directory" % user) + raise errors.OpExecError("Path %s is not a directory" % ssh_dir) - return [os.path.join(ssh_dir, base) + return [utils.PathJoin(ssh_dir, base) for base in ["id_dsa", "id_dsa.pub", "authorized_keys"]] -def BuildSSHCmd(hostname, user, command, batch=True, ask_key=False): - """Build an ssh string to execute a command on a remote node. - - Args: - hostname: the target host, string - user: user to auth as - command: the command - batch: if true, ssh will run in batch mode with no prompting - ask_key: if true, ssh will run with StrictHostKeyChecking=ask, so that - we can connect to an unknown host (not valid in batch mode) - - Returns: - The ssh call to run 'command' on the remote host. +class SshRunner: + """Wrapper for SSH commands. """ - argv = ["ssh", "-q"] - argv.extend(KNOWN_HOSTS_OPTS) - if batch: - # if we are in batch mode, we can't ask the key - if ask_key: - raise errors.ProgrammerError("SSH call requested conflicting options") - argv.extend(BATCH_MODE_OPTS) - elif ask_key: - argv.extend(ASK_KEY_OPTS) - argv.extend(["%s@%s" % (user, hostname), command]) - return argv - - -def SSHCall(hostname, user, command, batch=True, ask_key=False): - """Execute a command on a remote node. - - This method has the same return value as `utils.RunCmd()`, which it - uses to launch ssh. - - Args: - hostname: the target host, string - user: user to auth as - command: the command - batch: if true, ssh will run in batch mode with no prompting - ask_key: if true, ssh will run with StrictHostKeyChecking=ask, so that - we can connect to an unknown host (not valid in batch mode) - - Returns: - `utils.RunResult` as for `utils.RunCmd()` + def __init__(self, cluster_name, ipv6=False): + """Initializes this class. + + @type cluster_name: str + @param cluster_name: name of the cluster + @type ipv6: bool + @param ipv6: If true, force ssh to use IPv6 addresses only + + """ + self.cluster_name = cluster_name + self.ipv6 = ipv6 + + def _BuildSshOptions(self, batch, ask_key, use_cluster_key, + strict_host_check, private_key=None, quiet=True): + """Builds a list with needed SSH options. + + @param batch: same as ssh's batch option + @param ask_key: allows ssh to ask for key confirmation; this + parameter conflicts with the batch one + @param use_cluster_key: if True, use the cluster name as the + HostKeyAlias name + @param strict_host_check: this makes the host key checking strict + @param private_key: use this private key instead of the default + @param quiet: whether to enable -q to ssh + + @rtype: list + @return: the list of options ready to use in L{utils.process.RunCmd} + + """ + options = [ + "-oEscapeChar=none", + "-oHashKnownHosts=no", + "-oGlobalKnownHostsFile=%s" % constants.SSH_KNOWN_HOSTS_FILE, + "-oUserKnownHostsFile=/dev/null", + "-oCheckHostIp=no", + ] + + if use_cluster_key: + options.append("-oHostKeyAlias=%s" % self.cluster_name) + + if quiet: + options.append("-q") + + if private_key: + options.append("-i%s" % private_key) + + # TODO: Too many boolean options, maybe convert them to more descriptive + # constants. + + # Note: ask_key conflicts with batch mode + if batch: + if ask_key: + raise errors.ProgrammerError("SSH call requested conflicting options") + + options.append("-oBatchMode=yes") + + if strict_host_check: + options.append("-oStrictHostKeyChecking=yes") + else: + options.append("-oStrictHostKeyChecking=no") + + else: + # non-batch mode + + if ask_key: + options.append("-oStrictHostKeyChecking=ask") + elif strict_host_check: + options.append("-oStrictHostKeyChecking=yes") + else: + options.append("-oStrictHostKeyChecking=no") + + if self.ipv6: + options.append("-6") + + return options + + def BuildCmd(self, hostname, user, command, batch=True, ask_key=False, + tty=False, use_cluster_key=True, strict_host_check=True, + private_key=None, quiet=True): + """Build an ssh command to execute a command on a remote node. + + @param hostname: the target host, string + @param user: user to auth as + @param command: the command + @param batch: if true, ssh will run in batch mode with no prompting + @param ask_key: if true, ssh will run with + StrictHostKeyChecking=ask, so that we can connect to an + unknown host (not valid in batch mode) + @param use_cluster_key: whether to expect and use the + cluster-global SSH key + @param strict_host_check: whether to check the host's SSH key at all + @param private_key: use this private key instead of the default + @param quiet: whether to enable -q to ssh + + @return: the ssh call to run 'command' on the remote host. + + """ + argv = [constants.SSH] + argv.extend(self._BuildSshOptions(batch, ask_key, use_cluster_key, + strict_host_check, private_key, + quiet=quiet)) + if tty: + argv.extend(["-t", "-t"]) + argv.extend(["%s@%s" % (user, hostname), command]) + return argv + + def Run(self, *args, **kwargs): + """Runs a command on a remote node. + + This method has the same return value as `utils.RunCmd()`, which it + uses to launch ssh. + + Args: see SshRunner.BuildCmd. + + @rtype: L{utils.process.RunResult} + @return: the result as from L{utils.process.RunCmd()} + + """ + return utils.RunCmd(self.BuildCmd(*args, **kwargs)) + + def CopyFileToNode(self, node, filename): + """Copy a file to another node with scp. - """ - return utils.RunCmd(BuildSSHCmd(hostname, user, command, - batch=batch, ask_key=ask_key)) + @param node: node in the cluster + @param filename: absolute pathname of a local file + @rtype: boolean + @return: the success of the operation + + """ + if not os.path.isabs(filename): + logging.error("File %s must be an absolute path", filename) + return False -def CopyFileToNode(node, filename): - """Copy a file to another node with scp. + if not os.path.isfile(filename): + logging.error("File %s does not exist", filename) + return False - Args: - node: node in the cluster - filename: absolute pathname of a local file + command = [constants.SCP, "-p"] + command.extend(self._BuildSshOptions(True, False, True, True)) + command.append(filename) + if netutils.IP6Address.IsValid(node): + node = netutils.FormatAddress((node, None)) - Returns: - success: True/False + command.append("%s:%s" % (node, filename)) - """ - if not os.path.isfile(filename): - logger.Error("file %s does not exist" % (filename)) - return False + result = utils.RunCmd(command) - if not os.path.isabs(filename): - logger.Error("file %s must be an absolute path" % (filename)) - return False + if result.failed: + logging.error("Copy to node %s failed (%s) error %s," + " command was %s", + node, result.fail_reason, result.output, result.cmd) - command = ["scp", "-q", "-p"] - command.extend(KNOWN_HOSTS_OPTS) - command.extend(BATCH_MODE_OPTS) - command.append(filename) - command.append("%s:%s" % (node, filename)) + return not result.failed - result = utils.RunCmd(command) + def VerifyNodeHostname(self, node): + """Verify hostname consistency via SSH. - if result.failed: - logger.Error("copy to node %s failed (%s) error %s," - " command was %s" % - (node, result.fail_reason, result.output, result.cmd)) + This functions connects via ssh to a node and compares the hostname + reported by the node to the name with have (the one that we + connected to). - return not result.failed + This is used to detect problems in ssh known_hosts files + (conflicting known hosts) and inconsistencies between dns/hosts + entries and local machine names + @param node: nodename of a host to check; can be short or + full qualified hostname -def VerifyNodeHostname(node): - """Verify hostname consistency via SSH. + @return: (success, detail), where: + - success: True/False + - detail: string with details + """ + retval = self.Run(node, 'root', 'hostname --fqdn') - This functions connects via ssh to a node and compares the hostname - reported by the node to the name with have (the one that we - connected to). - - This is used to detect problems in ssh known_hosts files - (conflicting known hosts) and incosistencies between dns/hosts - entries and local machine names - - Args: - node: nodename of a host to check. can be short or full qualified hostname - - Returns: - (success, detail) - where - success: True/False - detail: String with details - - """ - retval = SSHCall(node, 'root', 'hostname') - - if retval.failed: - msg = "ssh problem" - output = retval.output - if output: - msg += ": %s" % output - return False, msg + if retval.failed: + msg = "ssh problem" + output = retval.output + if output: + msg += ": %s" % output + else: + msg += ": %s (no output)" % retval.fail_reason + logging.error("Command %s failed: %s", retval.cmd, msg) + return False, msg - remotehostname = retval.stdout.strip() + remotehostname = retval.stdout.strip() - if not remotehostname or remotehostname != node: - return False, "hostname mismatch, got %s" % remotehostname + if not remotehostname or remotehostname != node: + if node.startswith(remotehostname + "."): + msg = "hostname not FQDN" + else: + msg = "hostname mismatch" + return False, ("%s: expected %s but got %s" % + (msg, node, remotehostname)) - return True, "host matches" + return True, "host matches" -def WriteKnownHostsFile(cfg, sstore, file_name): +def WriteKnownHostsFile(cfg, file_name): """Writes the cluster-wide equally known_hosts file. """ - utils.WriteFile(file_name, mode=0700, - data="%s ssh-rsa %s\n" % (sstore.GetClusterName(), + utils.WriteFile(file_name, mode=0600, + data="%s ssh-rsa %s\n" % (cfg.GetClusterName(), cfg.GetHostKey()))