From ff184f88ecc2145c5713392259619c22f3974d1a Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Mon, 13 Jan 2025 16:47:48 +0900 Subject: [PATCH 1/7] fix: disable comment post on external-doc-update.yml Comment this part of the script until we find out why it's triggered on every single PR. --- .github/workflows/external-doc-update.yml | 26 +++++++++++------------ 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/.github/workflows/external-doc-update.yml b/.github/workflows/external-doc-update.yml index 941233f4..8740f7c5 100644 --- a/.github/workflows/external-doc-update.yml +++ b/.github/workflows/external-doc-update.yml @@ -48,18 +48,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_ From 249bd11f02c74d47ab56a6556157646bc901ff5b Mon Sep 17 00:00:00 2001 From: Maxime Pauvert Date: Mon, 13 Jan 2025 09:28:36 +0100 Subject: [PATCH 2/7] Improve Nuxt doc (#481) ## Describe your PR I will finish after my PR to add a page on the official nuxt doc https://github.com/nuxt/nuxt.com/pull/1668 ## Checklist - [ ] My PR is related to an opened issue : # - [ ] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --------- Co-authored-by: Julia March <101819212+juliamrch@users.noreply.github.com> --- content/guides/nuxt.md | 60 ++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 58 insertions(+), 2 deletions(-) diff --git a/content/guides/nuxt.md b/content/guides/nuxt.md index 02418133..f661ca1e 100644 --- a/content/guides/nuxt.md +++ b/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 >}} From ca740d071396b561c3a2834612b180dab1ec9a66 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cl=C3=A9ment=20Nivolle?= Date: Mon, 13 Jan 2025 11:54:59 +0100 Subject: [PATCH 3/7] fix: arrow for link in code tags (#478) ## Describe your PR Fix the red arrow for external link in code tags. Especially inside the page "En Var References". ## Checklist - [ ] My PR is related to an opened issue : # - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers Co-authored-by: Julia March <101819212+juliamrch@users.noreply.github.com> --- assets/css/custom.css | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/assets/css/custom.css b/assets/css/custom.css index f72bd0ce..9f738eed 100644 --- a/assets/css/custom.css +++ b/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. From cd0a600d35ea8130aadebc0e796051e8ac9c900d Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Mon, 13 Jan 2025 19:55:54 +0900 Subject: [PATCH 4/7] fix: upgrade hugo version, theme and fix 404 on image (#474) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR Maintenance PR for the site: - Upgrade to Hugo [0.140.0] - Upgrade to [Hextra v0.9.0](https://github.com/imfing/hextra/releases/tag/v0.9.0) (new callouts available) - fix: 404 on an image I injected the environment variables versions to the review app already. ## Checklist - [ ] My PR is related to an opened issue : # - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --------- Co-authored-by: Clément Nivolle --- .github/workflows/review-app.yml | 4 ++-- go.mod | 2 +- go.sum | 2 ++ hugo.yaml | 2 +- 4 files changed, 6 insertions(+), 4 deletions(-) diff --git a/.github/workflows/review-app.yml b/.github/workflows/review-app.yml index b38447f5..4552c838 100644 --- a/.github/workflows/review-app.yml +++ b/.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.0' GH_HUGO_ENV: 'production' - GH_HUGO_VERSION: '0.135.0' + GH_HUGO_VERSION: '0.140.0' with: type: 'static-apache' diff --git a/go.mod b/go.mod index 6100deb3..5de565cc 100644 --- a/go.mod +++ b/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.0 // indirect diff --git a/go.sum b/go.sum index 20743471..396e481d 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,4 @@ 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.0 h1:1UyLZgS1eayce2ETCOjAQssXpkRz3HDrIs/fljH0lkU= +github.com/imfing/hextra v0.9.0/go.mod h1:cEfel3lU/bSx7lTE/+uuR4GJaphyOyiwNR3PTqFTXpI= diff --git a/hugo.yaml b/hugo.yaml index d7b6ee4d..fbab8071 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -13,7 +13,7 @@ module: hugoVersion: extended: true min: "0.133.0" - max: "0.135.0" + max: "0.140.0" outputs: home: [HTML, LLMS] From 5b0f52519f8fcc8b5b3ae8e88ae0bafc0c5dba13 Mon Sep 17 00:00:00 2001 From: Julie POUNY <63869305+Juju-archy@users.noreply.github.com> Date: Tue, 14 Jan 2025 10:23:34 +0100 Subject: [PATCH 5/7] Display custom backup error (#446) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR This PR updates the backup documentation to clarify the behavior of custom backup configurations with multiple retention policies and periods. It explains that while the Clever Cloud console does not display all backups for restoration, users can leverage the CLI to restore a specific backup. --------- Co-authored-by: Juju-archy Co-authored-by: Clément Nivolle Co-authored-by: David Legrand <1110600+davlgd@users.noreply.github.com> Co-authored-by: Julia March <101819212+juliamrch@users.noreply.github.com> --- content/doc/find-help/faq.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/content/doc/find-help/faq.md b/content/doc/find-help/faq.md index fdb54fab..747e937f 100644 --- a/content/doc/find-help/faq.md +++ b/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 From f2b8671a3032b51b8832bc13958484bc78ad6320 Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 16 Jan 2025 10:14:23 +0100 Subject: [PATCH 6/7] changelog: Metabase 52 --- content/changelog/2024-12-05-metabase-52.md | 23 +++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 content/changelog/2024-12-05-metabase-52.md diff --git a/content/changelog/2024-12-05-metabase-52.md b/content/changelog/2024-12-05-metabase-52.md new file mode 100644 index 00000000..561e86b7 --- /dev/null +++ b/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" >}} From 128bed03dfed00ac2ba8cba7665936d45ce231a3 Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Thu, 16 Jan 2025 22:51:03 +0900 Subject: [PATCH 7/7] Upgrade Hugo to v0.140.2 and Hextra to v0.9.3 (#496) ## Describe your PR **Upgrades (no breaking changes):** - Hugo from v0.140.0 to [v0.140.2](https://github.com/gohugoio/hugo/releases/tag/v0.140.2) - Hextra from v0.9.0 to [v.0.9.3](https://github.com/imfing/hextra/releases/tag/v0.9.3) **Security update in `external-doc-update.yml`:** Use the environment parameter in job to avoid giving forks access to repository secrets. _The only secret used is `GITHUB_TOKEN`, which is ephemeral: a new one is generated for each job and revoked after the job ends._ ## Checklist - [ ] My PR is related to an opened issue : - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @cnivolle --- .github/workflows/external-doc-update.yml | 1 + .github/workflows/review-app.yml | 4 ++-- go.mod | 2 +- go.sum | 6 ++---- hugo.yaml | 2 +- 5 files changed, 7 insertions(+), 8 deletions(-) diff --git a/.github/workflows/external-doc-update.yml b/.github/workflows/external-doc-update.yml index 8740f7c5..68e351b7 100644 --- a/.github/workflows/external-doc-update.yml +++ b/.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 diff --git a/.github/workflows/review-app.yml b/.github/workflows/review-app.yml index 4552c838..9bf77441 100644 --- a/.github/workflows/review-app.yml +++ b/.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.9.0' + GH_HEXTRA_VERSION: 'v0.9.3' GH_HUGO_ENV: 'production' - GH_HUGO_VERSION: '0.140.0' + GH_HUGO_VERSION: '0.140.2' with: type: 'static-apache' diff --git a/go.mod b/go.mod index 5de565cc..6096581f 100644 --- a/go.mod +++ b/go.mod @@ -2,4 +2,4 @@ module github.com/CleverCloud/documentation go 1.21 -require github.com/imfing/hextra v0.9.0 // indirect +require github.com/imfing/hextra v0.9.3 // indirect diff --git a/go.sum b/go.sum index 396e481d..08708c9e 100644 --- a/go.sum +++ b/go.sum @@ -1,4 +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.0 h1:1UyLZgS1eayce2ETCOjAQssXpkRz3HDrIs/fljH0lkU= -github.com/imfing/hextra v0.9.0/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= diff --git a/hugo.yaml b/hugo.yaml index fbab8071..c5c36d1f 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -13,7 +13,7 @@ module: hugoVersion: extended: true min: "0.133.0" - max: "0.140.0" + max: "0.140.2" outputs: home: [HTML, LLMS]