InsertK8sApplication - 创建K8s应用

内网 SLB 后端端口，也是应用的服务端口，范围为 1~65535。

内网 SLB 前端端口，范围为 1~65535。

镜像地址，当设置PackageType为Image时，此参数项为必填。

应用描述信息。

镜像的仓库 ID。

应用实例数。

应用运行过程中，应用实例的 CPU 限额，单位：核数。如果 LimitmCpu 不为空，则忽略该参数。

应用运行过程中，应用实例的内存限额，单位：MB。LimitMem 取值要不小于 RequestsMem。

应用创建时，应用实例的 CPU 限额，单位：核数。设置为 0 时表示不限制。如果 RequestsmCpu，则使用 RequestsmCpu，忽略该参数。

应用创建时，应用实例的内存限额，单位：MB。设置为 0 时表示不限制。RequestsMem 的取值不能大于 LimitMem 的取值。

应用启动命令。如果设置该参数，镜像在启动时，会替代镜像中的原有的启动命令。

与命令组合使用，命令的参数是 JsonArray 字符串，格式如：[{"argument":"-c"},{"argument":"test"}]。其中-c、test为需要设置的两个参数。

应用名称。必须以字母开头，支持数字、字母和短划线（-），最多支持 36 个字符。

私网 SLB 协议，支持 TCP、HTTP 和 HTTPS 协议。

私网 SLB ID，不配置时，EDAS 会自动为用户新购 SLB。

集群 ID，可调用 ListCluster 接口获取，详情请参见 ListCluster 。

公网 SLB ID，不配置时，EDAS 会自动为用户新购 SLB。

公网 SLB 协议，支持 TCP、HTTP 和 HTTPS 协议。

公网 SLB 前端端口，范围为 1~65535。

私网 SLB 后端端口，也是应用的服务端口，范围为 1~65535。

部署环境变量，格式需要符合 JSON 对象数组。支持三种类型的环境变量，分别是普通环境变量，K8s ConfigMap 环境变量，K8s Secret 环境变量。普通环境变量格式如下所示：

{"name":"x", "value": "y"}

ConfigMap 环境变量配置可以将指定的 ConfigMap 中对应的 key 的值注入到容器的环境变量中，配置的格式如下所示：

{ "name": "x2", "valueFrom": { "configMapKeyRef": { "name": "my-config", "key": "y2" } } }

Secret 环境变量配置可以将指定的 Secret 中对应的 key 的值注入到容器的环境变量中，配置的格式如下所示：

{ "name": "x3", "valueFrom": { "secretKeyRef": { "name": "my-secret", "key": "y3" } } }

停止前执行脚本，示例格式：{"tcpSocket":{"host":"", "port":8080}}。

如果设置为""或者{}表示删除，不设置表示忽略。

启动后执行脚本，格式如：{"exec":{"command":\["cat","/etc/group"\]}}。

如果设置为""或者{}表示删除，不设置表示忽略。

容器存活状态监测 ，格式如{"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"tcpSocket":{"host":"", "port":8080}}。

如果设置为""或者{}表示删除，不设置表示忽略。

容器业务状态检查，如果检查失败，经过 K8s Service 的流量将不转入到该容器，格式如：{"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": \[{"name": "test","value": "testvalue"}\]}}。

如果设置为""或者{}表示删除，不设置表示忽略。

挂载的 NAS 的 ID。如果不填，且存在 mountDescs 字段，则默认将自动购买一个 NAS 并挂载到 VPC 内的交换机上。

挂载配置描述，为一个序列化的 JSON。例如：\[{"nasPath": "/k8s","mountPath": "/mnt"},{"nasPath": "/files","mountPath": "/app/files"}\]。其中，nasPath是指文件储存路径；mountPath是指挂载到容器内的路径。

NAS 存储类型，包括：

• 通用型 NAS：Capacity（容量型）、Performance（性能型）
• 极速型 NAS：Standard（标准型）、Advance（高级型）

目前只支持 Performance 类型。

宿主机文件挂载到容器内的配置。例如：\[{"type":"","nodePath":"/localfiles","mountPath":"/app/files"},{"type":"Directory","nodePath":"/mnt","mountPath":"/app/storage"}\]。其中：

• nodePath为宿主机路径。

• mountPath为容器内的路径。

• type为挂载类型。

K8s 集群的命名空间，它将决定您的应用部署在哪个 K8s 命名空间。默认为 default。

EDAS 命名空间对应 ID，非默认命名空间须填写。

应用包类型。可选参数值包含：FatJar、WAR 和 Image。

部署包地址。通过 FatJar 或 WAR 包部署的应用需要配置部署包地址。

部署包的版本号，WAR 和 FatJar 类型必填。请自定义它的含义。

