1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290 | # 应用名称
# 类型: 字符串(符合 dns1123 标准)
# 默认值: null
# 必须提供
# 对应 nhctl 参数: [NAME]
# 唯一
name: nocalhost
# 应用 manifest 类型
# 类型: 单选，可选项：helmGit/helmRepo/rawManifest
# 默认值: null
# 必须提供
# 对应 nhctl 参数: --type,-t
manifestType: helmGit
# helmGit类型此字段代表 Chart 相对于 Git 仓库根目录的位置。helmRepo 类型，此字段无意义。rawManifest 类型，此字段可以设置为 k8s manifest 文件夹相对于 Git 仓库的位置。
# 类型: 字符串[]
# 默认值: ["."]
# 必须提供
resourcePath: ["deployments/chart"]
# 指明应用是否以最小副本数量安装 (暂未实现，未来支持)
# 类型: boolean
# 默认值: false
# 可选
# 对应 nhctl 参数: TODO
minimalInstall: false
# 应用安装前的执行任务，须指定 k8s Job 的 yaml文件
# 类型: object[]
# 默认值: []
# 可选
onPreInstall:
# Job 的 yaml 文件, 相对于 Git 仓库的根目录
# 类型: 字符串
# 必须提供
- path: "job-1.yaml"
# Job 名称
# 类型: 字符串
# 必须提供
name: xxx-job
# 执行顺序，越小越先执行
# 类型: 整型
# 默认值: 0
# 可选
priority: -1
- path: "job-2.yaml"
name: xxx2-job
priority: 5
# 应用安装完毕后执行的任务，须指定 k8s Job 的 yaml文件 (暂未实现，未来支持)
# 类型: object[]
# 默认值: []
# 可选
onPostInstall:
# Job 的 yaml 文件, 相对于 Git 仓库的根目录
# 类型: 字符串
# 必须提供
- path: "job-1.yaml"
# Job 名称
# 类型: 字符串
# 必须提供
name: xxx-job
# 执行顺序，越小越先执行
# 类型: 整型
# 默认值: 0
# 可选
priority: -1
- path: "job-2.yaml"
name: xxx2-job
priority: 5
# 应用卸载前执行的任务，须指定 k8s Job 的 yaml文件 (暂未实现，未来支持)
# 类型: object[]
# 默认值: []
# 可选
onPreUninstall:
# Job 的 yaml 文件, 相对于 Git 仓库的根目录
# 类型: 字符串
# 必须提供
- path: "job-1.yaml"
# Job 名称
# 类型: 字符串
# 必须提供
name: xxx-job
# 执行顺序，越小越先执行
# 类型: 整型
# 默认值: 0
# 可选
priority: -1
- path: "job-2.yaml"
name: xxx2-job
priority: 5
# 应用卸载后执行的任务，须指定 k8s Job 的 yaml文件 (暂未实现，未来支持)
# 类型: object[]
# 默认值: []
# 可选
onPostUninstall:
# Job 的 yaml 文件, 相对于 Git 仓库的根目录
# 类型: 字符串
# 必须提供
- path: "job-1.yaml"
# Job 名称
# 类型: 字符串
# 必须提供
name: xxx-job
# 执行顺序，越小越先执行
# 类型: 整型
# 默认值: 0
# 可选
priority: -1
- path: "job-2.yaml"
name: xxx2-job
priority: 5
# 应用内的微服务列表
# 类型: object[]
# 默认值: []
# 可选
services:
# 微服务的名字,对应 Kubernetes 集群中的工作负载名称
# 类型: 字符串
# 默认值: null
# 必须提供
- name: service1
# 微服务对应的 k8s 工作负载类型
# 类型: 单选, 可选项: deployment/statefulset/pod/job/cronjob/daemonset 大小写不敏感
# 默认值: deployment
# 必须提供
serviceType: deployment
# 微服务的源码 Git 仓库地址
# 类型: 字符串
# 默认值: null
# 必须提供
gitUrl: "https://github.com/nocalhost/nocalhost.git"
# 微服务的 DevContainer 镜像
# 类型: 字符串
# 默认值: null
# 必须提供
devContainerImage: "codingcorp.coding.net/xxxx/go:latest"
# 进入 DevMode 时，默认的 shell 环境 (暂未实现，未来支持)
# 类型: 字符串
# 默认值: "/bin/sh"
# 可选
devContainerShell: "bash"
# 文件同步模式 (暂未实现，未来支持)
# "send" 单向同步本地文件到容器, "sendreceive" 双向同步
# 类型: 单选，send/sendreceive
# 默认值: "send"
# 可选
syncType: send
# 在开发模式下要同步的目录列表
# 类型: 字符串[]
# 默认值: ["."]
# 可选
syncFilePattern:
- "./src"
- "./pkg/fff"
# 在开发模式下要忽略同步的目录列表
# 类型: 字符串[]
# 默认值: []
# 可选
ignoreFilePattern:
- ".git"
- "./build"
# 进入开发模式后自动转发的端口列表
# 本地端口:远端端口
# 类型: 字符串[]
# 默认值: []
# 可选
devPorts:
- 8080:8080
- :8000 # 随机本地端口, 远端 8000
# 指明依赖的 Pods 标签选择器 (当前服务会等待被标签选择器选中的 Pod 处于 Ready 状态才启动)
# 类型: 字符串[]
# 默认值: []
# 可选
dependPodsLabelSelector:
- "name=mariadb"
- "app.kubernetes.io/name=mariadb"
# 指明依赖的 Jobs 标签选择器 (当前服务会等待被标签选择器选中的 Job 执行完毕才启动)
# 类型: 字符串[]
# 默认值: []
# 可选
dependJobsLabelSelector:
- "job-name=init-job"
- "app.kubernetes.io/name=init-job"
# 指定 DevContainer 的工作目录，源码会被传输到此目录
# 类型: 字符串
# 默认值: "/home/nocalhost-dev"
# 可选
workDir: "/root/nocalhost-dev"
# DevContainer 中需要持久化存储的目录列表
# 类型: 字符串[]
# 默认值: ["/home/nocalhost-dev"]
# 可选
persistentVolumeDir:
# 开发容器中要持久化的目录路径
# 类型: 字符串
# 默认值: null
# 必填
- path: "/root"
# 目录的容量
# 类型: 字符串
# 默认值: 10Gi
# 可选
capacity: 100Gi
# 在源码根目录下执行的构建编译命令
# 类型: 字符串
# 默认值: ""
# 可选
buildCommand: ["./gradlew", "package"]
# 在源码根目录下执行的启动服务命令
# 类型: 字符串
# 默认值: ""
# 可选
runCommand: ["./gradlew", "bootRun"]
# 在源码根目录下执行的启动调试服务命令
# 类型: 字符串
# 默认值: ""
# 可选
debugCommand: ["./gradlew", "bootRun", "--debug-jvm"]
# 在源码根目录下执行的支持热加载的启动服务命令
# 类型: 字符串
# 默认值: ""
# 可选
hotReloadRunCommand: ["bash", "-c", "kill `ps -ef|grep -i gradlew| grep -v grep| awk '{print $2}'`; gradlew bootRun"]
# 在源码根目录下执行的支持热加载的启动调试服务命令
# 类型: 字符串
# 默认值: ""
# 可选
hotReloadDebugCommand: ["bash", "-c", "kill `ps -ef|grep -i gradlew| grep -v grep| awk '{print $2}'`; gradlew bootRun --debug-jvm"]
# 该服务的远程调试端口
# 类型: 字符串
# 默认值: ""
# 可选
remoteDebugPort: 5005
# 使用 Git 仓库中的 .dev-container 声明来指定 DevContainer 镜像 (暂未实现，未来支持)
# 类型: 字符串
# 默认值: ""
# 可选
useDevContainer: false
# 指定 DevContainer 的资源申请和限制,配置信息符合 Kubernetes 对资源限定的约定 (暂未实现，未来支持)
# 类型: 对象
# 默认值: {}
# 可选
devContainerResources:
limits:
cpu: "1"
memory: 1g
requests:
cpu: "0.5"
memory: 200m
- name: service2
...
|