@@ -21,6 +21,7 @@ inputs:
21
21
region : ap-guangzhou
22
22
bucketName : my-bucket
23
23
protocol : http
24
+ replace : false # 是否替换式部署
24
25
hosts :
25
26
- host : abc.com
26
27
async : true
@@ -88,68 +89,69 @@ inputs:
88
89
89
90
主要参数描述
90
91
91
- | 参数名称 | 是否必选 | 默认值 | 描述 |
92
- | ------------------ | :------: | :----------: | :---------------------------------------------------------------------------------------- |
93
- | [src](#执行目录) | 是 | | 该项目的代码信息,参数参考执行目录 |
94
- | region | 否 | ap-guangzhou | 代码上传所在的 cos 区域。默认为广州区。 |
95
- | bucketName | 是 | | Bucket 名称。 不允许大写字母。如果你不加 AppId 后缀,则默认自动会为你加上。 |
96
- | protocol | 否 | https | 请求协议。Https 或 http |
97
- | env | 否 | | 环境变量参数文件。会将 env 下配置的参数写入 env.js 文件中,将该文件打包上传到你的代码里。 |
98
- | envPath | 否 | | 生成的 env.js 存放在你项目中的路径。默认是当前工作路径。 |
99
- | [cors](#跨域配置) | 否 | | 跨域访问配置 |
100
- | [hosts](#CDN-配置) | 否 | | CND 加速域名配置 |
92
+ | 参数名称 | 必选 | 默认值 | 描述 |
93
+ | ------------------ | :--: | :------------: | :---------------------------------------------------------------------------------------- |
94
+ | [src](#执行目录) | 是 | | 该项目的代码信息,参数参考执行目录 |
95
+ | bucketName | 是 | | Bucket 名称。 不允许大写字母。如果你不加 AppId 后缀,则默认自动会为你加上。 |
96
+ | region | 否 | ` ap-guangzhou` | 代码上传所在的 cos 区域。区。 |
97
+ | replace | 否 | `false` | 是否是替换式部署,如果为 `true`,部署时将 `先删除对应 bucket 的所有旧文件`。 |
98
+ | protocol | 否 | `https` | 请求协议。`https` 或 `http` |
99
+ | env | 否 | | 环境变量参数文件。会将 env 下配置的参数写入 env.js 文件中,将该文件打包上传到你的代码里。 |
100
+ | envPath | 否 | | 生成的 env.js 存放在你项目中的路径。默认是当前工作路径。 |
101
+ | [cors](#跨域配置) | 否 | | 跨域访问配置 |
102
+ | [hosts](#CDN-配置) | 否 | | CND 加速域名配置 |
101
103
102
104
# ## 执行目录
103
105
104
- | 参数名称 | 是否必选 | 默认值 | 描述 |
105
- | -------- | :------ : | :--------: | :----------------------------------------------------------- |
106
- | src | 是 | | 你构建的项目代码目录。 |
107
- | dist | 否 | | 钩子脚本执行构建后,输出的目录。如果配置 ` hook`, 此参数必填 |
108
- | hook | 否 | | 钩子脚本。在你项目代码上传之前执行。 |
109
- | index | 否 | index.html | 网站 index 页面 |
110
- | error | 否 | error.html | 网站 error 页面 |
106
+ | 参数名称 | 必选 | 默认值 | 描述 |
107
+ | -------- | :-- : | :-- --------: | :----------------------------------------------------------- |
108
+ | src | 是 | | 你构建的项目代码目录。 |
109
+ | dist | 否 | | 钩子脚本执行构建后,输出的目录。如果配置 `hook`, 此参数必填 |
110
+ | hook | 否 | | 钩子脚本。在你项目代码上传之前执行。 |
111
+ | index | 否 | ` index.html` | 网站 index 页面 |
112
+ | error | 否 | ` error.html` | 网站 error 页面 |
111
113
112
114
# ## 跨域配置
113
115
114
116
参考: https://cloud.tencent.com/document/product/436/8279
115
117
116
- | 参数 | 是否必选 | 类型 | Description |
117
- | -------------- | :------ : | -------- | :--------------------------------------------------------------------------------------------- |
118
- | id | 否 | String | 规则 ID |
119
- | allowedMethods | 是 | String[] | 允许的 HTTP 操作,枚举值:GET,PUT,HEAD,POST,DELETE |
120
- | allowedOrigins | 是 | String[] | 允许的访问来源,支持通配符`*`,格式为:`协议://域名[:端口]`,例如:`http://www.qq.com` |
121
- | allowedHeaders | 是 | | 在发送 OPTIONS 请求时告知服务端,接下来的请求可以使用哪些自定义的 HTTP 请求头部,支持通配符`*` |
122
- | maxAgeSeconds | shi | | 设置 OPTIONS 请求得到结果的有效期 |
118
+ | 参数 | 必选 | 类型 | Description |
119
+ | -------------- | :-- : | -------- | :--------------------------------------------------------------------------------------------- |
120
+ | id | 否 | String | 规则 ID |
121
+ | allowedMethods | 是 | String[] | 允许的 HTTP 操作,枚举值:GET,PUT,HEAD,POST,DELETE |
122
+ | allowedOrigins | 是 | String[] | 允许的访问来源,支持通配符`*`,格式为:`协议://域名[:端口]`,例如:`http://www.qq.com` |
123
+ | allowedHeaders | 是 | | 在发送 OPTIONS 请求时告知服务端,接下来的请求可以使用哪些自定义的 HTTP 请求头部,支持通配符`*` |
124
+ | maxAgeSeconds | 是 | | 设置 OPTIONS 请求得到结果的有效期 |
123
125
124
126
# ## CDN 配置
125
127
126
- | 参数名称 | 是否必选 | 默认 | 描述 |
127
- | ----------- | -------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
128
- | async | 否 | `false` | 是否为异步操作,如果为 true,则不会等待 CDN 创建或更新成功再返回, |
129
- | area | 否 | `mainland` | 域名加速区域,mainland:中国境内加速,overseas:中国境外加速,global:全球加速,(使用中国境外加速、全球加速时,需要先开通中国境外加速服务) |
130
- | autoRefresh | 否 | `false` | 是否自动刷新 CDN |
131
- | onlyRefresh | 否 | `false` | 是否只刷新预热 CDN,如果为 `true`,那么只进行刷新预热操作,不会更新 CDN 配置 |
132
- | refreshCdn | 否 | | 刷新 CDN 相关配置,参考 [refreshCdn](#refreshCdn) |
133
- | pushCdn | 否 | | 预热 CDN 相关配置,参考 [pushCdn](#pushCdn) |
134
- | host | 是 | | 需要接入的 CDN 域名。 |
135
- | https | 否 | | Https 加速配置,参考:https://cloud.tencent.com/document/api/228/30987#Https |
136
- | cacheKey | 否 | | 节点缓存键配置,参考:https://cloud.tencent.com/document/api/228/30987#CacheKey |
137
- | cache | 否 | | 缓存过期时间配置,参考: https://cloud.tencent.com/document/api/228/30987#Cache |
138
- | referer | 否 | '' | 防盗链设置,参考: https://cloud.tencent.com/document/api/228/30987#Referer |
139
- | ipFilter | 否 | '' | IP 黑白名单配置,参考: https://cloud.tencent.com/document/api/228/30987#IpFilter |
128
+ | 参数名称 | 必选 | 默认 | 描述 |
129
+ | ----------- | ---- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
130
+ | async | 否 | `false` | 是否为异步操作,如果为 true,则不会等待 CDN 创建或更新成功再返回, |
131
+ | area | 否 | `mainland` | 域名加速区域,mainland:中国境内加速,overseas:中国境外加速,global:全球加速,(使用中国境外加速、全球加速时,需要先开通中国境外加速服务) |
132
+ | autoRefresh | 否 | `false` | 是否自动刷新 CDN |
133
+ | onlyRefresh | 否 | `false` | 是否只刷新预热 CDN,如果为 `true`,那么只进行刷新预热操作,不会更新 CDN 配置 |
134
+ | refreshCdn | 否 | | 刷新 CDN 相关配置,参考 [refreshCdn](#refreshCdn) |
135
+ | pushCdn | 否 | | 预热 CDN 相关配置,参考 [pushCdn](#pushCdn) |
136
+ | host | 是 | | 需要接入的 CDN 域名。 |
137
+ | https | 否 | | Https 加速配置,参考:https://cloud.tencent.com/document/api/228/30987#Https |
138
+ | cacheKey | 否 | | 节点缓存键配置,参考:https://cloud.tencent.com/document/api/228/30987#CacheKey |
139
+ | cache | 否 | | 缓存过期时间配置,参考: https://cloud.tencent.com/document/api/228/30987#Cache |
140
+ | referer | 否 | '' | 防盗链设置,参考: https://cloud.tencent.com/document/api/228/30987#Referer |
141
+ | ipFilter | 否 | '' | IP 黑白名单配置,参考: https://cloud.tencent.com/document/api/228/30987#IpFilter |
140
142
141
143
> 注意:`async` 参数对于配置多个 CDN 域名需求,或者在 CI 流程中时,建议配置成 `true`,不然会导致 serverless cli 执行超时,或者 CI 流程超时。
142
144
143
145
更多配置,请移至官方云 API 文档:https://cloud.tencent.com/document/product/228/41123
144
146
145
147
# ### refreshCdn
146
148
147
- | 参数名称 | 是否必选 | 默认 | 描述 |
148
- | -------- | -------- | ---- | ------------------- |
149
- | urls | 否 | [] | 需要刷新的 CDN 目录 |
149
+ | 参数名称 | 必选 | 默认 | 描述 |
150
+ | -------- | ---- | ---- | ------------------- |
151
+ | urls | 否 | [] | 需要刷新的 CDN 目录 |
150
152
151
153
# ### pushCdn
152
154
153
- | 参数名称 | 是否必选 | 默认 | 描述 |
154
- | -------- | -------- | ---- | ------------------- |
155
- | urls | 否 | [] | 需要预热的 CDN URLs |
155
+ | 参数名称 | 必选 | 默认 | 描述 |
156
+ | -------- | ---- | ---- | ------------------- |
157
+ | urls | 否 | [] | 需要预热的 CDN URLs |
0 commit comments