mirror of
https://github.com/ansible-collections/community.general.git
synced 2026-02-04 07:51:50 +00:00
107 lines
3.4 KiB
Python
107 lines
3.4 KiB
Python
# Based on local.py (c) 2012, Michael DeHaan <michael.dehaan@gmail.com>
|
|
# Based on chroot.py (c) 2013, Maykel Moya <mmoya@speedyrails.com>
|
|
# Copyright (c) 2013, Michael Scherer <misc@zarb.org>
|
|
# Copyright (c) 2017 Ansible Project
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
DOCUMENTATION = r"""
|
|
author: Michael Scherer (@mscherer) <misc@zarb.org>
|
|
name: funcd
|
|
short_description: Use funcd to connect to target
|
|
description:
|
|
- This transport permits you to use Ansible over Func.
|
|
- For people who have already setup func and that wish to play with ansible, this permit to move gradually to ansible without
|
|
having to redo completely the setup of the network.
|
|
options:
|
|
remote_addr:
|
|
description:
|
|
- The path of the chroot you want to access.
|
|
type: string
|
|
default: inventory_hostname
|
|
vars:
|
|
- name: ansible_host
|
|
- name: ansible_func_host
|
|
"""
|
|
|
|
HAVE_FUNC = False
|
|
try:
|
|
import func.overlord.client as fc
|
|
|
|
HAVE_FUNC = True
|
|
except ImportError:
|
|
pass
|
|
|
|
import os
|
|
import shutil
|
|
import tempfile
|
|
|
|
from ansible.errors import AnsibleError
|
|
from ansible.plugins.connection import ConnectionBase
|
|
from ansible.utils.display import Display
|
|
|
|
display = Display()
|
|
|
|
|
|
class Connection(ConnectionBase):
|
|
"""Func-based connections"""
|
|
|
|
has_pipelining = False
|
|
|
|
def __init__(self, runner, host, port, *args, **kwargs):
|
|
self.runner = runner
|
|
self.host = host
|
|
# port is unused, this go on func
|
|
self.port = port
|
|
self.client = None
|
|
|
|
def connect(self, port=None):
|
|
if not HAVE_FUNC:
|
|
raise AnsibleError("func is not installed")
|
|
|
|
self.client = fc.Client(self.host)
|
|
return self
|
|
|
|
def exec_command(self, cmd, in_data=None, sudoable=True):
|
|
"""run a command on the remote minion"""
|
|
|
|
if in_data:
|
|
raise AnsibleError("Internal Error: this module does not support optimized module pipelining")
|
|
|
|
# totally ignores privilege escalation
|
|
display.vvv(f"EXEC {cmd}", host=self.host)
|
|
p = self.client.command.run(cmd)[self.host]
|
|
return p[0], p[1], p[2]
|
|
|
|
@staticmethod
|
|
def _normalize_path(path, prefix):
|
|
if not path.startswith(os.path.sep):
|
|
path = os.path.join(os.path.sep, path)
|
|
normpath = os.path.normpath(path)
|
|
return os.path.join(prefix, normpath[1:])
|
|
|
|
def put_file(self, in_path, out_path):
|
|
"""transfer a file from local to remote"""
|
|
|
|
out_path = self._normalize_path(out_path, "/")
|
|
display.vvv(f"PUT {in_path} TO {out_path}", host=self.host)
|
|
self.client.local.copyfile.send(in_path, out_path)
|
|
|
|
def fetch_file(self, in_path, out_path):
|
|
"""fetch a file from remote to local"""
|
|
|
|
in_path = self._normalize_path(in_path, "/")
|
|
display.vvv(f"FETCH {in_path} TO {out_path}", host=self.host)
|
|
# need to use a tmp dir due to difference of semantic for getfile
|
|
# ( who take a # directory as destination) and fetch_file, who
|
|
# take a file directly
|
|
tmpdir = tempfile.mkdtemp(prefix="func_ansible")
|
|
self.client.local.getfile.get(in_path, tmpdir)
|
|
shutil.move(os.path.join(tmpdir, self.host, os.path.basename(in_path)), out_path)
|
|
shutil.rmtree(tmpdir)
|
|
|
|
def close(self):
|
|
"""terminate the connection; nothing to do here"""
|
|
pass
|