add kcl-openapi binary install script and update kcl-openapi doc

Author: amyXia1994

docs/tools/cli/openapi/quick-start.md

@@ -6,13 +6,39 @@ sidebar_position: 1
 
 ## 1. Install KCLOpenAPI Tool
 
-You can install the kcl-openapi tool with go install:
+The kcl-openapi tool can be installed in following ways: 
+
+- [go install](#11-go-install)
+- [curl|sh install (MacOS & Linux)](#12-curlsh-install-macos--linux)
+- [download from release](#13-dowload-from-release)
+
+## 1.1 go install
+
+```shell
+go install kcl-lang.io/kcl-openapi@latest
+```
+
+## 1.2 Curl|sh install (MacOS & Linux)
+
+If you don't have go, you can install the CLI with this one-liner:
 
 ```shell
-go install kusionstack.io/kcl-openapi@latest
+curl https://kcl-lang.io/scripts/install-kcl-openapi.sh | sh
 ```
 
-To verify the installation, you can run the command: `kcl-openapi generate model -h` and the following information indicates your successful installation:
+## 1.3 Dowload from release
+
+```shell
+# 1. download the released binary from:
+# https://github.com/kcl-lang/kcl-openapi/releases
+
+# 2. Unzip the package and add the binary location to PATH
+export PATH="<Your directory to store KCLOpenapi binary>:$PATH"
+```
+
+## 1.4 Verify your installation
+
+- To verify the installation, you can run the command: `kcl-openapi generate model -h` and the following information indicates your successful installation:
 
 ```shell
 kcl-openapi command helps you to generate KCL schema structure from K8s CRD YAML/JSON file.

docs/user_docs/guides/working-with-k8s/_from_kubernetes.md

@@ -0,0 +1,49 @@
+# Adopt From Kubernetes to KCL
+
+## 1. Kubernetes OpenAPI Spec
+
+Starting from Kubernetes 1.4, the alpha support for the OpenAPI specification (known as Swagger 2.0 before it was donated to the OpenAPI Initiative) was introduced, and the API descriptions follow the [OpenAPI Spec 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md). And since Kubernetes 1.5, Kubernetes supports [directly extracting models from source code and then generating the OpenAPI spec file](https://github.com/kubernetes/kube-openapi) to automatically keep the specifications and documents up to date with the operation and models.
+
+In addition, Kubernetes CRD uses [OpenAPI V3.0 validation](https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#validation) to describe a custom schema (in addition to the built-in attributes apiVersion, Kind, and metadata), that APIServer uses to validate the CR during the resource creation and update phases.
+
+## 2. KCL OpenAPI Support
+
+The `kcl-openapi` tool supports extracting and generating KCL schemas from Kubernetes OpenAPI/CRD. the [KCL OpenAPI Spec](/docs/tools/cli/openapi/spec) defines the mapping between the OpenAPI specification and the KCL language features. For a quick start with the tool, see [KCL OpenAPI tool](/docs/tools/cli/openapi/)
+
+## 3. Migrate From Kubernetes To KCL
+
+### 3.1 Write configurations based on the Kusion_Models package
+``
+We provide an out-of-the-box `kusion_models` package for you to quickly start. It contains a well-designed frontend model called [`Server schema`](https://github.com/KusionStack/konfig/blob/main/base/pkg/kusion_models/kube/frontend/server.k). You can declare the configurations by initializing the `Server schema`. For the description and usage of the schema and its attributes, please refer to the [Server schema documentation](https://kusionstack.io/docs/reference/model/kusion_models/kube/frontend/doc_server).
+``
+### 3.2 Build Your Custom Frontend Models
+
+The existing KCL Models may not meet your specific business requirements, then you can also design your custom frontend model package. You can design your custom models based on the pre-generated Kubernetes KCL models among all versions. And you can also develop your custom scripts to migrate your configuration data as what `kube2kcl` tool does. 
+
+#### 3.2.1 Get the k8s package
+
+The [Kubernetes KCL models](https://github.com/orgs/KusionStack/packages/container/package/k8s) among all versions are pre-generated, you get it by executing `kpm add k8s:<version>` under your project. For detailed information about kpm usage, please refer to [kpm quick start guide](https://github.com/kcl-lang/kpm#quick-start).
+
+Alternatively, if you may want to generate them yourself, please refer to [Generate KCL Packages from Kubernetes OpenAPI Specs](https://github.com/kcl-lang/kcl-openapi/blob/main/docs/generate_from_k8s_spec.md).
+
+#### 3.2.2 Design Custom Frontend Models
+
+Since the Kubernetes built-in models are atomistic and kind of complex to beginners, we recommend taking the native model of Kubernetes as the backend output model and designing a batch of frontend models which could become a more abstract, friendlier and simpler interface to the user. You can refer to the design pattern in the [`Server Schema in the Konfig repo`](https://github.com/KusionStack/konfig/blob/main/base/pkg/kusion_models/kube/frontend/server.k).
+
+#### 3.2.3 Migrate The Configuration Data
+
+You can develop your custom scripts to migrate your configuration data automatically. KCL will later provide writing scaffolding and writing guidelines for this script.
+
+## 4. Migrate From Kubernetes CRD
+
+If you developed CRDs, you can generate the KCL version of the CRD schemas and declare CRs based on that.
+
+* Generate KCL Schema from CRD
+
+    ```
+    kcl-openapi generate model --crd --skip-validation -f <your_crd.yaml>
+    ```
+
+* Define CR based on CRDs in KCL
+
+    You can initialize the CRD schema to define a CR, or further, you can use the generated schema as a backend model and design a frontend interface for users to initialize. The practice is similar to what `KCL Models` does on Kubernetes built-in models.

docs/user_docs/guides/working-with-k8s/adopt_from_kubernetes.md

@@ -6,13 +6,35 @@ sidebar_position: 1
 
 ## 1. 安装 KCLOpenAPI 工具
 
-您可通过 go install 快速安装 kcl-openapi：
+目前有多种安装方式可选：
+
+- [通过 go install 安装](#11-通过-go-install-安装)
+- [通过 curl|sh 安装（仅限 MacOS & Linux）](#12-通过-curlsh-安装（仅限-MacOS-Linux）)
+- [下载发布包](#13-下载发布包)
+
+## 1.1 通过 go install 安装
+
+```shell
+go install kcl-lang.io/kcl-openapi@latest
+```
+
+## 1.2 通过 curl|sh 安装（仅限 MacOS & Linux）
 
 ```shell
-go install kusionstack.io/kcl-openapi@latest
+curl https://kcl-lang.io/scripts/install-kcl-openapi.sh | sh
+```
+
+## 1.3 下载发布包
+
+```shell
+# 1. 下载二进制程序
+# https://github.com/kcl-lang/kcl-openapi/releases
+
+# 2. 解压发布包，并将命令添加至 PATH
+export PATH="<Your directory to store KCLOpenapi binary>:$PATH"
 ```
 
-## 1.2 验证安装结果
+## 1.4 验证安装结果
 
 安装完成后，您可执行 `kcl-openapi generate model -h`，如果看到如下信息则说明安装成功：
 

i18n/zh-CN/docusaurus-plugin-content-docs/current/tools/cli/openapi/quick-start.md

@@ -0,0 +1,49 @@
+# From Kubernetes
+
+## 1. Kubernetes OpenAPI Spec
+
+从 Kubernetes 1.4 开始，引入了对 OpenAPI 规范（在捐赠给 Open API Initiative 之前称为 swagger 2.0）的 alpha 支持，API 描述遵循 [OpenAPI 规范 2.0](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md)，从 Kubernetes 1.5 开始，Kubernetes 能够直接从[源码自动地提取模型并生成 OpenAPI 规范](https://github.com/kubernetes/kube-openapi)，自动化地保证了规范和文档与操作/模型的更新完全同步。
+
+此外，Kubernetes CRD 使用 [OpenAPI v3.0 validation](https://kubernetes.io/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definitions/#validation) 来描述（除内置属性 apiVersion、kind、metadata 之外的）自定义 schema，在 CR 的创建和更新阶段，APIServer 会使用这个 schema 对 CR 的内容进行校验。
+
+## 2. KCL OpenAPI 支持
+
+KCLOpenAPI 工具支持从 OpenAPI/CRD 定义提取并生成 KCL schema. 在[KCLOpenapi Spec](/docs/tools/cli/openapi/spec)中明确定义了 OpenAPI 规范与 KCL 语言之间的映射关系。
+
+## 3. 从 Kubernetes 模型迁移到 KCL
+
+### 3.1 基于 kusion_models 编写配置
+
+我们为你提供了一个开箱即用的 `kusion_models` 包，让你可以快速开始。其中包含一个精心设计的前端模型，称为[服务器模型](https://github.com/KusionStack/konfig/blob/main/base/pkg/kusion_models/kube/frontend/server.k)(Server schema)。你可以通过初始化 `Server schema` 来声明其配置。有关模式及其属性的说明和用法，请参阅 [Server schema 文档](https://kusionstack.io/docs/reference/model/kusion_models/kube/frontend/doc_server)。
+
+### 3.2 创建自定义的 models 前端模型
+
+现有的 `kusion_models` 模型可能无法满足你的特定业务需求，那么你也可以设计自定义前端模型包。 您可基于预先生成的 Kubernetes KCL 包自定义您的前端模型。您还可以仿照`kube2kcl` 工具的模式，开发自定义脚本，完成配置数据的迁移。
+
+#### 3.2.1 获取 Kubernetes KCL 模型
+
+我们提供了预生成的各版本[Kubernetes KCL模型](https://github.com/orgs/KusionStack/packages/container/package/k8s)，您可以在项目下执行 `kpm add k8s:<version>` 来获得它。有关 kpm 使用的详细信息，请参考 [kpm快速入门指南](https://github.com/kcl-lang/kpm#quick-start)。
+
+或者，如果您需要自己生成这些包，请参考[从 Kubernetes OpenAPI 文件生成 KCL 包](https://github.com/kcl-lang/kcl-openapi/blob/main/docs/generate_from_k8s_spec.md)。
+
+#### 3.2.2 编写自定义前端模型
+
+由于 Kubernetes 内置模型较为原子化和复杂，我们推荐以 Kubernetes 原生模型作为后端输出的模型，对其进一步抽象，而向用户暴露一份更为友好和简单的前端模型界面，具体您可参照 Konfig 仓库中 [kusion_models Server](https://github.com/KusionStack/konfig/blob/main/base/pkg/kusion_models/kube/frontend/server.k) 模型的设计方式进行。
+
+#### 3.2.3 迁移配置数据
+
+对于存量的 Kubernetes 配置数据，您可以仿照 kube2Kcl 工具的做法，编写自定义的转换脚本，进行一键迁移。Kusion 后续将提供该脚本的编写脚手架和编写指南。
+
+## 4. 从 Kubernetes CRD 迁移
+
+如果您的项目中使用了 CRD，也可以采用类似的模式，生成 CRD 对应的 KCL schema，并基于该 schema 声明 CR。
+
+* 从 CRD 生成 KCL Schema
+
+    ```
+    kcl-openapi generate model --crd --skip-validation -f your_crd.yaml
+    ```
+
+* 使用 KCL 声明 CR
+
+    使用 KCL 声明 CR 的模式与声明 Kubernetes 内置模型配置的模式相同，在此不做赘述。