Red Hat SummitQuesto contenuto non è disponibile nella lingua selezionata.
Chapter 49. job-invocation
Manage job invocations
Usage
hammer job-invocation [OPTIONS] SUBCOMMAND [ARG] ...
# hammer job-invocation [OPTIONS] SUBCOMMAND [ARG] ...Options
-
-h,--help– Print help
49.1. job-invocation cancel
Cancel the job
Usage
hammer job-invocation cancel [OPTIONS]
# hammer job-invocation cancel [OPTIONS]Options
-
--force BOOLEAN -
--id VALUE -
--location-id NUMBER– Set the current location context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--search VALUE– Search query to cancel tasks only on matching hosts. If not provided, the whole job invocation will be cancelled. -
-h,--help– Print help
49.2. job-invocation create
Create a job invocation
Usage
hammer job-invocation create [OPTIONS]
# hammer job-invocation create [OPTIONS]Options
-
--async– Do not wait for the task -
--bookmark VALUE– Name to search by -
--bookmark-id NUMBER -
--concurrency-level NUMBER– Run at most N tasks at a time --cron-line VALUE– Create a recurring execution Cron line formata b c d e, where:- is minute (range: 0-59)
- is hour (range: 0-23)
- is day of month (range: 1-31)
- is month (range: 1-12)
- is day of week (range: 0-6)
-
--description-format VALUE– Override the description format from the template for this invocation only -
--dynamic– Dynamic search queries are evaluated at run time -
--effective-user VALUE– What user should be used to run the script (using sudo-like mechanisms). Defaults to a template parameter or global setting. -
--effective-user-password VALUE– Set password for effective user (using sudo-like mechanisms) -
--end-time DATETIME– Perform no more executions after this time, used with--cron-line -
--execution-timeout-interval NUMBEROverride the timeout interval from the template for this invocation only -
--feature VALUE– Remote execution feature label that should be triggered, job template assigned to this feature will be used -
--input-files KEY_VALUE_LIST– Read input values from files Comma-separated list of key=file, where file is a path to a text file to be read -
--inputs KEY_VALUE_LIST– Specify inputs from command line -
--job-template VALUE– Name to search by -
--job-template-id VALUE– The job template to use, parameter is required unless feature was specified -
--key-passphrase VALUE– Set SSH key passphrase -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--max-iteration NUMBER– Repeat a maximum of N times -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
--password VALUE– Set SSH password -
--purpose VALUE– Designation of a special purpose -
--randomized-ordering BOOLEAN– Execute the jobs on hosts in randomized order -
--search-query VALUE -
--ssh-user VALUE– Set SSH user -
--start-at DATETIME– Schedule the execution for a later time -
--start-before DATETIME– Execution should be cancelled if it cannot be started before--start-at -
--tags VALUE– A comma separated list of tags to use for Ansible run -
--tags-flag ENUM– IncludeExclude tags for Ansible run Possible value(s):include,exclude -
--time-to-pickup NUMBER– Override the global time to pickup interval for this invocation only -
-h,--help– Print help
49.3. job-invocation info
Show job invocation
Usage
hammer job-invocation <info|show> [OPTIONS]
# hammer job-invocation <info|show> [OPTIONS]Options
-
--fields LIST– Show specified fields or predefined field sets only. (See below) -
--id VALUE -
--location-id NUMBER– Set the current location context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--show-host-status– Show job status for the hosts -
--show-inputs– Show the complete input of the job -
-h,--help– Print help
Predefined field sets
| FIELDS | ALL | DEFAULT |
|---|---|---|
| Id | x | x |
| Description | x | x |
| Status | x | x |
| Success | x | x |
| Failed | x | x |
| Pending | x | x |
| Missing | x | x |
| Total | x | x |
| Start | x | x |
| Randomized ordering | x | x |
| Inputs | x | x |
| Job category | x | x |
| Mode | x | x |
| Cron line | x | x |
| Recurring logic id | x | x |
| Time to pickup | x | x |
| Hosts | x | x |
49.4. job-invocation list
List job invocations
Usage
hammer job-invocation <list|index> [OPTIONS]
# hammer job-invocation <list|index> [OPTIONS]Options
-
--fields LIST– Show specified fields or predefined field sets only. (See below) -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--order VALUE– Sort and order by a searchable field, e.g.<field> DESC -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
--page NUMBER– Page number, starting at 1 -
--per-page VALUE– Number of results per page to return,allto return all results -
--search VALUE– Filter results -
-h,--help– Print help
Predefined field sets
| FIELDS | ALL | DEFAULT |
|---|---|---|
| Id | x | x |
| Description | x | x |
| Status | x | x |
| Success | x | x |
| Failed | x | x |
| Pending | x | x |
| Total | x | x |
| Start | x | x |
| Randomized ordering | x | x |
| Inputs | x | x |
49.5. job-invocation output
View the output for a host
Usage
hammer job-invocation output [OPTIONS]
# hammer job-invocation output [OPTIONS]Options
-
--async– Do not wait for job to complete, shows current output only -
--host VALUE– Host name -
--host-id VALUE -
--id VALUE -
--location VALUE– Set the current location context for the request -
--location-id NUMBER– Set the current location context for the request -
--location-title VALUE– Set the current location context for the request -
--name VALUE– Name to search by -
--organization VALUE– Set the current organization context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--organization-title VALUE– Set the current organization context for the request -
-h,--help– Print help
49.6. job-invocation rerun
Rerun the job
Usage
hammer job-invocation rerun [OPTIONS]
# hammer job-invocation rerun [OPTIONS]Options
-
--failed-only BOOLEAN -
--id VALUE -
--location-id NUMBER– Set the current location context for the request -
--organization-id NUMBER– Set the current organization context for the request -
--succeeded-only BOOLEAN -
-h,--help– Print help
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}