Merge branch 'main' into Prerender

.github/styles/config/vocabularies/Doc/accept.txt

@@ -29,6 +29,7 @@ Gemfile
 Glassfish
 Gradle
 gradle
+Grafana
 healthcheck
 Heptapod
 Hextra

content/doc/addons/mongodb/_index.md

@@ -60,6 +60,8 @@ The process consists in three steps:
 
 Encryption at rest is available on MongoDB. You can have more information on the [dedicated page]({{< ref "doc/administrate/encryption-at-rest.md" >}})
 
+{{% content/dbMigration %}}
+
 ## Can I use Mongo Ops Manager on Clever Cloud?
 
 To be able to use [Mongo Ops Manager](https://www.mongodb.com/products/ops-manager), you'll need a valid MongoDB Enterprise Advanced subscription and to deploy a [Linux version of their manager solution](https://www.mongodb.com/try/download/ops-manager). If you haven't purchased any license from MongoDB and you are using the Community version, you might be looking for a similar service for your databases.

content/doc/addons/mysql/_index.md

@@ -36,6 +36,8 @@ If you want to import your **SQL** dump, you can use several methods:
 
 If you need to import a very large dump, contact [Clever Cloud Support](https://console.clever-cloud.com/ticket-center-choice).
 
+{{% content/dbMigration %}}
+
 ## Direct access
 
 {{< callout type="warning">}}

content/doc/addons/postgresql/_index.md

@@ -34,6 +34,8 @@ Some applications require a non-empty database to run properly. If you want to i
 2. Command line tool for PostgreSQL administration like `psql`
 3. Any PostgreSQL client such as [pgAdmin](https://www.pgadmin.org/)
 
+{{% content/dbMigration %}}
+
 ## Direct access
 
 A proxy serves all dedicated PostgreSQL databases. In some cases, this can add some latency between applications and their database. If this is an issue, you can generate a direct hostname and port for the add-on to bypass the proxy, using the "Generate direct hostname and port" button in the add-on dashboard.

content/doc/addons/redis.md

@@ -28,6 +28,8 @@ The version currently installed by the add-on are the following :
 
 A backup is a `tar.gz` archive containing both the `.rdb` and `.aof` files. You can extract this archive and run `redis-server` in the extracted folder to access data.
 
+{{% content/dbMigration %}}
+
 ## Leader / follower topology
 
 By default, all redis add-ons are configured as leaders. You can set up a redis add-on as a follower from the add-on panel (in the "Add-on information" tab). You need to set the leader

content/doc/applications/docker/_index.md

@@ -204,7 +204,6 @@ CMD ["sudo","/root/start.sh"]
 We provide a few examples of dockerized applications on Clever Cloud.
 
 * [Elixir App](https://github.com/CleverCloud/demo-docker-elixir/blob/master/Dockerfile)
-* [Haskell App](https://github.com/CleverCloud/demo-haskell)
 * [Hack / HHVM App](https://github.com/CleverCloud/demo-hhvm)
 * [Seaside / Smalltalk App](https://github.com/CleverCloud/demo-seaside)
 * [Rust App](https://github.com/CleverCloud/demo-rust)

content/doc/find-help/troubleshooting.md

@@ -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:
 
@@ -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)
@@ -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:
@@ -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" %}}

hugo.yaml

@@ -47,7 +47,7 @@ languages:
 params:
   description: Clever Cloud is a Platform-as-a-Service (PaaS) cloud provider, an automated hosting platform for developers. Deploy your app easily and launch dependencies without having to worry about the infrastructure set up
   images:
-  - /images/feature.png
+  - images/feature.png
   navbar:
     displayTitle: false
     displayLogo: true

layouts/shortcodes/content/dbMigration.md

@@ -0,0 +1,10 @@
+## Migrate your database
+
+Clever Cloud provides an add-on Migration/Upgrade tool. You can access it from the [Console](https://console.clever-cloud.com), in the left menu when an add-on is selected. It allows to choose a higher plan, a new version or another deployment zone.
+
+A migration process creates new instances, moves your data into it and stops the old ones if the process ended correctly. In case of a failure during migration, new instances are deleted and you go back to the original ones.
+The duration may vary depending on how much data your add-on has. Your database becomes read only for the entire duration.
+
+If you want to restart your add-on or update to the last supported version of the current branch, migrate it to the same plan, version, zone. 
+
+- [More Clever Cloud Tips and Tricks](/developers/doc/best-practices/tips_and_tricks/)