# app Operations with applications ## Usage ```bash apolo app [OPTIONS] COMMAND [ARGS]... ``` Operations with applications. **Commands:** | Usage | Description | | --------------------------------- | ------------------------------------------- | | [*configure*](#configure) | Reconfigure an app instance using YAML file | | [*get-input*](#get-input) | Get input for an app | | [*get-revisions*](#get-revisions) | Get configuration revisions for an app | | [*get-status*](#get-status) | Get status events for an app | | [*get-values*](#get-values) | Get application values | | [*install*](#install) | Install an app from a YAML file | | [*list*](#list) | List apps | | [*logs*](#logs) | Print the logs for an app | | [*ls*](#ls) | Alias to list | | [*rollback*](#rollback) | Rollback application configuration | | [*uninstall*](#uninstall) | Uninstall an app | ### configure Reconfigure an app instance using YAML file #### Usage ```bash apolo app configure [OPTIONS] APP_ID ``` Reconfigure an app instance using `YAML` file. #### Options | Name | Description | | -------------------- | ------------------------------------------------------ | | *--help* | Show this message and exit. | | *-c, --comment TEXT* | Comment for the configuration. | | *-f, --file TEXT* | Path to the app configuration YAML file. *\[required]* | ### get-input Get input for an app #### Usage ```bash apolo app get-input [OPTIONS] APP_ID ``` Get input for an app. `APP`\_ID: ID of the app to get input for. #### Options | Name | Description | | ------------------------------ | -------------------------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *-o, --output \[yaml \| json]* | Output format (default: yaml). | | *--project PROJECT* | Look on a specified project (the current project by default). | | *-r, --revision INTEGER* | Revision number to get input for. If not specified, the latest revision is used. | ### get-revisions Get configuration revisions for an app #### Usage ```bash apolo app get-revisions [OPTIONS] APP_ID ``` Get configuration revisions for an app. `APP`\_ID: ID of the app to get configuration revisions for. #### Options | Name | Description | | ------------------------------- | ------------------------------- | | *--help* | Show this message and exit. | | *-o, --output \[table \| json]* | Output format (default: table). | ### get-status Get status events for an app #### Usage ```bash apolo app get-status [OPTIONS] APP_ID ``` Get status events for an app. `APP`\_ID: ID of the app to get status for status events. #### Options | Name | Description | | ------------------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *-o, --output \[table \| json]* | Output format (default: table). | | *--project PROJECT* | Look on a specified project (the current project by default). | ### get-values Get application values #### Usage ```bash apolo app get-values [OPTIONS] [APP_ID] ``` Get application values. `APP`\_ID: Optional ID of the app to get values for. #### Options | Name | Description | | ------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *-o, --output TEXT* | Output format (default: table). | | *--project PROJECT* | Look on a specified project (the current project by default). | | *-t, --type TEXT* | Filter by value type. | ### install Install an app from a YAML file #### Usage ```bash apolo app install [OPTIONS] ``` Install an app from a `YAML` file. #### Options | Name | Description | | ------------------- | ----------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Specify the cluster (the current cluster by default). | | *-f, --file TEXT* | Path to the app YAML file. *\[required]* | | *--org ORG* | Specify the org (the current org by default). | | *--project PROJECT* | Specify the project (the current project by default). | ### list List apps #### Usage ```bash apolo app list [OPTIONS] ``` List apps. #### Options | Name | Description | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *-a, --all* | Show apps in all states. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *--project PROJECT* | Look on a specified project (the current project by default). | | *-s, --state \[queued \| progressing \| healthy \| degraded \| errored \| uninstalling \| uninstalled]* | Filter out apps by state (multiple option). | ### logs Print the logs for an app #### Usage ```bash apolo app logs [OPTIONS] APP_ID ``` Print the logs for an app. #### Options | Name | Description | | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *--project PROJECT* | Look on a specified project (the current project by default). | | *--since DATE\_OR\_TIMEDELTA* | Only return logs after a specific date (including). Use value of format '1d2h3m4s' to specify moment in past relatively to current time. | | *--timestamps* | Include timestamps on each line in the log output. | ### ls Alias to list #### Usage ```bash apolo app ls [OPTIONS] ``` Alias to list #### Options | Name | Description | | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *-a, --all* | Show apps in all states. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *--org ORG* | Look on a specified org (the current org by default). | | *--project PROJECT* | Look on a specified project (the current project by default). | | *-s, --state \[queued \| progressing \| healthy \| degraded \| errored \| uninstalling \| uninstalled]* | Filter out apps by state (multiple option). | ### rollback Rollback application configuration #### Usage ```bash apolo app rollback [OPTIONS] APP_ID REVISION_NUMBER ``` Rollback application configuration. `APP`*ID: ID of the app to rollback. `REVISION`*`NUMBER`: Target revision number. #### Options | Name | Description | | -------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *-c, --comment TEXT* | Comment for the rollback. | | *--org ORG* | Look on a specified org (the current org by default). | | *--project PROJECT* | Look on a specified project (the current project by default). | ### uninstall Uninstall an app #### Usage ```bash apolo app uninstall [OPTIONS] APP_ID ``` Uninstall an app. `APP`\_ID: ID of the app to uninstall #### Options | Name | Description | | ------------------- | ------------------------------------------------------------- | | *--help* | Show this message and exit. | | *--cluster CLUSTER* | Look on a specified cluster (the current cluster by default). | | *-f, --force* | Force uninstall the app. | | *--org ORG* | Look on a specified org (the current org by default). | | *--project PROJECT* | Look on a specified project (the current project by default). |