changelog: operators GA

CleverCloud · Feb 28, 2025 · 19c0503 · 19c0503
1 parent 6ef3077
commit 19c0503
Show file tree

Hide file tree

Showing 15 changed files with 284 additions and 22 deletions.
diff --git a/content/api/v4.md b/content/api/v4.md
@@ -2,20 +2,20 @@
 title: "APIv4 Reference"
 Description: "Reference documentation for the Clever Cloud APIv4. Includes methods and examples for billing, deployments, load balacers, logs, etc."
 type: "docs"
-keywords: 
+keywords:
 - openapi
 - api
 - reference
 - endpoint
 - v4
 ---
-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: 
+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/
 ```
 
-While the documentation moves towards completion, this page presents the most useful endpoints and example requests available now. 
+While the documentation moves towards completion, this page presents the most useful endpoints and example requests available now.
 
 {{< callout type="info" >}}
 Each query response contains a `Sozu-Id`. If you need help from our support team, it can help to provide it.
@@ -30,7 +30,7 @@ Each query response contains a `Sozu-Id`. If you need help from our support team
 
 You can use optional parameters to filter it:
 | Parameter                   | Type     | Comment                                                                        |
-| :---                        | :---     | :---                                                                           | 
+| :---                        | :---     | :---                                                                           |
 | `limit`                     | `int`    |                                                                                |
 | `since`                     | `string` | ISO 8601 formatted                                                             |
 | `until`                     | `string` | ISO 8601 formatted                                                             |
@@ -137,7 +137,7 @@ Example response, for each deployment:
 
 You can use optional parameters to filter it:
 | Parameter                   | Type     | Comment                                                                        |
-| :---                        | :---     | :---                                                                           | 
+| :---                        | :---     | :---                                                                           |
 | `deploymentId`              | `string` |                                                                                |
 | `limit`                     | `int`    |                                                                                |
 | `excludeDeleted`            | `boolean`|                                                                                |
@@ -209,6 +209,51 @@ Answers with logs in a SSE (Server-Sent Events) stream. You can use optional par
 | `throttleElements`          | `int`    | Maximum elements read per `throttlePerInMilliseconds`, default `100`           |
 | `throttlePerInMilliseconds` | `long`   | Default `300`                                                                  |
 
+## Operators
+A Clever Cloud Operator deploys and manage resources for a given service. Available operators are: `keycloak`, `matomo`, `metabase`, `otoroshi`.
+
+- `/v4/addon-providers/addon-{operator_name}/addons/{operator_id}`
+- Type: `GET`
+
+Example response:
+```bash
+{
+  "resourceId": "real_id",
+  "addonId": "addon_id",
+  "name": "resource_name",
+  "ownerId": "user_or_org_id",
+  "plan": "PLAN_NAME",
+  "version": "x.y.z",
+  "javaVersion": "X", # Optional
+  "phpVersion": "X",  # Optional
+  "accessUrl": "https://service-web-ui-id.services.clever-cloud.com",
+  "api": { # Optional
+    "url": "https://service-api-id.services.clever-cloud.com",
+    ...
+  },
+  "availableVersions": [
+    "x.y.z",
+    ...
+  ],
+  "resources": {
+    "entrypoint": "app_id",
+    ...
+  },
+  "features": {
+    ...
+  },
+  "envVars": {
+    "VAR_NAME": "value",
+    ...
+  }
+}
+```
+
+- `/v4/addon-providers/addon-{operator_name}/addons/{operator_id}/reboot`
+- `/v4/addon-providers/addon-{operator_name}/addons/{operator_id}/rebuild`
+- Type: `POST`
+- Response code: `204`
+
 ## Products zones
 - `/v4/products/zones`
 - `/v4/products/zones/{name}`

diff --git a/content/changelog/2025/01-14-keycloak-26.0.8.md b/content/changelog/2025/01-14-keycloak-26.0.8.md
@@ -0,0 +1,20 @@
+---
+title: "Keycloak 26.0.8 is available (security update)"
+date: 2025-01-14
+tags:
+  - addons
+  - keycloak
+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: Thanks to Clever Cloud, it's easy to upgrade
+excludeSearch: true
+---
+
+The release `26.0.8` of Keycloak is available on Clever Cloud. [It fixes](https://github.com/keycloak/keycloak/releases/26.0.8) some bugs, but also security issues: [CVE-2024-11734](https://nvd.nist.gov/vuln/detail/CVE-2024-11734) and [CVE-2024-11736](https://nvd.nist.gov/vuln/detail/CVE-2024-11736). To update, just set `CC_KEYCLOAK_VERSION` of the add-on's Java application to `26.0.8` and rebuild it.
+
+- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak)
diff --git a/content/changelog/2025/01-21-otoroshi-16.22.md b/content/changelog/2025/01-21-otoroshi-16.22.md
@@ -0,0 +1,20 @@
+---
+title: "Otoroshi v16.22 is available"
+date: 2025-01-21
+tags:
+  - addons
+  - Otoroshi
+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: Make the AI enterprise-grade
+excludeSearch: true
+---
+
+The release `16.22.0` of Otoroshi is available on Clever Cloud for new add-ons. [It fixes](https://github.com/MAIF/otoroshi/releases/tag/v16.22.0) some bugs and adds some features such as a plugin to add very simple basic auth, without complex user management, plug-ins to provide information (metrics, health, etc.) as user endpoint. LLM Extension also contains multiple fixes. To upgrade, edit `CC_OTOROSHI_VERSION` to `v16.22.0`, `CC_OTOROSHI_APIM_VERSION` to `1737449369` in the Java application and rebuild it.
+
+- [Learn more about Otoroshi with LLM on Clever Cloud](/developers/doc/addons/otoroshi/)
diff --git a/content/changelog/2025/01-31-keycloak-26.1.md b/content/changelog/2025/01-31-keycloak-26.1.md
@@ -0,0 +1,22 @@
+---
+title: "Keycloak 26.0.6 is available (security update)"
+date: 2025-01-31
+tags:
+  - addons
+  - keycloak
+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: Lots of new features and improvements
+excludeSearch: true
+---
+
+The release `26.1.0` of Keycloak is available on Clever Cloud. [It fixes](https://github.com/keycloak/keycloak/releases/26.1.0) some bugs, but also brings lots of new features and improvements, such as OpenTelemetry tracing, virtual thread pool support (embedded Infinispan and JGroups) when running on OpenJDK 21, a different way to discover other nodes of the same cluster (`jdbc-ping`) and a better OpenID for Verifiable Credential Issuance (OID4VCI) experimental support.
+
+To update, just set `CC_KEYCLOAK_VERSION` of the add-on's Java application to `26.1.0` and rebuild it.
+
+- [Learn more about Keycloak on Clever Cloud](/developers/doc/addons/keycloak)
diff --git a/content/changelog/2025/02-10-github-action-2.0.md b/content/changelog/2025/02-10-github-action-2.0.md
@@ -0,0 +1,20 @@
+---
+title: "Version 1.1 of our GitHub Action for review applications is available"
+date: 2025-02-10
+tags:
+  - github
+  - action
+authors:
+  - name: David Legrand
+    link: https://github.com/davlgd
+    image: https://github.com/davlgd.png?size=40
+  - name: Julia March
+    link: https://github.com/juliamrch
+    image: https://github.com/juliamrch.png?size=40
+description: Better, more secure practices for GitHub Action
+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 2.0 brings an improved interface for the comment section on deployments, as well as updated security practices in names and docs.
+
+- [Learn more about how to deploy from GitHub to Clever Cloud](/developers/doc/ci-cd/github/)
diff --git a/content/changelog/2025/02-10-metabase-53.md b/content/changelog/2025/02-10-metabase-53.md
@@ -0,0 +1,23 @@
+---
+title: "Metabase 52 is available"
+date: 2025-02-10
+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.53` 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.53` for the community edition or `1.53` for the enterprise edition (EE).
+
+- [Learn more about Metabase 53](https://www.metabase.com/releases/metabase-53)
+- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/metabase/)
+
+{{< youtube id="SMKsq6M__YM" >}}
diff --git a/content/changelog/2025/02-11-otoroshi-16.23.md b/content/changelog/2025/02-11-otoroshi-16.23.md
@@ -0,0 +1,22 @@
+---
+title: "Otoroshi with LLM supports DeepSeek and reasoning"
+date: 2025-02-11
+tags:
+  - addons
+  - Otoroshi
+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: And a better support of OVHcloud AI endpoints
+aliases:
+- /changelog/2024-12-04-otoroshi-available
+excludeSearch: true
+---
+
+The release `16.23.2` of Otoroshi is available on Clever Cloud for new add-ons. [It fixes](https://github.com/MAIF/otoroshi/releases/tag/v16.23.2) some bugs and adds some features but the better comes from LLM Extension which comes with a better OVHcloud AI endpoints integration, DeepSeek and reasoning models support. To upgrade, edit `CC_OTOROSHI_VERSION` to `v16.23.2`, `CC_OTOROSHI_APIM_VERSION` to `1739212580` in the Java application and rebuild it.
+
+- [Learn more about Otoroshi with LLM on Clever Cloud](/developers/doc/addons/otoroshi/)
diff --git a/content/changelog/2025/02-12-matomo-5.2.2.md b/content/changelog/2025/02-12-matomo-5.2.2.md
@@ -0,0 +1,22 @@
+---
+title: Matomo v5.2.2 is available
+date: 2025-02-12
+tags:
+  - addons
+  - matomo
+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: With updated PHP version and soon new features
+excludeSearch: true
+---
+
+Our [Matomo](https://matomo.org/) add-on has been updated to version `5.2.2` which is now used by default. You can deploy this latest release 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.2](https://matomo.org/changelog/matomo-5-2-0/)
+- [Learn more about Matomo 5.2.2](https://matomo.org/changelog/matomo-5-2-2/)
+- [Learn more about Matomo on Clever Cloud](/developers/doc/addons/matomo/)
diff --git a/content/changelog/2025/02-21-keycloak-GA.md b/content/changelog/2025/02-21-keycloak-GA.md
@@ -0,0 +1,20 @@
+---
+title: "Keycloak in General Availability"
+date: 2025-02-21
+tags:
+  - addons
+  - keycloak
+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: With the new Operator API
+excludeSearch: true
+---
+
+Keycloak is now in General Availability (GA). Deployed version is `26.1.2` and you now have access [to the operator API](/developers/api/v4/#operators). To update, just set `CC_METABASE_VERSION` of the add-on's Java application to `26.1.2` and rebuild it.
+
+- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/keycloak/)
diff --git a/content/changelog/2025/02-24-metabase-GA.md b/content/changelog/2025/02-24-metabase-GA.md
@@ -0,0 +1,20 @@
+---
+title: "Metabase in General Availability"
+date: 2025-02-24
+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: With the new Operator API
+excludeSearch: true
+---
+
+Metabase is now in General Availability (GA). Deployed version is `x.53.4` and you now have access [to the operator API](/developers/api/v4/#operators). To update, just set `CC_METABASE_VERSION` of the add-on's Java application to `0.53` for the community edition or `1.53` for the enterprise edition (EE) and rebuild it.
+
+- [Learn more about Metabase on Clever Cloud](/developers/doc/addons/metabase/)
diff --git a/content/changelog/2025/02-26-js-client-9.2.0.md b/content/changelog/2025/02-26-js-client-9.2.0.md
@@ -0,0 +1,18 @@
+---
+title: 'JS Client 9.2 is available'
+date: 2025-02-26
+tags:
+  - client
+  - javascript
+authors:
+  - name: David Legrand
+    link: https://github.com/davlgd
+    image: https://github.com/davlgd.png?size=40
+  - name: Hubert Sablonnière
+    link: https://github.com/hsablonniere
+    image: https://github.com/hsablonniere.png?size=40
+description: Preparing new features
+excludeSearch: true
+---
+
+[Clever Cloud JS client 9.2.0](https://github.com/CleverCloud/clever-client.js/blob/master/CHANGELOG.md#920-2025-02-26) is available with some enhancements and multiple new features for `billing`, `grafana`, `materia`, etc.
diff --git a/content/changelog/2025/02-28-otoroshi-GA-16.24.md b/content/changelog/2025/02-28-otoroshi-GA-16.24.md
@@ -0,0 +1,20 @@
+---
+title: "Otoroshi in General Availability"
+date: 2025-02-28
+tags:
+  - addons
+  - Otoroshi
+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: With the new Operator API
+excludeSearch: true
+---
+
+Otoroshi is now in General Availability (GA), with access [to the operator API](/developers/api/v4/#operators). Deployed version is `v16.24.0_1740754279`. The LLM extension includes new models filtering tools and pre-defined context per endpoint. To update, just set `CC_OTOROSHI_VERSION` of the add-on's Java application to `v16.24.0_1740754279` and rebuild it. You can also delete `CC_OTOROSHI_APIM_VERSION`, `CC_OTOROSHI_SECRET` variables from the Java application, they are not used anymore.
+
+- [Learn more about Otoroshi with LLM on Clever Cloud](/developers/doc/addons/otoroshi/)
diff --git a/content/doc/addons/keycloak.md b/content/doc/addons/keycloak.md
@@ -8,7 +8,7 @@ keywords:
 - Keycloak
 - IAM
 - Security
-- Autentication
+- Authentication
 - Identity
 - OAuth
 - OpenID
@@ -21,10 +21,7 @@ Keycloak is an open source identity and access management (IAM) solution that of
 
 To fit the most common needs, the Keycloak add-on comes with batteries included: sensible defaults, easy migration with realms import/export, Keycloak Metrics, default theme, etc.
 
-{{< callout type="info" >}}
-
-**Keycloak is in Beta testing phase:** your insights and suggestions are crucial in shaping the future of this platform. To share your feedback, please visit us at [our community page](https://github.com/CleverCloud/Community/discussions/categories/keycloak). Thank you for being a part of our journey towards innovation and improvement!
-{{< /callout >}}
+{{< callout type="info" >}}Share your feedback on Keycloak operator through [our community page](https://github.com/CleverCloud/Community/discussions/categories/keycloak){{< /callout >}}
 
 ## Key features
 Keycloak on Clever Cloud allows you to effortlessly set up a tailored authentication and access management solution, that you can adjust to your needs and workloads. It offers a wide panel of services such as:

diff --git a/content/doc/addons/metabase.md b/content/doc/addons/metabase.md
@@ -16,12 +16,7 @@ type: docs
 
 [Metabase](https://www.metabase.com/) is an open source Business Intelligence server that connects to MySQL, PostgreSQL, MongoDB, and more! Anyone can use it to build charts, dashboards, nightly emails or Slack reports. Thanks to this add-on, you can deploy Metabase in your organization in just one click. It leverages all Clever Cloud features such as monitoring, scalability, high availability SLA, etc.
 
-{{< callout type="info" >}}
-**Metabase is in Beta testing phase:** your insights and suggestions are crucial in shaping the future of this platform.
-To share your feedback, please visit us at [our community page](https://github.com/CleverCloud/Community/discussions/categories/metabase).
-Thank you for being a part of our journey towards innovation and improvement!
-{{< /callout >}}
-
+{{< callout type="info" >}}Share your feedback on Keycloak operator through [our community page](https://github.com/CleverCloud/Community/discussions/categories/metabase){{< /callout >}}
 
 ## Key features
 

diff --git a/content/doc/addons/otoroshi.md b/content/doc/addons/otoroshi.md
@@ -19,10 +19,8 @@ Otoroshi is a lightweight API management solution built on a modern HTTP reverse
 The solution excels at dynamic service management, offering essential API gateway functionalities including request routing, security enforcement, traffic management, and comprehensive monitoring. Its event-driven architecture and flexible deployment model make it particularly effective in cloud-native and PaaS environments.
 
 On Clever Cloud, it comes with pre-configured with features included such as [Coraza Web Appplication Firewall](#coraza-waf-web-application-firewall) or the [LLM extension](#llm-extension).
-{{< callout type="info" >}}
 
-**Otoroshi is in Beta testing phase:** your insights and suggestions are crucial in shaping the future of this platform. To share your feedback, please visit us at [our community page](https://github.com/CleverCloud/Community/discussions/categories/otoroshi). Thank you for being a part of our journey towards innovation and improvement!
-{{< /callout >}}
+{{< callout type="info" >}}Share your feedback on Keycloak operator through [our community page](https://github.com/CleverCloud/Community/discussions/categories/otoroshi){{< /callout >}}
 
 ## Create an Otoroshi with LLM add-on
 
@@ -75,14 +73,14 @@ When you create the Otoroshi add-on, Clever Cloud automatically deploys:
 
 By default, Otoroshi with LLM on Clever Cloud uses small-size resources, i.e:
 
-- XS Java
+- S Java
 - S Redis®
 
 They are dimensioned to suit a majority of needs. You can however manage and adjust them directly [in the Console](https://console.clever-cloud.com/).
 
 ## LLM extension
 
-Otoroshi on Clever Cloud comes with LLM Extension. It provides a unified gateway for managing and interacting with Large Language Models through an OpenAI-compatible API interface. This extension streamlines the integration and management of multiple LLM providers including Ollama instances, OpenAI, Mistral, Anthropic, Gemini, Groq, Hugging Face, and OVH AI Endpoints.
+Otoroshi on Clever Cloud comes with LLM Extension. It provides a unified gateway for managing and interacting with Large Language Models through an OpenAI-compatible API interface, with [MCP support](https://www.clever-cloud.com/blog/company/2025/01/21/create-your-own-mcp-client-server-as-easy-as-1-2-3-with-otoroshi/). This extension streamlines the integration and management of multiple LLM providers including Ollama instances, OpenAI, Mistral, Anthropic, DeepSeek, Gemini, Groq, Hugging Face, OVH and Scaleway AI Endpoints.
 
 ### Smarter AI operations
 The extension enhances your LLM operations with intelligent workload distribution and automatic failover mechanisms, ensuring consistent service availability. It implements sophisticated features such as semantic caching to optimize response times and reduce costs, while providing comprehensive quota management capabilities for effective resource allocation.