Skip to content

Latest commit

 

History

History
124 lines (114 loc) · 3.03 KB

extend.md

File metadata and controls

124 lines (114 loc) · 3.03 KB
Raw
title description position category
Yaml 继承
Yaml 继承
5
使用文档

Yaml 继承

通过关键字extend， 解决多个Yaml配置冗余的问题。

典型场景

比如使用Serverless Devs部署一个函数计算FC应用的时候，预发环境的和正式环境除了service名称不一致。其他配置完全一致。Yaml配置如下

├── code
├── s.yaml
├── s.prod.yaml
└── s.pre.yaml

s.yaml为默认配置

edition: 3.0.0
access: "default"
resources:
  fc-deploy-test:
    component: fc
    props:
      region: cn-hangzhou
      service:
        name: fc-service
        nasConfig: Auto
        description: "Serverless Devs Service"
      function:
        name: hello-function
        description: "Serverless Devs Function"
        codeUri: "./"
        runtime: nodejs12
        timeout: 60

s.pre.yaml配置如下

extend: s.yaml
resources:
  fc-deploy-test:
    props:
      service:
        name: fc-service-pre
        tracingConfig: Disable

s.pro.yaml配置如下

extend: s.yaml
resources:
  fc-deploy-test:
    props:
      service:
        name: fc-service-pro
        tracingConfig: Enable

显示的声明 extend关键字，获得继承能力

最终生效的配置

通过指定yaml配置s deploy -t s.pro.yaml生效

edition: 3.0.0
access: "default"
resources:
  fc-deploy-test:
    component: fc
    props:
      region: cn-hangzhou
      service:
        name: fc-service-pro
        tracingConfig: Enable
        nasConfig: Auto
        description: "Serverless Devs Service"
      function:
        name: hello-function
        description: "Serverless Devs Function"
        codeUri: "./"
        runtime: nodejs12
        timeout: 60

合并规则

配置的合并使用extend2 模块进行深度拷贝。 但是考虑到yaml的配置层级比较深，比如上面的示例,我们在预发环境需要覆盖resource名称，需要严格按照层级关系进行编写，相对繁琐。

resources:
  fc-deploy-test:
    props:
      service:
        name: fc-service-pro
        tracingConfig: Enable

数组合并

数据在做合并的时候，直接覆盖，而不是合并操作

const a = {
  arr: [1, 2],
};
const b = {
  arr: [3],
};
extend(true, a, b);
// => { arr: [ 3 ] }

最佳实践

Yaml继承一般用作环境划分，比如预发环境为s.pre.yaml，线上环境为s.pro.yaml，部署时候通过指定对应部署模版s deploy -t s.pro.yaml配置。

常见的环境变量

下面是一些常见的环境变量值以及他们对应的说明。

值 说明
local 本地开发环境
dev/daily/development 日常开发环境
pre/prepub 预生产环境
prod/production 生产环境
test/unittest 单元测试环境