Synopsis

fcli fod release create [--auto-required-attrs] [--skip-if-exists] [--copy-from=id|app[:ms]:rel] [-d=<description>] [--delim=<delimiter>] --status=<sdlcStatusType> [,[ATTR=VALUE]…​]]…​ [[-h] [--env-prefix=<envPrefix>_] [--log-file=<logFile>] [--log-level=<logLevel>]] [[--session=<sessionName>]] ] [--store=_variableName[: _ <propertyNames>]] [--to-file=<outputFile>_]] [[--app-description=<appDescription>] [--app-notify=<appNotifications>[, <appNotifications>…​]]…​ [--app-owner=<appOwner>] [--app-groups=<appUserGroups>[,<appUserGroups>…​]]…​ [--app-type=<appType>] [--app-criticality=<criticalityType>]] app[:ms]:rel

Description

Options

--attrs, --attributes=[ATTR=VALUE][,[ATTR=VALUE]…​]

Set of application & release attribute id’s or names and corresponding values. Please note for user attributes only the userId is currently supported. Depending on FoD configuration, some attributes may be required and either need to be set explicitly or auto-filled through the --auto-required-attrs option. Application attributes will be applied when creating a new application and ignored if the application already exists. Similarly, release attributes will be ignored if the release already exists and --skip-if-exists is enabled.

--auto-required-attrs

Automatically set a default value for required application and release attributes.

--copy-from=id|app[:ms]:rel

The id or name of a release to copy existing state from. Note that FoD will put the release in 'suspended' state until copying is complete, during which time scan requests and other operations may be rejected. If you want to run any other operations on the release, it is recommended to first invoke the fcli fod release wait-for command to wait until the release leaves suspended state. This option is ignored if the release name to be copied is equal to the release name to be created, or when creating the first release on a (new) application.

-d, --description=<description>

Description of the release.

--delim=<delimiter>

Change the default delimiter character when using options that accept "application[:microservice]:release" as an argument or parameter.

--skip-if-exists

Check to see if release already exists before creating.

--status, --sdlc-status=<sdlcStatusType>

The SDLC lifecycle status of the release. Valid values: Development, QA, Production, Retired

Application creation options (ignored if application exists)

--app-criticality=<criticalityType>

Required application business criticality when creating a new application. Valid values: High, Medium, Low.

--app-description=<appDescription>

Optional application description when creating a new application.

--app-groups=<appUserGroups>[,<appUserGroups>…​]

Optional user group ids or names to give access to the application when creating a new application.

--app-notify=<appNotifications>[,<appNotifications>…​]

Optional email address(es) when creating a new application to specify application user(s) to send notifications to.

--app-owner=<appOwner>

Required application owner when creating a new application.

--app-type=<appType>

Required application type when creating a new application. Valid values: Web, ThickClient, Mobile, Microservice.

Session options

--session=<sessionName>

Name of the FoD session to use for executing this command. Default value: default.

Output options

-o, --output=format[=<options>]

Specify output format and options. Available output formats: csv, csv-plain, json, json-flat, table, table-plain, tree, tree-flat, xml, xml-flat, yaml, yaml-flat, expr, json-properties. The 'expr' output format takes a string containing '{property}' placeholders, other output formats take an optional, comma-separated list of properties to include in the output. Use '-o json-properties' on the current command to see available properties.

--store=variableName[:<propertyNames>]

Store the JSON results of this command in a variable. Variables can be managed through the 'fcli util variable' command, and can be referenced using ::variable::[property] on any subsequent command.

--to-file=<outputFile>

Write command output to the specified file instead of stdout.

Generic fcli options

--env-prefix=<envPrefix>

Environment variable prefix for resolving default option and parameter values. Default value is FCLI_DEFAULT.

-h, --help

Show this help message and exit. Use 'fcli <command> -h' to display help for subcommands.

--log-file=<logFile>

File where logging data will be written. Defaults to fcli.log in current directory if --log-level is specified.

--log-level=<logLevel>

Set logging level. Note that DEBUG and TRACE levels may result in sensitive data being written to the log file. Allowed values: TRACE, DEBUG, INFO, WARN, ERROR.

Arguments

app[:ms]:rel

Release name in the format <application>[:<microservice>]:<release>.