# 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). | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.apolo.us/index/apolo-cli/commands/app.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.