Merge branch 'main' into davlgd-changelog-reorg

.github/workflows/external-doc-update.yml

@@ -9,6 +9,7 @@ jobs:
   changed_files:
     runs-on: ubuntu-latest
     name: Test changed-files
+    environment: update doc
     # Needed to post comments and create issues
     permissions:
         issues: write
@@ -48,18 +49,18 @@ jobs:
           search_existing: all
 
       # Post a single comment with auto-updating body
-      - name: Create or update a comment
-        env:
-          CHANGED_FILES: ${{ steps.changed-files-specific.outputs.all_changed_files }}
-        uses: taoliujun/action-unique-comment@v1
-        with:
-          uniqueIdentifier: ${{ github.workflow }}
-          body: |
-            You updated ${{ env.CHANGED_FILES }}. This content is also listed on external doc. Issue number ${{ steps.create-issue.outputs.number }} has been created and assigned to you 🫵👁️👄👁️
-            
-            See it or modify it here: 
-              * ${{ steps.create-issue.outputs.url }}
-            
-            _This unique comment uses the very cool [taoliujun/action-unique-comment](https://github.com/marketplace/actions/unique-comment). Thank you <3_
+      #- name: Create or update a comment
+      #  env:
+      #    CHANGED_FILES: ${{ steps.changed-files-specific.outputs.all_changed_files }}
+      #  uses: taoliujun/action-unique-comment@v1
+      #  with:
+      #    uniqueIdentifier: ${{ github.workflow }}
+      #    body: |
+      #      You updated ${{ env.CHANGED_FILES }}. This content is also listed on external doc. Issue number ${{ steps.create-issue.outputs.number }} has been created and assigned to you 🫵👁️👄👁️
+      #      
+      #      See it or modify it here: 
+      #        * ${{ steps.create-issue.outputs.url }}
+      #      
+      #      _This unique comment uses the very cool [taoliujun/action-unique-comment](https://github.com/marketplace/actions/unique-comment). Thank you <3_
 
 

.github/workflows/review-app.yml

@@ -31,9 +31,9 @@ jobs:
           ORGA_ID: ${{ secrets.ORGA_ID }}
           GH_CC_PRE_BUILD_HOOK: './clevercloud-deploy-script.sh'
           GH_CC_WEBROOT: '/public'
-          GH_HEXTRA_VERSION: 'v0.8.4'
+          GH_HEXTRA_VERSION: 'v0.9.3'
           GH_HUGO_ENV: 'production'
-          GH_HUGO_VERSION: '0.135.0'
+          GH_HUGO_VERSION: '0.140.2'
 
         with:
           type: 'static-apache'

assets/css/custom.css

@@ -234,9 +234,15 @@ html[class~="dark"] .content a:has(code){
 /* Display an arrow at the end of the linked variable */
 .content a:not(.code-block code) code::after {
   content: "\00a0↗";
-  color: tomato;
-  font-size: 1.1rem;
-
+    color: tomato;
+    font-size: 1rem;
+    bottom: -2px;
+    position: relative;
+    left: 4px;
+    width: 14px;
+    display: inline-block;
+    height: 14px;
+    line-height: 0.35em;
 }
 
 /* Display arrow for external links in the main menu.

content/changelog/2024-12-05-metabase-52.md

@@ -0,0 +1,23 @@
+---
+title: "Metabase 52 is available"
+date: 2024-12-05
+tags:
+  - addons
+  - metabase
+authors:
+  - name: Sébastien Allemand
+    link: https://github.com/allemas
+    image: https://github.com/allemas.png?size=40
+  - name: David Legrand
+    link: https://github.com/davlgd
+    image: https://github.com/davlgd.png?size=40
+description: Faster, with more features
+excludeSearch: true
+---
+
+The `x.52` branch of Metabase is now available on Clever Cloud. To update, just set `CC_METABASE_VERSION` of the add-on's Java application to `0.52` for the community edition or `1.52` for the enterprise edition (EE).
+
+- [Learn more about Metabase on Clever Cloud](/doc/addons/metabase/)
+- [Learn more about Metabase 51](https://www.metabase.com/releases/metabase-52)
+
+{{< youtube id="h4xKT3MkLj0" >}}

content/doc/find-help/faq.md

@@ -212,9 +212,10 @@ If a VACUUM operation needs more disk that there is remaining, migrating to the
 
 ## Where are the backups stored?
 
-Clever Cloud store all your backups on [Cellar](https://www.clever-cloud.com/product/cellar-object-storage/). 
-Cellar has a replication system to protect the data stored inside. It creates three copies of your backups, each stored in a different data centers in the PAR region.  
-This way, even if one data center has an accident, your backup are still safe in two different data centers.
+Clever Cloud stores all backups on [Cellar](https://www.clever-cloud.com/product/cellar-object-storage/), a replicated object storage service with three copies distributed across datacenters in the PAR region to ensure durability. Even if one datacenter fails, your backups remain safe.
+
+For custom configurations (for example, multiple retention policies), contact Support. To locate backups not visible in the Console, use [Clever Tools](https://github.com/CleverCloud/clever-tools) with: `clever database backups DATABASE-ID [--format, -F] FORMAT`.  Find more documentation on restoring backups with the CLI [here](https://github.com/CleverCloud/clever-tools/blob/master/docs/addons-backups.md#database-backups).
+
 
 ## I can't create my add-on
 

content/guides/nuxt.md

@@ -1,6 +1,6 @@
 ---
 title: Nuxt
-description: Build your website with Nuxt as a Static Site Generator (SSG) and host it on Clever Cloud. No dedicated runner needed.
+description: Build your website with Nuxt, either as a static site or using a NodeJs app, and host it on Clever Cloud. No dedicated runner needed.
 tags:
 - guides
 keywords:
@@ -17,15 +17,28 @@ comments: false
 draft: false
 ---
 
+{{< hextra/hero-subtitle >}}
+  Nuxt is a powerful and versatile web framework for building modern web applications, offering a seamless development experience with server-side rendering, static site generation, and hybrid capabilities. Learn in this guide how to deploy a Nuxt site on Clever Cloud.
+{{< /hextra/hero-subtitle >}}
+
+Clever Cloud supports deploying both [fully static and on-demand rendered](https://nuxt.com/docs/guide/concepts/rendering) Nuxt 3 projects:   
+
+- The `static` rendering mode is ideal for most content-oriented websites where you don't need per-visitor server-side customization. Consider using a [Static runtime](/doc/applications/static/) when using this mode, with the site generation handled in a post-build hook. Learn more about [static hosting with Nuxt](https://nuxt.com/docs/getting-started/deployment#static-hosting). 
+- The `server` or `hybrid` rendering modes are optimal for dynamic applications requiring server-side customization or a mix of static and server-rendered pages. For these modes, consider using a [Node.js runtime](/doc/applications/javascript/nodejs/). Learn more about [Node.js hosting with Nuxt](https://nuxt.com/docs/getting-started/deployment#nodejs-server).
+
 If you need an example source code compatible with Nuxt static generation, get [Zooper](https://github.com/fayazara/zooper) (you'll need [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) and [Node.js](https://nodejs.org/en/learn/getting-started/how-to-install-nodejs)):
 
 ```bash
 git clone https://github.com/fayazara/zooper myStaticApp
 ```
 
+## Deploy a static Nuxt site
+
+To deploy your Nuxt project to Clever Cloud, you need to **create a new application**. 
+
 {{% content/language-specific-deploy/create-static %}}
 
-## Configure environment variables
+### Configure environment variables
 
 Next, we configure the application with a medium build instance to quickly generate static files. The host instance is nano-sized, enough for a simple website. As Clever Cloud is based on standards, you only need to define a few variables:
 
@@ -40,4 +53,47 @@ clever env set CC_PRE_BUILD_HOOK "npm install"
 clever env set CC_POST_BUILD_HOOK "npx nuxi generate"
 ```
 
+## Deploy a server Nuxt site
+
+To deploy your Nuxt project to Clever Cloud, you need to **create a new application**. 
+
+
+### Create a Node.js application
+
+You can create an application from the [Console](https://console.clever-cloud.com) or through [Clever Tools](https://github.com/CleverCloud/clever-tools/):
+
+```bash
+npm i -g clever-tools
+clever login
+
+cd myStaticApp
+clever create -t node mNuxtApp
+```
+
+To deploy on Clever Cloud, your local folder needs to be a git repository (if not, `git init`) linked to an application. If you already have an application on Clever Cloud and want to link it to the current local folder:
+
+```bash
+clever link your_app_name_or_ID
+```
+
+### Configure environment variables
+
+Next, configure the application with a medium build instance. The host instance is XS, enough for a simple website. As Clever Cloud uses industry standards, you only need to define a few variables:
+
+```bash
+clever scale --build-flavor M
+clever scale --flavor xs
+
+clever env set CC_PRE_BUILD_HOOK "npm run build"
+clever env set CC_RUN_COMMAND "node .output/server/index.mjs"
+```
+
 {{% content/git-push %}}
+
+## Learn more
+
+{{< cards >}}
+  {{< card link="../../doc/applications/javascript/nodejs" title="Deploy a Node.js application" subtitle="Learn more on deploying a Node.js application on Clever Cloud" icon="node" >}}
+  {{< card link="../../doc/applications/static" title="Deploy a Static application" subtitle="Learn more on deploying a Static application on Clever Cloud" icon="feather" >}}
+  {{< card link="https://nuxt.com/docs" title="Learn Nuxt" subtitle="Nuxt full documentation" icon="rocket-launch" >}}
+{{< /cards >}}

go.mod

@@ -2,4 +2,4 @@ module github.com/CleverCloud/documentation
 
 go 1.21
 
-require github.com/imfing/hextra v0.8.4 // indirect
+require github.com/imfing/hextra v0.9.3 // indirect

go.sum

@@ -1,2 +1,2 @@
-github.com/imfing/hextra v0.8.4 h1:cR4asr0TeDlqHPHLdTpMQJOjVeXnq8nfLMzcF0pld+w=
-github.com/imfing/hextra v0.8.4/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=
+github.com/imfing/hextra v0.9.3 h1:p4vDm2TSgt3RpJdJm2mqkpoJCH2S08wzySyyYodtgCc=
+github.com/imfing/hextra v0.9.3/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI=

hugo.yaml

@@ -13,7 +13,7 @@ module:
   hugoVersion:
     extended: true
     min: "0.133.0"
-    max: "0.135.0"
+    max: "0.140.2"
 
 outputs:
   home: [HTML, LLMS]