[jira] [Created] (AURORA-43) Rename maintenance commands to have a consistent prefix

["Tobias Weingartner (JIRA)" <ji...@apache.org>]

Tobias Weingartner created AURORA-43:
----------------------------------------

             Summary: Rename maintenance commands to have a consistent prefix
                 Key: AURORA-43
                 URL: https://issues.apache.org/jira/browse/AURORA-43
             Project: Aurora
          Issue Type: Task
          Components: SRE
            Reporter: Tobias Weingartner
            Priority: Trivial


Let's make the drain/maintenance commands have a common prefix, preferably something short.  I propose the following in a man page format:
{noformat}
SYNOPSIS
  drain_status [-f filename] cluster [host ...]
  drain_script [-f filename] [-s N] [-b function] cluster script [host ...]

  drain_mark [-f filename] cluster [host ...]
  drain_start [-f filename] cluster [host ...]
  drain_end [-f filename] cluster [host ...]

DESCRIPTION
  drain_status
    Print the drain status of each supplied host.

  drain_script
    Perform a fully scripted drain cycle.  This includes doing the equivalent
    of doing a 'drain_start' for each batch, and once the batch is drained,
    running the given script file with the input being the list of hosts within
    the current batch.  After the script exits successfully, 'drain_end' will be
    run on the current batch before moving on to subsequent batches.

    If the script returns a non-zero exit status, the full operation is aborted.

  drain_mark
    The list of hosts is marked for maintenance, and will be de-prioritized
    from consideration for scheduling.  Note, they are not removed from
    consideration, and may still schedule tasks if resources are very scarce.
    Usually you would mark a larger set of machines for drain, and then do
    them in batches within the larger set, to help drained tasks not land on
    future hosts that will be drained shortly in subsequent batches.

  drain_start
    The list of hosts is drained and marked in a drained state.  This will kill
    off any tasks currently running on these hosts, as well as prevent future
    tasks from scheduling on these hosts while they are drained.

  drain_end
    The list of hosts is marked as not in a drained state anymore.  This will
    allow normal scheduling to resume on the given list of hosts.

OPTIONS
  -f, --file filename
    Provide a filename (you can specify stdin using "-") containing the list of
    hosts to perform the given action on.  No hosts performs nothing.
  -s, --size N
    Give the size of each batch done in parallel during the drain_script.
  -b, --by function
    Give a function to specify the type of grouping you wish to happen.




--
This message was sent by Atlassian JIRA
(v6.1.5#6160)