NAME

       openqa-clone-job - creates a new job based on an existing job

SYNOPSIS

       Clones a job from the local or a remote openQA instance. Downloads all assets associated
       with the job (unless --skip-download is specified). Optionally settings can be modified.

         openqa-clone-job [OPTIONS] JOBREF [KEY=[VALUE] ...]

         # clones job 42 (and any existing parents) from "openqa.opensuse.org" to the local openQA instance
         # note: If job 42 is a parallel parent (e.g. a "server" job), its parallel children (e.g. "client"
         #       jobs) will be cloned as well.
         openqa-clone-job https://openqa.opensuse.org/t42
         openqa-clone-job --from https://openqa.opensuse.org/tests/42
         openqa-clone-job --from https://openqa.opensuse.org 42

         # clones job 42 (and any existing parents) from "openqa.opensuse.org" to the openQA instance "openqa.example.com"
         openqa-clone-job --skip-download --from https://openqa.opensuse.org --host openqa.example.com 42

         # clones job 42 (and any existing parents) within "openqa.opensuse.org" modifying some job settings
         openqa-clone-job --within-instance https://openqa.opensuse.org/t42 MAKETESTSNAPSHOTS=1 TEST+=:PR-123 FOOBAR=

         # clones job 42 including all of its direct children but excluding its chained parents
         openqa-clone-job --skip-chained-deps --clone-children https://openqa.opensuse.org/tests/42

DESCRIPTION

       Call with either a full URL pointing to a test job to clone from or one of both parameters
       "--from" or "--within-instance". The job ID can be specified as part of the URL or as its
       own parameter.

       API key and secret are read from "client.conf" if not specified via CLI arguments. The
       config file is checked for under "$OPENQA_CONFIG", "~/.config/openqa" and "/etc/openqa" in
       this order. It must look like this:

         [openqa.opensuse.org]
         key = 45ABCEB4562ACB04
         secret = 4BA0003086C4CB95
         [another.host]
         key = D7345DA7B9D86B3B
         secret = A98CDBA9C8DB87BD

       Any parent jobs (chained or parallel) are also cloned unless "--skip-deps" or
       "--skip-chained-deps" is specified. If "--skip-chained-deps" is specified published assets
       generated by parent jobs are downloaded to be directly used instead of generated.

       Keep in mind that by default any additionally specified job settings are NOT added to the
       also cloned parent jobs. Specify "--parental-inheritance" if this is wanted. It is also
       possible to specify the job a setting should be added to explicitly, e.g.
       "WORKER_CLASS:create_hpc=special-worker". In this example the setting "WORKER_CLASS" will
       only be set to the specified value for jobs where the setting "TEST" equals "create_hpc".

       Note that the child job is the one which has the "START_AFTER_TEST" or "PARALLEL_WITH"
       setting and the parent job is the one mentioned by that setting.

       Cloning directly chained dependencies ("START_DIRECTLY_AFTER_TEST") is NOT supported.

OPTIONS

       --host HOST
           Specifies the hostname of the target openQA instance (defaults to localhost).

           Assets are still always downloaded to the local machine. When specifying a remote host
           make sure the assets are already there and use "--skip-download".

       --from HOST
           Specifies the hostname of the openQA instance to clone the job from (deduced from
           JOBREF if it is a URL).

       --dir DIR
           Specifies the directory to store test assets (defaults to $OPENQA_SHAREDIR/factory).

       --skip-checks
           Skips additional checks like maintenance update availability.

       --skip-deps
           Do NOT clone parent jobs (which is done by default).

       --skip-chained-deps
           Do NOT clone chained parent jobs (jobs specified via "START_AFTER_TEST").

           This makes the job use the downloaded HDD image instead of running the generator job
           again which is of course only possible if --host is the local machine.

       --skip-download
           Do NOT download assets. You need to ensure all required assets are provided yourself.

       --ignore-missing-assets
           Cloning a job will not fail if an asset is missing.

       --clone-children
           Clone all direct child jobs as well. By default, only parallel child jobs are cloned.

       --max-depth
           Specifies the max depth for cloning children. By default, only direct children are
           cloned. Use 0 to denote infinity.

       --within-instance HOST
           A shortcut for "--skip-download --from HOST --host HOST" to clone a job within a local
           or remote instance.

       --repeat N
           Do the same clone operation N times; this can be useful for Statistical investigation.
           Example:

           openqa-clone-job --skip-chained-deps --repeat=50 --within-instance \
           https://openqa.opensuse.org 123456

           Will create 50 clones of the same job.

       --show-progress
           Displays a progress bar when downloading assets.

       --parental-inheritance
           Provides parental job with settings specified via command line (they go to child job
           by default).

       --export-command
           Prints an `openqa-cli` command to create the jobs instead of creating them directly.
           This is useful to customize the API call or to review it before submitting.

       --apikey <value>
           Specifies the public key needed for API authentication.

       --apisecret <value>
           Specifies the secret key needed for API authentication.

       --verbose, -v
           Increases verbosity.

       --help, -h
           Prints help.