Files
2026-07-13 13:17:40 +08:00

577 lines
25 KiB
Python

import logging
import os
import subprocess
import time
import traceback
from threading import Thread
from typing import Any, Dict, List, Optional
import click
from ray._common.usage import usage_constants, usage_lib
from ray.autoscaler._private import subprocess_output_util as cmd_output_util
from ray.autoscaler._private.cli_logger import cf, cli_logger
from ray.autoscaler._private.command_runner import (
AUTOSCALER_NODE_START_WAIT_S,
ProcessRunnerError,
)
from ray.autoscaler._private.constants import (
LABELS_ENVIRONMENT_VARIABLE,
RESOURCES_ENVIRONMENT_VARIABLE,
)
from ray.autoscaler._private.event_system import CreateClusterEvent, global_event_system
from ray.autoscaler._private.log_timer import LogTimer
from ray.autoscaler.tags import (
STATUS_SETTING_UP,
STATUS_SYNCING_FILES,
STATUS_UP_TO_DATE,
STATUS_UPDATE_FAILED,
STATUS_WAITING_FOR_SSH,
TAG_RAY_FILE_MOUNTS_CONTENTS,
TAG_RAY_NODE_STATUS,
TAG_RAY_RUNTIME_CONFIG,
)
logger = logging.getLogger(__name__)
NUM_SETUP_STEPS = 7
READY_CHECK_INTERVAL = 5
class NodeUpdater:
"""A process for syncing files and running init commands on a node.
Arguments:
node_id: the Node ID
provider_config: Provider section of autoscaler yaml
provider: NodeProvider Class
auth_config: Auth section of autoscaler yaml
cluster_name: the name of the cluster.
file_mounts: Map of remote to local paths
initialization_commands: Commands run before container launch
setup_commands: Commands run before ray starts
ray_start_commands: Commands to start ray
runtime_hash: Used to check for config changes
file_mounts_contents_hash: Used to check for changes to file mounts
is_head_node: Whether to use head start/setup commands
node_resources: Optional resources string that the raylet should
advertise on startup.
node_labels: Optional labels for the node.
cluster_synced_files: Files synced from the head to worker nodes after
the head node finishes its setup.
rsync_options: Extra options related to the rsync command.
process_runner: the module to use to run the commands
in the CommandRunner. E.g., subprocess.
use_internal_ip: Wwhether the node_id belongs to an internal ip
or external ip.
docker_config: Docker section of autoscaler yaml
restart_only: Whether to skip setup commands & just restart ray
for_recovery: True if updater is for a recovering node. Only used for
metric tracking.
"""
def __init__(
self,
node_id: str,
provider_config: dict,
provider: Any,
auth_config: dict,
cluster_name: str,
file_mounts: dict,
initialization_commands: list,
setup_commands: list,
ray_start_commands: list,
runtime_hash: str,
file_mounts_contents_hash: str,
is_head_node: bool,
node_resources: Optional[str] = None,
node_labels: Optional[Dict[str, str]] = None,
cluster_synced_files: Optional[List[str]] = None,
rsync_options: Optional[Dict[str, Any]] = None,
process_runner: Any = subprocess,
use_internal_ip: bool = False,
docker_config: Optional[Dict[str, Any]] = None,
restart_only: bool = False,
for_recovery: bool = False,
):
self.log_prefix = "NodeUpdater: {}: ".format(node_id)
# Three cases:
# 1) use_internal_ip arg is True -> use_internal_ip is True
# 2) worker node -> use value of provider_config["use_internal_ips"]
# 3) head node -> use value of provider_config["use_internal_ips"] unless
# overridden by provider_config["use_external_head_ip"]
use_internal_ip = use_internal_ip or (
provider_config.get("use_internal_ips", False)
and not (
is_head_node and provider_config.get("use_external_head_ip", False)
)
)
self.cmd_runner = provider.get_command_runner(
self.log_prefix,
node_id,
auth_config,
cluster_name,
process_runner,
use_internal_ip,
docker_config,
)
self.daemon = True
self.node_id = node_id
self.provider_type = provider_config.get("type")
self.provider = provider
# Some node providers don't specify empty structures as
# defaults. Better to be defensive.
file_mounts = file_mounts or {}
self.file_mounts = {
remote: os.path.expanduser(local) for remote, local in file_mounts.items()
}
self.initialization_commands = initialization_commands
self.setup_commands = setup_commands
self.ray_start_commands = ray_start_commands
self.node_resources = node_resources
self.node_labels = node_labels
self.runtime_hash = runtime_hash
self.file_mounts_contents_hash = file_mounts_contents_hash
# TODO (Alex): This makes the assumption that $HOME on the head and
# worker nodes is the same. Also note that `cluster_synced_files` is
# set on the head -> worker updaters only (so `expanduser` is only run
# on the head node).
cluster_synced_files = cluster_synced_files or []
self.cluster_synced_files = [
os.path.expanduser(path) for path in cluster_synced_files
]
self.rsync_options = rsync_options or {}
self.auth_config = auth_config
self.is_head_node = is_head_node
self.docker_config = docker_config
self.restart_only = restart_only
self.update_time = None
self.for_recovery = for_recovery
def run(self):
update_start_time = time.time()
if (
cmd_output_util.does_allow_interactive()
and cmd_output_util.is_output_redirected()
):
# this is most probably a bug since the user has no control
# over these settings
msg = (
"Output was redirected for an interactive command. "
"Either do not pass `--redirect-command-output` "
"or also pass in `--use-normal-shells`."
)
cli_logger.abort(msg)
try:
with LogTimer(
self.log_prefix + "Applied config {}".format(self.runtime_hash)
):
self.do_update()
except Exception as e:
self.provider.set_node_tags(
self.node_id, {TAG_RAY_NODE_STATUS: STATUS_UPDATE_FAILED}
)
cli_logger.error("New status: {}", cf.bold(STATUS_UPDATE_FAILED))
cli_logger.error("!!!")
if hasattr(e, "cmd"):
stderr_output = getattr(e, "stderr", "No stderr available")
cli_logger.error(
"Setup command `{}` failed with exit code {}. stderr: {}",
cf.bold(e.cmd),
e.returncode,
stderr_output,
)
else:
cli_logger.verbose_error("Exception details: {}", str(vars(e)))
full_traceback = traceback.format_exc()
cli_logger.error("Full traceback: {}", full_traceback)
# todo: handle this better somehow?
cli_logger.error("Error message: {}", str(e))
cli_logger.error("!!!")
cli_logger.newline()
if isinstance(e, click.ClickException):
# todo: why do we ignore this here
return
raise
tags_to_set = {
TAG_RAY_NODE_STATUS: STATUS_UP_TO_DATE,
TAG_RAY_RUNTIME_CONFIG: self.runtime_hash,
}
if self.file_mounts_contents_hash is not None:
tags_to_set[TAG_RAY_FILE_MOUNTS_CONTENTS] = self.file_mounts_contents_hash
self.provider.set_node_tags(self.node_id, tags_to_set)
cli_logger.labeled_value("New status", STATUS_UP_TO_DATE)
self.update_time = time.time() - update_start_time
self.exitcode = 0
def sync_file_mounts(self, sync_cmd, step_numbers=(0, 2)):
# step_numbers is (# of previous steps, total steps)
previous_steps, total_steps = step_numbers
nolog_paths = []
if cli_logger.verbosity == 0:
nolog_paths = ["~/ray_bootstrap_key.pem", "~/ray_bootstrap_config.yaml"]
def do_sync(remote_path, local_path, allow_non_existing_paths=False):
if allow_non_existing_paths and not os.path.exists(local_path):
cli_logger.print("sync: {} does not exist. Skipping.", local_path)
# Ignore missing source files. In the future we should support
# the --delete-missing-args command to delete files that have
# been removed
return
assert os.path.exists(local_path), local_path
if os.path.isdir(local_path):
if not local_path.endswith("/"):
local_path += "/"
if not remote_path.endswith("/"):
remote_path += "/"
with LogTimer(
self.log_prefix + "Synced {} to {}".format(local_path, remote_path)
):
is_docker = (
self.docker_config and self.docker_config["container_name"] != ""
)
if not is_docker:
# The DockerCommandRunner handles this internally.
self.cmd_runner.run(
"mkdir -p {}".format(os.path.dirname(remote_path)),
run_env="host",
)
sync_cmd(local_path, remote_path, docker_mount_if_possible=True)
if remote_path not in nolog_paths:
# todo: timed here?
cli_logger.print(
"{} from {}", cf.bold(remote_path), cf.bold(local_path)
)
# Rsync file mounts
with cli_logger.group(
"Processing file mounts", _numbered=("[]", previous_steps + 1, total_steps)
):
for remote_path, local_path in self.file_mounts.items():
do_sync(remote_path, local_path)
previous_steps += 1
if self.cluster_synced_files:
with cli_logger.group(
"Processing worker file mounts",
_numbered=("[]", previous_steps + 1, total_steps),
):
cli_logger.print("synced files: {}", str(self.cluster_synced_files))
for path in self.cluster_synced_files:
do_sync(path, path, allow_non_existing_paths=True)
previous_steps += 1
else:
cli_logger.print(
"No worker file mounts to sync",
_numbered=("[]", previous_steps + 1, total_steps),
)
def wait_ready(self, deadline):
with cli_logger.group(
"Waiting for SSH to become available", _numbered=("[]", 1, NUM_SETUP_STEPS)
):
with LogTimer(self.log_prefix + "Got remote shell"):
cli_logger.print("Running `{}` as a test.", cf.bold("uptime"))
first_conn_refused_time = None
while True:
if time.time() > deadline:
raise Exception("wait_ready timeout exceeded.")
if self.provider.is_terminated(self.node_id):
raise Exception(
"wait_ready aborting because node "
"detected as terminated."
)
try:
# Run outside of the container
self.cmd_runner.run("uptime", timeout=10, run_env="host")
cli_logger.success("Success.")
return True
except ProcessRunnerError as e:
first_conn_refused_time = cmd_output_util.handle_ssh_fails(
e,
first_conn_refused_time,
retry_interval=READY_CHECK_INTERVAL,
)
time.sleep(READY_CHECK_INTERVAL)
except Exception as e:
# TODO(maximsmol): we should not be ignoring
# exceptions if they get filtered properly
# (new style log + non-interactive shells)
#
# however threading this configuration state
# is a pain and I'm leaving it for later
retry_str = "(" + str(e) + ")"
if hasattr(e, "cmd"):
if isinstance(e.cmd, str):
cmd_ = e.cmd
elif isinstance(e.cmd, list):
cmd_ = " ".join(e.cmd)
else:
logger.debug(
f"e.cmd type ({type(e.cmd)}) not list or str."
)
cmd_ = str(e.cmd)
retry_str = "(Exit Status {}): {}".format(
e.returncode, cmd_
)
cli_logger.print(
"SSH still not available {}, retrying in {} seconds.",
cf.dimmed(retry_str),
cf.bold(str(READY_CHECK_INTERVAL)),
)
time.sleep(READY_CHECK_INTERVAL)
def do_update(self):
self.provider.set_node_tags(
self.node_id, {TAG_RAY_NODE_STATUS: STATUS_WAITING_FOR_SSH}
)
cli_logger.labeled_value("New status", STATUS_WAITING_FOR_SSH)
deadline = time.time() + AUTOSCALER_NODE_START_WAIT_S
self.wait_ready(deadline)
global_event_system.execute_callback(CreateClusterEvent.ssh_control_acquired)
node_tags = self.provider.node_tags(self.node_id)
logger.debug("Node tags: {}".format(str(node_tags)))
if self.provider_type == "aws" and self.provider.provider_config:
from ray.autoscaler._private.aws.cloudwatch.cloudwatch_helper import (
CloudwatchHelper,
)
CloudwatchHelper(
self.provider.provider_config, self.node_id, self.provider.cluster_name
).update_from_config(self.is_head_node)
if node_tags.get(TAG_RAY_RUNTIME_CONFIG) == self.runtime_hash:
# When resuming from a stopped instance the runtime_hash may be the
# same, but the container will not be started.
init_required = self.cmd_runner.run_init(
as_head=self.is_head_node,
file_mounts=self.file_mounts,
sync_run_yet=False,
)
if init_required:
node_tags[TAG_RAY_RUNTIME_CONFIG] += "-invalidate"
# This ensures that `setup_commands` are not removed
self.restart_only = False
if self.restart_only:
self.setup_commands = []
# runtime_hash will only change whenever the user restarts
# or updates their cluster with `get_or_create_head_node`
if node_tags.get(TAG_RAY_RUNTIME_CONFIG) == self.runtime_hash and (
not self.file_mounts_contents_hash
or node_tags.get(TAG_RAY_FILE_MOUNTS_CONTENTS)
== self.file_mounts_contents_hash
):
# todo: we lie in the confirmation message since
# full setup might be cancelled here
cli_logger.print(
"Configuration already up to date, "
"skipping file mounts, initalization and setup commands.",
_numbered=("[]", "2-6", NUM_SETUP_STEPS),
)
else:
cli_logger.print(
"Updating cluster configuration.", _tags=dict(hash=self.runtime_hash)
)
self.provider.set_node_tags(
self.node_id, {TAG_RAY_NODE_STATUS: STATUS_SYNCING_FILES}
)
cli_logger.labeled_value("New status", STATUS_SYNCING_FILES)
self.sync_file_mounts(self.rsync_up, step_numbers=(1, NUM_SETUP_STEPS))
# Only run setup commands if runtime_hash has changed because
# we don't want to run setup_commands every time the head node
# file_mounts folders have changed.
if node_tags.get(TAG_RAY_RUNTIME_CONFIG) != self.runtime_hash:
# Run init commands
self.provider.set_node_tags(
self.node_id, {TAG_RAY_NODE_STATUS: STATUS_SETTING_UP}
)
cli_logger.labeled_value("New status", STATUS_SETTING_UP)
if self.initialization_commands:
with cli_logger.group(
"Running initialization commands",
_numbered=("[]", 4, NUM_SETUP_STEPS),
):
global_event_system.execute_callback(
CreateClusterEvent.run_initialization_cmd
)
with LogTimer(
self.log_prefix + "Initialization commands",
show_status=True,
):
for cmd in self.initialization_commands:
global_event_system.execute_callback(
CreateClusterEvent.run_initialization_cmd,
{"command": cmd},
)
try:
# Overriding the existing SSHOptions class
# with a new SSHOptions class that uses
# this ssh_private_key as its only __init__
# argument.
# Run outside docker.
self.cmd_runner.run(
cmd,
ssh_options_override_ssh_key=self.auth_config.get( # noqa: E501
"ssh_private_key"
),
run_env="host",
)
except ProcessRunnerError as e:
if e.msg_type == "ssh_command_failed":
cli_logger.error("Failed.")
cli_logger.error("See above for stderr.")
raise click.ClickException(
"Initialization command failed."
) from None
else:
cli_logger.print(
"No initialization commands to run.",
_numbered=("[]", 4, NUM_SETUP_STEPS),
)
with cli_logger.group(
"Initializing command runner",
# todo: fix command numbering
_numbered=("[]", 5, NUM_SETUP_STEPS),
):
self.cmd_runner.run_init(
as_head=self.is_head_node,
file_mounts=self.file_mounts,
sync_run_yet=True,
)
if self.setup_commands:
with cli_logger.group(
"Running setup commands",
# todo: fix command numbering
_numbered=("[]", 6, NUM_SETUP_STEPS),
):
global_event_system.execute_callback(
CreateClusterEvent.run_setup_cmd
)
with LogTimer(
self.log_prefix + "Setup commands", show_status=True
):
total = len(self.setup_commands)
for i, cmd in enumerate(self.setup_commands):
global_event_system.execute_callback(
CreateClusterEvent.run_setup_cmd, {"command": cmd}
)
if cli_logger.verbosity == 0 and len(cmd) > 30:
cmd_to_print = cf.bold(cmd[:30]) + "..."
else:
cmd_to_print = cf.bold(cmd)
cli_logger.print(
"{}", cmd_to_print, _numbered=("()", i, total)
)
try:
# Runs in the container if docker is in use
self.cmd_runner.run(cmd, run_env="auto")
except ProcessRunnerError as e:
if e.msg_type == "ssh_command_failed":
cli_logger.error("Failed.")
cli_logger.error("See above for stderr.")
raise click.ClickException("Setup command failed.")
else:
cli_logger.print(
"No setup commands to run.",
_numbered=("[]", 6, NUM_SETUP_STEPS),
)
with cli_logger.group(
"Starting the Ray runtime", _numbered=("[]", 7, NUM_SETUP_STEPS)
):
global_event_system.execute_callback(CreateClusterEvent.start_ray_runtime)
with LogTimer(self.log_prefix + "Ray start commands", show_status=True):
for cmd in self.ray_start_commands:
env_vars = {}
if self.is_head_node:
if usage_lib.usage_stats_enabled():
env_vars[usage_constants.USAGE_STATS_ENABLED_ENV_VAR] = 1
else:
# Disable usage stats collection in the cluster.
env_vars[usage_constants.USAGE_STATS_ENABLED_ENV_VAR] = 0
# Add a resource override env variable if needed.
# Local NodeProvider doesn't need resource and label override.
if self.provider_type != "local":
if self.node_resources:
env_vars[
RESOURCES_ENVIRONMENT_VARIABLE
] = self.node_resources
if self.node_labels:
env_vars[LABELS_ENVIRONMENT_VARIABLE] = self.node_labels
try:
old_redirected = cmd_output_util.is_output_redirected()
cmd_output_util.set_output_redirected(False)
# Runs in the container if docker is in use
self.cmd_runner.run(
cmd, environment_variables=env_vars, run_env="auto"
)
cmd_output_util.set_output_redirected(old_redirected)
except ProcessRunnerError as e:
if e.msg_type == "ssh_command_failed":
cli_logger.error("Failed.")
cli_logger.error("See above for stderr.")
raise click.ClickException("Start command failed.")
global_event_system.execute_callback(
CreateClusterEvent.start_ray_runtime_completed
)
def rsync_up(self, source, target, docker_mount_if_possible=False):
options = {}
options["docker_mount_if_possible"] = docker_mount_if_possible
options["rsync_exclude"] = self.rsync_options.get("rsync_exclude")
options["rsync_filter"] = self.rsync_options.get("rsync_filter")
self.cmd_runner.run_rsync_up(source, target, options=options)
cli_logger.verbose(
"`rsync`ed {} (local) to {} (remote)", cf.bold(source), cf.bold(target)
)
def rsync_down(self, source, target, docker_mount_if_possible=False):
options = {}
options["docker_mount_if_possible"] = docker_mount_if_possible
options["rsync_exclude"] = self.rsync_options.get("rsync_exclude")
options["rsync_filter"] = self.rsync_options.get("rsync_filter")
self.cmd_runner.run_rsync_down(source, target, options=options)
cli_logger.verbose(
"`rsync`ed {} (remote) to {} (local)", cf.bold(source), cf.bold(target)
)
class NodeUpdaterThread(NodeUpdater, Thread):
def __init__(self, *args, **kwargs):
Thread.__init__(self)
NodeUpdater.__init__(self, *args, **kwargs)
self.exitcode = -1