Merge pull request #144 from apecloud/support/add-blog-release-101

add blog release 101

Author: shanshanying

blogs/en/announcing-kubeblocks-v1-0-1.mdx

@@ -0,0 +1,62 @@
+---
+slug: announcing-kubeblocks-v1-0-1
+title: Announcing KubeBlocks v1.0.1
+description: This blog introduces major changes in KubeBlocks v1.0.1.
+date: 2025-09-12
+tags: [Announcing]
+image: /img/blogs/thumbnails/blog-release-1.0.1.png
+---
+
+# Announcing KubeBlocks v1.0.1
+
+We are delighted to announce the release of KubeBlocks v1.0.1. This release includes several new features, bug fixes, and various improvements. Here are the detailed update contents.
+
+## KubeBlocks
+
+### Features
+
+- **Improve the settings of the manager** - Improves performance, stability, and configurability of KubeBlocks Operator. ([#9587](https://github.com/apecloud/kubeblocks/pull/9587))
+- **Support user-defined environment variables in lifecycle actions** - Allows customization of environment variables for lifecycle actions. ([#9514](https://github.com/apecloud/kubeblocks/pull/9514))
+- **OpsDefinition supports image mapping for multi service version** - Enables image mapping for different service versions in operations definitions. ([#9605](https://github.com/apecloud/kubeblocks/pull/9605))
+- **Specify allowed symbols in password generation** - Allows customization of symbols used in generated passwords. [#9480](https://github.com/apecloud/kubeblocks/pull/9480)
+- **Support HTTP and gRPC actions** - Supports HTTP and gRPC in lifecycle actions. ([#9656](https://github.com/apecloud/kubeblocks/pull/9656))
+- **Scale out replicas from backup** - Supports to scale out replicas from backup in OpsRequest. ([#9623](https://github.com/apecloud/kubeblocks/pull/9623))
+- **Improves resource resizing handling** - Support resize subresource in InPlacePodVerticalScaling when supported. ([#9532](https://github.com/apecloud/kubeblocks/pull/9532),[#9545](https://github.com/apecloud/kubeblocks/pull/9545))
+- **Add azureblob storage provider** - Adds Azure Blob storage provider support.([#9492](https://github.com/apecloud/kubeblocks/pull/9492))
+
+
+## KubeBlocks Addons
+
+### PostgreSQL
+- Improve PostgreSQL dcs mode ([#1874](https://github.com/apecloud/kubeblocks-addons/pull/1874))
+- Support synchronous mode ([#1941](https://github.com/apecloud/kubeblocks-addons/pull/1941))
+- Update patroni scope value and dcs scope ([#2005](https://github.com/apecloud/kubeblocks-addons/pull/2005),[#1997](https://github.com/apecloud/kubeblocks-addons/pull/1997))
+
+### Redis
+- Support new Redis verions 8.2,8.0.3, 7.2.10 and 7.4.5/([#1968](https://github.com/apecloud/kubeblocks-addons/pull/1968), [#1785](https://github.com/apecloud/kubeblocks-addons/pull/1785), [#1710](https://github.com/apecloud/kubeblocks-addons/pull/1710))
+- Fixed Redis memory leak when loading redisgears module ([#1855](https://github.com/apecloud/kubeblocks-addons/pull/1855))
+- Support reconfiguration of `client-output-buffer-limit` ([#1973](https://github.com/apecloud/kubeblocks-addons/pull/1973))
+
+### Clickhouse
+- Support Horizontal Scale for keeper ([#1713](https://github.com/apecloud/kubeblocks-addons/pull/1713))
+
+### Elasticsearch
+- Support new ES version 8.15.5 ([#1923](https://github.com/apecloud/kubeblocks-addons/pull/1923))
+- Split master and data component to be more flexible ([#1971](https://github.com/apecloud/kubeblocks-addons/pull/1971))
+
+### Etcd
+- Support new Etcd version 3.6.1 ([#1709](https://github.com/apecloud/kubeblocks-addons/pull/1709))
+
+### MinIO
+- Add dashboard for MinIO ([#1833](https://github.com/apecloud/kubeblocks-addons/pull/1833))
+- Improve MinIO for metrics collection ([#1836](https://github.com/apecloud/kubeblocks-addons/pull/1836))
+
+### RocketMQ
+- Support RocketMQ Addon, for RocketMQ 4.9.6 ([#1883](https://github.com/apecloud/kubeblocks-addons/pull/1883))
+
+### Neo4j
+- Support Neo4j Addon, for Neo4j 4.4.42/5.26.5 ([#1649](https://github.com/apecloud/kubeblocks-addons/pull/1649))
+
+
+## Full Changelog
+You can check the [full changelog](https://github.com/apecloud/kubeblocks/compare/v1.0.0...v1.0.1) for additional changes.

docs/en/preview/user_docs/references/install-addons.mdx

@@ -1,22 +1,24 @@
 ---
-title: Install Addons
+title: Addons Management
 description: Install KubeBlocks addons with Helm
 keywords: [addon, helm, KubeBlocks, kubernetes, operator, database]
 sidebar_position: 3
-sidebar_label: Install Addons
+sidebar_label: Addons Management
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# Install Addons
+# Addons Management
 
 With the release of KubeBlocks v0.8.0, Addons are decoupled from KubeBlocks and some Addons are not installed by default. If you want to use these Addons, install Addons first by index. Or if you uninstalled some Addons, you can follow the steps in this tutorial to install them again.
 
 This tutorial takes elasticsearch as an example. You can replace elasticsearch with the Addon you need.
 
 The official index repo is [KubeBlocks index](https://github.com/apecloud/block-index). Addons are maintained in the [KubeBlocks Addon repo](https://github.com/apecloud/kubeblocks-addons).
 
+## Install Addons
+
 :::note
 
 Make sure the major version of Addons and KubeBlocks are the same.
@@ -202,6 +204,108 @@ What is the difference between using `kbcli` and `helm` to install an Addon?
 
 </Tabs>
 
+## Upgrade Addons
+
+Follow these steps to upgrade Addons individually.
+
+:::note
+Upgrading Addons may lead to restarting existing database clusters and affect availability. Only proceed during maintenance windows, and test the upgrade in a non-production environment first.
+:::
+
+<Tabs>
+
+  <TabItem value="Helm" label="Helm" default>
+
+  **Step 1: Configure Addon Repository**
+
+  ```bash
+  # Add the primary Addon repository
+  helm repo add kubeblocks-addons https://apecloud.github.io/helm-charts
+
+  # Alternative repository for users in regions with limited GitHub access
+  # helm repo add kubeblocks-addons https://jihulab.com/api/v4/projects/150246/packages/helm/stable
+
+  # Update repository information
+  helm repo update
+  ```
+
+  **Step 2: Find Available Versions**
+
+  ```bash
+  # Search for available versions of a specific Addon
+  helm search repo kubeblocks-addons/{addon-name} --versions --devel
+  # Example: helm search repo kubeblocks-addons/mysql --versions --devel
+  ```
+
+  **Step 3: Upgrade the Addon**
+
+  Select a version that is compatible (same major version) with your KubeBlocks release and upgrade:
+
+  ```bash
+  # Upgrade to a specific version
+  helm upgrade -i {addon-release-name} kubeblocks-addons/{addon-name} --version x.y.z -n kb-system
+  ```
+
+  :::note
+  **Parameter Reference:**
+  - `{addon-name}`: Replace with the actual Addon name (e.g., `mysql`, `postgresql`)
+  - `{addon-release-name}`: The release name of the installed Addon (e.g., `kb-addon-mysql`, `kb-addon-postgresql`)
+  - `x.y.z`: The target version number, compatible with your KubeBlocks release
+  :::
+
+  </TabItem>
+
+  <TabItem value="kbcli" label="kbcli">
+
+  **Step 1: Update Addon Index**
+
+  ```bash
+  # List available Addon indexes (the default index is `kubeblocks`)
+  kbcli addon index list
+
+  # Update the default KubeBlocks index
+  kbcli addon index update kubeblocks
+  ```
+
+  **Step 2: Search for Available Addon Versions**
+
+  ```bash
+  # Search for available versions of a specific Addon
+  kbcli addon search {addon-name}
+
+  # View currently installed Addons and their versions
+  kbcli addon list | grep {addon-name}
+  ```
+
+  **Step 3: Upgrade the Addon**
+
+  Select a version that is compatible (same major version) with your KubeBlocks release and upgrade:
+
+  ```bash
+  kbcli addon upgrade {addon-name} --version x.y.z
+  ```
+
+  **Force upgrade (use with caution):**
+  ```bash
+  kbcli addon upgrade {addon-name} --version x.y.z --force
+  ```
+
+  **Fresh installation (if not previously installed):**
+  ```bash
+  kbcli addon install {addon-name} --version x.y.z
+  ```
+
+  :::note
+  **When to use `--force`:**
+  - You need to downgrade to a previous version
+  - Use with caution as it bypasses compatibility checks
+  :::
+
+  </TabItem>
+
+</Tabs>
+
+
 ## Advanced Configuration
 
 ### Set Addon Values

docs/en/preview/user_docs/release_notes/release-10/101.mdx

@@ -54,6 +54,9 @@ We are delighted to announce the release of KubeBlocks v1.0.1. This release incl
 ### Neo4j
 - Support Neo4j Addon, for Neo4j 4.4.42/5.26.5 ([#1649](https://github.com/apecloud/kubeblocks-addons/pull/1649))
 
+## Upgrade to v1.0.1
+
+Refer to [Upgrade to KubeBlocks v1.0.x](../../upgrade/upgrade-to-v10x).
 
 ## Full Changelog
 You can check the [full changelog](https://github.com/apecloud/kubeblocks/compare/v1.0.0...v1.0.1) for additional changes.

docs/en/preview/user_docs/upgrade/upgrade-to-v10x.mdx

@@ -0,0 +1,147 @@
+---
+title: Upgrade to v1.0.x
+description: Upgrade to KubeBlocks v1.0.x, operation, tips and notes
+keywords: [upgrade, kubeblocks]
+sidebar_position: 1
+sidebar_label: Upgrade to v1.0.x
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+export const LATEST_VERSION = "v1.0.1";
+
+{/* Custom component to render code blocks with variable substitution */}
+export const VersionedCodeBlock = ({ children, language = "bash" }) => (
+  <pre>
+    <code className={`language-${language}`}>
+      {children.replace(/{LATEST_VERSION}/g, LATEST_VERSION)}
+    </code>
+  </pre>
+);
+
+# Upgrade to KubeBlocks v1.0.x
+
+This guide walks you through upgrading KubeBlocks to version 1.0.x.
+
+## Before You Begin
+
+### Verify Your Current Version
+
+First, check which version of KubeBlocks you're currently running:
+
+```bash
+# Using helm
+helm -n kb-system list | grep kubeblocks
+
+# Using kbcli
+kbcli version
+```
+
+### Choose Your Upgrade Path
+
+Select the appropriate upgrade path based on your current version:
+
+| Current Version | Target: v1.0.x | Upgrade Path |
+|-----------------|----------------|---------------|
+| v1.0.x | ✅ Direct upgrade | Follow [Upgrade from KubeBlocks v1.0.x](#upgrade-from-kubeblocks-v10x) |
+| v0.9.x | ❌ Not supported | N/A |
+
+
+## Upgrade from KubeBlocks v1.0.x
+
+This section covers upgrading between v1.0.x versions (for example, from v1.0.0 to v1.0.1). Since these are patch releases within the same major version, the upgrade process is straightforward.
+
+:::note
+**Version Placeholder:**
+
+Throughout this section, replace {LATEST_VERSION} with your target version number (e.g., `v1.0.1`).
+:::
+
+<Tabs>
+
+  <TabItem value="Helm" label="Helm" default>
+
+  **Step 1: Update Custom Resource Definitions (CRDs)**
+
+  KubeBlocks separates CRDs from the Helm chart to reduce chart size. Start by updating the CRDs:
+
+  <VersionedCodeBlock>
+{`kubectl replace -f https://github.com/apecloud/kubeblocks/releases/download/{LATEST_VERSION}/kubeblocks_crds.yaml`}
+  </VersionedCodeBlock>
+
+  **Step 2: Upgrade KubeBlocks Core**
+
+  First, update your Helm repository to get the latest chart information:
+  ```bash
+  helm repo add kubeblocks https://apecloud.github.io/helm-charts
+  helm repo update kubeblocks
+  ```
+
+  Then upgrade KubeBlocks to the target version:
+  <VersionedCodeBlock>
+{`helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version {LATEST_VERSION}`}
+  </VersionedCodeBlock>
+
+  **Step 3: (Optional) Upgrade Addons**
+
+  :::note
+  We are glad to announce that since KubeBlocks 1.0.0, each `ComponentDefinition` CR has its own version (usually the same as its Addon version), existing Clusters will not be affected by the Addon upgrade.
+
+  But it is still recommended to test upgrade Addons in a non-production environment first.
+  :::
+
+  To upgrade Addons to the versions bundled with the new KubeBlocks version:
+
+  <VersionedCodeBlock>
+{`helm -n kb-system upgrade kubeblocks kubeblocks/kubeblocks --version {LATEST_VERSION}  --set upgradeAddons=true`}
+  </VersionedCodeBlock>
+
+  Or you want to upgrade specific Addons follow the steps in [Upgrade Addons](../references/install-addons#upgrade-addons)
+
+  </TabItem>
+
+  <TabItem value="kbcli" label="kbcli">
+
+  **Step 1: Update kbcli**
+
+  Download and install the matching version of kbcli:
+
+  <VersionedCodeBlock>
+{`curl -fsSL https://kubeblocks.io/installer/install_cli.sh | bash -s {LATEST_VERSION}`}
+  </VersionedCodeBlock>
+
+  **Step 2: Upgrade KubeBlocks Core**
+
+  Perform the core upgrade without updating Addons:
+
+  <VersionedCodeBlock>
+{`kbcli kb upgrade --version {LATEST_VERSION}`}
+  </VersionedCodeBlock>
+
+  **Step 3: (Optional) Upgrade Addons**
+
+  :::note
+  We are glad to announce that since KubeBlocks 1.0.0, each `ComponentDefinition` CR has its own version (usually the same as its Addon version), existing Clusters will not be affected by the Addon upgrade.
+
+  But it is still recommended to test upgrade Addons in a non-production environment first.
+  :::
+
+  To upgrade Addons to the versions bundled with the new KubeBlocks version:
+
+  <VersionedCodeBlock>
+{`kbcli kb upgrade --version {LATEST_VERSION} --set upgradeAddons=true`}
+  </VersionedCodeBlock>
+
+   Or you want to upgrade specific Addons follow the steps in [Upgrade Addons](../references/install-addons#upgrade-addons)
+
+  </TabItem>
+
+</Tabs>
+
+## Getting Help
+
+If you encounter issues during the upgrade process:
+
+- **Check the logs**: Review upgrade logs using `kubectl -n kb-system logs deployment/kubeblocks`
+- **Community Support**: Visit the [KubeBlocks GitHub Issues](https://github.com/apecloud/kubeblocks/issues) for known issues and community help