Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve troubleshooting doc from feedback #2554

Merged
merged 2 commits into from
Jan 24, 2025
Merged

Improve troubleshooting doc from feedback #2554

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9d7be6e
Improve troubleshooting doc from feedback
dotNomad Jan 23, 2025
655e78b
Fix typo and header
dotNomad Jan 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 10 additions & 9 deletions docs/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,9 @@ If when deploying you see the following error:

> Cannot process manifest: Unrecognized app mode

there are few things to check.
check your Configuration for the following:

### Using `type = 'unknown'`
### `type = 'unknown'`

If your Configuration file contains `type = 'unknown'`, either from the
generated Configuration being unable to identify the type of your content, or
Expand All @@ -40,15 +40,16 @@ Configuration.
To fix this you will need to find and set the `type` in your Configuration file.
Supported types can be found in the [Configuration File Reference documentation](https://github.com/posit-dev/publisher/blob/main/docs/configuration.md#type).

### Using a `type` that is not supported by your server
### Unsupported `type`

Another possibility is Posit Connect, on the server you are deploying to, is
older than the version that introduced support for the `type` set in your
configuration file.
If the Posit Connect server you are deploying to is older than the version that
introduced support for the `type` set in your configuration file, you will see
the "Cannot process manifest: Unrecognized app mode" error.

For example, in [Posit Connect 2024.12.0](https://docs.posit.co/connect/news/#posit-connect-2024.12.0-new)
Gradio app support was introduced. When deploying a Gradio app to a server
running an older version of Posit Connect than 2024.12.0, it will error.
For example, [Posit Connect 2024.12.0](https://docs.posit.co/connect/news/#posit-connect-2024.12.0-new)
introduced support for Gradio apps. Attempting to deploy a Gradio app to a
server running a version of Posit Connect older than 2024.12.0 will result in
this error.
Comment on lines +49 to +52
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does Connect have a list of supported types anywhere in the docs we can point to? Or in-product?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A quick search of the Posit Connect Documentation isn't giving me much in terms of a comprehensive list of types.

There is a section for "Content Types", but with pages describing each like "Shiny for Python": https://docs.posit.co/connect/user/shiny-python/

Same with a look through Connect.


## Still having trouble?

Expand Down
Loading