Hook for SSH connections.
- class airflow.providers.ssh.hooks.ssh.SSHHook(ssh_conn_id=None, remote_host='', username=None, password=None, key_file=None, port=None, timeout=None, conn_timeout=None, cmd_timeout=NOTSET, keepalive_interval=30, banner_timeout=30.0, disabled_algorithms=None, ciphers=None)[source]¶
Hook for ssh remote execution using Paramiko. ref: https://github.com/paramiko/paramiko This hook also lets you create ssh tunnel and serve as basis for SFTP file transfer
ssh_conn_id (str | None) – ssh connection id from airflow Connections from where all the required parameters can be fetched like username, password or key_file, though priority is given to the params passed during init.
remote_host (str) – remote host to connect
username (str | None) – username to connect to the remote_host
password (str | None) – password of the username to connect to the remote_host
key_file (str | None) – path to key file to use to connect to the remote_host
port (int | None) – port of remote host to connect (Default is paramiko SSH_PORT)
conn_timeout (int | None) – timeout (in seconds) for the attempt to connect to the remote_host. The default is 10 seconds. If provided, it will replace the conn_timeout which was predefined in the connection of ssh_conn_id.
timeout (int | None) – (Deprecated). timeout for the attempt to connect to the remote_host. Use conn_timeout instead.
cmd_timeout (int | ArgNotSet | None) – timeout (in seconds) for executing the command. The default is 10 seconds. Nullable, None means no timeout. If provided, it will replace the cmd_timeout which was predefined in the connection of ssh_conn_id.
keepalive_interval (int) – send a keepalive packet to remote host every keepalive_interval seconds
banner_timeout (float) – timeout to wait for banner from the server in seconds
disabled_algorithms (dict | None) – dictionary mapping algorithm type to an iterable of algorithm identifiers, which will be disabled for the lifetime of the transport
ciphers (list[str] | None) – list of ciphers to use in order of preference
- get_tunnel(remote_port, remote_host='localhost', local_port=None)[source]¶
Creates a tunnel between two hosts. Like ssh -L <LOCAL_PORT>:host:<REMOTE_PORT>.
- create_tunnel(local_port, remote_port, remote_host='localhost')[source]¶
Creates tunnel for SSH connection [Deprecated].