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

doc: troubleshooting sozu default timeouts #502

Merged
merged 4 commits into from
Jan 21, 2025
Merged

doc: troubleshooting sozu default timeouts #502

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
7c78da9
doc: create timeout troubleshooting section
juliamrch Jan 21, 2025
4ccbc7b
style: accept 'Grafana' in the dictionary
juliamrch Jan 21, 2025
dd17851
doc: remove 'troubleshooting' from sections titles (redundant)
juliamrch Jan 21, 2025
8aea20d
typo
juliamrch Jan 21, 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
1 change: 1 addition & 0 deletions .github/styles/config/vocabularies/Doc/accept.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ Gemfile
Glassfish
Gradle
gradle
Grafana
healthcheck
Heptapod
Hextra
Expand Down
27 changes: 24 additions & 3 deletions content/doc/find-help/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ For most of Cloud providers, the use of the file system is not a good practice.
Follow the [File System buckets documentation page]({{< ref "doc/addons/fs-bucket" >}}) to set up an FS Bucket for your application.
{{% /details %}}

{{% details title="Troubleshooting empty repository git error" closed="true" %}}
{{% details title="Empty repository git error" closed="true" %}}

In some cases, git may display this type of error message:

Expand Down Expand Up @@ -67,7 +67,7 @@ git push clever production:master

{{% /details %}}

{{% details title="Troubleshooting 'Not a git repository' error" closed="true" %}}
{{% details title="'Not a git repository' error" closed="true" %}}

```text
fatal: Not a git repository (or any of the parent directories)
Expand All @@ -79,7 +79,7 @@ You can add all your files with `$ git add .`, then you need to commit the files
You will finally push your code with `$ git push clever master`.
{{% /details %}}

{{% details title="Troubleshooting 'fatal: 'clever' does not appear to be a git repository'" closed="true" %}}
{{% details title="'fatal: 'clever' does not appear to be a git repository'" closed="true" %}}

"clever" is a name used in our examples to represent the Clever Cloud servers.
In order to be able to use the same name for yourself, you will need to create a git remote named clever like this:
Expand Down Expand Up @@ -155,6 +155,27 @@ You have to pay all of your pending invoices to recover your data.

{{% /details %}}

## Network

{{% details title="Backend Timeout Limits" closed="true" %}}

Clever Cloud uses [Sōzu](https://www.sozu.io) as its load balancer and reverse proxy. Sōzu enforces a 180-second timeout for all backend operations to prevent resource exhaustion from hanging requests.

For operations that may exceed the 180-second limit, implement one of these approaches:

1. Use long polling to send periodic status checks from the client
2. Create an asynchronous worker system: move long-running tasks to a background [worker]({{< ref "doc/develop/workers/" >}} "workers")
3. [Purchase a custom load balancer from Clever Cloud](https://www.clever-cloud.com/fr/contact/) with different timeouts

##### Additional considerations:

- Design your application architecture to handle timeouts gracefully
- Break up long-running operations into smaller tasks

Use your embedded [Grafana]({{< ref "doc/metrics/">}} "Grafana on Clever Cloud") to monitor resource usage when implementing any of these solutions.

{{% /details %}}

## Others issues

{{% details title="Missing GitHub organization on the application creation page" closed="true" %}}
Expand Down
Loading