Files
python-mistralclient/mistralclient/commands/v2/executions.py
Bob Haddleton d53da3629f Provide consistent options and return latest execution entries
This patchset updates the *-list commands to have consistent
definitions of the sort_keys/sort_dirs/limit/filter/marker
options.  It also modified the execution-list, action-execution-list
and task-list commands to return the MOST RECENT entries by
default, when no other sort_key, sort_dir or marker options are
provided, rather than the oldest entries.  There is a new --oldest
option for these three commands to allow the user to access the
oldest entries instead of the newest.

A release note has also been created.

Change-Id: I002edd1b10ab281072cfa7501cfa763073a7781c
2018-12-19 20:51:39 -06:00

325 lines
9.4 KiB
Python

# Copyright 2014 - Mirantis, Inc.
# Copyright 2015 - StackStorm, Inc.
# Copyright 2016 - Brocade Communications Systems, Inc.
#
# All Rights Reserved
#
# Licensed under the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License. You may obtain
# a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
# License for the specific language governing permissions and limitations
# under the License.
#
import json
import logging
import os.path
from osc_lib.command import command
from mistralclient.commands.v2 import base
from mistralclient import utils
LOG = logging.getLogger(__name__)
class ExecutionFormatter(base.MistralFormatter):
COLUMNS = [
('id', 'ID'),
('workflow_id', 'Workflow ID'),
('workflow_name', 'Workflow name'),
('workflow_namespace', 'Workflow namespace'),
('description', 'Description'),
('task_execution_id', 'Task Execution ID'),
('root_execution_id', 'Root Execution ID'),
('state', 'State'),
('state_info', 'State info'),
('created_at', 'Created at'),
('updated_at', 'Updated at'),
]
@staticmethod
def format(execution=None, lister=False):
# TODO(nmakhotkin) Add parent task id when it's implemented in API.
if execution:
state_info = (execution.state_info if not lister
else base.cut(execution.state_info))
data = (
execution.id,
execution.workflow_id,
execution.workflow_name,
execution.workflow_namespace,
execution.description,
execution.task_execution_id or '<none>',
execution.root_execution_id or '<none>',
execution.state,
state_info,
execution.created_at,
execution.updated_at or '<none>'
)
else:
data = (tuple('' for _ in
range(len(ExecutionFormatter.COLUMNS))),)
return ExecutionFormatter.headings(), data
class List(base.MistralExecutionLister):
"""List all executions."""
def _get_format_function(self):
return ExecutionFormatter.format_list
def get_parser(self, parsed_args):
parser = super(List, self).get_parser(parsed_args)
parser.add_argument(
'--task',
nargs='?',
help="Parent task execution ID associated with workflow "
"execution list.",
)
return parser
def _get_resources(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
return mistral_client.executions.list(
task=parsed_args.task,
marker=parsed_args.marker,
limit=parsed_args.limit,
sort_keys=parsed_args.sort_keys,
sort_dirs=parsed_args.sort_dirs,
fields=ExecutionFormatter.fields(),
**base.get_filters(parsed_args)
)
class Get(command.ShowOne):
"""Show specific execution."""
def get_parser(self, prog_name):
parser = super(Get, self).get_parser(prog_name)
parser.add_argument('execution', help='Execution identifier')
return parser
def take_action(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
execution = mistral_client.executions.get(parsed_args.execution)
return ExecutionFormatter.format(execution)
class Create(command.ShowOne):
"""Create new execution."""
def get_parser(self, prog_name):
parser = super(Create, self).get_parser(prog_name)
parser.add_argument(
'workflow_identifier',
nargs='?',
help='Workflow ID or name. Workflow name will be deprecated since '
'Mitaka.'
)
parser.add_argument(
'--namespace',
nargs='?',
default='',
help="Workflow namespace."
)
parser.add_argument(
'workflow_input',
nargs='?',
help='Workflow input'
)
parser.add_argument(
'params',
nargs='?',
help='Workflow additional parameters'
)
parser.add_argument(
'-d',
'--description',
dest='description',
default='',
help='Execution description'
)
parser.add_argument(
'-s',
dest='source_execution_id',
nargs='?',
help="Workflow Execution id which will allow operators to create "
"a new workflow execution based on the previously successful "
"executed workflow. Example: mistral execution-create -s "
"123e4567-e89b-12d3-a456-426655440000")
return parser
def take_action(self, parsed_args):
if parsed_args.workflow_input:
wf_input = utils.load_json(parsed_args.workflow_input)
else:
wf_input = {}
if parsed_args.params:
params = utils.load_json(parsed_args.params)
else:
params = {}
mistral_client = self.app.client_manager.workflow_engine
execution = mistral_client.executions.create(
parsed_args.workflow_identifier,
parsed_args.namespace,
wf_input,
parsed_args.description,
parsed_args.source_execution_id,
**params
)
return ExecutionFormatter.format(execution)
class Delete(command.Command):
"""Delete execution."""
def get_parser(self, prog_name):
parser = super(Delete, self).get_parser(prog_name)
parser.add_argument(
'execution',
nargs='+',
help='Id of execution identifier(s).'
)
parser.add_argument(
'--force',
default=False,
action='store_true',
help='Force the deletion of an execution. Might cause a cascade '
' of errors if used for running executions.'
)
return parser
def take_action(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
force = parsed_args.force
utils.do_action_on_many(
lambda s: mistral_client.executions.delete(s, force=force),
parsed_args.execution,
"Request to delete execution %s has been accepted.",
"Unable to delete the specified execution(s)."
)
class Update(command.ShowOne):
"""Update execution."""
def get_parser(self, prog_name):
parser = super(Update, self).get_parser(prog_name)
parser.add_argument(
'id',
help='Execution identifier'
)
parser.add_argument(
'-s',
'--state',
dest='state',
choices=['RUNNING', 'PAUSED', 'SUCCESS', 'ERROR', 'CANCELLED'],
help='Execution state'
)
parser.add_argument(
'-e',
'--env',
dest='env',
help='Environment variables'
)
parser.add_argument(
'-d',
'--description',
dest='description',
help='Execution description'
)
return parser
def take_action(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
env = (
utils.load_file(parsed_args.env)
if parsed_args.env and os.path.isfile(parsed_args.env)
else utils.load_content(parsed_args.env)
)
execution = mistral_client.executions.update(
parsed_args.id,
parsed_args.state,
description=parsed_args.description,
env=env
)
return ExecutionFormatter.format(execution)
class GetInput(command.Command):
"""Show execution input data."""
def get_parser(self, prog_name):
parser = super(GetInput, self).get_parser(prog_name)
parser.add_argument('id', help='Execution ID')
return parser
def take_action(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
ex_input = mistral_client.executions.get(parsed_args.id).input
try:
ex_input = json.loads(ex_input)
ex_input = json.dumps(ex_input, indent=4) + "\n"
except Exception:
LOG.debug("Execution input is not JSON.")
self.app.stdout.write(ex_input or "\n")
class GetOutput(command.Command):
"""Show execution output data."""
def get_parser(self, prog_name):
parser = super(GetOutput, self).get_parser(prog_name)
parser.add_argument('id', help='Execution ID')
return parser
def take_action(self, parsed_args):
mistral_client = self.app.client_manager.workflow_engine
output = mistral_client.executions.get(parsed_args.id).output
try:
output = json.loads(output)
output = json.dumps(output, indent=4) + "\n"
except Exception:
LOG.debug("Execution output is not JSON.")
self.app.stdout.write(output or "\n")