docs: add kubevela integration user guide

Signed-off-by: peefy <[email protected]>

docs/user_docs/guides/working-with-kubevela/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "KubeVela",
+  "position": 16
+}

docs/user_docs/guides/working-with-kubevela/index.md

@@ -0,0 +1,99 @@
+# KubeVela
+
+[KubeVela](https://kubevela.net/) is a modern application delivery system hosted by the CNCF Foundation. It is built on the Open Application Model (OAM) specification and aims to abstract the complexity of Kubernetes, providing a set of simple and easy-to-use command-line tools and APIs for developers to deploy and operate cloud-native applications without worrying about the underlying details.
+
+Using KCL with KubeVela has the following benefits:
+
+- **Simpler configuration**: KCL provides stronger templating capabilities, such as conditions and loops, for KubeVela OAM configurations at the client level, reducing the need for repetitive YAML writing. At the same time, the reuse of KCL model libraries and toolchains enhances the experience and management efficiency of configuration and policy writing.
+- **Better maintainability**: KCL provides a configuration file structure that is more conducive to version control and team collaboration, instead of relying solely on YAML. When combined with OAM application models written in KCL, application configurations become easier to maintain and iterate.
+- **Simplified operations**: By combining the simplicity of KCL configurations with the ease of use of KubeVela, daily operational tasks such as deploying, updating, scaling, or rolling back applications can be simplified. Developers can focus more on the applications themselves rather than the tedious details of the deployment process.
+- **Improved cross-team collaboration**: By using KCL's configuration chunk writing and package management capabilities in conjunction with KubeVela, clearer boundaries can be defined, allowing different teams (such as development, testing, and operations teams) to collaborate systematically. Each team can focus on tasks within their scope of responsibility, delivering, sharing, and reusing their own configurations without worrying about other aspects.
+
+## How to
+
+### 1. Configure the Kubernetes Cluster
+
+Install [K3d](https://github.com/k3d-io/k3d) and create a cluster.
+
+```shell
+k3d cluster create
+```
+
+> Note: You can use other methods to create your own Kubernetes cluster, such as kind, minikube, etc., in this scenario.
+
+### 2. Install KubeVela
+
+- Install the KubeVela CLI.
+
+```shell
+curl -fsSl https://kubevela.net/script/install.sh | bash
+```
+
+- Install KubeVela Core.
+
+```shell
+vela install
+```
+
+### 3. Write OAM Configurations
+
+- Install KCL.
+
+```shell
+curl -fsSL https://kcl-lang.io/script/install-cli.sh | /bin/bash
+```
+
+- Create a new project and add OAM dependencies.
+
+```shell
+kcl mod init kcl-play-svc && cd kcl-play-svc && kcl mod add oam
+```
+
+- Write the following code in main.k.
+
+```python
+import oam
+
+oam.Application {
+    metadata.name = "kcl-play-svc"
+    spec.components = [{
+        name = metadata.name
+        type = "webservice"
+        properties = {
+            image = "kcllang/kcl"
+            ports = [{port = 80, expose = True}]
+            cmd = ["kcl", "play"]
+        }
+    }]
+}
+```
+
+> Note: You can see documents here: [https://artifacthub.io/packages/kcl/kcl-module/oam](https://artifacthub.io/packages/kcl/kcl-module/oam) or in the IDE extension.
+
+![oam-definition-hover](/img/blog/2023-12-15-kubevela-integration/oam-definition-hover.png)
+
+### 4. Deploy the application and verify.
+
+- Apply the configuration.
+
+```shell
+kcl run | vela up -f -
+```
+
+- Port forward the service.
+
+```shell
+vela port-forward kcl-play-svc
+```
+
+Then we can see the KCL Playground application running successfully in the browser.
+
+![kcl-play-svc](/img/blog/2023-12-15-kubevela-integration/kcl-play-svc.png)
+
+## Conclusion
+
+Through this guide, we have learned how to deploy cloud-native applications using KubeVela and KCL. In future documents, we will explain how to further extend the capabilities of KubeVela by using KCL on the client side such as
+
+- Using the inheritance, composition, and validation capabilities of KCL to extend the OAM model and define application abstractions that are better suited to your infrastructure or organization.
+- Using the modularized configuration capabilities of KCL to organize OAM multi-environment configurations with conditions, logic, loops, and modularity. For example, distribute longer App Definitions into different files to reduce boilerplate configurations.
+- Further integration with projects like KusionStack and ArgoCD to achieve better GitOps.

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/guides/working-with-kubevela/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "KubeVela",
+  "position": 16
+}

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/guides/working-with-kubevela/index.md

@@ -0,0 +1,99 @@
+# KubeVela
+
+[KubeVela](https://kubevela.net/) 是一个 CNCF 基金会托管的现代的应用交付系统，它基于 Open Application Model（OAM）规范构建，旨在屏蔽 Kubernetes 的复杂性，提供一套简单易用的命令行工具和 APIs，让开发者无需关心底层细节即可部署和运维云原生应用。
+
+将 KCL 与 KubeVela 一起使用具有如下好处:
+
+- **更简单的配置**：在客户端层面为 KubeVela OAM 配置提供更强的模版化能力如条件，循环等，减少样板 YAML 书写，同时复用 KCL 模型库和工具链生态，提升配置及策略编写的体验和管理效率。
+- **更好的可维护性**：通过 KCL 可以提供更有利于版本控制和团队协作的配置文件结构，而不是围绕 YAML 进行配置，同时搭配 KCL 编写的 OAM 应用模型，可以使得应用配置更易于维护和迭代。
+- **更简化的操作**：结合 KCL 的配置简洁性和 KubeVela 的易用性，可以简化日常的操作任务，比如部署更新、扩展或回滚应用。开发者可以更加专注于应用本身，而不是部署过程中的繁琐细节。
+- **更好的跨团队协作**：通过 KCL 配置分块编写以及包管理能力与 KubeVela 结合使用，可以定义更清晰的界限，使得不同的团队（如开发、测试和运维团队）可以有条理地协作。每个团队可以专注于其职责范围内的任务，分别交付、分享和复用各自的配置，而不用担心其他方面的细节。
+
+## 快速开始
+
+### 1. 配置 Kubernetes 集群
+
+- 安装 [K3d](https://github.com/k3d-io/k3d) 并创建一个集群
+
+```bash
+k3d cluster create
+```
+
+> 注意：你可以在此方案中使用其他方式创建您自己的 Kubernetes 集群，如 kind, minikube 等。
+
+### 2. 安装 KubeVela
+
+- 安装 KubeVela CLI
+
+```bash
+curl -fsSl https://kubevela.net/script/install.sh | bash
+```
+
+- 安装 KubeVela Core
+
+```bash
+vela install
+```
+
+### 3. 安装 KCL 并编写配置
+
+- 安装 KCL
+
+```bash
+curl -fsSL https://kcl-lang.io/script/install-cli.sh | /bin/bash
+```
+
+- 新建工程并添加 OAM 依赖
+
+```shell
+kcl mod init kcl-play-svc && cd kcl-play-svc && kcl mod add oam
+```
+
+- 在 main.k 中编写如下代码
+
+```python
+import oam
+
+oam.Application {
+    metadata.name = "kcl-play-svc"
+    spec.components = [{
+        name = metadata.name
+        type = "webservice"
+        properties = {
+            image = "kcllang/kcl"
+            ports = [{port = 80, expose = True}]
+            cmd = ["kcl", "play"]
+        }
+    }]
+}
+```
+
+> 注意，你可以在 ArtifactHub 上查阅到相应的 OAM 模型文档或者直接在 IDE 中查看 [https://artifacthub.io/packages/kcl/kcl-module/oam](https://artifacthub.io/packages/kcl/kcl-module/oam) or in the IDE extension.
+
+![oam-definition-hover](/img/blog/2023-12-15-kubevela-integration/oam-definition-hover.png)
+
+### 4. 部署应用并验证
+
+- 下发配置
+
+```shell
+kcl run | vela up -f -
+```
+
+- 端口转发
+
+```shell
+vela port-forward kcl-play-svc
+```
+
+然后我们可以在浏览器中看到 KCL Playground 应用成功运行
+
+![kcl-play-svc](/img/blog/2023-12-15-kubevela-integration/kcl-play-svc.png)
+
+## 结论
+
+通过本篇文档的教程，我们可以使用 KubeVela 和 KCL 等初步部署云原生应用，未来我们将补充更多文档讲解如何在客户端使用 KCL 进一步扩展 KubeVela 的能力
+
+- 使用 KCL 的继承、组合和校验手段扩展 OAM 模型，比如根据您的基础设施或者组织基于 OAM 定义更适合的应用抽象模型
+- 使用 KCL 配置分块编写，条件，逻辑，循环和模块化能力更好地组织 OAM 多环境配置，提升模版化能力，比如将较长的 App Definition 分散到不同的文件进行组织，减少样板配置
+- 与 KusionStack 和 ArgoCD 等项目进一步集成实现更好的 GitOps

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.7.0/user_docs/guides/working-with-kubevela/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "KubeVela",
+  "position": 16
+}

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.7.0/user_docs/guides/working-with-kubevela/index.md

@@ -0,0 +1,99 @@
+# KubeVela
+
+[KubeVela](https://kubevela.net/) 是一个 CNCF 基金会托管的现代的应用交付系统，它基于 Open Application Model（OAM）规范构建，旨在屏蔽 Kubernetes 的复杂性，提供一套简单易用的命令行工具和 APIs，让开发者无需关心底层细节即可部署和运维云原生应用。
+
+将 KCL 与 KubeVela 一起使用具有如下好处:
+
+- **更简单的配置**：在客户端层面为 KubeVela OAM 配置提供更强的模版化能力如条件，循环等，减少样板 YAML 书写，同时复用 KCL 模型库和工具链生态，提升配置及策略编写的体验和管理效率。
+- **更好的可维护性**：通过 KCL 可以提供更有利于版本控制和团队协作的配置文件结构，而不是围绕 YAML 进行配置，同时搭配 KCL 编写的 OAM 应用模型，可以使得应用配置更易于维护和迭代。
+- **更简化的操作**：结合 KCL 的配置简洁性和 KubeVela 的易用性，可以简化日常的操作任务，比如部署更新、扩展或回滚应用。开发者可以更加专注于应用本身，而不是部署过程中的繁琐细节。
+- **更好的跨团队协作**：通过 KCL 配置分块编写以及包管理能力与 KubeVela 结合使用，可以定义更清晰的界限，使得不同的团队（如开发、测试和运维团队）可以有条理地协作。每个团队可以专注于其职责范围内的任务，分别交付、分享和复用各自的配置，而不用担心其他方面的细节。
+
+## 快速开始
+
+### 1. 配置 Kubernetes 集群
+
+- 安装 [K3d](https://github.com/k3d-io/k3d) 并创建一个集群
+
+```bash
+k3d cluster create
+```
+
+> 注意：你可以在此方案中使用其他方式创建您自己的 Kubernetes 集群，如 kind, minikube 等。
+
+### 2. 安装 KubeVela
+
+- 安装 KubeVela CLI
+
+```bash
+curl -fsSl https://kubevela.net/script/install.sh | bash
+```
+
+- 安装 KubeVela Core
+
+```bash
+vela install
+```
+
+### 3. 安装 KCL 并编写配置
+
+- 安装 KCL
+
+```bash
+curl -fsSL https://kcl-lang.io/script/install-cli.sh | /bin/bash
+```
+
+- 新建工程并添加 OAM 依赖
+
+```shell
+kcl mod init kcl-play-svc && cd kcl-play-svc && kcl mod add oam
+```
+
+- 在 main.k 中编写如下代码
+
+```python
+import oam
+
+oam.Application {
+    metadata.name = "kcl-play-svc"
+    spec.components = [{
+        name = metadata.name
+        type = "webservice"
+        properties = {
+            image = "kcllang/kcl"
+            ports = [{port = 80, expose = True}]
+            cmd = ["kcl", "play"]
+        }
+    }]
+}
+```
+
+> 注意，你可以在 ArtifactHub 上查阅到相应的 OAM 模型文档或者直接在 IDE 中查看 [https://artifacthub.io/packages/kcl/kcl-module/oam](https://artifacthub.io/packages/kcl/kcl-module/oam) or in the IDE extension.
+
+![oam-definition-hover](/img/blog/2023-12-15-kubevela-integration/oam-definition-hover.png)
+
+### 4. 部署应用并验证
+
+- 下发配置
+
+```shell
+kcl run | vela up -f -
+```
+
+- 端口转发
+
+```shell
+vela port-forward kcl-play-svc
+```
+
+然后我们可以在浏览器中看到 KCL Playground 应用成功运行
+
+![kcl-play-svc](/img/blog/2023-12-15-kubevela-integration/kcl-play-svc.png)
+
+## 结论
+
+通过本篇文档的教程，我们可以使用 KubeVela 和 KCL 等初步部署云原生应用，未来我们将补充更多文档讲解如何在客户端使用 KCL 进一步扩展 KubeVela 的能力
+
+- 使用 KCL 的继承、组合和校验手段扩展 OAM 模型，比如根据您的基础设施或者组织基于 OAM 定义更适合的应用抽象模型
+- 使用 KCL 配置分块编写，条件，逻辑，循环和模块化能力更好地组织 OAM 多环境配置，提升模版化能力，比如将较长的 App Definition 分散到不同的文件进行组织，减少样板配置
+- 与 KusionStack 和 ArgoCD 等项目进一步集成实现更好的 GitOps

versioned_docs/version-0.7.0/user_docs/guides/working-with-kubevela/_category_.json

@@ -0,0 +1,4 @@
+{
+  "label": "KubeVela",
+  "position": 16
+}