部署的包依赖的 JDK 版本。可选的参数值为 Open JDK 7、Open JDK 8 或 Custom OpenJDK。镜像部署方式不支持此参数。当使用 Custom OpenJDK 时，还需配置 UserBaseImageUrl 字段。

部署包依赖的 Tomcat 版本。适用于通过 WAR 包部署的 Spring Cloud 和 Dubbo 应用，镜像不支持此参数。

部署的包依赖的EDAS-Container版本。

URI 编码方式，支持 ISO-8859-1、GBK、GB2312 和 UTF-8。

useBodyEncodingForURI 是否启用。

应用创建时，应用实例的 CPU 限额，单位：毫核数。

应用运行过程中，应用实例的 CPU 限额。 单位：毫核数，设置为 0 表示不限制。

容器运行时类型，仅适用于使用安全沙箱容器的集群。

是否将应用实例分布到多可用区。true代表是，其他值为否。

变更流程超时时间，单位：秒。取值范围为 1~1800 秒，不填默认为 1800 秒。

是否接入 AHAS：

• true：接入 AHAS。
• false：不接入 AHAS。

Tomcat 容器配置，设置为""或"{}"表示删除配置：

• useDefaultConfig：是否使用自定义配置，若为 true，则表示不使用自定义配置，若为 false，则表示使用自定义配置。若不使用自定义配置，则下面的参数配置将不会生效。

• contextInputType：选择应用的访问路径。

  • war：无需填写自定义路径，应用的访问路径是 WAR 包名称。
  • root：无需填写自定义路径，应用的访问路径是/。
  • custom：需要在下面的自定义路径中填写自定义的路径。

• contextPath：自定义路径，当 contextInputType 类型为 custom 时，才需要配置此参数。

• httpPort：端口范围为 1024~65535，小于 1024 的端口需要 Root 权限才能操作。因为容器配置的是 Admin 权限，所以请填写大于 1024 的端口。如果不配置，则默认为 8080。

• maxThreads：配置连接池的连接数大小，默认大小是 400。

  说明

  此项配置对应用性能有很大影响，请由专业人士配置。

• uriEncoding：Tomcat 的编码格式，包括 UTF-8、ISO-8859-1、GBK 和 GB2312。如果不设置则默认为 ISO-8859-1。

• useBodyEncoding：是否使用 BodyEncoding for URL。

• useAdvancedServerXml：是否使用高级配置自定义设置 server.xml 文件，当上述参数类型和具体参数无法满足您的需求时，可以选中使用高级设置，直接对 Tomcat 的 Server.xml 文件进行编辑。

• serverXml：高级配置中自定义设置的 server.xml 文本文件内容，当 useAdvancedServerXml 为 true 时生效。

Java 启动参数用于在 Java 应用启动时配置启动参数。可配置：内存配置、应用、GC 策略、工具、服务注册和发现配置和自定义等配置，正确配置这些参数有助于降低垃圾回收（GC）开销，从而缩短服务器响应时间并提高吞吐量。参数格式为 JSON 字符串：original 为配置值，startup 为启动参数，系统将自动拼接所有的 startup 作为应用程序的 Java 启动参数。设置为""或"{}"表示删除配置。JSON 中 key 取值如下：

• InitialHeapSize：代表初始化堆大小。
• MaxHeapSize：代表最大堆大小。
• CustomParams：代表用户自定义内容，如 JVM -D 参数等。
• 其它情况：可自行查看前端提交的 JSON 结构。

Logstore 配置，设置为""或"{}"表示删除配置：

• Configs：

  • type：采集类型，文件类型为 file，标准输出类型为 stdout。

  • Logstore：Logstore 名称。请确保 Logstore 名称在同一个集群中不重复，其命名应符合规则。

    • 日志库名称仅支持小写字母、数字、短划线（-）和下划线（_）。
    • 必须以小写字母和数字开头和结尾。
    • 名称长度为 3~63 个字符。若为空，则由系统自动生成。

  • LogDir：若为标准输出类型，则采集路径为 stdout.log，若为文件类型，则为采集的文件路径，支持通配，采集路径应符合正则：^/(.+)/(.*)^/$。

是否为多语言应用。

是否将应用实例分布到多个节点。true代表是，其他值为否。

配置 K8s PVC（PersistentVolumeClaim）挂载，支持将 K8s PVC 卷挂载到指定的容器目录。PvcMountDescs 的配置参数说明如下：

• pvcName：PVC 卷名称，PVC 卷必须已经存在，且处于 Bound 状态。
• mountPaths：挂载目录列表，支持配置多个挂载目录。每个挂载目录支持两个配置参数。
  • mountPath：挂载路径，以正斜线（/）开头的容器绝对路径。
  • readOnly：挂载模式，true 为只读，false 为可读写，默认为 false。

