From 46edde4356b3bed47a7126434cd414a1490b45e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cl=C3=A9ment=20Nivolle?= Date: Fri, 20 Dec 2024 15:25:21 +0100 Subject: [PATCH 01/36] fixing spelling in quickstart and marketplace (#476) ## Describe your PR Spelling in quickstart and in the marketplace pages. ## Checklist - [ ] My PR is related to an opened issue : # - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) I'm also adding @vballu to check on the changes in the marketplace page. --- content/doc/marketplace/_index.md | 43 ++++++++--------------------- content/doc/quickstart/_index.md | 45 +++++++++++++++---------------- 2 files changed, 33 insertions(+), 55 deletions(-) diff --git a/content/doc/marketplace/_index.md b/content/doc/marketplace/_index.md index 002b272d..0e02eed2 100644 --- a/content/doc/marketplace/_index.md +++ b/content/doc/marketplace/_index.md @@ -48,26 +48,17 @@ First, provide a JSON manifest file that describes your add-on: } ``` -Fields +### Available fields * `id` - An ID for your add-on. All lower case, no spaces or punctuation. Underscores and dashes are allowed. This can’t be changed after the first push. It is also used for HTTP basic auth when making provisioning calls. - * `name` (Optional) - A human-readable name for your add-on. You will be able to change it later in the dashboard, so you don't even have to provide it right now. - * `api/config_vars` - A list of configuration variables that will be returned on provisioning calls. Each `config_var` name must start with the capitalized, add-on id with underscores, as in the example. - * `api/password` - Password that Clever Cloud will send in HTTP basic auth when making provisioning calls. You should generate a long random string for that field. - * `api/sso_salt` - Shared secret used in single sign-on between the Clever Cloud admin panel and your service’s admin panel. You should generate a long random string for that field. - * `api/regions` - The list of geographical zones supported by your add-on. It cannot be empty. As for now, it *MUST* contain the element "eu". More will be supported. - * `api/production/base_url` - The production endpoint on which Clever Cloud sends actions requests (provision and deprovision). - * `api/production/sso_url` - The production endpoint for single sign-on. - * `api/test/base_url` - The test endpoint on which Clever Cloud sends actions requests. Used to test your service when you create an add-on provider. After the add-on creation,`api/production/base_url` is used. - * `api/test/sso_url` - The test endpoint for single sign-on. Used to test your service when you create an add-on provider. After that, the `api/production/sso_url` is used. ## Add-on Provider requests @@ -78,7 +69,7 @@ When a Clever Cloud's customer interacts with your add-on, you'll receive reques When a customer installs your add-on, Clever Cloud issues a POST request to your service to provision a resource for his app. -The request will be the following: +Clever Cloud will send the following request: ```json Request: POST {base_url} @@ -105,38 +96,26 @@ Response Body: { The request body contains the following fields: * `addon_id` - The id we give to your add-on to identify it on our side. - * `owner_id` - The id of the customer this add-on will belong to. - * `owner_name` - The name of the customer. (Actually, the name of the organisation) - * `user_id` - The id of the user that is performing the action of provisioning this add-on. (The user will do it for the account of `owner_id`). - * `plan` - The slug field for the plan the user chose. You can create plans in the dashboard once your add-on manifest has been uploaded to the Clever Cloud platform. We send you the slug of the given plan, not its name. - * `region` - The region to provision the add-on. As for now, only "EU" will be sent. - -* `callback_url` - The URL you can use to get informations about the add-on and the user. This URL is available as soon as the provisioning is done. You can't use this URL during the POST call. - +* `callback_url` - The URL you can use to get details about the add-on and the user. This URL is available as soon as the provisioning is done. You can't use this URL during the POST call. * `logplex_token` - Deprecated, don't use it. - * `options` - String -> String map with options. - The response body contains the following fields: - * `id` - The add-on id as seen from your side. It *MUST* be a String. - * `config` (Optional) - A String -> String map with value for each config\_var defined in your manifest. A key that is not in your config\_vars will be ignored. - * `message` (Optional) - A creation message we will display in the dashboard. -### Deprovisioning +### De-provisioning -When a customer deletes your add-on, Clever Cloud issues a DELETE request to your service to deprovision a ressource for his app. +When a customer deletes your add-on, Clever Cloud issues a DELETE request to your service to de-provision a resource for his app. The request will be the following: @@ -188,7 +167,7 @@ Response Body: [ * `addon_id` - The add-on's id from Clever Cloud's POV. -* `callback_url` - URL to call to get more informations about this add-on. +* `callback_url` - URL to call to get more details about this add-on. * `plan` - The current plan of this add-on. @@ -221,7 +200,7 @@ This endpoint gives you more information about a provisioned add-on. * `name` - The name the user gave to this add-on in the Clever Cloud dashboard. -* `config` - Config vars as you defined during the provision call. +* `config` - Configuration variables as you defined during the provision call. * `callback_url` - The URL you just called. @@ -231,7 +210,7 @@ This endpoint gives you more information about a provisioned add-on. * `owner_id` - The id of the owner that provisioned the add-on. This should never change. -* `region` - The region this add-on is located in. As for now, we only support "eu". +* `region` - The region this add-on is located in. As for now, only "eu" is supported. * `domains` - Originally the domains names for the application owning the add-on. We return an empty list. @@ -371,9 +350,9 @@ Where: * `id` - The id of the connecting add-on. This is the id you returned on the provision call. -* `sso_salt` - The sso_salt field defined in your manifest. +* `sso_salt` - The `sso_salt` field defined in your manifest. -* `timestamp` - The timestamp field of the sso request. +* `timestamp` - The timestamp field of the SSO request. ### Sample in Python @@ -388,7 +367,7 @@ token = sha1(id + ':' + salt + ':' + timestamp).hexdigest() print token ``` -This will return: +This code returns: ```text 'aca601ba464437cbaa12b2fedd7db755c32ddb5e' diff --git a/content/doc/quickstart/_index.md b/content/doc/quickstart/_index.md index 7e3ea023..8c69e37a 100644 --- a/content/doc/quickstart/_index.md +++ b/content/doc/quickstart/_index.md @@ -18,18 +18,18 @@ type: "docs" ## Create a Clever Cloud Account The API of Clever Cloud uses OAuth 1 to perform authentication actions. -There are two ways to signup to Clever Cloud: **email** or **GitHub login**. +There are two ways to sign up for Clever Cloud: **email** or **GitHub login**. {{< tabs items="Email Auth, GitHub Auth" >}} {{< tab >}} - This kind of auth requires a valid and non-temporary disposable e-mail, and a password having at least 6 characters. + This kind of auth requires a valid and non-temporary disposable email, and a password having at least 6 characters. Do not forget to validate your email by clicking the link you will receive. {{< /tab >}} {{< tab >}} - The GitHub signup allows you to create an account or link your existing one to GitHub, in one click. + The GitHub sign up allows you to create an account or link your existing one to GitHub, in one click. This process asks the following permissions: * Read your Public Key @@ -64,7 +64,7 @@ If one of these elements is missing, Clever Cloud can't deploy your application ### How it Works -When you push an application's code to git or via FTP, the platform receives it and checks the resource’s requirements. If they are complete, the deployment is launched. When finished and successful, the application is up and running. +When you push an application's code to git or via FTP, the platform receives it and checks the resource's requirements. If they are complete, the deployment is launched. When finished and successful, the application is up and running. The log system retrieves all output from the application and displays it in the logs tab of your application in the Clever Cloud console. @@ -110,7 +110,7 @@ If you want to deploy an application within a GitHub organisation, first [grant Choose the language or the framework you want to deploy. {{< callout emoji="💡" >}} - **Optional:** For PHP applications, you can choose between FTP and Git deployment. + **Optional:** for PHP applications, you can choose between FTP and Git deployment. {{< /callout >}} #### Fine-tune your scaling configuration @@ -139,11 +139,11 @@ Enter the name and the description of your application. {{< tab >}} *To deploy via Git, you need it installed on your machine. You can find more information on Git website: [git-scm.com](https://git-scm.com)* - *Note:* During the deployment, the .git folder is automatically deleted to avoid security problems. If you need to know which version is used on the server please use the `COMMIT_ID` [environment variable](/reference/reference-environment-variables). + *Note:* during the deployment, the .git folder is automatically deleted to avoid security problems. If you need to know which version is used on the server please use the `COMMIT_ID` [environment variable](/reference/reference-environment-variables). Follow these steps to deploy your application: -1. Get the git deployment url in the application information page, which looks like: `git+ssh://git@push..clever-cloud.com/.git`. +1. Get the git deployment URL in the application information page, which looks like: `git+ssh://git@push..clever-cloud.com/.git`. 2. In your terminal, go to your application repository. If you do not already track your app with git, start by typing: @@ -153,7 +153,7 @@ Enter the name and the description of your application. git commit -m "first commit" ``` -3. Then, link your local repository to Clever Cloud by providing the Git remote url: +3. Then, link your local repository to Clever Cloud by providing the Git remote URL: ```bash git remote add @@ -174,13 +174,13 @@ git push :master {{< image "/images/github-deployment-branch.png" "Github deployment branch select" >}} - If you don't find your repository in the list fetched from Github, a workaround is to unlink your account in your profile here : , remove **Clever Cloud API** from your Github [Authorized OAuth Apps](https://github.com/settings../applications) and link again your Github account to your Clever Cloud account. + If you don't find your repository in the list fetched from GitHub, a workaround is to unlink your account in your profile here : , remove **Clever Cloud API** from your GitHub [Authorized OAuth Apps](https://github.com/settings../applications) and link again your GitHub account to your Clever Cloud account. **Private GitHub repositories are also supported.** - Caution: in GitHub, private repositories in an ordinary user account are an all-or-nothing deal: either someone has full read write access (i.e., they're a collaborator) or they have no access. + Caution: in GitHub, private repositories in an ordinary user account are an all-or-nothing deal: that is, either someone has full read write access (because they're a collaborator) or they have no access. - However, if you set up an organization, create the repo under the aegis of the organization, and then add the collaborator, you have much more fine-grained control (including giving read-only access to a private repository). + However, if you set up an organization, create the repository under the aegis of the organization, and then add the collaborator, you have much more fine-grained control (including giving read-only access to a private repository). {{< /tab >}} {{< tab >}} @@ -204,17 +204,16 @@ git push :master {{% details title="Git ⋅ Remote is asking for a password" closed="true" %}} -If the remote asks you for a password right after a git push attempt, this may be due to a SSH Key misconfiguration. +If the remote asks you for a password right after a git push attempt, this may be due to a SSH Key configuration error. **Add your SSH key to your profile here:** -The full tutorial about adding SSH key is here: [Adding SSH keys](/account/ssh-keys-management) +The full tutorial about adding SSH key is here: [adding SSH keys](/account/ssh-keys-management) {{% /details %}} - {{% details title= "Git ⋅ Unable to resolve the reference master" closed="true" %}} -You are probably trying to push from another branch. Remeber that: +You are probably trying to push from another branch. Keep in mind that: * You can only push to the **master** branch for deployment. Trying to push to another branch will trigger an error. * You cannot push a tag (which refers to a commit) to the remote repository. If you do so, **no deployment** will be triggered. @@ -238,7 +237,7 @@ appear to be a git repository Indeed, no git repository is created on Clever Cloud because the application is directly cloned from GitHub. -If you have to push directly to a repo in order to deploy an application (eg if you deploy from a CI), then create a non-GitHub app. +If you have to push directly to a repository to deploy an application (eg if you deploy from a CI), then create a non-GitHub app. {{% /details %}} @@ -292,7 +291,7 @@ Clever Cloud provides multiple add-ons to work with your applications: 1. Go to the [Clever Cloud Console](https://console.clever-cloud.com/). 2. Go to the organization in which you want to create the add-on, for example your [personal space](https://console.clever-cloud.com/users/me). 3. Click on **Add an add-on**. This space let you create and configure the add-on according to your needs. - 4. Choose which *type* of add-on you want to create. See above the list of available add-ons and their corresponding documentation pages for further information on how they work. + 4. Choose which *type* of add-on you want to create. See preceding the list of available add-ons and their corresponding documentation pages for further information on how they work. 5. Select the plan you need for you add-on. You can find details about the pricing, the capacity of the add-on and other specifications on this page or in the corresponding documentation page. 6. Choose with which application you want to link you add-on. Linking an add-on to an application will provide configuration to the application through [environment variables](/develop/env-variables). The environment variables provided by the add-on are available for use in the linked application. If you want to use your add-on alone, just don't link it to any application. 7. Choose the name of the add-on and the region where the add-on will be hosted. @@ -307,7 +306,7 @@ Clever Cloud provides multiple add-ons to work with your applications: 1. Go in the organization of your application. 2. Click on the name of the application you want to link with your add-on. 3. Go in the **Service dependencies** section. - 4. Select the add-on you want to link under the "Link addons" dropdown menu. + 4. Select the add-on you want to link under the "Link add-ons" dropdown menu. 5. Click on the **Link** button of the add-on you want to link to your application. {{< /tab >}} {{< /tabs >}} @@ -320,11 +319,11 @@ There are two kinds of billing: * Per-usage billing: Add-ons based on consumption, like [FS Bucket]({{< ref "doc/addons/fs-bucket" >}}) and [Cellar]({{< ref "doc/addons/cellar.md" >}}) {{< callout type="warning" >}} -**Free Plan:** Add-ons having a free plan are meant for testing purposes, not production usage. These add-ons usually rely on shared resources, resulting in variable, non-guaranteed performances and stability. Shared clusters may not be running the same version as dedicated instances. +**Free Plan:** add-ons having a free plan are meant for testing purposes, not production usage. These add-ons usually rely on shared resources, resulting in variable, non-guaranteed performances and stability. Shared clusters may not be running the same version as dedicated instances. {{< /callout >}} {{< callout emoji="📊" >}} -**Your invoice:** Per usage billing will be taken on runtime credits each day, while per-month add-ons will create a new line in the monthly invoice. +**Your invoice:** per usage billing will be taken on runtime credits each day, while per-month add-ons will create a new line in the monthly invoice. {{< /callout >}} ### Manage your Add-on @@ -333,10 +332,10 @@ Once an add-on is created, at least two tabs are available in the Clever Cloud c * **Add-on dashboard:** This screen provides and overview of your add-on and its options, depending on the type of add-on it is. -{{< image "/images/addon-dashboard.png" "Example of the dashoard tab of an add-on" >}} +{{< image "/developers/images/addon-dashboard.png" "Example of the dashoard tab of an add-on" >}} * **Information tab:** This screen sums-up the characteristics of the selected add-on. -Features and environment variables (if applicable) are shown. +The system shows features and environment variables (if applicable). Other tabs may be available, depending on the add-on type. @@ -348,5 +347,5 @@ To delete an add-on: 2. Click on *Remove add-on*. {{< callout type="warning" >}} -After deletion of the add-on, all associated data will be removed. +The system removes all associated data after you delete the add-on. {{< /callout >}} From fa63ac385f050e5e1d6813d67e9e39656c065498 Mon Sep 17 00:00:00 2001 From: Rachel-nas <77396432+Rachel-nas@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:37:11 +0100 Subject: [PATCH 02/36] Fixed broken links in API documentation (#482) ## Describe your PR _Some links were broken in the API documentation, I put the correct links._ ## Checklist - [ ] My PR is related to an opened issue : # - [x ] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers @CleverCloud/reviewers Co-authored-by: Rachel Nascimento --- content/api/howto.md | 10 +++++----- content/api/v4.md | 2 +- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/api/howto.md b/content/api/howto.md index fb4f7add..f73e1cfb 100644 --- a/content/api/howto.md +++ b/content/api/howto.md @@ -55,11 +55,11 @@ You need to set a callback URL, this is the url your user will be redirected to #### **Get a request token** -You have to make a `POST`request to get a [request token](/api/v2/#post-/oauth/request_token) to the API. +You have to make a `POST`request to get a [request token](/developers/api/v2/#post-/oauth/request_token) to the API. #### **Get the authorization URL** -Ask the API for the [authorization URL](/api/v2/#get-/oauth/authorize) and go to this URL with a browser. Log in with your account and it will send you to the callback URL. +Ask the API for the [authorization URL](/developers/api/v2/#get-/oauth/authorize) and go to this URL with a browser. Log in with your account and it will send you to the callback URL. #### **Get the verifier token** @@ -71,7 +71,7 @@ Where `` is your token. #### **Get the access token** -Make a `POST` request to get the [access token](/api/v2/#post-/oauth/access_token) with your request token and the verifier. +Make a `POST` request to get the [access token](/developers/api/v2/#post-/oauth/access_token) with your request token and the verifier. You can use this access token to make OAuth1 signed requests. More information about [OAuth dance](https://oauth.net/core/1.0/#anchor9). @@ -88,8 +88,8 @@ All the API endpoints are referenced in a swagger documentation. **The base URL {{< cards >}} - {{< card link="/api/v2" title="Base v2 Endpoints" subtitle="Our base API endpoints with users, organisations, applications, add-ons, etc." icon="endpoints" >}} - {{< card link="/api/v4" title="New v4 Endpoints" subtitle="More recent API endpoints with billing, deployments, load balancers, logs, etc." icon="new" >}} + {{< card link="/developers/api/v2/" title="Base v2 Endpoints" subtitle="Our base API endpoints with users, organisations, applications, add-ons, etc." icon="endpoints" >}} + {{< card link="/developers/api/v4/" title="New v4 Endpoints" subtitle="More recent API endpoints with billing, deployments, load balancers, logs, etc." icon="new" >}} {{< /cards >}} diff --git a/content/api/v4.md b/content/api/v4.md index 3f74d916..98749253 100644 --- a/content/api/v4.md +++ b/content/api/v4.md @@ -9,7 +9,7 @@ keywords: - endpoint - v4 --- -Clever Cloud provides a public REST API used by its own services and customers, known as [`/v2`](/api/v2). +Clever Cloud provides a public REST API used by its own services and customers, known as [`/v2`](/developers/api/v2/). As our platform evolves, we're progressively moving to `/v4` endpoints, adding functionalities, with a more modern approach: ``` https://api.clever-cloud.com/v4/ From a646bba945b01be7555052e8b963a11bc9d56caa Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Thu, 26 Dec 2024 14:31:54 +0100 Subject: [PATCH 03/36] Update CONTRIBUTING.md --- CONTRIBUTING.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ff0396f5..d38904c0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,8 +1,7 @@ # Contributing guidelines -This document provides explicit standards expected in Clever Cloud documentation. Inspiration and research for this document comes from [Google's Developer Documentation Style Guide](https://developers.google.com/style/tone), and the incredible [Awesome Code Review](https://github.com/joho/awesome-code-review) project. - +This document provides explicit standards expected in Clever Cloud documentation. Inspiration and research for this document comes from the incredible [Awesome Code Review](https://github.com/joho/awesome-code-review) project. ## Standards Those are general standards to fulfill for every modification in this repository. @@ -21,6 +20,8 @@ Follow the established structure in this doc. If you wish to propose changes to Follow these guidelines while writing new content. The goal is to help you write in a **clear, precise, and unambiguous language**. They're not meant to be a burden, but to help you deliver the best content possible. +Sources for quality content are currently being updated. + #### 👍 Do - **Don't assume the user "knows better":** if you think something is obvious, it's not. Better over-explain than under-explain. From 895ee259359fbb28c71e9c6fb226a66a5bcd5108 Mon Sep 17 00:00:00 2001 From: "Pierre L. / Peyo" <166715564+Dekabry@users.noreply.github.com> Date: Mon, 30 Dec 2024 16:13:55 +0100 Subject: [PATCH 04/36] Cellar ip restriction example (#471) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR Added an example for IP restriction policy on Cellar ## Checklist - [x] My PR is related to an opened issue : #24 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers @CleverCloud/reviewers --------- Co-authored-by: Clément Nivolle --- content/doc/addons/cellar.md | 49 ++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/content/doc/addons/cellar.md b/content/doc/addons/cellar.md index cbfc567c..84dc0f68 100644 --- a/content/doc/addons/cellar.md +++ b/content/doc/addons/cellar.md @@ -379,6 +379,55 @@ s3cmd delpolicy s3:// The original ACL should apply to all of your objects after that. + +### IP restrictions + +If you need to restrict your S3 Cellar to certain IPs, you can use a policy. +To do so, you can use the template below in a `policy.json` file. This example show how to block actions from any IP that isn't `192.168.1.6`. + +- Replace the `` with your bucket name in the policy file. +- Change the `Effect` to `Allow` or `Deny` depending on your needs. +- Change the IP address under `Condition` to select which IP should trigger the rule. + +```json {filename="IP-restriction-policy.json"} +{ + "Version": "2012-10-17", + "Id": "S3PolicyIPRestrict", + "Statement": [ + { + "Sid": "IPAllow", + "Effect": "Deny", + "Principal": { + "AWS": "*" + }, + "Action": "s3:*", + "Resource": [ + "arn:aws:s3:::", + "arn:aws:s3:::/*" + ], + "Condition" : { + "IpAddress" : { + "aws:SourceIp": ["0.0.0.0/0"] + }, + "NotIpAddress": { + "aws:SourceIp": ["192.168.1.6/32"] + } + } + } + ] +} +``` + +To apply the policy, use this command: +``` +s3cmd setpolicy ./policy.json s3:// +``` + +To delete the policy, use this command: +``` +s3cmd delpolicy ./policy.json s3:// +``` + ### User access Cellar doesn't natively support creating different user accesses for the same add-on. Granting access to your Cellar add-on grants full access to all of your buckets. To grant limited access to a bucket, do the following: From 171ee5a0e80fa1e4a45fc1006461c509c0a829cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ga=C3=ABtan=20Maisse?= Date: Thu, 2 Jan 2025 16:52:51 +0100 Subject: [PATCH 05/36] Fix link in the index page of the CLI section (#483) ## Describe your PR The "Manage an application" button was wrongly redirecting to the "Configure" page instead of the "Manage" one. So, I just updated the link. ## Checklist - [x] My PR is not related to any opened issue, I just opened it because I was reading the doc and spotted the issue - [X] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --- content/doc/CLI/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/doc/CLI/_index.md b/content/doc/CLI/_index.md index 3daac793..34d54d38 100644 --- a/content/doc/CLI/_index.md +++ b/content/doc/CLI/_index.md @@ -27,7 +27,7 @@ In addition to the Clever Cloud console, you can manage your add-ons and applica {{< card link="getting_started" title="Install" icon="arrow-down-tray" >}} {{< card link="create" title="Create an application or an add-on" icon="command-line" >}} {{< card link="configure" title="Configure an application" icon= "adjustments-horizontal">}} - {{< card link="configure" title="Manage an application" icon="wrench-screwdriver" >}} + {{< card link="manage" title="Manage an application" icon="wrench-screwdriver" >}} {{< card link="lifecycle" title="Manage an application's lifecycle" icon="arrow-path" >}} {{< card link="notifications" title="Set notifications" icon="bell" >}} {{< card link="ssh-access" title="SSH access an application" icon="key" >}} From 55b6848552c6ffdd026d0601a8dc7a51a01174b9 Mon Sep 17 00:00:00 2001 From: Alexandre Burgoni Date: Thu, 19 Dec 2024 11:13:33 +0100 Subject: [PATCH 06/36] docs(materia-kv): add lolwut command --- content/doc/addons/materia-kv.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/doc/addons/materia-kv.md b/content/doc/addons/materia-kv.md index 85b53125..43a32711 100644 --- a/content/doc/addons/materia-kv.md +++ b/content/doc/addons/materia-kv.md @@ -159,6 +159,7 @@ Find below the list of currently supported commands: | `INCRBY` | Increments the number stored at `key` by the given `increment`. If the `key` doesn't exist, it is set to `0` before performing the operation. An error is returned if `key` contains a value of the wrong type or contains a string that can not be represented as integer. This operation is limited to 64-bit signed integers. | | `INFO` | The `INFO` command returns information and statistics about the server in a format that is simple to parse by computers and easy to read by humans. | | `KEYS` | Returns all keys matching `pattern`, can be `*` | +| `LOLWUT` | Returns Materia KV's version and might be hiding an easter egg 👀 | | `MGET` | Returns the values of all specified keys. For every key that doesn't hold a string value or doesn't exist, the special value `nil` is returned. Because of this, the operation never fails. | | `MSET` | Sets the given keys to their respective values. `MSET` replaces existing values with new values, just as regular `SET`. `MSET` is atomic, so all given keys are set at once. It is not possible for clients to see that some keys were updated while others are unchanged. | | `PERSIST` | Remove the existing time to live associated with the `key`. | From 015a39e629baa446b12758b4b94081ed5d64f5ed Mon Sep 17 00:00:00 2001 From: David Legrand <1110600+davlgd@users.noreply.github.com> Date: Tue, 7 Jan 2025 16:06:16 +0100 Subject: [PATCH 07/36] =?UTF-8?q?changelog:=20S=C5=8Dzu=201.0.6=20(#490)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR Add an entry about Sōzu 1.0.6 --- content/changelog/2025-01-06-sozu-1.0.6.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 content/changelog/2025-01-06-sozu-1.0.6.md diff --git a/content/changelog/2025-01-06-sozu-1.0.6.md b/content/changelog/2025-01-06-sozu-1.0.6.md new file mode 100644 index 00000000..06aefc96 --- /dev/null +++ b/content/changelog/2025-01-06-sozu-1.0.6.md @@ -0,0 +1,19 @@ +--- +title: Sōzu 1.0.6 is available and deployed, with new 4xx/5xx custom error pages +date: 2025-01-06 +tags: + - sozu +authors: + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 + - name: Florentin Dubois + link: https://github.com/FlorentinDUBOIS + image: https://github.com/FlorentinDUBOIS.png?size=40 +description: Next to come, HTTP/2! +excludeSearch: true +--- + +[Sōzu](https://www.sozu.io) 1.0.6 is now available and deployed on all our shared and dedicated load balancers. It comes with a fix for a TLS bug we encountered with [Metabase](../doc/addons/metabase) instances in some cases. We've also overhauled the custom pages for 4xx and 5xx errors. They now display a better designed and more detailed message. + +* Learn more about [Sōzu new releases](https://github.com/sozu-proxy/sozu/releases) {{< icon "github" >}} \ No newline at end of file From 56f4147c296f52f60661f1f3662b4ae8a29a5146 Mon Sep 17 00:00:00 2001 From: David Legrand <1110600+davlgd@users.noreply.github.com> Date: Tue, 7 Jan 2025 17:18:47 +0100 Subject: [PATCH 08/36] Add llms.txt support (#486) ## Describe your PR This PR add `llms.txt` standard support to the documentation through a new `LLMS` output format. It creates a `llms.txt` file at the root of the project with: - Documentation title - Documentation description (in most part from quickstart section) - List non empty documentation sections - Creates a `.md` version of all sections pages, including shortcodes/versions tables - List all `.md` pages links and their description - List all guides in `optional` section (as they're not mandatory to understand to use Clever Cloud) - Add markdown files support for Apache through `.htaccess` --- clevercloud-deploy-script.sh | 3 +- content/guides/_index.md | 1 + data/software_versions_shared_dedicated.yml | 2 + hugo.yaml | 16 ++++-- layouts/_default/list.md | 1 + layouts/_default/single.md | 1 + layouts/hextra-home.llms.txt | 52 +++++++++++++++++++ .../partials/markdown/include_entrypoint.md | 5 ++ .../markdown/include_runtimes_versions.md | 32 ++++++++++++ .../markdown/include_shortcode_content.md | 13 +++++ ...lude_software_versions_shared_dedicated.md | 23 ++++++++ 11 files changed, 145 insertions(+), 4 deletions(-) create mode 100644 layouts/_default/list.md create mode 100644 layouts/_default/single.md create mode 100644 layouts/hextra-home.llms.txt create mode 100644 layouts/partials/markdown/include_entrypoint.md create mode 100644 layouts/partials/markdown/include_runtimes_versions.md create mode 100644 layouts/partials/markdown/include_shortcode_content.md create mode 100644 layouts/partials/markdown/include_software_versions_shared_dedicated.md diff --git a/clevercloud-deploy-script.sh b/clevercloud-deploy-script.sh index ee316b5f..41deb219 100755 --- a/clevercloud-deploy-script.sh +++ b/clevercloud-deploy-script.sh @@ -2,4 +2,5 @@ wget https://github.com/gohugoio/hugo/releases/download/v$HUGO_VERSION/hugo_exte tar xvf hugo_extended_"$HUGO_VERSION"_Linux-64bit.tar.gz chmod +x ./hugo ./hugo mod get github.com/imfing/hextra@$HEXTRA_VERSION -./hugo --gc --minify --destination public/developers \ No newline at end of file +./hugo --gc --minify --destination public/developers +echo "AddType text/markdown;charset=UTF-8 .md" > public/.htaccess diff --git a/content/guides/_index.md b/content/guides/_index.md index 6c3891fb..e02891fa 100644 --- a/content/guides/_index.md +++ b/content/guides/_index.md @@ -10,6 +10,7 @@ aliases: - /doc/deploy/application/docker/tutorials type: "docs" comments: false +llmsTxtOptional: true --- ## Frameworks diff --git a/data/software_versions_shared_dedicated.yml b/data/software_versions_shared_dedicated.yml index eb051fd6..d2672638 100644 --- a/data/software_versions_shared_dedicated.yml +++ b/data/software_versions_shared_dedicated.yml @@ -35,3 +35,5 @@ elasticsearch: redis: dedicated: - "v7.2.4" + +dev_message: "**Important**: Dev plans are free and **solely for testing purposes**. They don't provide the same guarantees or SLAs as dedicated plans." diff --git a/hugo.yaml b/hugo.yaml index 51f26f37..14bde371 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -17,9 +17,18 @@ module: max: "0.135.0" outputs: - home: [HTML] - page: [HTML] - section: [HTML, RSS] + home: [HTML, LLMS] + page: [HTML, Markdown] + section: [HTML, Markdown, RSS] + +outputFormats: + LLMS: + mediaType: "text/plain" + baseName: "llms" + isPlainText: true + + Markdown: + baseName: index.html privacy: youtube: @@ -37,6 +46,7 @@ languages: #title: "Documentation de Clever Cloud " 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 navbar: diff --git a/layouts/_default/list.md b/layouts/_default/list.md new file mode 100644 index 00000000..71828b22 --- /dev/null +++ b/layouts/_default/list.md @@ -0,0 +1 @@ +{{ partial "markdown/include_entrypoint.md" .RawContent | htmlUnescape }} diff --git a/layouts/_default/single.md b/layouts/_default/single.md new file mode 100644 index 00000000..71828b22 --- /dev/null +++ b/layouts/_default/single.md @@ -0,0 +1 @@ +{{ partial "markdown/include_entrypoint.md" .RawContent | htmlUnescape }} diff --git a/layouts/hextra-home.llms.txt b/layouts/hextra-home.llms.txt new file mode 100644 index 00000000..532a5955 --- /dev/null +++ b/layouts/hextra-home.llms.txt @@ -0,0 +1,52 @@ +{{- if eq .Kind "home" -}} +# {{ .Site.Title }} + +> {{ .Site.Params.description }} + +{{- $mainSections := where .Site.Sections "Type" "docs" -}} +{{- $sortedSections := sort $mainSections "Title" }} +{{- range $sortedSections }} +{{- if and (not .Params.llmsTxtOptional) (gt (len .Pages) 0) }} +{{- $allSections := slice . -}} +{{- range .Sections -}} +{{- if not .Params.llmsTxtOptional -}} +{{- $allSections = $allSections | append . -}} +{{- end -}} +{{- end -}} +{{- $sortedAllSections := sort $allSections "Title" -}} +{{- range $sortedAllSections }} + +{{- if and (gt (len .Pages) 0) (not (strings.Contains .Title "Postmortem" )) }} + +## {{ .Title }} +{{- $pages := sort .Pages "Title" "asc" }} +{{- range $pages }} +{{- if not (strings.Contains .RelPermalink "/api/v2") }} +- [{{ .Title }}](https://www.clever-cloud.com{{ .RelPermalink }}index.html.md){{ with .Description }}: {{ . }}{{ end }} +{{- end }} +{{- end }} +{{- end }} +{{- end }} +{{- end }} +{{- end }} + +## Optional +{{- range $mainSections }} +{{- if .Params.llmsTxtOptional }} +{{- $pages := sort .Pages "Title" "asc" }} +{{- range $pages }} +- [{{ .Title }}](https://www.clever-cloud.com{{ .RelPermalink }}index.html.md){{ with .Description }}: {{ . }}{{ end }} +{{- end }} +{{- end }} +{{- range .Sections }} +{{- if .Params.llmsTxtOptional }} +{{- $pages := sort .Pages "Title" "asc" }} +{{- range $pages }} +- [{{ .Title }}]({{ .RelPermalink }}index.html.md){{ with .Description }}: {{ . }}{{ end }} +{{- end }} +{{- end }} +{{- end }} +{{- end }} +{{- else -}} +{{- .RawContent | .Page.RenderString -}} +{{- end -}} diff --git a/layouts/partials/markdown/include_entrypoint.md b/layouts/partials/markdown/include_entrypoint.md new file mode 100644 index 00000000..c109cc54 --- /dev/null +++ b/layouts/partials/markdown/include_entrypoint.md @@ -0,0 +1,5 @@ +{{- $content := . -}} +{{- $content = partial "markdown/include_shortcode_content.md" $content -}} +{{- $content = partial "markdown/include_runtimes_versions.md" $content -}} +{{- $content = partial "markdown/include_software_versions_shared_dedicated.md" $content -}} +{{ $content }} diff --git a/layouts/partials/markdown/include_runtimes_versions.md b/layouts/partials/markdown/include_runtimes_versions.md new file mode 100644 index 00000000..eb6097c2 --- /dev/null +++ b/layouts/partials/markdown/include_runtimes_versions.md @@ -0,0 +1,32 @@ +{{- $content := . -}} +{{- $runtimesPattern := "\\{\\{<\\s*runtimes_versions\\s+([^>]+)\\s*>\\}\\}" -}} + +{{- range $runtimeFound := findRE $runtimesPattern $content -}} + {{- $runtime := replaceRE $runtimesPattern "$1" $runtimeFound -}} + {{- $runtime = trim $runtime " " -}} + {{- $versions := index site.Data.runtime_versions $runtime -}} + {{- $output := "" -}} + {{- with $versions -}} + {{- if .default -}} + {{- $output = printf "%s### Default version\n" $output -}} + {{- range .default -}} + {{- $output = printf "%s- %s\n" $output . -}} + {{- end -}} + {{- end -}} + + {{- if .accepted -}} + {{- $output = printf "%s\n### Accepted version(s)\n" $output -}} + {{- range .accepted -}} + {{- $output = printf "%s- %s\n" $output . -}} + {{- end -}} + {{- end -}} + + {{- if .eol_source -}} + {{- $output = printf "%s\nCheck the [end-of-life (EOL)](%s) status of these versions." $output .eol_source -}} + {{- end -}} + {{- end -}} + + {{- $content = replace $content $runtimeFound $output -}} +{{- end -}} + +{{- return $content -}} diff --git a/layouts/partials/markdown/include_shortcode_content.md b/layouts/partials/markdown/include_shortcode_content.md new file mode 100644 index 00000000..7479f05c --- /dev/null +++ b/layouts/partials/markdown/include_shortcode_content.md @@ -0,0 +1,13 @@ +{{- $content := . -}} +{{- $patternSearch := "\\{\\{%\\s*content/([^%}]+)\\s*%\\}\\}" -}} +{{- $patternClean := "\\{\\{%\\s*content/(.+?)\\s*%\\}\\}" -}} + +{{- range $shortcodeFound := findRE $patternSearch $content -}} + {{- $name := replaceRE $patternClean "$1" $shortcodeFound -}} + {{- $filepath := printf "layouts/shortcodes/content/%s.md" $name -}} + {{- with os.ReadFile $filepath -}} + {{- $content = replace $content $shortcodeFound . -}} + {{- end -}} +{{- end -}} + +{{- return $content -}} diff --git a/layouts/partials/markdown/include_software_versions_shared_dedicated.md b/layouts/partials/markdown/include_software_versions_shared_dedicated.md new file mode 100644 index 00000000..2c7f7a41 --- /dev/null +++ b/layouts/partials/markdown/include_software_versions_shared_dedicated.md @@ -0,0 +1,23 @@ +{{- $content := . -}} +{{- $versionsPattern := "\\{\\{<\\s*software_versions_shared_dedicated\\s+([^>]+)\\s*>\\}\\}" -}} + +{{- range $versionFound := findRE $versionsPattern $content -}} + {{- $dbname := replaceRE $versionsPattern "$1" $versionFound -}} + {{- $versions := index site.Data.software_versions_shared_dedicated $dbname -}} + {{- $output := "### Regular versions\n" -}} + {{- with $versions.dedicated -}} + {{- range . -}} + {{- $output = printf "%s- %s\n" $output . -}} + {{- end -}} + {{- end -}} + {{- if $versions.dev -}} + {{- $output = printf "%s\n### DEV plan\n" $output -}} + {{- range $versions.dev -}} + {{- $output = printf "%s- %s\n" $output . -}} + {{- end -}} + {{- $output = printf "%s\n%s" $output site.Data.software_versions_shared_dedicated.dev_message -}} + {{- end -}} + {{- $content = replace $content $versionFound $output -}} +{{- end -}} + +{{- return $content -}} From fdf1cc3652a9741755e3a33a41e73ef0540f538e Mon Sep 17 00:00:00 2001 From: David Legrand <1110600+davlgd@users.noreply.github.com> Date: Tue, 7 Jan 2025 17:20:46 +0100 Subject: [PATCH 09/36] chore: delete robots.txt (#485) As the domain is now back to clever-cloud.com, there is no need for a dedicated robots.txt for the documentation --- hugo.yaml | 1 - layouts/robots.txt | 4 ---- 2 files changed, 5 deletions(-) delete mode 100644 layouts/robots.txt diff --git a/hugo.yaml b/hugo.yaml index 14bde371..d7b6ee4d 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -5,7 +5,6 @@ publishDir: public/developers pagination: pagerSize: 21 # Number of entries in Changelog section before pagination -enableRobotsTXT: true enableGitInfo: true module: diff --git a/layouts/robots.txt b/layouts/robots.txt deleted file mode 100644 index 20a4e938..00000000 --- a/layouts/robots.txt +++ /dev/null @@ -1,4 +0,0 @@ -User-agent: * -Allow: / - -Sitemap: {{ site.Home.Sitemap.Filename | absURL }} From fee8c9c3362f2c661718976c856ca081e3419623 Mon Sep 17 00:00:00 2001 From: "Pierre L. / Peyo" <166715564+PLhuillery@users.noreply.github.com> Date: Tue, 7 Jan 2025 17:25:43 +0100 Subject: [PATCH 10/36] DEV FAQ entry + MongoDB clean + partial (#484) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR - Created a FAQ entry for DEV plan - Modified the partial to have a link to FAQ entry - Cleaned up redundant MongoDB info about DEV plan - Style & typos ## Checklist - [x] My PR is related to an opened issue : #15 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --------- Co-authored-by: David Legrand <1110600+davlgd@users.noreply.github.com> Co-authored-by: Clément Nivolle --- content/doc/addons/mongodb/_index.md | 12 ++++-------- content/doc/find-help/faq.md | 8 ++++++++ .../software_versions_shared_dedicated.html | 2 +- 3 files changed, 13 insertions(+), 9 deletions(-) diff --git a/content/doc/addons/mongodb/_index.md b/content/doc/addons/mongodb/_index.md index f296ca27..afb8ea4c 100644 --- a/content/doc/addons/mongodb/_index.md +++ b/content/doc/addons/mongodb/_index.md @@ -30,19 +30,15 @@ In order to comply with [MongoDB Server Side Public License](https://www.mongodb ### Higher Versions -If you puchased a higher version from MongoDB and you want to deploy your database on Clever Cloud, please [contact us](https://www.clever-cloud.com/contact/). - -## About Free Databases - -Free plans are recommended for test and development usage only. Using these databases in production is not recommended, because performance may vary depending on the global usage of the cluster. Therefore, before switching to production, consider upgrading to a dedicated database for better performance. +If you purchased a higher version from MongoDB and you want to deploy your database on Clever Cloud, [contact us](https://www.clever-cloud.com/contact/). {{< callout type="warning" >}} -The ability to create free plan for MongoDB is currently turned off. It may come back in the future. +DEV plan is no longer available for MongoDB. {{< /callout >}} -### Important Note About Fair Use on Free Databases +### Important note about fair use on DEV plans -Heavy usage of free databases may impact the shared cluster they rely upon. It will degrade performance of the other databases. To that extent, we set a soft limit of **15 operations/second**. Going above the limit will expose your database to disconnection, would you not answer our notices. +Heavy usage of DEV databases may impact the shared cluster they rely upon. It will degrade performance of the other databases. To that extent, DEV plan has a limit of **15 operations/second**. Going above the limit might disconnect your database. {{% content/db-backup %}} diff --git a/content/doc/find-help/faq.md b/content/doc/find-help/faq.md index fd4f29bc..ac276f07 100644 --- a/content/doc/find-help/faq.md +++ b/content/doc/find-help/faq.md @@ -229,3 +229,11 @@ This way, even if one data center has an accident, your backup are still safe in To create add-ons, you need to complete your account information, including your city and ZIP code. For instance, you cannot create a Matomo add-on until you provide these details. + +## What is a DEV plan ? + +DEV plan is a free-tier plan available for some databases, designed to let customers explore and test these products. They operate on shared clusters, which may result in variable performance; they also have no SLA guarantees. + +Some features such as simultaneous connections numbers, functions... might be reduced or unavailable. + +Support is not able to provide help in case of DEV plan. diff --git a/layouts/shortcodes/software_versions_shared_dedicated.html b/layouts/shortcodes/software_versions_shared_dedicated.html index b742f71c..c5a9728f 100644 --- a/layouts/shortcodes/software_versions_shared_dedicated.html +++ b/layouts/shortcodes/software_versions_shared_dedicated.html @@ -33,6 +33,6 @@ {{ if $has_dev }} - {{ $.Page.RenderString "{{< callout type=\"warning\">}} Important: Dev plans are free and solely for testing purposes. They don't provide the same guarantees or SLAs as dedicated plans. {{< /callout >}}" | safeHTML }} + {{ $.Page.RenderString "{{< callout type=\"warning\">}} Important: DEV plan is free, for testing purposes only. It has lower performances and no SLA. You can find more info [in the FAQ](/doc/find-help/faq.md) {{< /callout >}}" | safeHTML }} {{ end }} From 5d196b1ccdfc8d6834705c28b5fd7957f92bf692 Mon Sep 17 00:00:00 2001 From: "Pierre L. / Peyo" <166715564+PLhuillery@users.noreply.github.com> Date: Tue, 7 Jan 2025 17:56:02 +0100 Subject: [PATCH 11/36] X-CleverCloud-Header header to identify a monitoring ping (#469) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR Added a note in FAQ to explain how to identify a monitoring request using `X-CleverCloud -Monitoring` header ## Checklist - [x] My PR is related to an opened issue : #69 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers @CleverCloud/reviewers --------- Co-authored-by: Pierre L. / Peyo <166715564+Dekabry@users.noreply.github.com> Co-authored-by: Clément Nivolle Co-authored-by: Corentin BARAULT <74433435+Kirbeerus@users.noreply.github.com> Co-authored-by: David Legrand <1110600+davlgd@users.noreply.github.com> --- content/doc/find-help/faq.md | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/content/doc/find-help/faq.md b/content/doc/find-help/faq.md index ac276f07..fdb54fab 100644 --- a/content/doc/find-help/faq.md +++ b/content/doc/find-help/faq.md @@ -71,14 +71,6 @@ We will investigate and contact the application's owner over the violation if ne ## Does Clever Cloud support TLS/SSL (HTTPS)? -<<<<<<< HEAD -Absolutely! For testing purposes, `cleverapps.io` domains support TLS out of the box. For custom SSL certificates, you can either order one from us or use an existing one. -Have a look at [installing SSL certificates]({{< ref"doc/administrate/ssl" >}} "Install a certificate SSL"), and feel free to contact us at if you have questions. - -## I'd like to have two applications available on the same domain name - -Please refer to [prefix routing](../../administrate/domain-names/#prefix-routing) to learn how to have two applications share a domain name. -======= Yes. For testing purposes, `cleverapps.io` domains support TLS out of the box. For custom SSL certificates, you can either generate one automatically with Let's Encrypt while adding a domain, or [use an existing one]{{< ref "doc/administrate/ssl/#uploading-my-own-certificates" >}}). Have a look at [installing TLS certificates](/doc/administrate/ssl), and feel free to contact the support team in the [Ticket Center](https://console.clever-cloud.com/ticket-center-choice) if you have questions. @@ -93,7 +85,6 @@ nmap --script ssl-enum-ciphers -p 443 example.com ## I'd like to have two applications available on the same domain name Refer to [prefix routing]({{< ref "doc/administrate/domain-names/#prefix-routing" >}}) to learn how to have two applications share a domain name. ->>>>>>> origin/main ## How do I define cron jobs for my application? @@ -230,10 +221,15 @@ This way, even if one data center has an accident, your backup are still safe in To create add-ons, you need to complete your account information, including your city and ZIP code. For instance, you cannot create a Matomo add-on until you provide these details. +## I get unknown regular requests, is there a problem ? + +The platform performs routine health checks to applications every 2 minutes. You may notice these periodic HTTP requests in your logs, with `X-Clever-Monitoring` header. They're part of Clever Cloud's standard monitoring process. + ## What is a DEV plan ? DEV plan is a free-tier plan available for some databases, designed to let customers explore and test these products. They operate on shared clusters, which may result in variable performance; they also have no SLA guarantees. -Some features such as simultaneous connections numbers, functions... might be reduced or unavailable. +Some features such as simultaneous connections numbers, functions… might be reduced or unavailable. Support is not able to provide help in case of DEV plan. + From 76117e49d72e4477eda2ec6767b986c41acc9f1a Mon Sep 17 00:00:00 2001 From: David Legrand Date: Tue, 7 Jan 2025 14:42:38 +0100 Subject: [PATCH 12/36] changelog: Terraform provider 0.5 --- ...4-12-24-terraform-0.5-Keycloak-Metabase.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md diff --git a/content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md b/content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md new file mode 100644 index 00000000..430cf5f9 --- /dev/null +++ b/content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md @@ -0,0 +1,20 @@ +--- +title: Deploy Keycloak and Metabase on Clever Cloud with Terraform (or OpenTofu) +date: 2024-12-24 +tags: + - addons + - terraform +authors: + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 + - name: Rémi Collignon-Ducret + link: https://github.com/miton18 + image: https://github.com/miton18.png?size=40 +description: Your favorite services as code +excludeSearch: true +--- + +You can now deploy [Keycloak](../doc/addons/keycloak) and [Metabase](../doc/addons/metabase) add-ons using our Terraform provider, compatible with OpenTofu. + +* Learn more about [our Terraform provider](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs) 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 13/36] 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 14/36] 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 15/36] 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 16/36] 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 17/36] 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 18/36] 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 19/36] 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] From 94df15d327aacae508579704ce47681c4d8f1a39 Mon Sep 17 00:00:00 2001 From: David Legrand <1110600+davlgd@users.noreply.github.com> Date: Thu, 16 Jan 2025 15:50:25 +0100 Subject: [PATCH 20/36] chore: changelog reorg (#492) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR This PR reorg `changelog` folder by year of publication for better long term management, with: - Remove year from file name as it's now in URL path - Aliases in every file to handle old URL redirect - Fix for bad links (from domain change) Replace any `changelog/year/filename.md` by `changelog/year-filename.md` in the Preview app, it should work. Co-authored-by: Clément Nivolle --- .../11-10-healthcheck-for-java.md} | 4 +++- .../11-29-api-update.md} | 4 +++- .../12-13-cellar-migration-tool-update.md} | 2 ++ .../12-15-sozu-0.15.18.md} | 2 ++ .../12-18-java-21-default.md} | 4 +++- .../12-18-new-par-ip-console.md} | 4 +++- .../12-18-php-8-default.md} | 4 +++- .../12-19-console-web-components-v12.md} | 4 +++- .../12-22-sozu-wider usage.md} | 4 +++- .../2024-06-10-mongo-db-terraform.md | 22 ----------------- .../2024-08-26-java-containers-update.md | 20 ---------------- .../01-02-pulsar-update.md} | 2 ++ .../01-10-documentation-changelog.md} | 4 +++- .../01-11-redis-7.2.4.md} | 2 ++ .../01-15-go-sdk-v0.0.8.md} | 2 ++ .../01-22-matomo-5.0.1.md} | 4 +++- .../01-24-ruby-3.3.0.md} | 6 +++-- .../01-25-clever-tools-3.1.0.md} | 4 +++- .../01-30-js-client-8.0.3.md} | 2 ++ .../02-02-images-update.md} | 4 +++- .../02-07-clever-tools-3.2.0.md} | 4 +++- .../02-08-sozu-0.15.19.md} | 2 ++ .../02-12-new-grahds-region.md} | 2 ++ .../02-16-clever-tools-3.4.0.md} | 4 +++- .../02-22-postgresql-pgvector-support.md} | 4 +++- .../02-26-healthcheck-for-everyone.md} | 4 +++- .../02-26-mtl-iplb-update.md} | 8 ++++--- .../02-27-images-update-part2.md} | 10 ++++---- .../02-27-js-client-8.2.0.md} | 4 +++- .../03-07-env-vars-app-creation-api.md} | 4 +++- .../03-07-web-components-v13.md} | 4 +++- .../03-11-console-components-update.md} | 4 +++- .../03-12-oauth-token-expiration.md} | 4 +++- .../03-20-pulsar-3.2.1-update.md} | 4 +++- .../04-04-CVE-2024-3094.md} | 10 ++++---- .../04-11-clever-tools-3.5.2.md} | 8 ++++--- .../04-15-new-logs-interface-public-beta.md} | 4 +++- .../04-16-clever-tools-3.6.0.md} | 2 ++ .../04-24-php-deprecate-warning.md} | 2 ++ .../04-25-images-update.md} | 4 +++- .../04-26-new-images-stack.md} | 4 +++- .../05-28-tasks-in-console.md} | 6 +++-- .../05-30-php-8.3-java-22.md} | 4 +++- .../06-07-sozu-1.0.2.md} | 2 ++ .../2024/06-10-mongo-db-terraform.md | 24 +++++++++++++++++++ .../06-11-clever-tools-3.7.0.md} | 2 ++ .../06-11-materia-kv-public-alpha.md} | 8 ++++--- .../06-21-better-new-logs.md} | 2 ++ .../06-28-new-ip-list-paris.md} | 4 +++- .../07-01-matomo-5.1.0.md} | 2 ++ .../07-02-clever-tools-3.8.0.md} | 2 ++ .../07-03-docker-terraform.md} | 4 +++- .../07-04-apache-php-image-update.md} | 4 +++- .../07-05-go-haskell-ruby-update.md} | 2 ++ .../07-06-mysql-pgsql-update.md} | 2 ++ .../07-10-CVE-2024-6387.md} | 2 ++ .../07-11-pulsar-3.3.0-update.md} | 2 ++ .../07-12-accountant-access-console-fix.md} | 2 ++ .../07-17-keycloak-public-release.md} | 6 +++-- .../07-17-new-logs-default.md} | 4 +++- .../07-18-elastic-8.10.2-jenkins-2.452.3.md} | 2 ++ .../07-18-github-action-review-apps.md} | 4 +++- .../07-26-domains-console-update.md} | 4 +++- .../07-30-github-action-1.1.md} | 4 +++- .../08-01-lagging-server-crate.md} | 2 ++ .../08-09-python-3.12-update.md} | 2 ++ .../2024/08-26-java-containers-update.md | 22 +++++++++++++++++ .../08-30-deploy-url-mtl.md} | 2 ++ .../09-03-gitlab-components-review-apps.md} | 4 +++- .../09-12-clever-tools-3.8.3.md} | 2 ++ .../09-12-js-client-9.0.0.md} | 2 ++ .../10-01-materia-kv-ttl-layer-update.md} | 6 +++-- .../10-01-python-image-changes.md} | 8 ++++--- .../10-04-keycloak-beta-release.md} | 8 ++++--- .../10-07-CVE-2024-47561.md} | 2 ++ .../10-17-sozu-1.0.5.md} | 4 +++- .../10-18-azimutt-available.md} | 4 +++- .../10-21-clever-tools-3.9.0.md} | 6 +++-- .../10-28-metabase-available.md} | 6 +++-- .../10-28-pulsar-4.0.0-update.md} | 2 ++ .../11-08-erlang-rust-update.md} | 4 +++- .../11-08-mysql-mysql-8.4.0.md} | 4 +++- .../11-09-java-update.md} | 2 ++ .../11-13-metabase-51-version-warning.md} | 4 +++- .../11-18-keycloak-26.md} | 4 +++- .../11-21-eol-warnings-console.md} | 4 +++- .../11-26-keycloak-26.0.06.md} | 4 +++- .../11-27-clever-tools-3.10.md} | 4 +++- .../11-27-elastic-plugins-support.md} | 6 +++-- .../11-28-kv-explorer-available.md} | 8 ++++--- .../12-04-otoroshi-available.md} | 6 +++-- .../12-12-python-3.13-update.md} | 4 +++- .../12-18-clever-tools-3.11.md} | 2 ++ .../12-24-terraform-0.5-Keycloak-Metabase.md} | 4 +++- .../01-06-sozu-1.0.6.md} | 6 +++-- 95 files changed, 316 insertions(+), 130 deletions(-) rename content/changelog/{2023-11-10-healthcheck-for-java.md => 2023/11-10-healthcheck-for-java.md} (86%) rename content/changelog/{2023-11-29-api-update.md => 2023/11-29-api-update.md} (91%) rename content/changelog/{2023-12-13-cellar-migration-tool-update.md => 2023/12-13-cellar-migration-tool-update.md} (92%) rename content/changelog/{2023-12-15-sozu-0.15.18.md => 2023/12-15-sozu-0.15.18.md} (93%) rename content/changelog/{2023-12-18-java-21-default.md => 2023/12-18-java-21-default.md} (82%) rename content/changelog/{2023-12-18-new-par-ip-console.md => 2023/12-18-new-par-ip-console.md} (75%) rename content/changelog/{2023-12-18-php-8-default.md => 2023/12-18-php-8-default.md} (81%) rename content/changelog/{2023-12-19-console-web-components-v12.md => 2023/12-19-console-web-components-v12.md} (83%) rename content/changelog/{2023-12-22-sozu-wider usage.md => 2023/12-22-sozu-wider usage.md} (86%) delete mode 100644 content/changelog/2024-06-10-mongo-db-terraform.md delete mode 100644 content/changelog/2024-08-26-java-containers-update.md rename content/changelog/{2024-01-02-pulsar-update.md => 2024/01-02-pulsar-update.md} (91%) rename content/changelog/{2024-01-10-documentation-changelog.md => 2024/01-10-documentation-changelog.md} (64%) rename content/changelog/{2024-01-11-redis-7.2.4.md => 2024/01-11-redis-7.2.4.md} (95%) rename content/changelog/{2024-01-15-go-sdk-v0.0.8.md => 2024/01-15-go-sdk-v0.0.8.md} (94%) rename content/changelog/{2024-01-22-matomo-5.0.1.md => 2024/01-22-matomo-5.0.1.md} (93%) rename content/changelog/{2024-01-24-ruby-3.3.0.md => 2024/01-24-ruby-3.3.0.md} (84%) rename content/changelog/{2024-01-25-clever-tools-3.1.0.md => 2024/01-25-clever-tools-3.1.0.md} (96%) rename content/changelog/{2024-01-30-js-client-8.0.3.md => 2024/01-30-js-client-8.0.3.md} (95%) rename content/changelog/{2024-02-02-images-update.md => 2024/02-02-images-update.md} (86%) rename content/changelog/{2024-02-07-clever-tools-3.2.0.md => 2024/02-07-clever-tools-3.2.0.md} (78%) rename content/changelog/{2024-02-08-sozu-0.15.19.md => 2024/02-08-sozu-0.15.19.md} (96%) rename content/changelog/{2024-02-12-new-grahds-region.md => 2024/02-12-new-grahds-region.md} (95%) rename content/changelog/{2024-02-16-clever-tools-3.4.0.md => 2024/02-16-clever-tools-3.4.0.md} (77%) rename content/changelog/{2024-02-22-postgresql-pgvector-support.md => 2024/02-22-postgresql-pgvector-support.md} (79%) rename content/changelog/{2024-02-26-healthcheck-for-everyone.md => 2024/02-26-healthcheck-for-everyone.md} (85%) rename content/changelog/{2024-02-26-mtl-iplb-update.md => 2024/02-26-mtl-iplb-update.md} (77%) rename content/changelog/{2024-02-27-images-update-part2.md => 2024/02-27-images-update-part2.md} (52%) rename content/changelog/{2024-02-27-js-client-8.2.0.md => 2024/02-27-js-client-8.2.0.md} (52%) rename content/changelog/{2024-03-07-env-vars-app-creation-api.md => 2024/03-07-env-vars-app-creation-api.md} (93%) rename content/changelog/{2024-03-07-web-components-v13.md => 2024/03-07-web-components-v13.md} (95%) rename content/changelog/{2024-03-11-console-components-update.md => 2024/03-11-console-components-update.md} (67%) rename content/changelog/{2024-03-12-oauth-token-expiration.md => 2024/03-12-oauth-token-expiration.md} (94%) rename content/changelog/{2024-03-20-pulsar-3.2.1-update.md => 2024/03-20-pulsar-3.2.1-update.md} (78%) rename content/changelog/{2024-04-04-CVE-2024-3094.md => 2024/04-04-CVE-2024-3094.md} (66%) rename content/changelog/{2024-04-11-clever-tools-3.5.2.md => 2024/04-11-clever-tools-3.5.2.md} (86%) rename content/changelog/{2024-04-15-new-logs-interface-public-beta.md => 2024/04-15-new-logs-interface-public-beta.md} (95%) rename content/changelog/{2024-04-16-clever-tools-3.6.0.md => 2024/04-16-clever-tools-3.6.0.md} (94%) rename content/changelog/{2024-04-24-php-deprecate-warning.md => 2024/04-24-php-deprecate-warning.md} (96%) rename content/changelog/{2024-04-25-images-update.md => 2024/04-25-images-update.md} (88%) rename content/changelog/{2024-04-26-new-images-stack.md => 2024/04-26-new-images-stack.md} (78%) rename content/changelog/{2024-05-28-tasks-in-console.md => 2024/05-28-tasks-in-console.md} (56%) rename content/changelog/{2024-05-30-php-8.3-java-22.md => 2024/05-30-php-8.3-java-22.md} (87%) rename content/changelog/{2024-06-07-sozu-1.0.2.md => 2024/06-07-sozu-1.0.2.md} (97%) create mode 100644 content/changelog/2024/06-10-mongo-db-terraform.md rename content/changelog/{2024-06-11-clever-tools-3.7.0.md => 2024/06-11-clever-tools-3.7.0.md} (94%) rename content/changelog/{2024-06-11-materia-kv-public-alpha.md => 2024/06-11-materia-kv-public-alpha.md} (58%) rename content/changelog/{2024-06-21-better-new-logs.md => 2024/06-21-better-new-logs.md} (97%) rename content/changelog/{2024-06-28-new-ip-list-paris.md => 2024/06-28-new-ip-list-paris.md} (81%) rename content/changelog/{2024-07-01-matomo-5.1.0.md => 2024/07-01-matomo-5.1.0.md} (95%) rename content/changelog/{2024-07-02-clever-tools-3.8.0.md => 2024/07-02-clever-tools-3.8.0.md} (98%) rename content/changelog/{2024-07-03-docker-terraform.md => 2024/07-03-docker-terraform.md} (91%) rename content/changelog/{2024-07-04-apache-php-image-update.md => 2024/07-04-apache-php-image-update.md} (88%) rename content/changelog/{2024-07-05-go-haskell-ruby-update.md => 2024/07-05-go-haskell-ruby-update.md} (89%) rename content/changelog/{2024-07-06-mysql-pgsql-update.md => 2024/07-06-mysql-pgsql-update.md} (92%) rename content/changelog/{2024-07-10-CVE-2024-6387.md => 2024/07-10-CVE-2024-6387.md} (97%) rename content/changelog/{2024-07-11-pulsar-3.3.0-update.md => 2024/07-11-pulsar-3.3.0-update.md} (91%) rename content/changelog/{2024-07-12-accountant-access-console-fix.md => 2024/07-12-accountant-access-console-fix.md} (89%) rename content/changelog/{2024-07-17-keycloak-public-release.md => 2024/07-17-keycloak-public-release.md} (55%) rename content/changelog/{2024-07-17-new-logs-default.md => 2024/07-17-new-logs-default.md} (54%) rename content/changelog/{2024-07-18-elastic-8.10.2-jenkins-2.452.3.md => 2024/07-18-elastic-8.10.2-jenkins-2.452.3.md} (90%) rename content/changelog/{2024-07-18-github-action-review-apps.md => 2024/07-18-github-action-review-apps.md} (88%) rename content/changelog/{2024-07-26-domains-console-update.md => 2024/07-26-domains-console-update.md} (87%) rename content/changelog/{2024-07-30-github-action-1.1.md => 2024/07-30-github-action-1.1.md} (83%) rename content/changelog/{2024-08-01-lagging-server-crate.md => 2024/08-01-lagging-server-crate.md} (93%) rename content/changelog/{2024-08-09-python-3.12-update.md => 2024/08-09-python-3.12-update.md} (92%) create mode 100644 content/changelog/2024/08-26-java-containers-update.md rename content/changelog/{2024-08-30-deploy-url-mtl.md => 2024/08-30-deploy-url-mtl.md} (96%) rename content/changelog/{2024-09-03-gitlab-components-review-apps.md => 2024/09-03-gitlab-components-review-apps.md} (86%) rename content/changelog/{2024-09-12-clever-tools-3.8.3.md => 2024/09-12-clever-tools-3.8.3.md} (95%) rename content/changelog/{2024-09-12-js-client-9.0.0.md => 2024/09-12-js-client-9.0.0.md} (93%) rename content/changelog/{2024-10-01-materia-kv-ttl-layer-update.md => 2024/10-01-materia-kv-ttl-layer-update.md} (58%) rename content/changelog/{2024-10-01-python-image-changes.md => 2024/10-01-python-image-changes.md} (84%) rename content/changelog/{2024-10-04-keycloak-beta-release.md => 2024/10-04-keycloak-beta-release.md} (62%) rename content/changelog/{2024-10-07-CVE-2024-47561.md => 2024/10-07-CVE-2024-47561.md} (95%) rename content/changelog/{2024-10-17-sozu-1.0.5.md => 2024/10-17-sozu-1.0.5.md} (84%) rename content/changelog/{2024-10-18-azimutt-available.md => 2024/10-18-azimutt-available.md} (83%) rename content/changelog/{2024-10-21-clever-tools-3.9.0.md => 2024/10-21-clever-tools-3.9.0.md} (79%) rename content/changelog/{2024-10-28-metabase-available.md => 2024/10-28-metabase-available.md} (83%) rename content/changelog/{2024-10-28-pulsar-4.0.0-update.md => 2024/10-28-pulsar-4.0.0-update.md} (92%) rename content/changelog/{2024-11-08-erlang-rust-update.md => 2024/11-08-erlang-rust-update.md} (84%) rename content/changelog/{2024-11-08-mysql-mysql-8.4.0.md => 2024/11-08-mysql-mysql-8.4.0.md} (88%) rename content/changelog/{2024-11-09-java-update.md => 2024/11-09-java-update.md} (94%) rename content/changelog/{2024-11-13-metabase-51-version-warning.md => 2024/11-13-metabase-51-version-warning.md} (85%) rename content/changelog/{2024-11-18-keycloak-26.md => 2024/11-18-keycloak-26.md} (87%) rename content/changelog/{2024-11-21-eol-warnings-console.md => 2024/11-21-eol-warnings-console.md} (61%) rename content/changelog/{2024-11-26-keycloak-26.0.06.md => 2024/11-26-keycloak-26.0.06.md} (88%) rename content/changelog/{2024-11-27-clever-tools-3.10.md => 2024/11-27-clever-tools-3.10.md} (76%) rename content/changelog/{2024-11-27-elastic-plugins-support.md => 2024/11-27-elastic-plugins-support.md} (60%) rename content/changelog/{2024-11-28-kv-explorer-available.md => 2024/11-28-kv-explorer-available.md} (87%) rename content/changelog/{2024-12-04-otoroshi-available.md => 2024/12-04-otoroshi-available.md} (90%) rename content/changelog/{2024-12-12-python-3.13-update.md => 2024/12-12-python-3.13-update.md} (67%) rename content/changelog/{2024-12-18-clever-tools-3.11.md => 2024/12-18-clever-tools-3.11.md} (96%) rename content/changelog/{2024-12-24-terraform-0.5-Keycloak-Metabase.md => 2024/12-24-terraform-0.5-Keycloak-Metabase.md} (68%) rename content/changelog/{2025-01-06-sozu-1.0.6.md => 2025/01-06-sozu-1.0.6.md} (65%) diff --git a/content/changelog/2023-11-10-healthcheck-for-java.md b/content/changelog/2023/11-10-healthcheck-for-java.md similarity index 86% rename from content/changelog/2023-11-10-healthcheck-for-java.md rename to content/changelog/2023/11-10-healthcheck-for-java.md index 47224dfc..c0484cb5 100644 --- a/content/changelog/2023-11-10-healthcheck-for-java.md +++ b/content/changelog/2023/11-10-healthcheck-for-java.md @@ -9,6 +9,8 @@ authors: link: https://github.com/judu image: https://github.com/judu.png?size=40 description: Your java applications can now be deployed with one or multiple custom healtchecks +aliases: +- /changelog/2023-11-10-healthcheck-for-java excludeSearch: true --- @@ -19,4 +21,4 @@ You can now define the paths that the orchestrator will call to validate a deplo Currently, the orchestrator only checks whether the application is listening to TCP port `8080`. It does not always mean that the application has started correctly. -- Read the documentation about [Deployment healthcheck path](../../doc/develop/healthcheck/) 📖 +- Read the documentation about [Deployment healthcheck path](/developers/doc/develop/healthcheck/) 📖 diff --git a/content/changelog/2023-11-29-api-update.md b/content/changelog/2023/11-29-api-update.md similarity index 91% rename from content/changelog/2023-11-29-api-update.md rename to content/changelog/2023/11-29-api-update.md index d7fa0b35..349c6184 100644 --- a/content/changelog/2023-11-29-api-update.md +++ b/content/changelog/2023/11-29-api-update.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: You can now check if an application is a task via the Clever Cloud API +aliases: +- /changelog/2023-11-29-api-update excludeSearch: true --- For years, you can deploy applications on Clever Cloud as a `Task` with the API or more recently the `CC_TASK=true` environment variable. As this feature will be widely available and used, the API has been updated to return such a state in the `instance.lifetime` object: @@ -40,4 +42,4 @@ For years, you can deploy applications on Clever Cloud as a `Task` with the API } ``` -You can read the full APIv2 documentation [here]({{< ref "/api/v2" >}} "OpenAPI"). +You can read the full APIv2 documentation [here](/developers/api/v2). diff --git a/content/changelog/2023-12-13-cellar-migration-tool-update.md b/content/changelog/2023/12-13-cellar-migration-tool-update.md similarity index 92% rename from content/changelog/2023-12-13-cellar-migration-tool-update.md rename to content/changelog/2023/12-13-cellar-migration-tool-update.md index f797b1d3..34880b75 100644 --- a/content/changelog/2023-12-13-cellar-migration-tool-update.md +++ b/content/changelog/2023/12-13-cellar-migration-tool-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/BlackYoup image: https://github.com/BlackYoup.png?size=40 description: Keep-alive support and better behavior during network errors +aliases: +- /changelog/2023-12-13-cellar-migration-tool-update excludeSearch: true --- diff --git a/content/changelog/2023-12-15-sozu-0.15.18.md b/content/changelog/2023/12-15-sozu-0.15.18.md similarity index 93% rename from content/changelog/2023-12-15-sozu-0.15.18.md rename to content/changelog/2023/12-15-sozu-0.15.18.md index 56c00b60..3053f6ab 100644 --- a/content/changelog/2023-12-15-sozu-0.15.18.md +++ b/content/changelog/2023/12-15-sozu-0.15.18.md @@ -8,6 +8,8 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: Better, faster, stronger +aliases: +- /changelog/2023-12-15-sozu-0.15.18 excludeSearch: true --- diff --git a/content/changelog/2023-12-18-java-21-default.md b/content/changelog/2023/12-18-java-21-default.md similarity index 82% rename from content/changelog/2023-12-18-java-21-default.md rename to content/changelog/2023/12-18-java-21-default.md index 61d83c14..72d4b3d8 100644 --- a/content/changelog/2023-12-18-java-21-default.md +++ b/content/changelog/2023/12-18-java-21-default.md @@ -9,9 +9,11 @@ authors: link: https://github.com/judu image: https://github.com/judu.png?size=40 description: Deploy Java applications on Clever Cloud with version 21 as default +aliases: +- /changelog/2023-12-18-java-21-default excludeSearch: true --- Java version 21 is available on Clever Cloud for several weeks, but is now deployed as the default version for new applications. Of course, you can set the one of your choice between those available through `CC_JAVA_VERSION` environment variable. -- Read our documentation [about Java]({{< ref "/doc/applications/java" >}} "Java Doc") +- Read our documentation [about Java](/developers/doc/applications/java) diff --git a/content/changelog/2023-12-18-new-par-ip-console.md b/content/changelog/2023/12-18-new-par-ip-console.md similarity index 75% rename from content/changelog/2023-12-18-new-par-ip-console.md rename to content/changelog/2023/12-18-new-par-ip-console.md index 1406ef92..3d33dacf 100644 --- a/content/changelog/2023-12-18-new-par-ip-console.md +++ b/content/changelog/2023/12-18-new-par-ip-console.md @@ -9,9 +9,11 @@ authors: link: https://github.com/GuillaumeASSIER image: https://github.com/GuillaumeASSIER.png?size=40 description: New IP list for DNS of Clever Cloud PAR region in the Console +aliases: +- /changelog/2023-12-18-new-par-ip-console excludeSearch: true --- Setup of our new infrastructure in Paris implies addition of new IP which can be used for DNS entries. They are now detailed in the **Domain Names** section of your applications in the [Console](https://console.clever-cloud.com). -{{< figure src="/images/changelog/console-new-ip-par.webp" caption="The new IP of the PAR region in the Console" width="800px">}} +![New IP entries in Clever Cloud Console](/images/changelog/console-new-ip-par.webp "The new IP of the PAR region in the Console") diff --git a/content/changelog/2023-12-18-php-8-default.md b/content/changelog/2023/12-18-php-8-default.md similarity index 81% rename from content/changelog/2023-12-18-php-8-default.md rename to content/changelog/2023/12-18-php-8-default.md index e3822b2d..75b5077d 100644 --- a/content/changelog/2023-12-18-php-8-default.md +++ b/content/changelog/2023/12-18-php-8-default.md @@ -12,9 +12,11 @@ authors: link: https://github.com/judu image: https://github.com/judu.png?size=40 description: Deploy PHP applications on Clever Cloud with latest version 8.x as default +aliases: +- /changelog/2023-12-18-php-8-default excludeSearch: true --- PHP 8.x is available for years on Clever Cloud, but is now deployed as the default version for new applications. Of course, you can set the one of your choice between those available through `CC_PHP_VERSION` environment variable. -- Read our documentation [about PHP version]({{< ref "/doc/applications/php/#choose-your-php-version" >}} "Choose PHP version" ) +- Read our documentation [about PHP version](/developers/doc/applications/php/#choose-your-php-version) diff --git a/content/changelog/2023-12-19-console-web-components-v12.md b/content/changelog/2023/12-19-console-web-components-v12.md similarity index 83% rename from content/changelog/2023-12-19-console-web-components-v12.md rename to content/changelog/2023/12-19-console-web-components-v12.md index 5286f600..c153490e 100644 --- a/content/changelog/2023-12-19-console-web-components-v12.md +++ b/content/changelog/2023/12-19-console-web-components-v12.md @@ -9,6 +9,8 @@ authors: link: https://github.com/pdesoyres-cc image: https://github.com/pdesoyres-cc.png?size=40 description: Console update with new icons for the documentation +aliases: +- /changelog/2023-12-19-console-web-components-v12 excludeSearch: true --- @@ -18,4 +20,4 @@ Among other changes under the hood, our [Console](https://console.clever-cloud.c Links to the new documentation are now available in the Console. They're more precise depending on the `variant` (e.g. PHP/Static), use small icons to boost visibility and are now effective for applications and add-ons: -{{< figure src="/developers/images/changelog/doc-link-console.webp" caption="The new documentation link in the Console" >}} +![The new documentation link in the Console](/images/changelog/doc-link-console.webp "The new documentation link in the Console") diff --git a/content/changelog/2023-12-22-sozu-wider usage.md b/content/changelog/2023/12-22-sozu-wider usage.md similarity index 86% rename from content/changelog/2023-12-22-sozu-wider usage.md rename to content/changelog/2023/12-22-sozu-wider usage.md index e1c27288..a26fd018 100644 --- a/content/changelog/2023-12-22-sozu-wider usage.md +++ b/content/changelog/2023/12-22-sozu-wider usage.md @@ -1,5 +1,5 @@ --- -title: Wider Sōzu usage +title: Wider Sōzu usage date: 2023-12-22 tags: - sozu @@ -8,6 +8,8 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: Sōzu gets better and can be used on more services on Clever Cloud +aliases: +- /changelog/2023-12-22-sozu-wider usage excludeSearch: true --- diff --git a/content/changelog/2024-06-10-mongo-db-terraform.md b/content/changelog/2024-06-10-mongo-db-terraform.md deleted file mode 100644 index b578e583..00000000 --- a/content/changelog/2024-06-10-mongo-db-terraform.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: Deploy MongoDB add-ons with our Terraform provider -date: 2024-06-10 -tags: - - mongodb - - terraform -authors: - - name: David Legrand - link: https://github.com/davlgd - image: https://github.com/davlgd.png?size=40 - - name: Mathieu Barcelo - link: https://github.com/TheCrabe - image: https://github.com/TheCrabe.png?size=40 -description: -excludeSearch: true ---- - -If you can deploy on Clever Cloud through our [Console](https://console.clever-cloud.com), our CLI ([Clever Tools](https://github.com/CleverCloud/clever-tools)), or our [API](/api/), you can also use Terraform and compatible tools such as [OpenTofu](https://opentofu.org/). We maintain a provider that allows you to manage your resources as code, from applications to add-ons (object storage, databases, etc.). - -We've recently added support for Python and [Materia KV](../../doc/addons/materia-kv/). It's MongoDB's turn [to be available](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs/resources/mongodb). You can now create such an add-on, choose its plan, region and get the credentials to connect to it. - -* Learn more about [our Terraform provider](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs) diff --git a/content/changelog/2024-08-26-java-containers-update.md b/content/changelog/2024-08-26-java-containers-update.md deleted file mode 100644 index 52f83284..00000000 --- a/content/changelog/2024-08-26-java-containers-update.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -title: "Java servlet containers cleanup, Wildfly upgrade" -date: 2024-08-26 -tags: - - applications - - java -authors: - - name: Julien Durillon - link: https://github.com/judu - image: https://github.com/judu.png?size=40 - - name: David Legrand - link: https://github.com/davlgd - image: https://github.com/davlgd.png?size=40 -description: Wildfly 27.0.1 and 33.0.1 are now supported -excludeSearch: true ---- - -As part of our images enhancement process, we've tidied up the [list of supported servlet containers](../../doc/applications/java/java-war/#available-containers). Those that are not longer used by our customers are removed from the Java image. If you need a container which is not listed [here](../../doc/applications/java/java-war/#available-containers) or a specific version, please contact [our support team](https://console.clever-cloud.com/ticket-center-choice). This release also includes a [Wildfly](https://github.com/wildfly/wildfly) upgrade. Versions 27.0.1 and 33.0.1 are now available. - -- Learn more about [Java on Clever Cloud](../../doc/applications/java/) diff --git a/content/changelog/2024-01-02-pulsar-update.md b/content/changelog/2024/01-02-pulsar-update.md similarity index 91% rename from content/changelog/2024-01-02-pulsar-update.md rename to content/changelog/2024/01-02-pulsar-update.md index 883e7b02..3b8b2808 100644 --- a/content/changelog/2024-01-02-pulsar-update.md +++ b/content/changelog/2024/01-02-pulsar-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/kannarfr image: https://github.com/kannarfr.png?size=40 description: The Clever Cloud Pulsar stack has been updated and is more stable +aliases: +- /changelog/2024-01-02-pulsar-update excludeSearch: true --- diff --git a/content/changelog/2024-01-10-documentation-changelog.md b/content/changelog/2024/01-10-documentation-changelog.md similarity index 64% rename from content/changelog/2024-01-10-documentation-changelog.md rename to content/changelog/2024/01-10-documentation-changelog.md index 685bf66c..a0c058da 100644 --- a/content/changelog/2024-01-10-documentation-changelog.md +++ b/content/changelog/2024/01-10-documentation-changelog.md @@ -15,7 +15,9 @@ authors: link: https://github.com/cnivolle image: https://github.com/cnivolle.png?size=40 description: You can now check Clever Cloud's evolutions in our new changelog, RSS feed included +aliases: +- /changelog/2024-01-10-documentation-changelog excludeSearch: true --- -A changelog has been [added](/changelog) to our [Developer Center](/). It will be regularly updated by the Clever Cloud teams to give you an overview of our new features, but also changes made and deprecations planned on the platform. +A changelog has been [added](/developers/changelog) to our [Developer Center](/developers). It will be regularly updated by the Clever Cloud teams to give you an overview of our new features, but also changes made and deprecations planned on the platform. diff --git a/content/changelog/2024-01-11-redis-7.2.4.md b/content/changelog/2024/01-11-redis-7.2.4.md similarity index 95% rename from content/changelog/2024-01-11-redis-7.2.4.md rename to content/changelog/2024/01-11-redis-7.2.4.md index 6e93418e..6c688ef3 100644 --- a/content/changelog/2024-01-11-redis-7.2.4.md +++ b/content/changelog/2024/01-11-redis-7.2.4.md @@ -9,6 +9,8 @@ authors: link: https://github.com/aurrelhebert image: https://github.com/aurrelhebert.png?size=40 description: Use Redis 7.2 in its latest release on Clever Cloud +aliases: +- /changelog/2024-01-11-redis-7.2.4 excludeSearch: true --- diff --git a/content/changelog/2024-01-15-go-sdk-v0.0.8.md b/content/changelog/2024/01-15-go-sdk-v0.0.8.md similarity index 94% rename from content/changelog/2024-01-15-go-sdk-v0.0.8.md rename to content/changelog/2024/01-15-go-sdk-v0.0.8.md index 80d18e09..5e5fef15 100644 --- a/content/changelog/2024-01-15-go-sdk-v0.0.8.md +++ b/content/changelog/2024/01-15-go-sdk-v0.0.8.md @@ -13,6 +13,8 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: The Clever Cloud Go Client has been updated to v0.0.8 +aliases: +- /changelog/2024-01-15-go-sdk-v0.0.8 excludeSearch: true --- diff --git a/content/changelog/2024-01-22-matomo-5.0.1.md b/content/changelog/2024/01-22-matomo-5.0.1.md similarity index 93% rename from content/changelog/2024-01-22-matomo-5.0.1.md rename to content/changelog/2024/01-22-matomo-5.0.1.md index 02d09587..2c486610 100644 --- a/content/changelog/2024-01-22-matomo-5.0.1.md +++ b/content/changelog/2024/01-22-matomo-5.0.1.md @@ -12,10 +12,12 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: You can now deploy Matomo 5.0.1 on Clever Cloud +aliases: +- /changelog/2024-01-22-matomo-5.0.1 excludeSearch: true --- -[Matomo](https://matomo.org/) 5.0 was released mid-December, version 5.0.1 is now available. Since then, we've worked on the support of this new branch on Clever Cloud. It's done! You can deploy this latest version right now from our [Console](https://console.clever-cloud.com) or [Clever Tools](https://github.com/CleverCloud/clever-tools). +[Matomo](https://matomo.org/) 5.0 was released mid-December, version 5.0.1 is now available. Since then, we've worked on the support of this new branch on Clever Cloud. It's done! You can deploy this latest version right now from our [Console](https://console.clever-cloud.com) or [Clever Tools](https://github.com/CleverCloud/clever-tools). Existing customers add-ons are already up-to-date. - [Learn more about Matomo 5.0](https://matomo.org/changelog/matomo-5-0-0/) diff --git a/content/changelog/2024-01-24-ruby-3.3.0.md b/content/changelog/2024/01-24-ruby-3.3.0.md similarity index 84% rename from content/changelog/2024-01-24-ruby-3.3.0.md rename to content/changelog/2024/01-24-ruby-3.3.0.md index f40db22e..f70867e8 100644 --- a/content/changelog/2024-01-24-ruby-3.3.0.md +++ b/content/changelog/2024/01-24-ruby-3.3.0.md @@ -9,13 +9,15 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Use Ruby 3.3.0 in your Ruby on Rails applications on Clever Cloud +aliases: +- /changelog/2024-01-24-ruby-3.3.0 excludeSearch: true --- -You can now choose the `3.3.0` release of Ruby when you deploy Ruby on Rails applications on Clever Cloud. It can be set either through your `Gemfile` or the `CC_RUBY_VERSION` [environment variable](../../doc/reference/reference-environment-variables/#ruby). +You can now choose the `3.3.0` release of Ruby when you deploy Ruby on Rails applications on Clever Cloud. It can be set either through your `Gemfile` or the `CC_RUBY_VERSION` [environment variable](/developers/doc/reference/reference-environment-variables/#ruby). * Learn more about Ruby 3.3.0 release [here](https://www.ruby-lang.org/en/news/2023/12/25/ruby-3-3-0-released/) {{< callout type="info" >}} - If you use Node.js on this image, be aware that default version is now 20.11.0 (LTS). If you need another release to deploy your application, set the `CC_NODE_VERSION` [environment variable](../../doc/develop/env-variables/). + If you use Node.js on this image, be aware that default version is now 20.11.0 (LTS). If you need another release to deploy your application, set the `CC_NODE_VERSION` [environment variable](/developers/doc/develop/env-variables/). {{< /callout >}} diff --git a/content/changelog/2024-01-25-clever-tools-3.1.0.md b/content/changelog/2024/01-25-clever-tools-3.1.0.md similarity index 96% rename from content/changelog/2024-01-25-clever-tools-3.1.0.md rename to content/changelog/2024/01-25-clever-tools-3.1.0.md index 6f9ece3c..45c103a9 100644 --- a/content/changelog/2024-01-25-clever-tools-3.1.0.md +++ b/content/changelog/2024/01-25-clever-tools-3.1.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Be prepared for a new wave of Clever Tools starting this release 3.1.0! +aliases: +- /changelog/2024-01-25-clever-tools-3.1.0 excludeSearch: true --- @@ -20,7 +22,7 @@ For several months, we were preparing our CLI, [Clever Tools](https://github.com - No more beta channel: you'll be able to test new features easier - Better process, quicker tests, more releases! -If 3.0.x branch brought new log stack (faster, longer, order), you now get updated runtimes and zones lists [in autocomplete](https://github.com/CleverCloud/clever-tools?tab=readme-ov-file#enabling-autocompletion), details about application owner during deployment, `git+ssh` URL in new linked/created applications informations. +If 3.0.x branch brought new log stack (faster, longer, order), you now get updated runtimes and zones lists [in autocomplete](https://github.com/CleverCloud/clever-tools?tab=readme-ov-file#enabling-autocompletion), details about application owner during deployment, `git+ssh` URL in new linked/created applications information. `clever deploy` can now be used with the `--same-commit-policy` or `-p` flag to set policy to apply when the local commit is the same as the remote one: `error`, `ignore`, `restart` or `rebuild` (default: `error`). diff --git a/content/changelog/2024-01-30-js-client-8.0.3.md b/content/changelog/2024/01-30-js-client-8.0.3.md similarity index 95% rename from content/changelog/2024-01-30-js-client-8.0.3.md rename to content/changelog/2024/01-30-js-client-8.0.3.md index 262c82df..8dd34cb4 100644 --- a/content/changelog/2024-01-30-js-client-8.0.3.md +++ b/content/changelog/2024/01-30-js-client-8.0.3.md @@ -13,6 +13,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: The Clever Cloud JS Client has been updated to version 8.0.3 +aliases: +- /changelog/2024-01-30-js-client-8.0.3 excludeSearch: true --- diff --git a/content/changelog/2024-02-02-images-update.md b/content/changelog/2024/02-02-images-update.md similarity index 86% rename from content/changelog/2024-02-02-images-update.md rename to content/changelog/2024/02-02-images-update.md index baf9112d..91746ebf 100644 --- a/content/changelog/2024-02-02-images-update.md +++ b/content/changelog/2024/02-02-images-update.md @@ -10,12 +10,14 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: An in-depth work leading to faster updates +aliases: +- /changelog/2024-02-02-images-update excludeSearch: true --- Over the past few months, we've overhauled the way we build our applications and add-ons images from tooling to included binaries. We'll deliver soon the first public milestone of this project, which will leads us to more frequent releases. -In the meantime, we've updated Docker, Erlang, Go, Haskell, Ruby and Rust images into production with no impact for our users. They include security patches and now use Linux kernel 6.7.1, OpenSSL 3.2.1 and Node.js 20.11.0 by default. For the latter, you can change it in the updated images via the `CC_NODE_VERSION` [environment variable](../../doc/reference/reference-environment-variables/#commons-to-all-applications). Other changes are as follows: +In the meantime, we've updated Docker, Erlang, Go, Haskell, Ruby and Rust images into production with no impact for our users. They include security patches and now use Linux kernel 6.7.1, OpenSSL 3.2.1 and Node.js 20.11.0 by default. For the latter, you can change it in the updated images via the `CC_NODE_VERSION` [environment variable](/developers/doc/reference/reference-environment-variables/#commons-to-all-applications). Other changes are as follows: - **Docker**: - moby 25.0.2 diff --git a/content/changelog/2024-02-07-clever-tools-3.2.0.md b/content/changelog/2024/02-07-clever-tools-3.2.0.md similarity index 78% rename from content/changelog/2024-02-07-clever-tools-3.2.0.md rename to content/changelog/2024/02-07-clever-tools-3.2.0.md index a50b9e8d..75af3288 100644 --- a/content/changelog/2024-02-07-clever-tools-3.2.0.md +++ b/content/changelog/2024/02-07-clever-tools-3.2.0.md @@ -12,10 +12,12 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: And more is coming! +aliases: +- /changelog/2024-02-07-clever-tools-3.2.0 excludeSearch: true --- -As mentioned [in the previous release](/changelog/2024-01-25-clever-tools-3.1.0/), the packaging process moved to GitHub Actions to provide a better process, quicker tests and more frequent releases. We start with [the 3.2.0](https://github.com/CleverCloud/clever-tools/releases/tag/3.2.0) adding the log auto retry feature on network failures and some fixes: +As mentioned [in the previous release](../01-25-clever-tools-3.1.0/), the packaging process moved to GitHub Actions to provide a better process, quicker tests and more frequent releases. We start with [the 3.2.0](https://github.com/CleverCloud/clever-tools/releases/tag/3.2.0) adding the log auto retry feature on network failures and some fixes: * **api:** improve error message with `EAI_AGAIN` and `ECONNRESET` ([b134213](https://github.com/CleverCloud/clever-tools/commit/b134213f30d46dd7f5690a38425deb4fd752148c)) * **logs:** improve error message with `EAI_AGAIN` and `ECONNRESET` ([fada067](https://github.com/CleverCloud/clever-tools/commit/fada06771369173e579f5fd3a708ff3cef40c95f)) diff --git a/content/changelog/2024-02-08-sozu-0.15.19.md b/content/changelog/2024/02-08-sozu-0.15.19.md similarity index 96% rename from content/changelog/2024-02-08-sozu-0.15.19.md rename to content/changelog/2024/02-08-sozu-0.15.19.md index 50540963..ba150021 100644 --- a/content/changelog/2024-02-08-sozu-0.15.19.md +++ b/content/changelog/2024/02-08-sozu-0.15.19.md @@ -11,6 +11,8 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: Do you know protobuf? +aliases: +- /changelog/2024-02-08-sozu-0.15.19 excludeSearch: true --- diff --git a/content/changelog/2024-02-12-new-grahds-region.md b/content/changelog/2024/02-12-new-grahds-region.md similarity index 95% rename from content/changelog/2024-02-12-new-grahds-region.md rename to content/changelog/2024/02-12-new-grahds-region.md index 081e58e5..f5eed3f2 100644 --- a/content/changelog/2024-02-12-new-grahds-region.md +++ b/content/changelog/2024/02-12-new-grahds-region.md @@ -10,6 +10,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: HDS servers, the duplicate way +aliases: +- /changelog/2024-02-12-new-grahds-region excludeSearch: true --- diff --git a/content/changelog/2024-02-16-clever-tools-3.4.0.md b/content/changelog/2024/02-16-clever-tools-3.4.0.md similarity index 77% rename from content/changelog/2024-02-16-clever-tools-3.4.0.md rename to content/changelog/2024/02-16-clever-tools-3.4.0.md index 5143ccfe..b8dcde37 100644 --- a/content/changelog/2024-02-16-clever-tools-3.4.0.md +++ b/content/changelog/2024/02-16-clever-tools-3.4.0.md @@ -12,10 +12,12 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: JSON everywhere, create more easily! +aliases: +- /changelog/2024-02-16-clever-tools-3.4.0 excludeSearch: true --- -This week, we published two Clever Tools updates in a row. 3.3.0 was about adding [our new Gravelines HDS region](/changelog/2024-02-12-new-grahds-region/) support and fixing a bug in our add-ons logs feature. 3.4.0 brings `json` and `json-stream` formats for applications logs. The latter uses the Newline delimited JSON (NDJSON) specification (`jq` compatible). You can learn more about it [here](https://github.com/ndjson/ndjson-spec/blob/master/README.md). +This week, we published two Clever Tools updates in a row. 3.3.0 was about adding [our new Gravelines HDS region](../02-12-new-grahds-region/) support and fixing a bug in our add-ons logs feature. 3.4.0 brings `json` and `json-stream` formats for applications logs. The latter uses the Newline delimited JSON (NDJSON) specification (`jq` compatible). You can learn more about it [here](https://github.com/ndjson/ndjson-spec/blob/master/README.md). But it's the `create` and `deploy` commands which are the most improved by this release. First, you'll now get the application or add-on name confirmed after creation. You can also get a JSON response adding `--format json` or `-F json` to the `create` or `create-addon` command. Second, the current folder name is now used as default application name if none is provided. diff --git a/content/changelog/2024-02-22-postgresql-pgvector-support.md b/content/changelog/2024/02-22-postgresql-pgvector-support.md similarity index 79% rename from content/changelog/2024-02-22-postgresql-pgvector-support.md rename to content/changelog/2024/02-22-postgresql-pgvector-support.md index 0d499057..f77e4285 100644 --- a/content/changelog/2024-02-22-postgresql-pgvector-support.md +++ b/content/changelog/2024/02-22-postgresql-pgvector-support.md @@ -15,10 +15,12 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Your wishes are our commands +aliases: +- /changelog/2024-02-22-postgresql-pgvector-support excludeSearch: true --- -PostgreSQL databases managed by Clever Cloud come with [lots of extensions enabled by default](../../doc/addons/postgresql/#default-extensions). There are also [some you can ask for](../../doc/addons/postgresql/#on-demand-extensions), and we'll set them up, like `pg_cron`, `pgtap` or `timescaledb`. +PostgreSQL databases managed by Clever Cloud come with [lots of extensions enabled by default](/developers/doc/addons/postgresql/#default-extensions). There are also [some you can ask for](/developers/doc/addons/postgresql/#on-demand-extensions), and we'll set them up, like `pg_cron`, `pgtap` or `timescaledb`. We recently noticed an increased interest from our clients in supporting the `pgvector` extension, needed for specific (AI) workloads. To answer these needs, we've packaged it and are now able to provide it on-demand. diff --git a/content/changelog/2024-02-26-healthcheck-for-everyone.md b/content/changelog/2024/02-26-healthcheck-for-everyone.md similarity index 85% rename from content/changelog/2024-02-26-healthcheck-for-everyone.md rename to content/changelog/2024/02-26-healthcheck-for-everyone.md index c3124d1d..a15e5a41 100644 --- a/content/changelog/2024-02-26-healthcheck-for-everyone.md +++ b/content/changelog/2024/02-26-healthcheck-for-everyone.md @@ -8,6 +8,8 @@ authors: link: https://github.com/judu image: https://github.com/judu.png?size=40 description: Your applications can now be deployed with one or multiple custom healtchecks +aliases: +- /changelog/2024-02-26-healthcheck-for-everyone excludeSearch: true --- @@ -18,5 +20,5 @@ You can now define the paths that the orchestrator will call to validate a deplo * If the application responds on this specified path, and the response code is between `200` and `300`, the orchestrator considers that the deployment has been validated. * If it responds with a code outside this interval, the application is considered to have failed its deployment. -- Read the documentation about [Deployment healthcheck path](../../doc/develop/healthcheck/) 📖 +- Read the documentation about [Deployment healthcheck path](/developers/doc/develop/healthcheck/) 📖 diff --git a/content/changelog/2024-02-26-mtl-iplb-update.md b/content/changelog/2024/02-26-mtl-iplb-update.md similarity index 77% rename from content/changelog/2024-02-26-mtl-iplb-update.md rename to content/changelog/2024/02-26-mtl-iplb-update.md index 4ff947e2..a35c7ec4 100644 --- a/content/changelog/2024-02-26-mtl-iplb-update.md +++ b/content/changelog/2024/02-26-mtl-iplb-update.md @@ -13,12 +13,14 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: But please, prefer CNAMEs +aliases: +- /changelog/2024-02-26-mtl-iplb-update excludeSearch: true --- -As we're upgrading our infrastructure and load balancers in Montreal, we've added new failover IPs in this region. +As we're upgrading our infrastructure and load balancers in Montreal, we've added new failover IPs in this region. -If you configure your domains through CNAME records, this update will be transparent. But if you use A records, switch to CNAME or update your [DNS configuration](../../doc/administrate/domain-names/). Old IPs will continue to work for a while, but we recommend you to update your DNS as soon as possible to avoid any service interruption. +If you configure your domains through CNAME records, this update will be transparent. But if you use A records, switch to CNAME or update your [DNS configuration](/developers/doc/administrate/domain-names/). Old IPs will continue to work for a while, but we recommend you to update your DNS as soon as possible to avoid any service interruption. ## Applications @@ -27,7 +29,7 @@ If you configure your domains through CNAME records, this update will be transpa | CNAME
Recommended | `{yoursubdomain} 10800 IN CNAME domain.mtl.clever-cloud.com.` | | A
Only if CNAME is not available | @ 10800 IN A 158.69.109.229
@ 10800 IN A 149.56.117.183 | -## Add-ons +## Add-ons | Record Type | Value | | ----------- | ----- | diff --git a/content/changelog/2024-02-27-images-update-part2.md b/content/changelog/2024/02-27-images-update-part2.md similarity index 52% rename from content/changelog/2024-02-27-images-update-part2.md rename to content/changelog/2024/02-27-images-update-part2.md index fa9dddc6..84fa30d9 100644 --- a/content/changelog/2024-02-27-images-update-part2.md +++ b/content/changelog/2024/02-27-images-update-part2.md @@ -9,18 +9,20 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New .Net version, Java Elastic/APM agent update +aliases: +- /changelog/2024-02-27-images-update-part2 excludeSearch: true --- -Earlier this month, we published [a first set of updates](../2024-02-02-images-update/) for Docker, Erlang, Go, Haskell, Ruby and Rust. Some days ago, we finished this work and all images are now up-to-date. This process occurred with no impact for our users. As mentioned in a previous post, this enables [the new `healthcheck` feature](../2024-02-26-healthcheck-for-everyone/) available for all applications. +Earlier this month, we published [a first set of updates](../02-02-images-update) for Docker, Erlang, Go, Haskell, Ruby and Rust. Some days ago, we finished this work and all images are now up-to-date. This process occurred with no impact for our users. As mentioned in a previous post, this enables [the new `healthcheck` feature](../02-26-healthcheck-for-everyone) available for all applications. -New images include security patches, Linux kernel 6.7.1, OpenSSL 3.2.1 and Node.js 20.11.0 by default. For the latter, you can set it via the `CC_NODE_VERSION` [environment variable](../../doc/reference/reference-environment-variables/#commons-to-all-applications). Other changes are as follows: +New images include security patches, Linux kernel 6.7.1, OpenSSL 3.2.1 and Node.js 20.11.0 by default. For the latter, you can set it via the `CC_NODE_VERSION` [environment variable](/developers/doc/reference/reference-environment-variables/#commons-to-all-applications). Other changes are as follows: * **.Net:** * Version 8.0 support - * `CC_DOTNET_VERSION` [environment variable](../../doc/reference/reference-environment-variables/#net) can be `6.0` or `8.0` + * `CC_DOTNET_VERSION` [environment variable](/developers/doc/reference/reference-environment-variables/#net) can be `6.0` or `8.0` * **Java - Elastic / APM:** * The agent has been updated to 1.47.1 * Java 21 support -New PHP image is next to come, with 8.3 version support, we're currently working on it. After that, we'll bring our new strategy to build images into production. We're currently testing it, and preparing enhancements for multiples runtimes. Your applications will automatically benefit from it when available. [Stay tuned](../index.xml). +New PHP image is next to come, with 8.3 version support, we're currently working on it. After that, we'll bring our new strategy to build images into production. We're currently testing it, and preparing enhancements for multiples runtimes. Your applications will automatically benefit from it when available. [Stay tuned](/developers/changelog/index.xml). diff --git a/content/changelog/2024-02-27-js-client-8.2.0.md b/content/changelog/2024/02-27-js-client-8.2.0.md similarity index 52% rename from content/changelog/2024-02-27-js-client-8.2.0.md rename to content/changelog/2024/02-27-js-client-8.2.0.md index bef346c0..8adef3da 100644 --- a/content/changelog/2024-02-27-js-client-8.2.0.md +++ b/content/changelog/2024/02-27-js-client-8.2.0.md @@ -12,9 +12,11 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: The Clever Cloud JS Client has been updated to version 8.2.0 +aliases: +- /changelog/2024-02-27-js-client-8.2.0 excludeSearch: true --- -Since [latest big update](/changelog/2024-01-30-js-client-8.0.3/) of the [JS Client](https://www.npmjs.com/package/@clevercloud/client/v/8.2.0), we've fixed multiple issues with Server-Sent Events (SSE). [8.2.0 release](https://github.com/CleverCloud/clever-client.js/blob/master/CHANGELOG.md#820-2024-02-27) allows error handling from legacy client and brings support repeatable query parameters, which is a feature enabler for some tools. +Since [latest big update](../01-30-js-client-8.0.3/) of the [JS Client](https://www.npmjs.com/package/@clevercloud/client/v/8.2.0), we've fixed multiple issues with Server-Sent Events (SSE). [8.2.0 release](https://github.com/CleverCloud/clever-client.js/blob/master/CHANGELOG.md#820-2024-02-27) allows error handling from legacy client and brings support repeatable query parameters, which is a feature enabler for some tools. - Check this project [on GitHub](https://github.com/CleverCloud/clever-client.js) {{< icon "github" >}} diff --git a/content/changelog/2024-03-07-env-vars-app-creation-api.md b/content/changelog/2024/03-07-env-vars-app-creation-api.md similarity index 93% rename from content/changelog/2024-03-07-env-vars-app-creation-api.md rename to content/changelog/2024/03-07-env-vars-app-creation-api.md index 749c829c..b8dc9136 100644 --- a/content/changelog/2024-03-07-env-vars-app-creation-api.md +++ b/content/changelog/2024/03-07-env-vars-app-creation-api.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: A game changer for some features coming soon +aliases: +- /changelog/2024-03-07-env-vars-app-creation-api excludeSearch: true --- @@ -24,7 +26,7 @@ When you create an application with the Clever Cloud API, you can now set enviro } ``` -The response will contain an `env` object, with the environment variables set: +The response will contain an `env` object, with the environment variables set: ```json "env": [ diff --git a/content/changelog/2024-03-07-web-components-v13.md b/content/changelog/2024/03-07-web-components-v13.md similarity index 95% rename from content/changelog/2024-03-07-web-components-v13.md rename to content/changelog/2024/03-07-web-components-v13.md index fb379912..ed606b41 100644 --- a/content/changelog/2024-03-07-web-components-v13.md +++ b/content/changelog/2024/03-07-web-components-v13.md @@ -12,10 +12,12 @@ authors: link: https://github.com/florian-sanders-cc image: https://github.com/florian-sanders-cc.png?size=40 description: Console update with new icons for the documentation +aliases: +- /changelog/2024-03-07-web-components-v13 excludeSearch: true --- -Clever Cloud's [Web Components](https://www.clever-cloud.com/doc/clever-components/?path=/docs/readme--docs) v13 are available, with bug fixes, refactoring, and new features. We introduced new possibilities to highlight form fields (larger labels, with color), paving the way for our new add-on/application creation process. +Clever Cloud's [Web Components](https://www.clever-cloud.com/doc/clever-components/?path=/docs/readme--docs) v13 are available, with bug fixes, refactoring, and new features. We introduced new possibilities to highlight form fields (larger labels, with color), paving the way for our new add-on/application creation process. A standardized API is used for UI components that depend on a smart component. It includes a `state` property receiving state type: `loaded`, `loading`, `error` and data. Latest smart components no longer rely on `rxjs`, making them easier to maintain. diff --git a/content/changelog/2024-03-11-console-components-update.md b/content/changelog/2024/03-11-console-components-update.md similarity index 67% rename from content/changelog/2024-03-11-console-components-update.md rename to content/changelog/2024/03-11-console-components-update.md index b4ccedb3..396bb2e5 100644 --- a/content/changelog/2024-03-11-console-components-update.md +++ b/content/changelog/2024/03-11-console-components-update.md @@ -12,7 +12,9 @@ authors: link: https://github.com/pdesoyres-cc image: https://github.com/pdesoyres-cc.png?size=40 description: More security and information for our users +aliases: +- /changelog/2024-03-11-console-components-update excludeSearch: true --- -In our ongoing effort to improve our [Console](https://console.clever-cloud.com) experience, we upgraded some of its components. It now uses [JS Client 8.2.0](/changelog/2024-02-27-js-client-8.2.0/) and [Web Components 13.0.0](/changelog/2024-03-07-web-components-v13/). This update also brings some fixes regarding deployment logs links and Warp10 calls. \ No newline at end of file +In our ongoing effort to improve our [Console](https://console.clever-cloud.com) experience, we upgraded some of its components. It now uses [JS Client 8.2.0](../02-27-js-client-8.2.0/) and [Web Components 13.0.0](../03-07-web-components-v13/). This update also brings some fixes regarding deployment logs links and Warp10 calls. \ No newline at end of file diff --git a/content/changelog/2024-03-12-oauth-token-expiration.md b/content/changelog/2024/03-12-oauth-token-expiration.md similarity index 94% rename from content/changelog/2024-03-12-oauth-token-expiration.md rename to content/changelog/2024/03-12-oauth-token-expiration.md index f8ff331d..d3da3c24 100644 --- a/content/changelog/2024-03-12-oauth-token-expiration.md +++ b/content/changelog/2024/03-12-oauth-token-expiration.md @@ -15,11 +15,13 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: More security and information for our users +aliases: +- /changelog/2024-03-12-oauth-token-expiration excludeSearch: true --- When you connect to Clever Cloud's interfaces, such as API, Console or CLI, you use OAuth tokens. They are now valid for a certain amount of time, and you need to refresh it before it expires. -The duration of the token is 1 year for [Clever Tools](https://github.com/CleverCloud/clever-tools), 3 months for [Console](https://console.clever-cloud.com) and any other integration. The expiration date of the token is mentioned at the time of its creation from CLI, you can also check it from [Console](https://console.clever-cloud.com/users/me/tokens). You can still revoke tokens at any time from the same (enhanced) page. We'll add such information in future releases of Clever Tools. +The duration of the token is 1 year for [Clever Tools](https://github.com/CleverCloud/clever-tools), 3 months for [Console](https://console.clever-cloud.com) and any other integration. The expiration date of the token is mentioned at the time of its creation from CLI, you can also check it from [Console](https://console.clever-cloud.com/users/me/tokens). You can still revoke tokens at any time from the same (enhanced) page. We'll add such information in future releases of Clever Tools. Please note that if you ask a member of our support team to access your account, this interface will show their own token, you can revoke, valid for 12 hours. This change is part of our ongoing effort to improve [the security](https://www.clever-cloud.com/security/) of our users' accounts and data. If you have any questions or concerns, please [contact us](https://console.clever-cloud.com/ticket-center-choice). \ No newline at end of file diff --git a/content/changelog/2024-03-20-pulsar-3.2.1-update.md b/content/changelog/2024/03-20-pulsar-3.2.1-update.md similarity index 78% rename from content/changelog/2024-03-20-pulsar-3.2.1-update.md rename to content/changelog/2024/03-20-pulsar-3.2.1-update.md index af652359..e1c98ab8 100644 --- a/content/changelog/2024-03-20-pulsar-3.2.1-update.md +++ b/content/changelog/2024/03-20-pulsar-3.2.1-update.md @@ -12,9 +12,11 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New API endpoint and stack update +aliases: +- /changelog/2024-03-20-pulsar-3.2.1-update excludeSearch: true --- -We've deployed the [3.2.1 release](https://github.com/apache/pulsar/releases/tag/v3.2.1) of Apache Pulsar on our platform. It brings lots of fixes and some new features. Please note we also added [a new v4 endpoint](/api/v4/#pulsar-policies) in our API to control Pulsar's storage policies (offload, retention). +We've deployed the [3.2.1 release](https://github.com/apache/pulsar/releases/tag/v3.2.1) of Apache Pulsar on our platform. It brings lots of fixes and some new features. Please note we also added [a new v4 endpoint](/developers/api/v4/#pulsar-policies) in our API to control Pulsar's storage policies (offload, retention). - Learn more about [Apache Pulsar](https://www.clever-cloud.com/product/pulsar/) \ No newline at end of file diff --git a/content/changelog/2024-04-04-CVE-2024-3094.md b/content/changelog/2024/04-04-CVE-2024-3094.md similarity index 66% rename from content/changelog/2024-04-04-CVE-2024-3094.md rename to content/changelog/2024/04-04-CVE-2024-3094.md index b50a78fb..50d50e48 100644 --- a/content/changelog/2024-04-04-CVE-2024-3094.md +++ b/content/changelog/2024/04-04-CVE-2024-3094.md @@ -11,18 +11,20 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: None of our services were impacted +aliases: +- /changelog/2024-04-04-CVE-2024-3094 excludeSearch: true --- -On March 29th, we were informed that a backdoor was discovered in the source code of `xz`, introduced with version 5.6.0 (CVE-2024-3094). Our security team instantly made sanity checks, and found our services were not impacted. +On March 29th, we were informed that a backdoor was discovered in the source code of `xz`, introduced with version 5.6.0 (CVE-2024-3094). Our security team instantly made sanity checks, and found our services were not impacted. As stated [by NIST](https://nvd.nist.gov/vuln/detail/CVE-2024-3094), « *Through a series of complex obfuscations, the liblzma build process extracts a prebuilt object file from a disguised test file existing in the source code, which is then used to modify specific functions in the liblzma code. This results in a modified liblzma library that can be used by any software linked against this library, intercepting and modifying the data interaction with this library.* ». -First, the malicious version was not deployed on images we use for most of our services. Second, we don't use patches to suppport systemd within OpenSSH through libsystemd (which depends on the backdoored libzma). Third, some GNU/Linux distributions were specifically targeted, not [Exherbo Linux](https://www.exherbolinux.org/) which we use for our services. +First, the malicious version was not deployed on images we use for most of our services. Second, we don't use patches to support systemd within OpenSSH through libsystemd (which depends on the backdoored libzma). Third, some GNU/Linux distributions were specifically targeted, not [Exherbo Linux](https://www.exherbolinux.org/) which we use for our services. -Nevertheless, we immediatly put the backdoored version on a deny list to prevent its installation, and so did Exherbo Linux maintainers promptly after. We also started to revert `xz` 5.6.x to 5.4.6 on the few custom services where it had been set up, although it would not have been possible for an attacker to exploit it. +Nevertheless, we immediately put the backdoored version on a deny list to prevent its installation, and so did Exherbo Linux maintainers promptly after. We also started to revert `xz` 5.6.x to 5.4.6 on the few custom services where it had been set up, although it would not have been possible for an attacker to exploit it. -You can know more about this CVE following these links: +You can know more about this CVE following these links: * https://boehs.org/node/everything-i-know-about-the-xz-backdoor * https://gynvael.coldwind.pl/?lang=en&id=782 diff --git a/content/changelog/2024-04-11-clever-tools-3.5.2.md b/content/changelog/2024/04-11-clever-tools-3.5.2.md similarity index 86% rename from content/changelog/2024-04-11-clever-tools-3.5.2.md rename to content/changelog/2024/04-11-clever-tools-3.5.2.md index 7a970932..aed37e92 100644 --- a/content/changelog/2024-04-11-clever-tools-3.5.2.md +++ b/content/changelog/2024/04-11-clever-tools-3.5.2.md @@ -12,10 +12,12 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Lots of new features included! +aliases: +- /changelog/2024-04-11-clever-tools-3.5.2 excludeSearch: true --- -Clever Tools 3.5 is now available, and this branch brings lots of new important features. First, `clever curl` is now public and listed as an official command. It helps you to send cURL requests with the auth context of your Clever Tools configuration. Thus, you can use Clever Cloud [API v2 or v4](/api/). +Clever Tools 3.5 is now available, and this branch brings lots of new important features. First, `clever curl` is now public and listed as an official command. It helps you to send curl requests with the auth context of your Clever Tools configuration. Thus, you can use Clever Cloud [API v2 or v4](/developers/api/). JSON format is supported for more commands, the `--since` option now supports a duration value. For example if you want to get logs since 2 hours ago, you can use `clever logs --since 2h`. This command documentation is available [there](https://github.com/CleverCloud/clever-tools/blob/master/docs/applications-deployment-lifecycle.md#logs). @@ -41,9 +43,9 @@ clever env set CC_RUN_COMMAND "bash a_bash_script.sh" ``` Clever Tasks will evolve with enhancements planed over the coming months. Feel free to tell us about your needs or ideas on this! -* [Learn more about Clever Tasks](/doc/develop/tasks/) +* [Learn more about Clever Tasks](/developers/doc/develop/tasks/) -Last but not least, we're introducing the access to Materia KV. Those granted with alpha access can now create a serverless, synchronously-replicated (over our 3 datacenters in Paris) key-value add-on. You'll be able to use it with multiples kind of clients. First to be supported is Redis API. Thus, you can run: +Last but not least, we're introducing the access to Materia KV. Those granted with alpha access can now create a serverless, synchronously-replicated (over our 3 data centers in Paris) key-value add-on. You'll be able to use it with multiples kind of clients. First to be supported is Redis API. Thus, you can run: ```` clever addon create kv myKV diff --git a/content/changelog/2024-04-15-new-logs-interface-public-beta.md b/content/changelog/2024/04-15-new-logs-interface-public-beta.md similarity index 95% rename from content/changelog/2024-04-15-new-logs-interface-public-beta.md rename to content/changelog/2024/04-15-new-logs-interface-public-beta.md index 9d16c8ec..5d83113a 100644 --- a/content/changelog/2024-04-15-new-logs-interface-public-beta.md +++ b/content/changelog/2024/04-15-new-logs-interface-public-beta.md @@ -12,10 +12,12 @@ authors: link: https://github.com/pdesoyres-cc image: https://github.com/pdesoyres-cc.png?size=40 description: Lots of new features included! +aliases: +- /changelog/2024-04-15-new-logs-interface-public-beta excludeSearch: true --- -Since 2023, applications use a new Logs stack based on Pulsar and Vector, through CLI. Thanks to it, we provide a more reliable service, with new filtering features. It's now available from [the Console](https://console.clever-cloud.com) too! As it's in public beta stage, you'll need to activate it through the "Try the new Logs experience" link. You can revert this choice if needed. +Since 2023, applications use a new Logs stack based on Pulsar and Vector, through CLI. Thanks to it, we provide a more reliable service, with new filtering features. It's now available from [the Console](https://console.clever-cloud.com) too! As it's in public beta stage, you'll need to activate it through the "Try the new Logs experience" link. You can revert this choice if needed. This new feature is available for **applications only**. diff --git a/content/changelog/2024-04-16-clever-tools-3.6.0.md b/content/changelog/2024/04-16-clever-tools-3.6.0.md similarity index 94% rename from content/changelog/2024-04-16-clever-tools-3.6.0.md rename to content/changelog/2024/04-16-clever-tools-3.6.0.md index 1bce0a1c..b5f0ff93 100644 --- a/content/changelog/2024-04-16-clever-tools-3.6.0.md +++ b/content/changelog/2024/04-16-clever-tools-3.6.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Lots of new features included! +aliases: +- /changelog/2024-04-16-clever-tools-3.6.0 excludeSearch: true --- diff --git a/content/changelog/2024-04-24-php-deprecate-warning.md b/content/changelog/2024/04-24-php-deprecate-warning.md similarity index 96% rename from content/changelog/2024-04-24-php-deprecate-warning.md rename to content/changelog/2024/04-24-php-deprecate-warning.md index e03ec4b2..ecd29fec 100644 --- a/content/changelog/2024-04-24-php-deprecate-warning.md +++ b/content/changelog/2024/04-24-php-deprecate-warning.md @@ -10,6 +10,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Please, update! +aliases: +- /changelog/2024-04-24-php-deprecate-warning excludeSearch: true --- diff --git a/content/changelog/2024-04-25-images-update.md b/content/changelog/2024/04-25-images-update.md similarity index 88% rename from content/changelog/2024-04-25-images-update.md rename to content/changelog/2024/04-25-images-update.md index 2afd6b71..256ef0ce 100644 --- a/content/changelog/2024-04-25-images-update.md +++ b/content/changelog/2024/04-25-images-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Kernel 6.8.6, security fixes and action executor +aliases: +- /changelog/2024-04-25-images-update excludeSearch: true --- @@ -27,4 +29,4 @@ We've updated all our images and deployed them without any impact for our users. We had to delay the release of PHP image with 8.3 version support, to better support some extensions and include latest security fixes. It will start to deploy next week and include an informative message when a deprecated version of PHP is used. -* Learn more about the [message for deprecated PHP versions](/changelog/2024-04-24-php-deprecate-warning/). +* Learn more about the [message for deprecated PHP versions](../04-24-php-deprecate-warning/). diff --git a/content/changelog/2024-04-26-new-images-stack.md b/content/changelog/2024/04-26-new-images-stack.md similarity index 78% rename from content/changelog/2024-04-26-new-images-stack.md rename to content/changelog/2024/04-26-new-images-stack.md index db2f87d9..a640768d 100644 --- a/content/changelog/2024-04-26-new-images-stack.md +++ b/content/changelog/2024/04-26-new-images-stack.md @@ -9,9 +9,11 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Fewer images, more updates coming +aliases: +- /changelog/2024-04-26-new-images-stack excludeSearch: true --- As mentioned in previous posts, we've made a major overhaul of how we create the images underlying our virtual machines over the past few months. Our main goals are to provide a more efficient way of keeping add-ons and application up to date without breaking changes, to make new features available more quickly and to keep it simple for our team to manage all of this. -We also use fewer base images for our runtimes to reduce binaries and configuration disparities, storage footprint, simplify build and maintenance. After extensive tests, this new stack is now used in production, starting with Dotnet, Go and Rust images. We'll progressively deploy it to all our products in the coming months. This should be done without any impact for our users. \ No newline at end of file +We also use fewer base images for our runtimes to reduce binaries and configuration disparities, storage footprint, simplify build and maintenance. After extensive tests, this new stack is now used in production, starting with .Net, Go and Rust images. We'll progressively deploy it to all our products in the coming months. This should be done without any impact for our users. \ No newline at end of file diff --git a/content/changelog/2024-05-28-tasks-in-console.md b/content/changelog/2024/05-28-tasks-in-console.md similarity index 56% rename from content/changelog/2024-05-28-tasks-in-console.md rename to content/changelog/2024/05-28-tasks-in-console.md index bcef37f4..61b89063 100644 --- a/content/changelog/2024-05-28-tasks-in-console.md +++ b/content/changelog/2024/05-28-tasks-in-console.md @@ -12,11 +12,13 @@ authors: link: https://github.com/pdesoyres-cc image: https://github.com/pdesoyres-cc.png?size=40 description: Just a box to check +aliases: +- /changelog/2024-05-28-tasks-in-console excludeSearch: true --- -Since [its release 3.5.2](/changelog/2024-04-11-clever-tools-3.5.2/), Clever Tools is able to manage [Clever Tasks](/doc/develop/tasks/). It's now possible to create, configure and deploy them directly from the Console. To declare an application as a Task, check the corresponding box in the `Information` tab. +Since [its release 3.5.2](../04-11-clever-tools-3.5.2/), Clever Tools is able to manage [Clever Tasks](/developers/doc/develop/tasks/). It's now possible to create, configure and deploy them directly from the Console. To declare an application as a Task, check the corresponding box in the `Information` tab. A Clever Task can be run on demand. It executes the command you've set in the `CC_RUN_COMMAND` environment variable, without waiting for any HTTP request on the `8080` port. After that, the application stops. It's just billed for the execution time. -{{< figure src="/images/changelog/clever-tasks.webp" caption="Defines a Clever Cloud application as a Task in Console" width="800px">}} +![Clever Task Management in Console](/images/changelog/clever-tasks.webp "Defines a Clever Cloud application as a Task in Console") diff --git a/content/changelog/2024-05-30-php-8.3-java-22.md b/content/changelog/2024/05-30-php-8.3-java-22.md similarity index 87% rename from content/changelog/2024-05-30-php-8.3-java-22.md rename to content/changelog/2024/05-30-php-8.3-java-22.md index fce5b355..38ad4585 100644 --- a/content/changelog/2024-05-30-php-8.3-java-22.md +++ b/content/changelog/2024/05-30-php-8.3-java-22.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: May images update +aliases: +- /changelog/2024-05-30-php-8.3-java-22 excludeSearch: true --- @@ -26,5 +28,5 @@ We've updated some of our images and deployed them without any impact for our us * Support for NewRelic with Java 22 * **PHP:** * Composer 2.7.6 - * Support for PHP 8.3 with [all supported extensions](../../doc/applications/php/#available-extensions-and-modules) + * Support for PHP 8.3 with [all supported extensions](/developers/doc/applications/php/#available-extensions-and-modules) * PHP info apps are available for PHP [8.0](https://php80info.cleverapps.io), [8.1](https://php81info.cleverapps.io), [8.2](https://php82info.cleverapps.io) and [8.3](https://php83info.cleverapps.io) diff --git a/content/changelog/2024-06-07-sozu-1.0.2.md b/content/changelog/2024/06-07-sozu-1.0.2.md similarity index 97% rename from content/changelog/2024-06-07-sozu-1.0.2.md rename to content/changelog/2024/06-07-sozu-1.0.2.md index 6286caad..29037720 100644 --- a/content/changelog/2024-06-07-sozu-1.0.2.md +++ b/content/changelog/2024/06-07-sozu-1.0.2.md @@ -11,6 +11,8 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: A big step forward for our open source reverse proxy +aliases: +- /changelog/2024-06-07-sozu-1.0.2 excludeSearch: true --- diff --git a/content/changelog/2024/06-10-mongo-db-terraform.md b/content/changelog/2024/06-10-mongo-db-terraform.md new file mode 100644 index 00000000..684a9962 --- /dev/null +++ b/content/changelog/2024/06-10-mongo-db-terraform.md @@ -0,0 +1,24 @@ +--- +title: Deploy MongoDB add-ons with our Terraform provider +date: 2024-06-10 +tags: + - mongodb + - terraform +authors: + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 + - name: Mathieu Barcelo + link: https://github.com/TheCrabe + image: https://github.com/TheCrabe.png?size=40 +description: +aliases: +- /changelog/2024-06-10-mongo-db-terraform +excludeSearch: true +--- + +If you can deploy on Clever Cloud through our [Console](https://console.clever-cloud.com), our CLI ([Clever Tools](https://github.com/CleverCloud/clever-tools)), or our [API](/developers/api/), you can also use Terraform and compatible tools such as [OpenTofu](https://opentofu.org/). We maintain a provider that allows you to manage your resources as code, from applications to add-ons (object storage, databases, etc.). + +We've recently added support for Python and [Materia KV](/developers/doc/addons/materia-kv/). It's MongoDB's turn [to be available](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs/resources/mongodb). You can now create such an add-on, choose its plan, region and get the credentials to connect to it. + +* Learn more about [our Terraform provider](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs) diff --git a/content/changelog/2024-06-11-clever-tools-3.7.0.md b/content/changelog/2024/06-11-clever-tools-3.7.0.md similarity index 94% rename from content/changelog/2024-06-11-clever-tools-3.7.0.md rename to content/changelog/2024/06-11-clever-tools-3.7.0.md index 97c34f35..3af8fe09 100644 --- a/content/changelog/2024-06-11-clever-tools-3.7.0.md +++ b/content/changelog/2024/06-11-clever-tools-3.7.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: cURL is fixed, some enhancements +aliases: +- /changelog/2024-06-11-clever-tools-3.7.0 excludeSearch: true --- diff --git a/content/changelog/2024-06-11-materia-kv-public-alpha.md b/content/changelog/2024/06-11-materia-kv-public-alpha.md similarity index 58% rename from content/changelog/2024-06-11-materia-kv-public-alpha.md rename to content/changelog/2024/06-11-materia-kv-public-alpha.md index e315aa44..47870268 100644 --- a/content/changelog/2024-06-11-materia-kv-public-alpha.md +++ b/content/changelog/2024/06-11-materia-kv-public-alpha.md @@ -9,13 +9,15 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: May images update +aliases: +- /changelog/2024-06-11-materia-kv-public-alpha excludeSearch: true --- -At Devoxx France 2024, we introduced our new [Materia](https://www.clever-cloud.com/materia/) databases offering. The first "flavor", KV, is now available in public Alpha to all our customers. It's a key-value data store, compatible with Redis protocol and soon DynamoDB, GraphQL. You can create such an add-on from [API](../../api/), [Clever Tools](https://github.com/CleverCloud/clever-tools) or [Console](https://console.clever-cloud.com/users/me/addons/new). Let us know what to improve ! +At Devoxx France 2024, we introduced our new [Materia](https://www.clever-cloud.com/materia/) databases offering. The first "flavor", KV, is now available in public Alpha to all our customers. It's a key-value data store, compatible with Redis protocol and soon DynamoDB, GraphQL. You can create such an add-on from [API](/developers/api/), [Clever Tools](https://github.com/CleverCloud/clever-tools) or [Console](https://console.clever-cloud.com/users/me/addons/new). Let us know what to improve ! - [Materia KV public announcement](https://www.clever-cloud.com/blog/company/2024/04/16/materiadb-kv-materia-functions/) -- [Materia KV documentation](../../doc/addons/materia-kv/) +- [Materia KV documentation](/developers/doc/addons/materia-kv/) - [Give us your feedback](https://github.com/CleverCloud/Community/discussions/categories/materia) - +{{< youtube id="B8wQEG8qkqs" >}} diff --git a/content/changelog/2024-06-21-better-new-logs.md b/content/changelog/2024/06-21-better-new-logs.md similarity index 97% rename from content/changelog/2024-06-21-better-new-logs.md rename to content/changelog/2024/06-21-better-new-logs.md index 426c073c..b796c02e 100644 --- a/content/changelog/2024-06-21-better-new-logs.md +++ b/content/changelog/2024/06-21-better-new-logs.md @@ -12,6 +12,8 @@ authors: link: https://github.com/pdesoyres-cc image: https://github.com/pdesoyres-cc.png?size=40 description: Lots of new features included! +aliases: +- /changelog/2024-06-21-better-new-logs excludeSearch: true --- diff --git a/content/changelog/2024-06-28-new-ip-list-paris.md b/content/changelog/2024/06-28-new-ip-list-paris.md similarity index 81% rename from content/changelog/2024-06-28-new-ip-list-paris.md rename to content/changelog/2024/06-28-new-ip-list-paris.md index 076630bb..1b31d02a 100644 --- a/content/changelog/2024-06-28-new-ip-list-paris.md +++ b/content/changelog/2024/06-28-new-ip-list-paris.md @@ -12,10 +12,12 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: A big step forward for our open source reverse proxy +aliases: +- /changelog/2024-06-28-new-ip-list-paris excludeSearch: true --- -As our network evolves, we've updated [IP list for Paris (PAR) zone](../../doc/administrate/domain-names/#your-application-runs-in-the-europeparis-par-zone). If you use A records for DNS configuration, update them. 4 new IP addresses should be added (`91.208.207.220` to `91.208.207.223`). **We strongly recommend using CNAME records instead.** +As our network evolves, we've updated [IP list for Paris (PAR) zone](/developers/doc/administrate/domain-names/#your-application-runs-in-the-europeparis-par-zone). If you use A records for DNS configuration, update them. 4 new IP addresses should be added (`91.208.207.220` to `91.208.207.223`). **We strongly recommend using CNAME records instead.** | Record Type | Value | | ----------- | ----- | diff --git a/content/changelog/2024-07-01-matomo-5.1.0.md b/content/changelog/2024/07-01-matomo-5.1.0.md similarity index 95% rename from content/changelog/2024-07-01-matomo-5.1.0.md rename to content/changelog/2024/07-01-matomo-5.1.0.md index cdd1c914..46c9100e 100644 --- a/content/changelog/2024-07-01-matomo-5.1.0.md +++ b/content/changelog/2024/07-01-matomo-5.1.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: You can now deploy Matomo v5.1.0 on Clever Cloud +aliases: +- /changelog/2024-07-01-matomo-5.1.0 excludeSearch: true --- diff --git a/content/changelog/2024-07-02-clever-tools-3.8.0.md b/content/changelog/2024/07-02-clever-tools-3.8.0.md similarity index 98% rename from content/changelog/2024-07-02-clever-tools-3.8.0.md rename to content/changelog/2024/07-02-clever-tools-3.8.0.md index 6816257c..50084704 100644 --- a/content/changelog/2024-07-02-clever-tools-3.8.0.md +++ b/content/changelog/2024/07-02-clever-tools-3.8.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Better manage your apps, lots of new features +aliases: +- /changelog/2024-07-02-clever-tools-3.8.0 excludeSearch: true --- diff --git a/content/changelog/2024-07-03-docker-terraform.md b/content/changelog/2024/07-03-docker-terraform.md similarity index 91% rename from content/changelog/2024-07-03-docker-terraform.md rename to content/changelog/2024/07-03-docker-terraform.md index 558e420a..1e3f8f4c 100644 --- a/content/changelog/2024-07-03-docker-terraform.md +++ b/content/changelog/2024/07-03-docker-terraform.md @@ -12,10 +12,12 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: Manage your Docker containers on Clever Cloud with Terraform or compatible tools such as OpenTofu +aliases: +- /changelog/2024-07-03-docker-terraform excludeSearch: true --- -To manage your resources as code on Clever Cloud, from applications to add-ons (object storage, databases, etc.), you can use our Terraform provider. It's compatible with tools such as [OpenTofu](https://opentofu.org/) and can now deploy applications using [our Docker runtime](../../doc/applications/docker/). +To manage your resources as code on Clever Cloud, from applications to add-ons (object storage, databases, etc.), you can use our Terraform provider. It's compatible with tools such as [OpenTofu](https://opentofu.org/) and can now deploy applications using [our Docker runtime](/developers/doc/applications/docker/). You can define instances count or flavors, region, dependencies, ports, Dockerfile and application paths, registry credentials and more. Full parameters list is available [here](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs/resources/docker). diff --git a/content/changelog/2024-07-04-apache-php-image-update.md b/content/changelog/2024/07-04-apache-php-image-update.md similarity index 88% rename from content/changelog/2024-07-04-apache-php-image-update.md rename to content/changelog/2024/07-04-apache-php-image-update.md index 6d1f9f13..d8b48c00 100644 --- a/content/changelog/2024-07-04-apache-php-image-update.md +++ b/content/changelog/2024/07-04-apache-php-image-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Apache 2.4.60 and Composer 2.7.7 also included +aliases: +- /changelog/2024-07-04-apache-php-image-update excludeSearch: true --- @@ -19,4 +21,4 @@ We've updated our PHP image to support versions [8.2.21](https://www.php.net/Cha Over the past few weeks, we have also included [Apache 2.4.60](https://dlcdn.apache.org/httpd/CHANGES_2.4.60), fixing CVE-2024-36387, 38472, 38473, 38474, 38475, 38476, 38477, 39573 and [Composer 2.7.7](https://github.com/composer/composer/releases/tag/2.7.7), fixing CVE-2024-35241, 35242. -* Learn more about [PHP on Clever Cloud](../../doc/applications/php/) +* Learn more about [PHP on Clever Cloud](/developers/doc/applications/php/) diff --git a/content/changelog/2024-07-05-go-haskell-ruby-update.md b/content/changelog/2024/07-05-go-haskell-ruby-update.md similarity index 89% rename from content/changelog/2024-07-05-go-haskell-ruby-update.md rename to content/changelog/2024/07-05-go-haskell-ruby-update.md index d1911d87..9a681332 100644 --- a/content/changelog/2024-07-05-go-haskell-ruby-update.md +++ b/content/changelog/2024/07-05-go-haskell-ruby-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Some fixes and new versions +aliases: +- /changelog/2024-07-05-go-haskell-ruby-update excludeSearch: true --- diff --git a/content/changelog/2024-07-06-mysql-pgsql-update.md b/content/changelog/2024/07-06-mysql-pgsql-update.md similarity index 92% rename from content/changelog/2024-07-06-mysql-pgsql-update.md rename to content/changelog/2024/07-06-mysql-pgsql-update.md index aeb2868a..245ea12c 100644 --- a/content/changelog/2024-07-06-mysql-pgsql-update.md +++ b/content/changelog/2024/07-06-mysql-pgsql-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: And some new extensions/versions for PostgreSQL +aliases: +- /changelog/2024-07-06-mysql-pgsql-update excludeSearch: true --- diff --git a/content/changelog/2024-07-10-CVE-2024-6387.md b/content/changelog/2024/07-10-CVE-2024-6387.md similarity index 97% rename from content/changelog/2024-07-10-CVE-2024-6387.md rename to content/changelog/2024/07-10-CVE-2024-6387.md index 339ce301..f29a1da3 100644 --- a/content/changelog/2024-07-10-CVE-2024-6387.md +++ b/content/changelog/2024/07-10-CVE-2024-6387.md @@ -11,6 +11,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: All our systems are up-to-date +aliases: +- /changelog/2024-07-10-CVE-2024-6387 excludeSearch: true --- diff --git a/content/changelog/2024-07-11-pulsar-3.3.0-update.md b/content/changelog/2024/07-11-pulsar-3.3.0-update.md similarity index 91% rename from content/changelog/2024-07-11-pulsar-3.3.0-update.md rename to content/changelog/2024/07-11-pulsar-3.3.0-update.md index bd1cea36..379422fd 100644 --- a/content/changelog/2024-07-11-pulsar-3.3.0-update.md +++ b/content/changelog/2024/07-11-pulsar-3.3.0-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New API endpoint and stack update +aliases: +- /changelog/2024-07-11-pulsar-3.3.0-update excludeSearch: true --- diff --git a/content/changelog/2024-07-12-accountant-access-console-fix.md b/content/changelog/2024/07-12-accountant-access-console-fix.md similarity index 89% rename from content/changelog/2024-07-12-accountant-access-console-fix.md rename to content/changelog/2024/07-12-accountant-access-console-fix.md index 3c78dfdb..7859f565 100644 --- a/content/changelog/2024-07-12-accountant-access-console-fix.md +++ b/content/changelog/2024/07-12-accountant-access-console-fix.md @@ -12,6 +12,8 @@ authors: link: https://github.com/florian-sanders-cc image: https://github.com/florian-sanders-cc.png?size=40 description: You won't be constantly disconnected anymore +aliases: +- /changelog/2024-07-12-accountant-access-console-fix excludeSearch: true --- diff --git a/content/changelog/2024-07-17-keycloak-public-release.md b/content/changelog/2024/07-17-keycloak-public-release.md similarity index 55% rename from content/changelog/2024-07-17-keycloak-public-release.md rename to content/changelog/2024/07-17-keycloak-public-release.md index 422609d5..8312a01b 100644 --- a/content/changelog/2024-07-17-keycloak-public-release.md +++ b/content/changelog/2024/07-17-keycloak-public-release.md @@ -12,9 +12,11 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Try it and give us feedback +aliases: +- /changelog/2024-07-17-keycloak-public-release excludeSearch: true --- -Clever Cloud provides a Keycloak add-on, developed with Please Open-it, for some months in private alpha. We're releasing it publicly, with a new version and some fixes. Any Clever Cloud user can now deploy a Keycloak service from [API](/api/), [Clever Tools](https://github.com/CleverCloud/clever-tools) or [Console](https://console.clever-cloud.com) and use it. If you have any question or feedback, use our [GitHub Community space](https://github.com/CleverCloud/Community/discussions/categories/keycloak). +Clever Cloud provides a Keycloak add-on, developed with Please Open-it, for some months in private alpha. We're releasing it publicly, with a new version and some fixes. Any Clever Cloud user can now deploy a Keycloak service from [API](/developers/api/), [Clever Tools](https://github.com/CleverCloud/clever-tools) or [Console](https://console.clever-cloud.com) and use it. If you have any question or feedback, use our [GitHub Community space](https://github.com/CleverCloud/Community/discussions/categories/keycloak). -- [Learn more about Keycloak on Clever Cloud](../../doc/addons/keycloak/) \ No newline at end of file +- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak/) \ No newline at end of file diff --git a/content/changelog/2024-07-17-new-logs-default.md b/content/changelog/2024/07-17-new-logs-default.md similarity index 54% rename from content/changelog/2024-07-17-new-logs-default.md rename to content/changelog/2024/07-17-new-logs-default.md index 925dd4d9..1fdfcf5a 100644 --- a/content/changelog/2024-07-17-new-logs-default.md +++ b/content/changelog/2024/07-17-new-logs-default.md @@ -13,7 +13,9 @@ authors: image: https://github.com/davlgd.png?size=40 description: Final countdown +aliases: +- /changelog/2024-07-17-new-logs-default excludeSearch: true --- -New logs interface is available in the Console in public beta [for some months](/changelog/2024-04-15-new-logs-interface-public-beta/), and we already [enhanced it](/changelog/2024-06-21-better-new-logs/). We're now confident enough to use it by default. You can still disable it. If you have any question or feedback, use our [GitHub Community space](https://github.com/CleverCloud/Community/discussions/categories/new-logs-interface). \ No newline at end of file +New logs interface is available in the Console in public beta [for some months](../04-15-new-logs-interface-public-beta/), and we already [enhanced it](../06-21-better-new-logs/). We're now confident enough to use it by default. You can still disable it. If you have any question or feedback, use our [GitHub Community space](https://github.com/CleverCloud/Community/discussions/categories/new-logs-interface). \ No newline at end of file diff --git a/content/changelog/2024-07-18-elastic-8.10.2-jenkins-2.452.3.md b/content/changelog/2024/07-18-elastic-8.10.2-jenkins-2.452.3.md similarity index 90% rename from content/changelog/2024-07-18-elastic-8.10.2-jenkins-2.452.3.md rename to content/changelog/2024/07-18-elastic-8.10.2-jenkins-2.452.3.md index c014c633..0ef2f724 100644 --- a/content/changelog/2024-07-18-elastic-8.10.2-jenkins-2.452.3.md +++ b/content/changelog/2024/07-18-elastic-8.10.2-jenkins-2.452.3.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Elasticsearch 8.1.0 and Jenkins 2.452.3 are now available +aliases: +- /changelog/2024-07-18-elastic-8.10.2-jenkins-2.452.3 excludeSearch: true --- diff --git a/content/changelog/2024-07-18-github-action-review-apps.md b/content/changelog/2024/07-18-github-action-review-apps.md similarity index 88% rename from content/changelog/2024-07-18-github-action-review-apps.md rename to content/changelog/2024/07-18-github-action-review-apps.md index 6c512aae..3a17d506 100644 --- a/content/changelog/2024-07-18-github-action-review-apps.md +++ b/content/changelog/2024/07-18-github-action-review-apps.md @@ -12,6 +12,8 @@ authors: link: https://github.com/juliamrch image: https://github.com/juliamrch.png?size=40 description: Simplify your GitHubworkflows +aliases: +- /changelog/2024-07-18-github-action-review-apps excludeSearch: true --- @@ -28,4 +30,4 @@ Some months ago, Clever Cloud released [a new GitHub Action](https://github.com/ type: '' ``` -- [Learn more about how to deploy from GitHub to Clever Cloud](../../doc/ci-cd/github/) \ No newline at end of file +- [Learn more about how to deploy from GitHub to Clever Cloud](/developers/doc/ci-cd/github/) \ No newline at end of file diff --git a/content/changelog/2024-07-26-domains-console-update.md b/content/changelog/2024/07-26-domains-console-update.md similarity index 87% rename from content/changelog/2024-07-26-domains-console-update.md rename to content/changelog/2024/07-26-domains-console-update.md index f2400764..68308068 100644 --- a/content/changelog/2024-07-26-domains-console-update.md +++ b/content/changelog/2024/07-26-domains-console-update.md @@ -12,10 +12,12 @@ authors: link: https://github.com/florian-sanders-cc image: https://github.com/florian-sanders-cc.png?size=40 description: Did you know about path routing? +aliases: +- /changelog/2024-07-26-domains-console-update excludeSearch: true --- -We've upgraded the applications' Domains page in the Console. It's now more clear, complete and easy to use. We designed it to highlight some of our underrated features such as [path routing](../../doc/administrate/domain-names/#path-routing). You also now have: +We've upgraded the applications' Domains page in the Console. It's now more clear, complete and easy to use. We designed it to highlight some of our underrated features such as [path routing](/developers/doc/administrate/domain-names/#path-routing). You also now have: - A unique form to add a custom domain or a test domain (`cleverapps.io`) - A unique list of test and custom domains diff --git a/content/changelog/2024-07-30-github-action-1.1.md b/content/changelog/2024/07-30-github-action-1.1.md similarity index 83% rename from content/changelog/2024-07-30-github-action-1.1.md rename to content/changelog/2024/07-30-github-action-1.1.md index 0925a88e..1ecbcd9b 100644 --- a/content/changelog/2024-07-30-github-action-1.1.md +++ b/content/changelog/2024/07-30-github-action-1.1.md @@ -12,9 +12,11 @@ authors: link: https://github.com/juliamrch image: https://github.com/juliamrch.png?size=40 description: Better, simpler GitHub Action +aliases: +- /changelog/2024-07-30-github-action-1.1 excludeSearch: true --- Update for [GitHub Action](https://github.com/marketplace/actions/clever-cloud-review-app-on-prs) to deploy applications from GitHub to Clever Cloud. Version 1.1 simplifies workflow files and gives conditional comments depending on the actions performed on the PR (deploy, update, delete). -- [Learn more about how to deploy from GitHub to Clever Cloud](../../doc/ci-cd/github/) \ No newline at end of file +- [Learn more about how to deploy from GitHub to Clever Cloud](/developers/doc/ci-cd/github/) \ No newline at end of file diff --git a/content/changelog/2024-08-01-lagging-server-crate.md b/content/changelog/2024/08-01-lagging-server-crate.md similarity index 93% rename from content/changelog/2024-08-01-lagging-server-crate.md rename to content/changelog/2024/08-01-lagging-server-crate.md index 68681c09..9e60e207 100644 --- a/content/changelog/2024-08-01-lagging-server-crate.md +++ b/content/changelog/2024/08-01-lagging-server-crate.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: n2 is the new n1 +aliases: +- /changelog/2024-08-01-lagging-server-crate excludeSearch: true --- diff --git a/content/changelog/2024-08-09-python-3.12-update.md b/content/changelog/2024/08-09-python-3.12-update.md similarity index 92% rename from content/changelog/2024-08-09-python-3.12-update.md rename to content/changelog/2024/08-09-python-3.12-update.md index 3753b1c1..ec856d57 100644 --- a/content/changelog/2024-08-09-python-3.12-update.md +++ b/content/changelog/2024/08-09-python-3.12-update.md @@ -12,6 +12,8 @@ authors: link: https://github.com/s0dyy image: https://github.com/s0dyy.png?size=40 description: Python 3.12 support and lighter Docker image +aliases: +- /changelog/2024-08-09-python-3.12-update excludeSearch: true --- diff --git a/content/changelog/2024/08-26-java-containers-update.md b/content/changelog/2024/08-26-java-containers-update.md new file mode 100644 index 00000000..dde9bcbd --- /dev/null +++ b/content/changelog/2024/08-26-java-containers-update.md @@ -0,0 +1,22 @@ +--- +title: "Java servlet containers cleanup, Wildfly upgrade" +date: 2024-08-26 +tags: + - applications + - java +authors: + - name: Julien Durillon + link: https://github.com/judu + image: https://github.com/judu.png?size=40 + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 +description: Wildfly 27.0.1 and 33.0.1 are now supported +aliases: +- /changelog/2024-08-26-java-containers-update +excludeSearch: true +--- + +As part of our images enhancement process, we've tidied up the [list of supported servlet containers](/developers/doc/applications/java/java-war/#available-containers). Those that are not longer used by our customers are removed from the Java image. If you need a container which is not listed [here](/developers/doc/applications/java/java-war/#available-containers) or a specific version, please contact [our support team](https://console.clever-cloud.com/ticket-center-choice). This release also includes a [Wildfly](https://github.com/wildfly/wildfly) upgrade. Versions 27.0.1 and 33.0.1 are now available. + +- Learn more about [Java on Clever Cloud](/developers/doc/applications/java/) diff --git a/content/changelog/2024-08-30-deploy-url-mtl.md b/content/changelog/2024/08-30-deploy-url-mtl.md similarity index 96% rename from content/changelog/2024-08-30-deploy-url-mtl.md rename to content/changelog/2024/08-30-deploy-url-mtl.md index 4fc372c7..67f23a4f 100644 --- a/content/changelog/2024-08-30-deploy-url-mtl.md +++ b/content/changelog/2024/08-30-deploy-url-mtl.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: n2 is the new n1 +aliases: +- /changelog/2024-08-30-deploy-url-mtl excludeSearch: true --- diff --git a/content/changelog/2024-09-03-gitlab-components-review-apps.md b/content/changelog/2024/09-03-gitlab-components-review-apps.md similarity index 86% rename from content/changelog/2024-09-03-gitlab-components-review-apps.md rename to content/changelog/2024/09-03-gitlab-components-review-apps.md index 84f47937..7aaf6384 100644 --- a/content/changelog/2024-09-03-gitlab-components-review-apps.md +++ b/content/changelog/2024/09-03-gitlab-components-review-apps.md @@ -12,6 +12,8 @@ authors: link: https://github.com/juliamrch image: https://github.com/juliamrch.png?size=40 description: Simplify your GitLab workflows +aliases: +- /changelog/2024-09-03-gitlab-components-review-apps excludeSearch: true --- @@ -19,4 +21,4 @@ Some months ago, we released [a new GitLab Component](https://gitlab.com/explore **Breaking changes**: Input `deploy` have been removed to prevent users to script the environment variables injection before deploying the app. Remove it from your `.gitlab-ci.yml` file if it's set up, to avoid breaking your pipeline. -- [Learn more about how to deploy from GitLab to Clever Cloud](../../doc/ci-cd/gitlab/) +- [Learn more about how to deploy from GitLab to Clever Cloud](/developers/doc/ci-cd/gitlab/) diff --git a/content/changelog/2024-09-12-clever-tools-3.8.3.md b/content/changelog/2024/09-12-clever-tools-3.8.3.md similarity index 95% rename from content/changelog/2024-09-12-clever-tools-3.8.3.md rename to content/changelog/2024/09-12-clever-tools-3.8.3.md index 9c07d85c..486f9926 100644 --- a/content/changelog/2024-09-12-clever-tools-3.8.3.md +++ b/content/changelog/2024/09-12-clever-tools-3.8.3.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Last minors updates before a big change +aliases: +- /changelog/2024-09-12-clever-tools-3.8.3 excludeSearch: true --- diff --git a/content/changelog/2024-09-12-js-client-9.0.0.md b/content/changelog/2024/09-12-js-client-9.0.0.md similarity index 93% rename from content/changelog/2024-09-12-js-client-9.0.0.md rename to content/changelog/2024/09-12-js-client-9.0.0.md index ba1b4f0b..49d2c39b 100644 --- a/content/changelog/2024-09-12-js-client-9.0.0.md +++ b/content/changelog/2024/09-12-js-client-9.0.0.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: A must have for next packaging of clever tools +aliases: +- /changelog/2024-09-12-js-client-9.0.0 excludeSearch: true --- diff --git a/content/changelog/2024-10-01-materia-kv-ttl-layer-update.md b/content/changelog/2024/10-01-materia-kv-ttl-layer-update.md similarity index 58% rename from content/changelog/2024-10-01-materia-kv-ttl-layer-update.md rename to content/changelog/2024/10-01-materia-kv-ttl-layer-update.md index 8fed706a..f0cea24b 100644 --- a/content/changelog/2024-10-01-materia-kv-ttl-layer-update.md +++ b/content/changelog/2024/10-01-materia-kv-ttl-layer-update.md @@ -9,12 +9,14 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Get ready for more commands and layers soon +aliases: +- /changelog/2024-10-01-materia-kv-ttl-layer-update excludeSearch: true --- -After the first release of our [Materia KV add-on](../../doc/addons/materia-kv), we discussed with users and what they wanted to see in the next version. A major milestone for us was to add support for `TTL` (Time To Live) command, and those related to it such as `EXPIRE`, `PEXPIRE`, `PTTL`, `SET EX`. It's now available and will helps us, for example, to bring Materia KV support to PHP sessions. +After the first release of our [Materia KV add-on](/developers/doc/addons/materia-kv), we discussed with users and what they wanted to see in the next version. A major milestone for us was to add support for `TTL` (Time To Live) command, and those related to it such as `EXPIRE`, `PEXPIRE`, `PTTL`, `SET EX`. It's now available and will helps us, for example, to bring Materia KV support to PHP sessions. -This new release of our Redis API compatible layer brings a new design, helping us to better support more commands in the future. In the meantime, we've retired hash and list commands, to enhance them. They will be back soon. Some others are added, like `CLIENT ID`, `DECRBY`, `INCRBY`,`GETBIT`, `SETBIT`, etc. The full list is available [here](../../doc/addons/materia-kv/#supported-types-and-commands). +This new release of our Redis API compatible layer brings a new design, helping us to better support more commands in the future. In the meantime, we've retired hash and list commands, to enhance them. They will be back soon. Some others are added, like `CLIENT ID`, `DECRBY`, `INCRBY`,`GETBIT`, `SETBIT`, etc. The full list is available [here](/developers/doc/addons/materia-kv/#supported-types-and-commands). If you have any questions or feedback, let's discuss it on our [GitHub Community](https://github.com/CleverCloud/Community/discussions/categories/materia). diff --git a/content/changelog/2024-10-01-python-image-changes.md b/content/changelog/2024/10-01-python-image-changes.md similarity index 84% rename from content/changelog/2024-10-01-python-image-changes.md rename to content/changelog/2024/10-01-python-image-changes.md index f8d979a2..97cf5785 100644 --- a/content/changelog/2024-10-01-python-image-changes.md +++ b/content/changelog/2024/10-01-python-image-changes.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: uv, Python 3.13 and some clean up +aliases: +- /changelog/2024-10-01-python-image-changes excludeSearch: true --- @@ -16,7 +18,7 @@ Python ecosystem is diverse, with lots of legacy versions and practices. But in ## Package management: uv on Clever Cloud -We only support [pip](https://packaging.python.org/en/latest/tutorials/installing-packages/), `requirements.txt` and `setup.py` natively. For some weeks, we've included [uv](https://docs.astral.sh/uv/getting-started/features/) in our Python image to make some tests. Based on Rust, this package and project manager is compliant with existing ecosystem and blazing fast. [It's now a part](/applications/python/#use-uv-as-a-package-manager) of our "Enthusiast tools" initiative and will be updated regularly. Thus, there is no active support for it yet. +We only support [pip](https://packaging.python.org/en/latest/tutorials/installing-packages/), `requirements.txt` and `setup.py` natively. For some weeks, we've included [uv](https://docs.astral.sh/uv/getting-started/features/) in our Python image to make some tests. Based on Rust, this package and project manager is compliant with existing ecosystem and blazing fast. [It's now a part](/developers/doc/applications/python/#use-uv-as-a-package-manager) of our "Enthusiast tools" initiative and will be updated regularly. Thus, there is no active support for it yet. We'll enhance its native support in coming releases of our Python image. @@ -28,9 +30,9 @@ We're in 2024 and Python 2.x still coexists with Python 3.x. As it's always used We'll also get closer to [the official Python release cycle](https://devguide.python.org/versions/#python-release-cycle), which is 5 years of support. Thus, we'll stop using Python 3.7 starting December 1st, 2024. Next year, we'll deprecate Python 3.8 and stop providing it. If an application is asking for a deprecated version, it will use the latest available by default. So, upgrade your `CC_PYTHON_VERSION` towards your needs. -If you need to sideload unsupported Python versions, `uv` [can help you](https://docs.astral.sh/uv/guides/install-python/). You can also deploy your applications through [Docker](../../doc/applications/docker), but you should avoid to use end of life runtime in your applications. +If you need to sideload unsupported Python versions, `uv` [can help you](https://docs.astral.sh/uv/guides/install-python/). You can also deploy your applications through [Docker](/developers/doc/applications/docker), but you should avoid to use end of life runtime in your applications. -* Learn more about [Python on Clever Cloud](../../doc/applications/python/) +* Learn more about [Python on Clever Cloud](/developers/doc/applications/python/) ## What's next? diff --git a/content/changelog/2024-10-04-keycloak-beta-release.md b/content/changelog/2024/10-04-keycloak-beta-release.md similarity index 62% rename from content/changelog/2024-10-04-keycloak-beta-release.md rename to content/changelog/2024/10-04-keycloak-beta-release.md index f7de447a..052453b5 100644 --- a/content/changelog/2024-10-04-keycloak-beta-release.md +++ b/content/changelog/2024/10-04-keycloak-beta-release.md @@ -12,13 +12,15 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Release 26 is coming +aliases: +- /changelog/2024-10-04-keycloak-beta-release excludeSearch: true --- -Clever Cloud's Keycloak add-on, developed with Please Open-it, is now available in public beta. We enhanced user experience, performances and features since [the alpha stage](/changelog/2024-07-17-keycloak-public-release/). We revised the default configuration of underlying resources. We now use a `S flavored` Java application with more memory and a XXS Small Space PostgreSQL database which is enough for low-volume needs. Of course, you can change it according to your needs at any time. +Clever Cloud's Keycloak add-on, developed with Please Open-it, is now available in public beta. We enhanced user experience, performances and features since [the alpha stage](../07-17-keycloak-public-release/). We revised the default configuration of underlying resources. We now use a `S flavored` Java application with more memory and a XXS Small Space PostgreSQL database which is enough for low-volume needs. Of course, you can change it according to your needs at any time. -The default Keycloak version is now 25.0.6. If you want to upgrade, change the `CC_KEYCLOAK_VERSION` environment variable to `25.0.6` and restart the Java application. You can also add the new `CC_METRICS_PROMETHEUS_PATH=/metrics` and `CC_METRICS_PROMETHEUS_PORT=9000`to access metrics [from Grafana](../../doc/metrics/#publish-your-own-metrics). +The default Keycloak version is now 25.0.6. If you want to upgrade, change the `CC_KEYCLOAK_VERSION` environment variable to `25.0.6` and restart the Java application. You can also add the new `CC_METRICS_PROMETHEUS_PATH=/metrics` and `CC_METRICS_PROMETHEUS_PORT=9000`to access metrics [from Grafana](/developers/doc/metrics/#publish-your-own-metrics). We plan to upgrade to [26.x](https://github.com/keycloak/keycloak/releases/tag/26.0.0) in the next few weeks after checking its stability and validating it for our platform. -- [Learn more about Keycloak on Clever Cloud](../../doc/addons/keycloak/) +- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak/) diff --git a/content/changelog/2024-10-07-CVE-2024-47561.md b/content/changelog/2024/10-07-CVE-2024-47561.md similarity index 95% rename from content/changelog/2024-10-07-CVE-2024-47561.md rename to content/changelog/2024/10-07-CVE-2024-47561.md index 94c4a417..f66da9cf 100644 --- a/content/changelog/2024-10-07-CVE-2024-47561.md +++ b/content/changelog/2024/10-07-CVE-2024-47561.md @@ -8,6 +8,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: All our systems are up-to-date +aliases: +- /changelog/2024-10-07-CVE-2024-47561 excludeSearch: true --- diff --git a/content/changelog/2024-10-17-sozu-1.0.5.md b/content/changelog/2024/10-17-sozu-1.0.5.md similarity index 84% rename from content/changelog/2024-10-17-sozu-1.0.5.md rename to content/changelog/2024/10-17-sozu-1.0.5.md index 964a339a..1d716de9 100644 --- a/content/changelog/2024-10-17-sozu-1.0.5.md +++ b/content/changelog/2024/10-17-sozu-1.0.5.md @@ -11,10 +11,12 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: Lots of fixes and improvements before the 1.1.0 release +aliases: +- /changelog/2024-10-17-sozu-1.0.5 excludeSearch: true --- -[Sōzu](https://www.sozu.io) 1.0.5 is now available and deployed on `cleverapps.io` domains, we're progressively rolling it out on our own domains and dedicated load balancers. Since [the release of Sōzu 1.0.2](/changelog/2024-10-04-sozu-1.0.2/) we've fixed some bugs, improved CLI, metrics and performances. +[Sōzu](https://www.sozu.io) 1.0.5 is now available and deployed on `cleverapps.io` domains, we're progressively rolling it out on our own domains and dedicated load balancers. Since [the release of Sōzu 1.0.2](../06-07-sozu-1.0.2) we've fixed some bugs, improved CLI, metrics and performances. We're currently testing the 1.1.0 release candidate of Sōzu, with HTTP/2 support, coming soon on Clever Cloud. diff --git a/content/changelog/2024-10-18-azimutt-available.md b/content/changelog/2024/10-18-azimutt-available.md similarity index 83% rename from content/changelog/2024-10-18-azimutt-available.md rename to content/changelog/2024/10-18-azimutt-available.md index 5df1514e..620b4d70 100644 --- a/content/changelog/2024-10-18-azimutt-available.md +++ b/content/changelog/2024/10-18-azimutt-available.md @@ -12,10 +12,12 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: A new partner enters our Marketplace +aliases: +- /changelog/2024-10-18-azimutt-available excludeSearch: true --- -Azimutt is [an open-source project](https://github.com/azimuttapp/azimutt) we follow for a long time. Created by Loïc Knuchel, it helps you to explore, analyze and manage your database in a pleasant graphical interface. It's a member of the [Clever Cloud startup program](https://www.clever-cloud.com/up-program/), for some weeks and now part of our [Marketplace](../../doc/marketplace/). Thus, you can create an Azimutt account, free or with a subscription, directly [from the Console](https://console.clever-cloud.com). +Azimutt is [an open-source project](https://github.com/azimuttapp/azimutt) we follow for a long time. Created by Loïc Knuchel, it helps you to explore, analyze and manage your database in a pleasant graphical interface. It's a member of the [Clever Cloud startup program](https://www.clever-cloud.com/up-program/), for some weeks and now part of our [Marketplace](/developers/doc/marketplace/). Thus, you can create an Azimutt account, free or with a subscription, directly [from the Console](https://console.clever-cloud.com). You just have to provide a compatible database URI, hosted by Clever Cloud or not, and start exploring it. Our integration is based on a gateway hosted by Clever Cloud. No credentials are shared with Azimutt, and they're kept safely in your browser. diff --git a/content/changelog/2024-10-21-clever-tools-3.9.0.md b/content/changelog/2024/10-21-clever-tools-3.9.0.md similarity index 79% rename from content/changelog/2024-10-21-clever-tools-3.9.0.md rename to content/changelog/2024/10-21-clever-tools-3.9.0.md index c9290315..21b2d6bb 100644 --- a/content/changelog/2024-10-21-clever-tools-3.9.0.md +++ b/content/changelog/2024/10-21-clever-tools-3.9.0.md @@ -12,10 +12,12 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Better manage your apps, lots of new features +aliases: +- /changelog/2024-10-21-clever-tools-3.9.0 excludeSearch: true --- -[Clever Tools 3.9](https://github.com/CleverCloud/clever-tools/releases/tag/3.9.0) is available. It's the first minor release since our [Big Summer Update](/changelog/2024-07-02-clever-tools-3.8.0/). Over the past few months, we've revamped many things under the hood, to clean the code and prepare next big changes we're working on. +[Clever Tools 3.9](https://github.com/CleverCloud/clever-tools/releases/tag/3.9.0) is available. It's the first minor release since our [Big Summer Update](../07-02-clever-tools-3.8.0/). Over the past few months, we've revamped many things under the hood, to clean the code and prepare next big changes we're working on. ## List and diagnose your domains This new version brings two new features to manage domains. First is `clever domain overview`, allowing you to list domains linked to your account, across all the organizations you manage. List only domains containing a specific text string in their name thanks to the `--filter` option. Use the `json` output (`--format`/`-F`) and tools such as [jless](https://jless.io/) to navigate through long lists easily. @@ -31,7 +33,7 @@ The `clever domain diag` command allows you to check domains' configuration for ## Post-creation instructions for add-ons and fixes -This release also provides bug fixes, the token expiry date/time in `clever profile` and a better experience with add-ons like [Keycloak](/doc/addons/keycloak/), [Matomo](../../doc/addons/matomo) or [Metabase](../../doc/addons/metabase/). Once created, you get post-creation instructions such as management/Console URL, temporary credentials and a link to the add-on's documentation. +This release also provides bug fixes, the token expiry date/time in `clever profile` and a better experience with add-ons like [Keycloak](/developers/doc/addons/keycloak/), [Matomo](/developers/doc/addons/matomo) or [Metabase](/developers/doc/addons/metabase/). Once created, you get post-creation instructions such as management/Console URL, temporary credentials and a link to the add-on's documentation. To upgrade Clever Tools, [use your favorite package manager](https://github.com/CleverCloud/clever-tools/blob/master/docs/setup-systems.md#how-to-install-clever-tools). For example with `npm`: diff --git a/content/changelog/2024-10-28-metabase-available.md b/content/changelog/2024/10-28-metabase-available.md similarity index 83% rename from content/changelog/2024-10-28-metabase-available.md rename to content/changelog/2024/10-28-metabase-available.md index 7f857f2b..b8048195 100644 --- a/content/changelog/2024-10-28-metabase-available.md +++ b/content/changelog/2024/10-28-metabase-available.md @@ -12,13 +12,15 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Analyze and explore your data with ease +aliases: +- /changelog/2024-10-28-metabase-available excludeSearch: true --- -After some weeks of testing, the Clever Cloud's Metabase add-on, developed with [David Sferruzza](https://david.sferruzza.fr/), is available in public beta. Thus, you can deploy the service, from [Console](https://console.clever-cloud.com/users/me/addons/new), [API](/api) or [Clever Tools](https://github.com/CleverCloud/clever-tools), and use it in minutes. +After some weeks of testing, the Clever Cloud's Metabase add-on, developed with [David Sferruzza](https://david.sferruzza.fr/), is available in public beta. Thus, you can deploy the service, from [Console](https://console.clever-cloud.com/users/me/addons/new), [API](/developers/api) or [Clever Tools](https://github.com/CleverCloud/clever-tools), and use it in minutes. It's based on a Java application and a PostgreSQL database. Once deployed you'll get a management URL to create an admin account. Then, just start using Metabase, add your data sources, create your questions and dashboards. You'll get benefits from the Clever Cloud's integration, with scalability options, database backups logs, metrics, easy version and upgrade management. Feel free to let us know what you think and ask your questions in [our GitHub Community](https://github.com/CleverCloud/Community/discussions/categories/metabase). -- [Learn more about Metabase on Clever Cloud](/doc/addons/metabase/) +- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/metabase/) diff --git a/content/changelog/2024-10-28-pulsar-4.0.0-update.md b/content/changelog/2024/10-28-pulsar-4.0.0-update.md similarity index 92% rename from content/changelog/2024-10-28-pulsar-4.0.0-update.md rename to content/changelog/2024/10-28-pulsar-4.0.0-update.md index 6062bfed..83362b3f 100644 --- a/content/changelog/2024-10-28-pulsar-4.0.0-update.md +++ b/content/changelog/2024/10-28-pulsar-4.0.0-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: And soon lots of news for Pulsar on Clever Cloud +aliases: +- /changelog/2024-10-28-pulsar-4.0.0-update excludeSearch: true --- diff --git a/content/changelog/2024-11-08-erlang-rust-update.md b/content/changelog/2024/11-08-erlang-rust-update.md similarity index 84% rename from content/changelog/2024-11-08-erlang-rust-update.md rename to content/changelog/2024/11-08-erlang-rust-update.md index 79351a6c..fa6d2432 100644 --- a/content/changelog/2024-11-08-erlang-rust-update.md +++ b/content/changelog/2024/11-08-erlang-rust-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New versions, tools, colors and more +aliases: +- /changelog/2024-11-08-erlang-rust-update excludeSearch: true aliases: - /changelog/2024-11-11-08-erlang-rust-update @@ -28,4 +30,4 @@ We’ve updated Erlang and Rust images. They were deployed without any impact fo * Rust 1.82.0 * libassuan fix -We also started to add [Redirection.io](https://redirection.io) agent in our images with this update, as part of our [Enthusiast Tools initiative](/changelog/2024-10-01-python-image-changes/), and plan to ease its native support in coming releases. \ No newline at end of file +We also started to add [Redirection.io](https://redirection.io) agent in our images with this update, as part of our [Enthusiast Tools initiative](../10-01-python-image-changes/), and plan to ease its native support in coming releases. \ No newline at end of file diff --git a/content/changelog/2024-11-08-mysql-mysql-8.4.0.md b/content/changelog/2024/11-08-mysql-mysql-8.4.0.md similarity index 88% rename from content/changelog/2024-11-08-mysql-mysql-8.4.0.md rename to content/changelog/2024/11-08-mysql-mysql-8.4.0.md index 22ab3918..ce058e70 100644 --- a/content/changelog/2024-11-08-mysql-mysql-8.4.0.md +++ b/content/changelog/2024/11-08-mysql-mysql-8.4.0.md @@ -9,10 +9,12 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Try the new branch now, and discover what's new +aliases: +- /changelog/2024-11-08-mysql-mysql-8.4.0 excludeSearch: true --- MySQL 8.4 is available on Clever Cloud. You can deploy it as a new add-on or migrate existing ones. As this is the first release (8.4.0) of this long term support (LTS) branch for the [Percona Server](https://www.percona.com/mysql/software/percona-server-for-mysql) we use, it's tagged as `early`. That means you should consider it mostly to make some tests and discover what's new. But we recommend [waiting a bit](https://www.percona.com/blog/severe-instability-of-mysql-8-0-38-8-4-1-and-9-0-resolved-in-upcoming-releases/) before using a new branch in production. * [Learn more about MySQL 8.4](https://www.percona.com/blog/mysql-8-4-first-peek/) -* [Learn more about MySQL on Clever Cloud](/doc/addons/mysql/) +* [Learn more about MySQL on Clever Cloud](/developers/doc/addons/mysql/) diff --git a/content/changelog/2024-11-09-java-update.md b/content/changelog/2024/11-09-java-update.md similarity index 94% rename from content/changelog/2024-11-09-java-update.md rename to content/changelog/2024/11-09-java-update.md index 4d3d35e7..3a34cff2 100644 --- a/content/changelog/2024-11-09-java-update.md +++ b/content/changelog/2024/11-09-java-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New versions, tools, colors and more +aliases: +- /changelog/2024-11-09-java-update excludeSearch: true --- diff --git a/content/changelog/2024-11-13-metabase-51-version-warning.md b/content/changelog/2024/11-13-metabase-51-version-warning.md similarity index 85% rename from content/changelog/2024-11-13-metabase-51-version-warning.md rename to content/changelog/2024/11-13-metabase-51-version-warning.md index d18de17f..e45140cd 100644 --- a/content/changelog/2024-11-13-metabase-51-version-warning.md +++ b/content/changelog/2024/11-13-metabase-51-version-warning.md @@ -12,12 +12,14 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: New branch, better update instructions +aliases: +- /changelog/2024-11-13-metabase-51-version-warning excludeSearch: true --- The `x.51` 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.51` for the community edition or `1.51` for the enterprise edition (EE). We also added a warning message in logs if you modify the version to deploy and restart the application without rebuilding it. -- [Learn more about Metabase on Clever Cloud](/doc/addons/metabase/) +- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/metabase/) - [Learn more about Metabase 51](https://www.metabase.com/releases/metabase-51) {{< youtube id="oqoqSiVihdo" >}} diff --git a/content/changelog/2024-11-18-keycloak-26.md b/content/changelog/2024/11-18-keycloak-26.md similarity index 87% rename from content/changelog/2024-11-18-keycloak-26.md rename to content/changelog/2024/11-18-keycloak-26.md index 76475827..11613127 100644 --- a/content/changelog/2024-11-18-keycloak-26.md +++ b/content/changelog/2024/11-18-keycloak-26.md @@ -12,11 +12,13 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Lot of changes, just an environment variable to update +aliases: +- /changelog/2024-11-18-keycloak-26 excludeSearch: true --- The `26` branch of Keycloak is available on Clever Cloud. To update, just set `CC_KEYCLOAK_VERSION` of the add-on's Java application to `26.0.5`. Newly created add-ons come with this release by default and an enhanced `clever-cloud` login theme. -- [Learn more about Keycloak on Clever Cloud](/doc/addons/keycloak/) +- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak/) - [Learn more about Keycloak 26](https://www.keycloak.org/2024/10/keycloak-2600-released.html) - [Latest Keycloak releases](https://github.com/keycloak/keycloak/releases) diff --git a/content/changelog/2024-11-21-eol-warnings-console.md b/content/changelog/2024/11-21-eol-warnings-console.md similarity index 61% rename from content/changelog/2024-11-21-eol-warnings-console.md rename to content/changelog/2024/11-21-eol-warnings-console.md index 804071ee..ef24b35a 100644 --- a/content/changelog/2024-11-21-eol-warnings-console.md +++ b/content/changelog/2024/11-21-eol-warnings-console.md @@ -12,10 +12,12 @@ authors: link: https://github.com/florian-sanders-cc image: https://github.com/florian-sanders-cc.png?size=40 description: Better stay up to date! +aliases: +- /changelog/2024-11-21-eol-warnings-console excludeSearch: true --- -[Earlier this year](/changelog/2024-04-24-php-deprecate-warning/), we started to show warnings in logs when you deploy PHP applications with a `CC_PHP_VERSION` corresponding to a release considered as [end-of-life by PHP community](https://www.php.net/supported-versions.php). Today, we start showing such warnings in the environment variables panel of applications in the Clever Cloud Console for: +[Earlier this year](../04-24-php-deprecate-warning/), we started to show warnings in logs when you deploy PHP applications with a `CC_PHP_VERSION` corresponding to a release considered as [end-of-life by PHP community](https://www.php.net/supported-versions.php). Today, we start showing such warnings in the environment variables panel of applications in the Clever Cloud Console for: - `CC_PHP_VERSION` - `CC_PYTHON_VERSION` - `CC_RUBY_VERSION` diff --git a/content/changelog/2024-11-26-keycloak-26.0.06.md b/content/changelog/2024/11-26-keycloak-26.0.06.md similarity index 88% rename from content/changelog/2024-11-26-keycloak-26.0.06.md rename to content/changelog/2024/11-26-keycloak-26.0.06.md index 989b42f8..10953720 100644 --- a/content/changelog/2024-11-26-keycloak-26.0.06.md +++ b/content/changelog/2024/11-26-keycloak-26.0.06.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Thanks to Clever Cloud, it's easy to upgrade +aliases: +- /changelog/2024-11-26-keycloak-26.0.06 excludeSearch: true --- @@ -19,4 +21,4 @@ The release `26.0.6` of Keycloak is available on Clever Cloud. [It fixes](https: To update, just set `CC_KEYCLOAK_VERSION` of the add-on's Java application to `26.0.6` and rebuild it. -- [Learn more about Keycloak on Clever Cloud](/doc/addons/keycloak/) +- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak) diff --git a/content/changelog/2024-11-27-clever-tools-3.10.md b/content/changelog/2024/11-27-clever-tools-3.10.md similarity index 76% rename from content/changelog/2024-11-27-clever-tools-3.10.md rename to content/changelog/2024/11-27-clever-tools-3.10.md index 2c0eb66f..b0f27b0e 100644 --- a/content/changelog/2024-11-27-clever-tools-3.10.md +++ b/content/changelog/2024/11-27-clever-tools-3.10.md @@ -12,10 +12,12 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Some tiny changes, before the huge ones +aliases: +- /changelog/2024-11-27-clever-tools-3.10 excludeSearch: true --- -[Clever Tools 3.10](https://github.com/CleverCloud/clever-tools/releases/tag/3.10.0) is available. It includes some bug fixes on the `domain` command and supports [plugins activation](/changelog/2024-11-27-elastic-plugins-support/) for Elasticsearch add-ons at creation (supported plugins list [is here](/doc/addons/elastic/#plugins)). For example: +[Clever Tools 3.10](https://github.com/CleverCloud/clever-tools/releases/tag/3.10.0) is available. It includes some bug fixes on the `domain` command and supports [plugins activation](../11-27-elastic-plugins-support/) for Elasticsearch add-ons at creation (supported plugins list [is here](/developers/doc/addons/elastic/#plugins)). For example: ```bash clever addon create es-addon --option plugins=analysis-icu,mapper-murmur3 diff --git a/content/changelog/2024-11-27-elastic-plugins-support.md b/content/changelog/2024/11-27-elastic-plugins-support.md similarity index 60% rename from content/changelog/2024-11-27-elastic-plugins-support.md rename to content/changelog/2024/11-27-elastic-plugins-support.md index ff19c497..df87a515 100644 --- a/content/changelog/2024-11-27-elastic-plugins-support.md +++ b/content/changelog/2024/11-27-elastic-plugins-support.md @@ -12,9 +12,11 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: More flexibility for Elasticsearch add-ons +aliases: +- /changelog/2024-11-27-elastic-plugins-support excludeSearch: true --- -When you create an Elasticsearch add-on, you can now activate plugins through [API](/api) or the `--option` flag of [Clever Tools](https://github.com/CleverCloud/clever-tools/blob/master/docs/addons-backups.md#create--rename--delete). You must pass the option as a comma-separated list: `plugins=plugin1,plugin2`. +When you create an Elasticsearch add-on, you can now activate plugins through [API](/developers/api) or the `--option` flag of [Clever Tools](https://github.com/CleverCloud/clever-tools/blob/master/docs/addons-backups.md#create--rename--delete). You must pass the option as a comma-separated list: `plugins=plugin1,plugin2`. -- Learn more about [Elasticsearch plugins support on Clever Cloud](/doc/addons/elastic/#plugins) +- Learn more about [Elasticsearch plugins support on Clever Cloud](/developers/doc/addons/elastic/#plugins) diff --git a/content/changelog/2024-11-28-kv-explorer-available.md b/content/changelog/2024/11-28-kv-explorer-available.md similarity index 87% rename from content/changelog/2024-11-28-kv-explorer-available.md rename to content/changelog/2024/11-28-kv-explorer-available.md index 793c8d71..4fe17ae6 100644 --- a/content/changelog/2024-11-28-kv-explorer-available.md +++ b/content/changelog/2024/11-28-kv-explorer-available.md @@ -12,6 +12,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Lot of changes, just an environment variable to update +aliases: +- /changelog/2024-11-28-kv-explorer-available excludeSearch: true --- @@ -19,11 +21,11 @@ Since we've launched [Materia KV](https://www.clever-cloud.com/materia/materia-k To use it, just open the `KV Explorer` tab of any compatible add-on, it's part of the Clever Cloud experience. This first public iteration supports hash, list, set and string data types, only strings for Materia KV add-ons as other types are yet to come. -![landscape](/images/doc/kv-explorer.webp "The KV Explorer tool in the Console") +![KV Explorer](/images/doc/kv-explorer.webp "The KV Explorer tool in the Console") You can filter keys by type, with a filter (`*value_to_search*` for example), value text fields are multi-lines, and you can copy/paste values directly from the interface. As usual, we've worked on keyboard shortcuts and accessibility. At the bottom, the KV Explorer Terminal allows you to type any command you want as you would do in a CLI client. It works the same, you type a command, press Enter, and you get the result (yes, also when you type `FLUSHDB` or `FLUSHALL`, so be careful). Of course, we'll continue to improve this tool, over the coming months, thanks to your feedback and suggestions. So feel free to share them and ask your questions in our [GitHub Community](https://github.com/CleverCloud/Community/discussions/categories/kv-explorer). -- [Learn more about Materia KV](/doc/addons/materia-kv/) -- [Learn more about Redis® on Clever Cloud](/doc/addons/redis/) +- [Learn more about Materia KV](/developers/doc/addons/materia-kv/) +- [Learn more about Redis® on Clever Cloud](/developers/doc/addons/redis/) diff --git a/content/changelog/2024-12-04-otoroshi-available.md b/content/changelog/2024/12-04-otoroshi-available.md similarity index 90% rename from content/changelog/2024-12-04-otoroshi-available.md rename to content/changelog/2024/12-04-otoroshi-available.md index 5ed364bc..721d4c5e 100644 --- a/content/changelog/2024-12-04-otoroshi-available.md +++ b/content/changelog/2024/12-04-otoroshi-available.md @@ -12,10 +12,12 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Make the AI enterprise-grade +aliases: +- /changelog/2024-12-04-otoroshi-available excludeSearch: true --- -After some weeks of testing, the Clever Cloud's Otoroshi with LLM add-on, is available in public beta. Thus, you can deploy the service, from [Console](https://console.clever-cloud.com/users/me/addons/new), [API](/api) or [Clever Tools](https://github.com/CleverCloud/clever-tools), and use it in minutes. +After some weeks of testing, the Clever Cloud's Otoroshi with LLM add-on, is available in public beta. Thus, you can deploy the service, from [Console](https://console.clever-cloud.com/users/me/addons/new), [API](/developers/api) or [Clever Tools](https://github.com/CleverCloud/clever-tools), and use it in minutes. We developed this product with its creator and core developer: [Mathieu Ancelin](https://github.com/mathieuancelin) from [Cloud APIM](https://www.cloud-apim.com/). Otoroshi is an open source reverse proxy that allows you to create your own routes, manage authentication, authorization, and rate limiting. It helps you to expose services with enterprise needs in mind, as you can manage organizations, teams, service groups, with event management, data export, multiple secret stores support, etc. And it can be managed from a web interface or [as an API](https://maif.github.io/otoroshi/manual/api.html). @@ -26,5 +28,5 @@ All this with a unique interface, adding token management, rate limit, context, It's based on a Java application and a Redis® database. Once deployed you'll get a management URL with credentials. Want to learn more? Feel free to let us know what you think and ask your questions in [our GitHub Community](https://github.com/CleverCloud/Community/discussions/categories/otoroshi). - [Learn more about Otoroshi](https://maif.github.io/otoroshi/manual/how-to-s/index.html) -- [Learn more about Otoroshi with LLM on Clever Cloud](/doc/addons/otoroshi/) +- [Learn more about Otoroshi with LLM on Clever Cloud](/developers/doc/addons/otoroshi/) - [Otoroshi LLM extension video tutorials](https://www.youtube.com/watch?v=M8PbydxPw4A&list=PLNHaf5rXAx3FWk7dn2fKGwQXxeLCPhZCh) diff --git a/content/changelog/2024-12-12-python-3.13-update.md b/content/changelog/2024/12-12-python-3.13-update.md similarity index 67% rename from content/changelog/2024-12-12-python-3.13-update.md rename to content/changelog/2024/12-12-python-3.13-update.md index b9baed41..50cd6c46 100644 --- a/content/changelog/2024-12-12-python-3.13-update.md +++ b/content/changelog/2024/12-12-python-3.13-update.md @@ -9,6 +9,8 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Newer Python and more tools +aliases: +- /changelog/2024-12-12-python-3.13-update excludeSearch: true --- @@ -20,4 +22,4 @@ We deployed an updated Python image with no impact for our users. * Python 3.13 support * Python 3.7 withdrawal -You can now use `3.13` as `CC_PYTHON_VERSION` environment variable. This version will also be used as default value. As announced [in October]({{< ref "/changelog/2024-10-01-python-image-changes" >}} "Python Changes on 10-2014"), Python 3.7 is not supported anymore. However, you can use `uv` to [install or use Python 3.7](https://docs.astral.sh/uv/guides/install-python/#installing-a-specific-version). \ No newline at end of file +You can now use `3.13` as `CC_PYTHON_VERSION` environment variable. This version will also be used as default value. As announced [in October](../10-01-python-image-changes), Python 3.7 is not supported anymore. However, you can use `uv` to [install or use Python 3.7](https://docs.astral.sh/uv/guides/install-python/#installing-a-specific-version). \ No newline at end of file diff --git a/content/changelog/2024-12-18-clever-tools-3.11.md b/content/changelog/2024/12-18-clever-tools-3.11.md similarity index 96% rename from content/changelog/2024-12-18-clever-tools-3.11.md rename to content/changelog/2024/12-18-clever-tools-3.11.md index 13e9322f..bd0fe362 100644 --- a/content/changelog/2024-12-18-clever-tools-3.11.md +++ b/content/changelog/2024/12-18-clever-tools-3.11.md @@ -12,6 +12,8 @@ authors: link: https://github.com/hsablonniere image: https://github.com/hsablonniere.png?size=40 description: Some tiny changes, before the huge ones +aliases: +- /changelog/2024-12-18-clever-tools-3.11 excludeSearch: true --- diff --git a/content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md b/content/changelog/2024/12-24-terraform-0.5-Keycloak-Metabase.md similarity index 68% rename from content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md rename to content/changelog/2024/12-24-terraform-0.5-Keycloak-Metabase.md index 430cf5f9..08d3d929 100644 --- a/content/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md +++ b/content/changelog/2024/12-24-terraform-0.5-Keycloak-Metabase.md @@ -12,9 +12,11 @@ authors: link: https://github.com/miton18 image: https://github.com/miton18.png?size=40 description: Your favorite services as code +aliases: +- /developers/changelog/2024-12-24-terraform-0.5-Keycloak-Metabase.md excludeSearch: true --- -You can now deploy [Keycloak](../doc/addons/keycloak) and [Metabase](../doc/addons/metabase) add-ons using our Terraform provider, compatible with OpenTofu. +You can now deploy [Keycloak](/developers/doc/addons/keycloak) and [Metabase](/developers/doc/addons/metabase) add-ons using our Terraform provider, compatible with OpenTofu. * Learn more about [our Terraform provider](https://registry.terraform.io/providers/CleverCloud/clevercloud/latest/docs) diff --git a/content/changelog/2025-01-06-sozu-1.0.6.md b/content/changelog/2025/01-06-sozu-1.0.6.md similarity index 65% rename from content/changelog/2025-01-06-sozu-1.0.6.md rename to content/changelog/2025/01-06-sozu-1.0.6.md index 06aefc96..4826b405 100644 --- a/content/changelog/2025-01-06-sozu-1.0.6.md +++ b/content/changelog/2025/01-06-sozu-1.0.6.md @@ -11,9 +11,11 @@ authors: link: https://github.com/FlorentinDUBOIS image: https://github.com/FlorentinDUBOIS.png?size=40 description: Next to come, HTTP/2! +aliases: +- /changelog/2025-01-06-sozu-1.0.6 excludeSearch: true --- -[Sōzu](https://www.sozu.io) 1.0.6 is now available and deployed on all our shared and dedicated load balancers. It comes with a fix for a TLS bug we encountered with [Metabase](../doc/addons/metabase) instances in some cases. We've also overhauled the custom pages for 4xx and 5xx errors. They now display a better designed and more detailed message. +[Sōzu](https://www.sozu.io) 1.0.6 is now available and deployed on all our shared and dedicated load balancers. It comes with a fix for a TLS bug we encountered with [Metabase](/developers/doc/addons/metabase) instances in some cases. We've also overhauled the custom pages for 4xx and 5xx errors. They now display a better designed and more detailed message. -* Learn more about [Sōzu new releases](https://github.com/sozu-proxy/sozu/releases) {{< icon "github" >}} \ No newline at end of file +* Learn more about [Sōzu new releases](https://github.com/sozu-proxy/sozu/releases) {{< icon "github" >}} From 9f9c851a664e628937cfd3599c77c09351c6c3ee Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 16 Jan 2025 15:58:07 +0100 Subject: [PATCH 21/36] fix: Metabase 52 changelog after reorg --- .../12-05-metabase-52.md} | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) rename content/changelog/{2024-12-05-metabase-52.md => 2024/12-05-metabase-52.md} (77%) diff --git a/content/changelog/2024-12-05-metabase-52.md b/content/changelog/2024/12-05-metabase-52.md similarity index 77% rename from content/changelog/2024-12-05-metabase-52.md rename to content/changelog/2024/12-05-metabase-52.md index 561e86b7..da8d5417 100644 --- a/content/changelog/2024-12-05-metabase-52.md +++ b/content/changelog/2024/12-05-metabase-52.md @@ -12,12 +12,14 @@ authors: link: https://github.com/davlgd image: https://github.com/davlgd.png?size=40 description: Faster, with more features +aliases: +- /changelog/2024-12-05-metabase-52 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) +- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/metabase/) +- [Learn more about Metabase 52](https://www.metabase.com/releases/metabase-52) {{< youtube id="h4xKT3MkLj0" >}} From 6c8704346ed3e25409157ca417a882fdf3e6606c Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 16 Jan 2025 18:13:46 +0100 Subject: [PATCH 22/36] changelog: Node 22 LTS image, with mise and redirection.io easy setup --- .../2025/01-15-node-22-lts-image-update.md | 35 +++++++++++++++++++ .../reference-environment-variables.md | 17 +++++++++ 2 files changed, 52 insertions(+) create mode 100644 content/changelog/2025/01-15-node-22-lts-image-update.md diff --git a/content/changelog/2025/01-15-node-22-lts-image-update.md b/content/changelog/2025/01-15-node-22-lts-image-update.md new file mode 100644 index 00000000..02d33d69 --- /dev/null +++ b/content/changelog/2025/01-15-node-22-lts-image-update.md @@ -0,0 +1,35 @@ +--- +title: "Node.js image update, with Mise package manager and Redirection.io easy setup" +date: 2025-01-15 +tags: + - images + - update +authors: + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 +description: Ease your life on Clever Cloud +excludeSearch: true +--- + +We deployed an updated Node.js image with no impact for our users. It uses `22.13 LTS` release by default and Linux Kernel `6.12.9`. + +## Mise package manager + +It's the first image to include the [Mise package manager](https://mise.jdx.dev/), allowing you to install and manage many developer tools, environment variables, secrets, aliases, tasks, hooks through commands or a configuration file. It's compatible with [asdf ecosystem](https://mise.jdx.dev/dev-tools/comparison-to-asdf.html). + +* Learn more about [Mise](https://mise.jdx.dev/) + +## Redirection.io easy setup + +This image is also the first to include [Redirection.io](https://redirection.io/) easy setup. To configure the agent as a proxy, you just need to create an app listening on the port of your choice, get a project key from Redirection.io and set these environment variables: + +- `CC_ENABLE_REDIRECTIONIO=true` +- `CC_REDIRECTIONIO_PROJECT_KEY=""`: The Redirection.io project key +- `CC_REDIRECTIONIO_FORWARD_PORT=""`: The listening port of your application + +The Redirection.io agent will start as a service, listen to `8080` port and forward the traffic to your application. An optional `CC_REDIRECTIONIO_INSTANCE_NAME` is also available. It's the name of your application by default. + +These environment variables will progressively be available on all our compatible images. + +- [Clever Cloud Environment Variables Reference](/developers/doc/reference/reference-environment-variables/) diff --git a/content/doc/reference/reference-environment-variables.md b/content/doc/reference/reference-environment-variables.md index afeaa8fb..90de8fbe 100644 --- a/content/doc/reference/reference-environment-variables.md +++ b/content/doc/reference/reference-environment-variables.md @@ -99,6 +99,23 @@ Use these to define [commands to run]({{< ref "doc/develop/build-hooks.md" >}}) |[`CC_VARNISH_STORAGE_SIZE`](../../administrate/cache "Cache") | Configure the size of the Varnish cache. | 1G | |[`CC_WORKER_COMMAND`](../../develop/workers "Workers") | Command to run in background as a worker process. You can run multiple workers. | | +### Redirection.io support + +[Redirection.io](https://redirection.io) can help reduce HTTP traffic issues on your website. It gives a complete control on how HTTP requests are handled, which helps make it SEO-friendly. It can perform redirections and comes with lots of features. You can link any application to a Redirection.io project easily, setting up the proxy mode with following environment variables: + +| Name | Description | Default value | +|-----------------------|------------------------------|--------------------------------| +|`CC_ENABLE_REDIRECTIONIO` | Enable Redirection.io support | false | +|`CC_REDIRECTIONIO_PROJECT_KEY` | The Redirection.io project key | | +|`CC_REDIRECTIONIO_FORWARD_PORT` | The listening port of your application | | +|`CC_REDIRECTIONIO_INSTANCE_NAME` | The name of your application (optional) | | + +The Redirection.io agent will start as a service, listen to `8080` port and forward the traffic to your application port. + +{{< callout type="info" >}} + Redirection.io easy setup is available in the Node.js runtime and will progressively be available on all our compatible images. +{{< /callout >}} + ### Tailscale support [Tailscale](https://tailscale.com/) is a managed VPN service based on Wireguard that enable private networking between users, devices or machines. Clever Cloud provides a native integration of Tailscale, by mounting a VPN endpoint for each of your application's instances. From 229d1712312fbedaa12b314adcd4552b1b04126e Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Mon, 20 Jan 2025 18:58:23 +0900 Subject: [PATCH 23/36] fix: 404 images urls --- content/doc/addons/jenkins.md | 12 ++++++------ content/doc/quickstart/_index.md | 2 +- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/content/doc/addons/jenkins.md b/content/doc/addons/jenkins.md index 272502fd..bc199113 100644 --- a/content/doc/addons/jenkins.md +++ b/content/doc/addons/jenkins.md @@ -21,7 +21,7 @@ You can find out more about Jenkins on [their website](https://www.jenkins.io). Jenkins on Clever Cloud will allow your team to effortlessly setup CI/CD pipelines, executed on runners that deploy on Clever Cloud docker applications. This way, you will only pay for the CI/CD you really consume, to the second. You will also be able to access Jenkins interface by using the Clever Cloud SSO (Single Sign-On) Authentication. -{{< image "/images/jenkins/full-dashboard.png" "Jenkins Dashboard" >}} +{{< image "/developers/images/jenkins/full-dashboard.png" "Jenkins Dashboard" >}} ## Create Jenkins add-on @@ -92,7 +92,7 @@ Let's configure a runner template for Java Maven projects: - Set the docker image your jobs will use. For example `jenkins/jnlp-agent-maven`. Be sure to read the [section about Docker image requiremetns](#docker-image-requirements). - Select the virtual machine size you need. For Java projects, let's use a M instance that has 4 vCPUs and 8 GiB of RAM. -{{< image "/images/jenkins/cloud-configuration.png" "Jenkins Cloud configuration" >}} +{{< image "/developers/images/jenkins/cloud-configuration.png" "Jenkins Cloud configuration" >}} Once you configured everything, click on `Save` at the end. You should now have a runner template ready for Java Maven projects. @@ -153,12 +153,12 @@ sleep 60 Now that the job is configured, we can start it by clicking on the `Build now` button in the left menu. A message saying that the build has been scheduled should be printed. You should also see after a few seconds a pending Job in the `Build history`, on your left. -{{< image "/images/jenkins/jobs-history.png" "Jenkins jobs history" >}} +{{< image "/developers/images/jenkins/jobs-history.png" "Jenkins jobs history" >}} At the same time, a new application should have been created in your organization, named `Jenkins agent `. The application should be deploying and once it gets deployed, the job will start to be executed. -{{< image "/images/jenkins/runner-deploying.png" "Jenkins runner deploying" >}} +{{< image "/developers/images/jenkins/runner-deploying.png" "Jenkins runner deploying" >}} At some point the application should have deployed and you should be able to click on the Job's number in the `build history` list. From there, you can open the `Console Output` which is basically your job logs. @@ -242,7 +242,7 @@ it will be displayed as a notification and as a message in the `Manage Jenkins` The Clever Cloud Jenkins dashboard also has an item informing you about available Jenkins updates. -{{< image "/images/jenkins/update-available-cc-dashboard.png" "Jenkins update available" >}} +{{< image "/developers/images/jenkins/update-available-cc-dashboard.png" "Jenkins update available" >}} After Jenkins or some plugins were updated, Jenkins will need to restart. @@ -250,7 +250,7 @@ After Jenkins or some plugins were updated, Jenkins will need to restart. To update Jenkins, you can go into the `Manage Jenkins` administration page. If an update is available, it should ask you if you want to install it with a message looking like this: -{{< image "/images/jenkins/update-available.png" "Jenkins update message" >}} +{{< image "/developers/images/jenkins/update-available.png" "Jenkins update message" >}} You can then click on the `Or upgrade automatically` button. It should start downloading and installing the update. You can enable the option `Restart Jenkins when installation is complete and no jobs are running` and Jenkins will restart automatically. After a few minutes, it should be available again. diff --git a/content/doc/quickstart/_index.md b/content/doc/quickstart/_index.md index 8c69e37a..e46d49ea 100644 --- a/content/doc/quickstart/_index.md +++ b/content/doc/quickstart/_index.md @@ -172,7 +172,7 @@ git push :master {{< tab >}} Once you have created your application with GitHub, each push on the `master` branch trigger a deployment. To deploy an other branch than `master`, go to the `information` panel of your application and select the default branch to use. - {{< image "/images/github-deployment-branch.png" "Github deployment branch select" >}} + {{< image "/developers/images/doc/github-deployment-branch.png" "Github deployment branch select" >}} If you don't find your repository in the list fetched from GitHub, a workaround is to unlink your account in your profile here : , remove **Clever Cloud API** from your GitHub [Authorized OAuth Apps](https://github.com/settings../applications) and link again your GitHub account to your Clever Cloud account. From aeb33afe99ad9c718887a8f277082ad1c5d69ec8 Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Tue, 21 Jan 2025 23:00:14 +0900 Subject: [PATCH 24/36] doc: troubleshooting sozu default timeouts (#502) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR New section in the doc to inform users about default timeouts (often asked on the Support chat) and ways to eventually bypass them. ## Checklist - [x] My PR is related to an opened issue : #223 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --------- Co-authored-by: Eloi Démolis <43861898+Wonshtrum@users.noreply.github.com> --- .../styles/config/vocabularies/Doc/accept.txt | 1 + content/doc/find-help/troubleshooting.md | 27 ++++++++++++++++--- 2 files changed, 25 insertions(+), 3 deletions(-) diff --git a/.github/styles/config/vocabularies/Doc/accept.txt b/.github/styles/config/vocabularies/Doc/accept.txt index 3312a011..a0aebdc1 100644 --- a/.github/styles/config/vocabularies/Doc/accept.txt +++ b/.github/styles/config/vocabularies/Doc/accept.txt @@ -29,6 +29,7 @@ Gemfile Glassfish Gradle gradle +Grafana healthcheck Heptapod Hextra diff --git a/content/doc/find-help/troubleshooting.md b/content/doc/find-help/troubleshooting.md index edc7888a..bf07d355 100644 --- a/content/doc/find-help/troubleshooting.md +++ b/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" %}} From 63e323c2b4b721361ea14c64c4ece5d006bbc866 Mon Sep 17 00:00:00 2001 From: Corentin BARAULT <74433435+Kirbeerus@users.noreply.github.com> Date: Tue, 21 Jan 2025 17:24:16 +0100 Subject: [PATCH 25/36] Add Migration explanation to add-on doc (#497) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Describe your PR I added a shortcodes to explain how to upgrade to a higher plan and how migration work. The shortcodes has been added to MySQL, PG, Redis and MongoDB Also explained how migrating to the same plan allow to redeploy add-on on an instances with the most recent patch. ## Checklist - [x] 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: David Legrand <1110600+davlgd@users.noreply.github.com> Co-authored-by: Clément Nivolle --- content/doc/addons/mongodb/_index.md | 2 ++ content/doc/addons/mysql/_index.md | 2 ++ content/doc/addons/postgresql/_index.md | 2 ++ content/doc/addons/redis.md | 2 ++ layouts/shortcodes/content/dbMigration.md | 10 ++++++++++ 5 files changed, 18 insertions(+) create mode 100644 layouts/shortcodes/content/dbMigration.md diff --git a/content/doc/addons/mongodb/_index.md b/content/doc/addons/mongodb/_index.md index afb8ea4c..edf8e570 100644 --- a/content/doc/addons/mongodb/_index.md +++ b/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. diff --git a/content/doc/addons/mysql/_index.md b/content/doc/addons/mysql/_index.md index 551be715..da5788cc 100644 --- a/content/doc/addons/mysql/_index.md +++ b/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">}} diff --git a/content/doc/addons/postgresql/_index.md b/content/doc/addons/postgresql/_index.md index 6c2be641..50e606d2 100644 --- a/content/doc/addons/postgresql/_index.md +++ b/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. diff --git a/content/doc/addons/redis.md b/content/doc/addons/redis.md index ce08ce47..5f6e05e8 100644 --- a/content/doc/addons/redis.md +++ b/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 diff --git a/layouts/shortcodes/content/dbMigration.md b/layouts/shortcodes/content/dbMigration.md new file mode 100644 index 00000000..dc7d8c54 --- /dev/null +++ b/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/) From 546f469790a097eadec6d7ac9cbcb42722b1c5d1 Mon Sep 17 00:00:00 2001 From: "Pierre L. / Peyo" <166715564+PLhuillery@users.noreply.github.com> Date: Tue, 21 Jan 2025 17:36:30 +0100 Subject: [PATCH 26/36] Deleted dead link in Docker (#503) ## Describe your PR Deleted a dead link that used to point to a Haskell dockerized example. ## Checklist - [x] My PR is related to an opened issue : #494 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers --- content/doc/applications/docker/_index.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/doc/applications/docker/_index.md b/content/doc/applications/docker/_index.md index 1dea4e8e..45f01311 100644 --- a/content/doc/applications/docker/_index.md +++ b/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) From 414942f951aac4a348737eedaa11a493205878df Mon Sep 17 00:00:00 2001 From: David Legrand <1110600+davlgd@users.noreply.github.com> Date: Wed, 22 Jan 2025 11:02:48 +0100 Subject: [PATCH 27/36] fix: feature image URL (#501) ## Describe your PR Fix the URL of the feature image (shared on social networks) after domain update Co-authored-by: Julia March <101819212+juliamrch@users.noreply.github.com> --- hugo.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo.yaml b/hugo.yaml index c5c36d1f..5db18f8b 100644 --- a/hugo.yaml +++ b/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 From 5a2a017175a119a808fca33231f99e0c4ae874af Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 23 Jan 2025 19:10:10 +0100 Subject: [PATCH 28/36] fix: Java EOL source --- data/runtime_versions.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/data/runtime_versions.yml b/data/runtime_versions.yml index 7ae06583..8695a9ee 100644 --- a/data/runtime_versions.yml +++ b/data/runtime_versions.yml @@ -50,7 +50,7 @@ elixir: - "1.15" - "1.16" java: - eol_source: "https://www.oracle.com/fr/java/technologies/java-se-support-roadmap.html" + eol_source: "https://adoptium.net/fr/support/" default: - "11" accepted: From ccb5cd2db3dcb426b909b04a816be15c5c1a1ddf Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 23 Jan 2025 19:48:55 +0100 Subject: [PATCH 29/36] Elixir: 1.18 as default, 1.13 EOL --- content/doc/reference/reference-environment-variables.md | 2 +- data/runtime_versions.yml | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/content/doc/reference/reference-environment-variables.md b/content/doc/reference/reference-environment-variables.md index 90de8fbe..01cbd4af 100644 --- a/content/doc/reference/reference-environment-variables.md +++ b/content/doc/reference/reference-environment-variables.md @@ -166,7 +166,7 @@ If `TAILSCALE_LOGIN_SERVER` is provided, the agent will be configured to reach a | Name | Description | Default value | |-----------------------|------------------------------|--------------------------------| - |`CC_ELIXIR_VERSION` | Choose the Elixir version between `1.8`, `1.9`, `1.10`, `1.11`, `1.12`, `1.13`, `1.14`, `1.15` or `1.16` | 1.16 | + |`CC_ELIXIR_VERSION` | Choose the Elixir version among [those supported](/developers/doc/applications/elixir/#mandatory-configuration) | | |`CC_MIX_BUILD_GOAL` | The mix goal to build the application (default compile) | | |`CC_PHOENIX_ASSETS_DIR` | Folder in which your Phoenix assets are located. | | |`CC_PHOENIX_DIGEST_GOAL` | Phoenix digest goal. | phx.digest | diff --git a/data/runtime_versions.yml b/data/runtime_versions.yml index 8695a9ee..09ec90b4 100644 --- a/data/runtime_versions.yml +++ b/data/runtime_versions.yml @@ -38,17 +38,18 @@ dotnet: elixir: eol_source: "https://hexdocs.pm/elixir/compatibility-and-deprecations.html" default: - - "1.17" + - "1.18" accepted: - "1.8 (EOL)" - "1.9 (EOL)" - "1.10 (EOL)" - "1.11 (EOL)" - "1.12 (EOL)" - - "1.13" + - "1.13 (EOL)" - "1.14" - "1.15" - "1.16" + - "1.17" java: eol_source: "https://adoptium.net/fr/support/" default: From 03145b1314d3cb36956b60b1c8209e4b0dbed661 Mon Sep 17 00:00:00 2001 From: David Legrand Date: Thu, 23 Jan 2025 19:49:17 +0100 Subject: [PATCH 30/36] changelog: Elixir 1.18 --- .../2025/01-22-elixir-1.18-image-update.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 content/changelog/2025/01-22-elixir-1.18-image-update.md diff --git a/content/changelog/2025/01-22-elixir-1.18-image-update.md b/content/changelog/2025/01-22-elixir-1.18-image-update.md new file mode 100644 index 00000000..f2ad242d --- /dev/null +++ b/content/changelog/2025/01-22-elixir-1.18-image-update.md @@ -0,0 +1,15 @@ +--- +title: "Elixir 1.18 is available" +date: 2025-01-22 +tags: + - images + - update +authors: + - name: David Legrand + link: https://github.com/davlgd + image: https://github.com/davlgd.png?size=40 +description: Elixir 1.13 is now end-of-life +excludeSearch: true +--- + +We deployed an updated Elixir image with no impact for our users. It uses `1.18` release by default and Linux Kernel `6.12.9`. From cb7f4683c0ed91907a92ccc1de6b9766712140fa Mon Sep 17 00:00:00 2001 From: Rachel-nas <77396432+Rachel-nas@users.noreply.github.com> Date: Mon, 27 Jan 2025 15:36:28 +0100 Subject: [PATCH 31/36] typo correction in networking and IP adresses ranges (#512) ## Describe your PR _I just fixed the oven by two, because there are no longer 4 but 2 IP ranges_ ## 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: Rachel Nascimento --- content/doc/administrate/network.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/doc/administrate/network.md b/content/doc/administrate/network.md index 27977811..a4f7ac1f 100644 --- a/content/doc/administrate/network.md +++ b/content/doc/administrate/network.md @@ -55,7 +55,7 @@ If you are interested, please ask the support / your sales contact for a quote. The Paris region is owned and handled by Clever Cloud. We own or entrust the associated AS's and IP addresses ranges. -Here are the current four addresses ranges your application may have an outgoing IP in: +Here are the current two addresses ranges your application may have an outgoing IP in: - 91.208.207.0/24 - 185.133.116.0/22 From 9e53d56e736458478283f72fc836f0036dc6445b Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Mon, 27 Jan 2025 21:46:28 +0900 Subject: [PATCH 32/36] Update external-doc-update.yml --- .github/workflows/external-doc-update.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/workflows/external-doc-update.yml b/.github/workflows/external-doc-update.yml index 68e351b7..7fe7a04d 100644 --- a/.github/workflows/external-doc-update.yml +++ b/.github/workflows/external-doc-update.yml @@ -31,6 +31,7 @@ jobs: with: files: | content/guides/astro.md + context/guides/nuxt.md # Create issue and assign PR author - name: Create issue From bbc0c093e3aa34653cc83875a2d6dae8a94b7ab0 Mon Sep 17 00:00:00 2001 From: Stanislav Sauvin Date: Fri, 24 Jan 2025 16:52:38 +0100 Subject: [PATCH 33/36] Add SSH/SFTP public keys for FSBucket addons --- content/doc/addons/fs-bucket.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/content/doc/addons/fs-bucket.md b/content/doc/addons/fs-bucket.md index eb414cb0..54d9612c 100644 --- a/content/doc/addons/fs-bucket.md +++ b/content/doc/addons/fs-bucket.md @@ -119,6 +119,35 @@ variable, see [special environment variables]({{< ref "doc/develop/env-variables The **File explorer** tab of the **add-on dashboard** gives you access to your files in the FS bucket. +### From your favorite SFTP client + +The **Add-on information** tab of your FS Bucket in [Clever Cloud Console](https://console.clever-cloud.com) displays information you need to connect using SSH File Transfer Protocol (SFTP). You can use the following SSH public keys to ensure the connection is authentic and trusted: + +| Algorithm | Key size | Fingerprint | +|-----------|----------|----------------------------------------------------| +| ED25519 | 256 | `SHA256:+ku6hhQb1O3OVzkZa2B+htPD+P+5K/X6QQYWXym/4Zo` | +| ED25519 | 256 | `SHA256:8tZzRvA3Fh9poG7g1bu8m0LQS819UBh7AYcEXJYiPqw` | +| ED25519 | 256 | `SHA256:HHGCP5cf0jQbQrIRXjiC9aYJGNQ+L9ijOmJUueLp+9A` | +| ED25519 | 256 | `SHA256:Hyt6ox+v2Lrvdfl29jwe1/dBq9zh2fmq2DO6rqurl7o` | +| ED25519 | 256 | `SHA256:drShQbl3Ox+sYYYP+urOCtuMiJFh7k1kECdvZ4hMuAE` | +| ED25519 | 256 | `SHA256:h1oUNRkYaIycchUsyAXPQHnu6MtTF2YUEYuisu+vnOE` | +| RSA | 4096 | `SHA256:+550bmBCNAHscjOmKrdweueVUz2E6h1KzmSV+0c0U7w` | +| RSA | 4096 | `SHA256:1O7d6cdmqj42Dw4nX90Y+6zIFTUI+aIwD0SLMQuj0ko` | +| RSA | 4096 | `SHA256:AkHQnQXJ1lFEtliLHl8hlG7NiIZZgVn/uuRMCZJOKJk` | +| RSA | 4096 | `SHA256:Atxhx7U0MOuZC7e4vs1tpyTJmNttB7d4+HNC5hiavFo` | +| RSA | 4096 | `SHA256:Bla7GeL6hggg+rf6iDlKMrzIhxEBYB3VL7Q6PYGJYt4` | +| RSA | 4096 | `SHA256:H5ZhQ/5JdMPSG49ojUNEhwSuRD663mnIJb/YDFFntyk` | +| RSA | 4096 | `SHA256:TZr6eFrzoJmn4RS55Tb6yTd+WV9lTGtW0q+uLVbI7IE` | +| RSA | 4096 | `SHA256:ZYFb1AsB+q++NRf7yW8E5rNOfxTRwjpJt6hqFP/NBNs` | +| RSA | 4096 | `SHA256:d+nTyowvYtcxF28mCUu1ilqPJuLMExGyJ16Sv/pvoVY` | +| RSA | 4096 | `SHA256:flpv4s3VxOrQFc/IG+BpR1s9dgDvR07A6zunNqO4Co0` | +| RSA | 4096 | `SHA256:hvZN8rgSG82weLOeMTXdh1VwhjuRv+MJNnUt/X9R39g` | +| RSA | 4096 | `SHA256:ls20B8C6Jdqx7RPQAjzVX7KmnrHizJum2sEvNhMcl60` | +| RSA | 4096 | `SHA256:u1AzFc2AdFmlPRdNIZsn0sQJ/CKbfC2ZmXnQfabPek4` | +| RSA | 4096 | `SHA256:wUPBX3X5gALgxXqD+IwG5qPRb0jbiOZ8/U1BOZeNhtk` | +| RSA | 4096 | `SHA256:yRHC/tAlBpHLlRZ5rwbZ1z+159Bj3yg0VxHf+hXINLg` | +| RSA | 4096 | `SHA256:yhn79aqxOGQZ+LXdN1/vIY+jwRIbBamlVT1+HdFoA6o` | + ### From your favorite FTP client The **Add-on information** tab of your FS Bucket add-on displays the information From c88aa1b639684a371f7dd3ac6f38f9cfa3c9ac66 Mon Sep 17 00:00:00 2001 From: Corentin BARAULT <74433435+Kirbeerus@users.noreply.github.com> Date: Tue, 28 Jan 2025 17:16:57 +0100 Subject: [PATCH 34/36] Add prerender.io to Static doc (#491) ## Describe your PR Some client may want to prerender there SPA application to have better SEO. One of the way to do it is by using prerender.io Added a part in the documentation to talk about how to do it on Clever Cloud. You can check if prerender.io work correctly on your app by using this guide. https://docs.prerender.io/docs/how-to-test-your-site-after-you-have-successfully-validated-your-prerender-integration ## Checklist - [x] 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: Julia March <101819212+juliamrch@users.noreply.github.com> Co-authored-by: Pierre L. / Peyo <166715564+PLhuillery@users.noreply.github.com> --- content/doc/applications/static/_index.md | 30 +++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/content/doc/applications/static/_index.md b/content/doc/applications/static/_index.md index 51f9c596..186b2a06 100644 --- a/content/doc/applications/static/_index.md +++ b/content/doc/applications/static/_index.md @@ -66,6 +66,36 @@ RewriteRule ^ - [L] RewriteRule ^ /index.html ``` +## Prerendering with Prerender.io + +When you use a SPA framework, you are using Client side rendering. +One of the problem with this method is a poor SEO as search engine crawlers have more difficulty reading the content of this type of application. +To minimize this issue, prerendering can be a solution. + +If you want to Prerender your application on Clever Cloud, one solution is to use [Prerender.io](https://prerender.io/). +To use it with our static applications, you need a `.htaccess` file like this at the root of your project: + +```ApacheConf + + RequestHeader set X-Prerender-Token "" + RequestHeader set X-Prerender-Version "prerender-apache@2.0.0" + + + + RewriteEngine On + + + RewriteCond %{HTTP_USER_AGENT} googlebot|bingbot|yandex|baiduspider|facebookexternalhit|twitterbot|rogerbot|linkedinbot|embedly|quora\ link\ preview|showyoubot|outbrain|pinterest\/0\.|pinterestbot|slackbot|vkShare|W3C_Validator|whatsapp|redditbot|applebot|flipboard|tumblr|bitlybot|skypeuripreview|nuzzel|discordbot|google\ page\ speed|qwantify|bitrix\ link\ preview|xing-contenttabreceiver|google-inspectiontool|chrome-lighthouse|telegrambot [NC,OR] + RewriteCond %{QUERY_STRING} _escaped_fragment_ + RewriteCond %{REQUEST_URI} ^(?!.*?(\.js|\.css|\.xml|\.less|\.png|\.jpg|\.jpeg|\.gif|\.pdf|\.doc|\.txt|\.ico|\.rss|\.zip|\.mp3|\.rar|\.exe|\.wmv|\.doc|\.avi|\.ppt|\.mpg|\.mpeg|\.tif|\.wav|\.mov|\.psd|\.ai|\.xls|\.mp4|\.m4a|\.swf|\.dat|\.dmg|\.iso|\.flv|\.m4v|\.torrent|\.ttf|\.woff|\.svg)) + + RewriteRule ^(index\.html|index\.php)?(.*) http://service.prerender.io/%{REQUEST_SCHEME}://%{HTTP_HOST}$2 [P,END] + + +``` +You can find your `PRERENDER_TOKEN` on your [Prerender.io account](https://prerender.io/). + +You can verify your configuration work using [this guide](https://docs.prerender.io/docs/how-to-test-your-site-after-you-have-successfully-validated-your-prerender-integration). ## Apache Configuration with `CC_WEBROOT` If you set the `CC_WEBROOT = /` environment variable, make sure you put your `.htaccess` file at the root of your `/`. This is where Apache will look for directives when you deploy an application in a Static runtime. From 1812997c59563f847d2f4a6ddc2591b282ac7cd5 Mon Sep 17 00:00:00 2001 From: Julie POUNY <63869305+Juju-archy@users.noreply.github.com> Date: Tue, 28 Jan 2025 17:22:13 +0100 Subject: [PATCH 35/36] Diag network issue with curl (#504) ## Describe your PR This guide provides a method for diagnosing network-related issues using the curl command. By analyzing detailed timing information, you can determine whether problems originate from the network infrastructure, DNS resolution, TLS handshake, or server response ## Checklist - [x] My PR is related to an opened issue : #480 - [x] I've read the [contributing guidelines](/CleverCloud/documentation/blob/main/CONTRIBUTING.md) ## Reviewers _Who should review these changes?_ @CleverCloud/reviewers Co-authored-by: jpouny Co-authored-by: Pierre L. / Peyo <166715564+PLhuillery@users.noreply.github.com> --- content/doc/find-help/troubleshooting.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/content/doc/find-help/troubleshooting.md b/content/doc/find-help/troubleshooting.md index bf07d355..d9eb6f66 100644 --- a/content/doc/find-help/troubleshooting.md +++ b/content/doc/find-help/troubleshooting.md @@ -173,6 +173,13 @@ For operations that may exceed the 180-second limit, implement one of these appr - 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. + +##### How can I diagnosing Network Issue with `curl` + +To gather detailed timing information for each step of the connection process, run the following `curl` command: +``` bash +curl -o /dev/null -s -w "DNS resolution: %{time_namelookup}s\nTCP connection: %{time_connect}s\nTLS handshake: %{time_appconnect}s\nTime to first byte: %{time_starttransfer}s\nTotal time: %{time_total}s\n" https:// +``` {{% /details %}} From 901b211da727ffaaa5d4812125f0563a87e9fadd Mon Sep 17 00:00:00 2001 From: Julia March <101819212+juliamrch@users.noreply.github.com> Date: Wed, 29 Jan 2025 16:04:36 +0900 Subject: [PATCH 36/36] Update review-app.yml --- .github/workflows/review-app.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/review-app.yml b/.github/workflows/review-app.yml index 9bf77441..7eaa7c32 100644 --- a/.github/workflows/review-app.yml +++ b/.github/workflows/review-app.yml @@ -23,7 +23,7 @@ jobs: token: ${{ secrets.GITHUB_TOKEN }} fetch-depth: 0 - name: Manage review app - uses: CleverCloud/clever-cloud-review-app@v1.1.1 + uses: CleverCloud/clever-cloud-review-app@beta env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} CLEVER_SECRET: ${{ secrets.CLEVER_SECRET }} @@ -39,4 +39,4 @@ jobs: type: 'static-apache' set-env: true environment: 'review' - domain: '${{ github.event.pull_request.base.repo.name }}-PR-${{ github.event.number }}.cleverapps.io/developers' \ No newline at end of file + domain: '${{ github.event.pull_request.base.repo.name }}-PR-${{ github.event.number }}.cleverapps.io/developers'