Skip to content

Latest commit

 

History

History
228 lines (186 loc) · 9.87 KB

README.md

File metadata and controls

228 lines (186 loc) · 9.87 KB

前言

注意:建议您直接阅读 fc3-domain 组件官方文档

简述

通过该组件,快速部署函数计算自定义域名

快速使用

  1. 在本地创建s.yaml
edition: 3.0.0 #  命令行YAML规范版本,遵循语义化版本(Semantic Versioning)规范
name: fcDomainApp #  项目名称
access: quanxi #  秘钥别名

resources:
  fc-domain-test: #  服务名称
    component: fc3-domain
    props: #  组件的属性值
      region: cn-huhehaote
      domainName: my.abc.com
      protocol: HTTP # HTTP | HTTPS 
      routeConfig:
        routes:
          - functionName: test-serverless-devs-custom-domain-ci-1
            methods:
              - GET
            path: /a
            qualifier: LATEST
          - functionName: test-serverless-devs-custom-domain-ci-2
            methods:
              - GET
            path: /bb
            qualifier: LATEST
  1. 可以通过s deploy快速进行部署

完整配置

edition: 3.0.0 #  命令行YAML规范版本,遵循语义化版本(Semantic Versioning)规范
name: fcDomainApp #  项目名称
access: quanxi #  秘钥别名

resources:
  fc-domain-test:
    component: fc3-domain
    props: #  组件的属性值
      region: cn-huhehaote
      # domainName: auto
      domainName: xiliu-test.shoushuai.top # 可以使用 auto 自动获取一个临时测试域名
      protocol: HTTP,HTTPS  # HTTP | HTTPS | HTTP,HTTPS
      routeConfig:
        routes:
          - functionName: test-serverless-devs-custom-domain-ci-1
            methods:
              - GET
            path: /a
            qualifier: LATEST
            rewriteConfig:
              equalRules:
                - match: /equalRules
                  replacement: /xxxx
              regexRules:
                - match: ^/old/[a-z]+/
                  replacement: /xxxx
              wildcardRules:
                - match: /api/*
                  replacement: /$1
          - functionName: test-serverless-devs-custom-domain-ci-2
            methods:
              - GET
            path: /bb
            qualifier: LATEST

      wafConfig:
        enableWAF: false
      
      tlsConfig:
        cipherSuites:
          - "TLS_RSA_WITH_AES_128_CBC_SHA"
          - "TLS_RSA_WITH_AES_256_CBC_SHA"
          - "TLS_RSA_WITH_AES_128_GCM_SHA256"
          - "TLS_RSA_WITH_AES_256_GCM_SHA384"
          - "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA"
          - "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA"
          - "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA"
          - "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA"
          - "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256"
          - "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384"
          - "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"
          - "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
          - "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305"
          - "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305"
          - "TLS_RSA_WITH_RC4_128_SHA"
          - "TLS_RSA_WITH_3DES_EDE_CBC_SHA"
          - "TLS_RSA_WITH_AES_128_CBC_SHA256"
          - "TLS_ECDHE_ECDSA_WITH_RC4_128_SHA"
          - "TLS_ECDHE_RSA_WITH_RC4_128_SHA"
          - "TLS_ECDHE_RSA_WITH_3DES_EDE_CBC_SHA"
          - "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256"
          - "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256"
        maxVersion: TLSv1.3
        minVersion: TLSv1.0
     
      certConfig:
        certName: test-cert
        certificate: oss://cn-huhehaote/serverless-devs-fc3-ci-test/xiliu-test.shoushuai.top.pem
        privateKey: oss://cn-huhehaote/serverless-devs-fc3-ci-test/xiliu-test.shoushuai.top.key
	  
      # certConfig:
      #   certName: test-cert
      #   certificate: /Users/songluo/work/code-inc/domain/examples/xiliu-test.shoushuai.top.pem
      #   privateKey: /Users/songluo/work/code-inc/domain/examples/xiliu-test.shoushuai.top.key

      # certConfig:
      #   certName: test-cert
      #   certificate: https://images.devsapp.cn/test/xiliu-test-cert/xiliu-test.shoushuai.top.pem
      #   privateKey: https://images.devsapp.cn/test/xiliu-test-cert/xiliu-test.shoushuai.top.key


      # certConfig:
      #   certId: 7246639

      # authConfig:
      #   authInfo: xxx
      #   authType: jwt || function || anonymous

其中针对 certConfig 可以支持如下四种方式:

    1. 本地文件形式
    1. http url 形式
    1. oss object 地址形式
    1. 阿里云数字证书管理服务中的ssl证书 id

参数详情

参数名 必填 类型 参数描述
region True enum 地域
domainName True string 已在阿里云备案或接入备案的自定义域名名称
protocol True enum 域名支持的协议类型:
HTTP:仅支持HTTP协议
HTTPS:仅支持HTTPS协议
HTTP,HTTPS:支持HTTP及HTTPS协议
routeConfig True object 路由表:自定义域名访问时的PATH到Function的映射
certConfig False object HTTPS证书的信息
tlsConfig False object TLS配置信息
wafConfig False object Web应用防火墙配置信息

命令相关

Deploy命令

进行函数计算自定义域名部署

参数全称 参数缩写 Yaml 模式下必填 参数含义
assume-yes y 选填 在交互时,默认选择y
access a 选填 本次请求使用的密钥,可以使用通过config 命令 配置的密钥信息,以及配置到环境变量的密钥信息
debug - 选填 打开debug模式,将会输出更多日志信息
help h 选填 查看帮助信息

Remove命令

移除函数计算自定义域名

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地区,取值范围请参考: 函数计算开服地域
domain-name - 选填 必填 自定义域名名字,比如 myabc.com
assume-yes y 选填 选填 在交互时,默认选择y
access a 选填 必填 本次请求使用的密钥,可以使用通过config 命令 配置的密钥信息,以及配置到环境变量的密钥信息
debug - 选填 选填 打开debug模式,将会输出更多日志信息
help h 选填 选填 查看帮助信息

Plan命令

展示函数计算自定义域名本地yaml配置和线上自定义域名配置差异

参数全称 参数缩写 Yaml 模式下必填 参数含义
access a 选填 本次请求使用的密钥,可以使用通过config 命令 配置的密钥信息,以及配置到环境变量的密钥信息
debug - 选填 打开debug模式,将会输出更多日志信息
help h 选填 查看帮助信息

Info命令

显示已经部署到线上的自定义域名配置信息

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地区,取值范围请参考: 函数计算开服地域
domain-name - 选填 必填 自定义域名名字,比如 myabc.com
access a 选填 必填 本次请求使用的密钥,可以使用通过config 命令 配置的密钥信息,以及配置到环境变量的密钥信息
debug - 选填 选填 打开debug模式,将会输出更多日志信息
help h 选填 选填 查看帮助信息