pcl-configure(1) :: Payara Cloud Documentation

Name

pcl-configure - Change configuration of an application

Synopsis

pcl configure [-elq] [--deploy] [-a=<applicationName>] [-n=<namespaceName>] [-o=<outputFormat>] [-s=<subscriptionName>] [-t=<seconds>]

Description

Change configuration of an application Configuration is different for each application. In order to discover which configuration kinds for an application are available, invoke pcl configuration -n $namespace -a $app configure --help. In order to learn about keys and configuration ids available for specific kind invoke pcl configuration -n $namespace -a $app configure $kind --help. It is possible to chain setting values of multiple configuration kinds in single command.

Options

-a, --application=<applicationName>: Name of application to manage.

Not required for commands listed by -n option, as well as list-applications and upload.
--deploy: Applies and deploys configuration changes immediately
-e, --fail-early: Fail command immediately after first deployment problem instead of waiting for timeout on client or backend side

There are certain scenarios when deployment can succeed despite reported deployment problems.

This means that even if you receive early warning messages about deployment failures, the application might still start up and run properly later.
-l, --logs: Shows application deployment logs in real-time
-n, --namespace=<namespaceName>: Name of namespace to manage.

Required for all commands except login, list-namespaces and create-namespace.
-o, --output=<outputFormat>: Set the output format. Allowed values: TEXT, JSON.
-q, --quiet: Enable quiet output.

Only result of operations will be displayed to stdout, or error message to stderrr.
-s, --subscription=<subscriptionName>: Specify the name of the subscription to use. This is only necessary when your account has access to multiple subscriptions.
-t, --timeout=<seconds>: Sets how long to wait for deployment completion on the client side.

This timeout doesn’t affect the actual deployment process in Payara Cloud, so applications might still start up even after a timeout occurs.