配置 K8s ConfigMap 和 Secret 挂载，支持将 ConfigMap 和 Secret 挂载到指定的容器目录。ConfigMountDescs 的配置参数说明如下：

• name：ConfigMap 或 Secret 的名称。
• type：配置类型，支持 ConfigMap 和 Secret 两种类型。
• mountPath：挂载路径，以正斜线（/）开头的容器绝对路径。

只有在用户使用一个从未导入的集群来创建应用时，才需要指定 csClusterId。

只有在用户使用一个从未导入的集群来创建应用，同时开启 ASM 时，才需要设置这个值为 true。

配置 K8s EnvFrom 类型的环境变量，将指定的 ConfigMap 或 Secret 挂载到指定目录，每个 key 对应目录下的一个文件，文件的内容为该 key 对应的 value。

EnvFroms 的配置参数说明如下：

• configMapRef：ConfigMap 引用，该字段包括以下参数：
  • name：ConfigMap 名称。
• secretRef：Secret 引用，该字段包括以下参数：
  • name：Secret 名称。

配置 K8s emptyDir 挂载，支持将 emptyDir 卷挂载到指定的容器目录。EmptyDirs 的配置参数说明如下：

• mountPath：容器挂载路径，必填。
• readOnly：是否只读，可选，true 为只读，false 为读写，默认为 false。
• subPathExpr：子目录表达式，可选。

配置edas container版本，与edasContainerVersion字段冲突。建议使用edasContainerVersion字段。

自定义关联。

自定义公差。

资源组 ID。

应用 Pod 注解。

应用 Pod 标签。

是否开启推空保护：

• true：开启推空保护。
• false：不开启推空保护。

是否启用无损上线规则：

• true：启用无损上线规则。
• false：不启用无损上线规则。

服务预热时长，单位：秒。取值范围为 0~86400 秒。

服务延迟注册时长，单位：秒。取值范围为 0~86400 秒。

服务预热曲线。取值范围 0~20。默认为 2（适合于一般预热场景），表示在预热周期内服务提供者的流量接收曲线形状呈 2 次曲线形状。

是否启用无损滚动发布模式配置通过就绪检查前完成服务注册：

• true：打开开关会为应用无侵入提供 55199 端口和/health 路径的健康检查方式，当完成服务注册后，该接口返回 200，否则返回 500。

  说明

  若同时配置LosslessRuleRelated为true，则该接口检查是否完成服务预热。

• false：不为应用提供检查是否完成服务注册的接口。

是否启用无损滚动发布模式配置通过就绪检查前完成服务预热：

• true：打开开关会为应用无侵入提供 55199 端口和/health 路径的健康检查方式，当完成服务预热后，该接口返回 200，否则返回 500。
• false：不为应用提供检查是否完成服务预热的接口。

K8s 服务 Service 配置。

创建应用使用的应用模版名称，若创建应用时指定应用模版，则将优先使用应用模版和 AppConfig 参数确定应用配置，忽略其他配置。

使用应用模版时的应用配置，JSON 格式字符串。

临时存储资源需求上限，单位：GB。设置 0 表示不限制。

临时存储最小资源需求，单位：GB。设置 0 表示不限制。

用户指定的镜像拉取凭证名，需要自行创建相关 Secret 配置。

构建镜像仓库使用的仓库 ID，留空表示使用 EDAS 提供的默认仓库。当前只支持 EDAS 提供的默认仓库。

创建应用时 Workload 的类型，目前仅支持 Deployment 类型。

为应用 Pod 设置 Sidecar 容器。支持设置容器配置的格式 YAML，其值为 Sidecar 容器 YAML 配置 base64 编码后的值。

为应用 Pod 设置初始化容器。支持设置容器配置的格式 YAML，其值为 Init 容器 YAML 配置 base64 编码后的值。

使用自定义 JDK 运行时，需要配置基础镜像地址。该地址需要可公开访问，EDAS 服务端会拉取该镜像，用于构建应用镜像。

设置应用优雅停止超时时间。单位：秒。

镜像目标平台架构，当使用 war、jar 部署时有效，输入样例：

• 指定 x86 64 架构：linux/amd64

• 指定 arm 64 架构：linux/arm64

• 指定构建双架构镜像：linux/amd64,linux/arm64

• 不输入：默认架构

启动探针可以用于对慢启动容器进行存活性检测，避免它们在启动运行之前就被杀掉，格式如：{"failureThreshold": 3,"initialDelaySeconds": 5,"successThreshold": 1,"timeoutSeconds": 1,"httpGet": {"path": "/consumer","port": 8080,"scheme": "HTTP","httpHeaders": [{"name": "test","value": "testvalue"}]}}。

如果设置为""或者{}表示删除，不设置表示忽略。