cloudflare/cloudflared

Public

mirrored from https://github.com/cloudflare/cloudflaredAvailable

CodeCommitsIssuesPull requestsActionsInsightsSecurity
2025.11.0

Branches

Tags

  • No tags available.
0Branches0Tags
Go to file
Add file
Code

Clone

HTTPS

Download ZIP

component-tests/cli.py

127lines · modeblame

e921ab35Devin Carr4 years ago1import json
2import subprocess
3from time import sleep
4
ee5e447dDevin Carr3 years ago5from constants import MANAGEMENT_HOST_NAME
e921ab35Devin Carr4 years ago6from setup import get_config_from_file
ee5e447dDevin Carr3 years ago7from util import get_tunnel_connector_id
e921ab35Devin Carr4 years ago8
9SINGLE_CASE_TIMEOUT = 600
10
11class CloudflaredCli:
12def __init__(self, config, config_path, logger):
13self.basecmd = [config.cloudflared_binary, "tunnel"]
14if config_path is not None:
15self.basecmd += ["--config", str(config_path)]
16origincert = get_config_from_file()["origincert"]
17if origincert:
18self.basecmd += ["--origincert", origincert]
19self.logger = logger
20
21def _run_command(self, subcmd, subcmd_name, needs_to_pass=True):
22cmd = self.basecmd + subcmd
23# timeout limits the time a subprocess can run. This is useful to guard against running a tunnel when
24# command/args are in wrong order.
25result = run_subprocess(cmd, subcmd_name, self.logger, check=needs_to_pass, capture_output=True, timeout=15)
26return result
27
28def list_tunnels(self):
29cmd_args = ["list", "--output", "json"]
30listed = self._run_command(cmd_args, "list")
31return json.loads(listed.stdout)
32
5e212a6bSudarsan Reddy3 years ago33def get_management_token(self, config, config_path):
34basecmd = [config.cloudflared_binary]
35if config_path is not None:
36basecmd += ["--config", str(config_path)]
37origincert = get_config_from_file()["origincert"]
38if origincert:
39basecmd += ["--origincert", origincert]
40
41cmd_args = ["tail", "token", config.get_tunnel_id()]
42cmd = basecmd + cmd_args
43result = run_subprocess(cmd, "token", self.logger, check=True, capture_output=True, timeout=15)
44return json.loads(result.stdout.decode("utf-8").strip())["token"]
ee5e447dDevin Carr3 years ago45
46def get_management_url(self, path, config, config_path):
47access_jwt = self.get_management_token(config, config_path)
48connector_id = get_tunnel_connector_id()
49return f"https://{MANAGEMENT_HOST_NAME}/{path}?connector_id={connector_id}&access_token={access_jwt}"
50
51def get_management_wsurl(self, path, config, config_path):
52access_jwt = self.get_management_token(config, config_path)
53connector_id = get_tunnel_connector_id()
54return f"wss://{MANAGEMENT_HOST_NAME}/{path}?connector_id={connector_id}&access_token={access_jwt}"
5e212a6bSudarsan Reddy3 years ago55
56def get_connector_id(self, config):
57op = self.get_tunnel_info(config.get_tunnel_id())
58connectors = []
59for conn in op["conns"]:
60connectors.append(conn["id"])
61return connectors
62
e921ab35Devin Carr4 years ago63def get_tunnel_info(self, tunnel_id):
64info = self._run_command(["info", "--output", "json", tunnel_id], "info")
65return json.loads(info.stdout)
66
67def __enter__(self):
68self.basecmd += ["run"]
69self.process = subprocess.Popen(self.basecmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
70self.logger.info(f"Run cmd {self.basecmd}")
71return self.process
72
73def __exit__(self, exc_type, exc_value, exc_traceback):
74terminate_gracefully(self.process, self.logger, self.basecmd)
75self.logger.debug(f"{self.basecmd} logs: {self.process.stderr.read()}")
76
77
78def terminate_gracefully(process, logger, cmd):
79process.terminate()
80process_terminated = wait_for_terminate(process)
81if not process_terminated:
82process.kill()
83logger.warning(f"{cmd}: cloudflared did not terminate within wait period. Killing process. logs: \
84stdout: {process.stdout.read()}, stderr: {process.stderr.read()}")
85
86
87def wait_for_terminate(opened_subprocess, attempts=10, poll_interval=1):
88"""
89wait_for_terminate polls the opened_subprocess every x seconds for a given number of attempts.
90It returns true if the subprocess was terminated and false if it didn't.
91"""
92for _ in range(attempts):
93if _is_process_stopped(opened_subprocess):
94return True
95sleep(poll_interval)
96return False
97
98
99def _is_process_stopped(process):
100return process.poll() is not None
101
102
103def cert_path():
104return get_config_from_file()["origincert"]
105
106
107class SubprocessError(Exception):
108def __init__(self, program, exit_code, cause):
109self.program = program
110self.exit_code = exit_code
111self.cause = cause
112
113
114def run_subprocess(cmd, cmd_name, logger, timeout=SINGLE_CASE_TIMEOUT, **kargs):
115kargs["timeout"] = timeout
116try:
117result = subprocess.run(cmd, **kargs)
118logger.debug(f"{cmd} log: {result.stdout}", extra={"cmd": cmd_name})
119return result
120except subprocess.CalledProcessError as e:
121err = f"{cmd} return exit code {e.returncode}, stderr" + e.stderr.decode("utf-8")
122logger.error(err, extra={"cmd": cmd_name, "return_code": e.returncode})
123raise SubprocessError(cmd[0], e.returncode, e)
124except subprocess.TimeoutExpired as e:
125err = f"{cmd} timeout after {e.timeout} seconds, stdout: {e.stdout}, stderr: {e.stderr}"
126logger.error(err, extra={"cmd": cmd_name, "return_code": "timeout"})
127raise e