Skip to content

Commit 02d1ce0

Browse files
committed
draft
Signed-off-by: Zihan Kuang <zihan_kuang@outlook.com>
1 parent f21a655 commit 02d1ce0

1 file changed

Lines changed: 76 additions & 0 deletions

File tree

content/en/kanvas/getting-started/starting-helm.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,3 +43,79 @@ You should now have Kanvas design of the chart.
4343
![Copy of a Design](/kanvas/getting-started/images/2024-04-18_18-10.png)
4444

4545
Continue to make any changes if required or deploy it.
46+
47+
他想要的是一个**结构化、信息详尽且能解决实际问题的指南**
48+
49+
我们来分解一下,并为你构建一个 Lee 想要的文档大纲。
50+
51+
**标题:在 Meshery 中导入设计 (Importing Designs in Meshery)**
52+
53+
**1. 简介 (Introduction)**
54+
* 这部分是**通用内容**,不会重复。
55+
* 简要说明什么是“导入设计”,以及为什么用户会需要这个功能(例如,复用现有配置、与团队共享等)。
56+
* 概述支持的三种主要导入方式:
57+
* 通过文件上传 (File Upload)
58+
draw and drap
59+
model file
60+
* 通过 URL (Via URL)
61+
model url
62+
* 通过 GitHub (Via GitHub)
63+
没试过,试一下
64+
65+
**2. 导入方式详解 (Using a Tab-based Layout)**
66+
* **标签页 (Tab Panes)** 的地方。每个标签对应一种导入方式。
67+
68+
* **【标签页 1: 文件上传 (File Upload)】**
69+
* **操作步骤**: 简洁地描述如何通过拖拽或浏览文件来上传。*(这部分步骤可能很短,可以减少截图)*
70+
* **支持的格式与具体要求 (Supported Formats & Requirements)**:
71+
* **Helm Chart**:
72+
* 必须是打包好的 `tar.gz` 压缩文件。
73+
* **错误示例**: 不能只上传单个 `chart.yaml``values.yaml` 文件。
74+
* **Kustomize**:
75+
* 必须是包含 `kustomization.yaml` 及其相关文件的**目录压缩包**
76+
* **错误示例**: 不能只上传单个 `kustomization.yaml` 文件。
77+
* **Docker Compose**:
78+
* 必须是有效的 `docker-compose.yaml``docker-compose.yml` 文件。
79+
* **Kubernetes Manifests**:
80+
* 可以是单个 YAML 文件,也可以是包含多个 YAML 文件的目录压缩包。
81+
82+
* **【标签页 2: 通过 URL 导入】**
83+
* **操作步骤**: 描述如何粘贴 URL 并点击导入。
84+
* **支持的格式与具体要求**:
85+
* 说明 URL 必须是指向**原始文件 (raw file)** 的直接链接。
86+
* 列出支持的格式(如指向单个 `yaml` 文件、`tar.gz` 包的 URL 等)以及对应的注意事项。
87+
88+
* **【标签页 3: 通过 GitHub 导入】**
89+
* **操作步骤**: 描述如何使用 GitHub 向导,授权并选择仓库和文件。
90+
* **支持的格式与具体要求**:
91+
* 说明支持识别仓库中的哪种文件或目录结构(例如,它会自动寻找 Helm Chart 还是 Kustomize 目录?)。
92+
* 解释相关的权限要求。
93+
94+
**3. 高级主题与常见问题 (Advanced Topics & FAQ)**
95+
* 这部分也是**通用内容**,用来解答 Lee 提出的那些更复杂的问题。
96+
* **合并与覆盖设计 (Merging & Overwriting Designs)**:
97+
* 回答“在一个已导入的设计上再拖拽一个文件会发生什么?”
98+
* 解释合并逻辑,例如是覆盖还是增量添加。
99+
* **支持的组合 (Supported Combinations)**:
100+
* 回答“能否将 Helm Chart 和 Kustomize 文件合并导入?”
101+
* **文件大小与限制 (File Size & Limitations)**:
102+
* 回答“可以导入一个超大的 Kubernetes 文件吗?”
103+
104+
在import model页面一次性放入多个file会出现:
105+
不会融合,只会取最后一个文件
106+
107+
在cloud端导入的时候
108+
helm和oci的不行/ k8s和meshery的可以
109+
110+
在kanvas页面import的时候
111+
可以选择融合或者import as new,h
112+
helm/oci可以融合,可以作为新文件
113+
k8s和meshery 也可以融合/作为新文件
114+
在kanvas页面上的import是功能完全正确的
115+
116+
docker compose
117+
https://github.com/docker/awesome-compose/tree/master/nginx-golang-postgres
118+
119+
kustomize example
120+
https://github.com/kubernetes-sigs/kustomize/tree/master/examples/helloWorld
121+

0 commit comments

Comments
 (0)