{"id":13498593,"url":"https://github.com/serverless-components/tencent-website","last_synced_at":"2025-06-10T20:33:16.978Z","repository":{"id":43109876,"uuid":"217219491","full_name":"serverless-components/tencent-website","owner":"serverless-components","description":"Easily deploy serverless websites (e.g. Vue.js, React, static) to Tencent Cloud with the Serverless Framework","archived":false,"fork":false,"pushed_at":"2022-03-18T02:05:53.000Z","size":932,"stargazers_count":83,"open_issues_count":1,"forks_count":15,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-03-19T08:49:38.614Z","etag":null,"topics":["tencent","tencent-cloud","tencent-cos"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/serverless-components.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-24T05:38:14.000Z","updated_at":"2024-02-27T14:12:57.000Z","dependencies_parsed_at":"2022-09-14T09:40:48.932Z","dependency_job_id":null,"html_url":"https://github.com/serverless-components/tencent-website","commit_stats":null,"previous_names":["serverless-tencent/tencent-website"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-components%2Ftencent-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-components%2Ftencent-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-components%2Ftencent-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-components%2Ftencent-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serverless-components","download_url":"https://codeload.github.com/serverless-components/tencent-website/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247202999,"owners_count":20900889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["tencent","tencent-cloud","tencent-cos"],"created_at":"2024-07-31T21:00:37.424Z","updated_at":"2025-04-04T15:32:01.818Z","avatar_url":"https://github.com/serverless-components.png","language":"JavaScript","readme":"[![Serverless Components](https://img.serverlesscloud.cn/202019/1578569597879-website.png)](http://serverless.com)\n\n\u003cbr/\u003e\n\n**腾讯云 Website 静态网站组件** ⎯⎯⎯ 通过使用 [Tencent Serverless Framework](https://github.com/serverless/components/tree/cloud)，基于云上 Serverless 服务（如对象存储等），实现“0”配置，便捷开发，极速部署你的静态网站，Website 静态网站组件支持丰富的配置扩展，如自定义域名和 CDN 加速等。提供了目前最易用、低成本并且弹性伸缩的静态站点开发和托管能力。\n\u003cbr/\u003e\n\n特性介绍：\n\n- [x] **按需付费** - 按照请求的使用量进行收费，没有请求时无需付费\n- [x] **\"0\"配置** - 只需要关心项目代码，之后部署即可，Serverless Framework 会搞定所有配置。\n- [x] **极速部署** - 仅需几秒，部署你的静态网站。\n- [x] **实时日志** - 通过实时日志的输出查看业务状态，便于直接在云端开发应用。\n- [x] **便捷协作** - 通过云端的状态信息和部署日志，方便的进行多人协作开发。\n- [x] **CDN 加速，SSL 证书配置和自定义域名** - 支持配置 CDN 加速，支持自定义域名及 HTTPS 访问\n\n\u003cbr/\u003e\n\n快速开始：\n\n1. [**安装**](#1-安装)\n2. [**创建**](#2-创建)\n3. [**部署**](#3-部署)\n4. [**配置**](#4-配置)\n5. [**开发调试**](#5-开发调试)\n6. [**查看状态**](#6-查看状态)\n7. [**移除**](#7-移除)\n8. [**账号配置(可选)**](\u003c#账号配置(可选)\u003e)\n\n\u0026nbsp;\n\n### 1. 安装\n\n通过 npm 安装最新版本的 Serverless Framework\n\n```\n$ npm install -g serverless\n```\n\n### 2. 创建\n\n通过如下命令，快速创建一个静态网站托管应用\n\n```bash\n$ serverless init website-starter --name example\n$ cd example\n```\n\n下载完毕后，目录结构如下所示：\n\n```\n|- src\n|   └── index.html\n└──  serverless.yml\n```\n\n在 `src` 目录中既可以托管简单的 html 文件，也可以托管完整的 React/Vue 的应用。\n\n### 3. 部署\n\n在 `serverless.yml` 文件下的目录中运行如下命令进行静态网站的部署。部署完毕后，你可以在命令行的输出中查看到你静态网站的 URL 地址，点击地址即可访问网站托管的链接。\n\n```\n$ serverless deploy\n```\n\n如您的账号未[登陆](https://cloud.tencent.com/login)或[注册](https://cloud.tencent.com/register)腾讯云，您可以直接通过`微信`扫描命令行中的二维码进行授权登陆和注册。\n\n如果希望查看更多部署过程的信息，可以通过`sls deploy --debug` 命令查看部署过程中的实时日志信息，`sls`是 `serverless` 命令的缩写。\n\n\u003cbr/\u003e\n\n### 4. 配置\n\n静态网站组件支持 0 配置部署，也就是可以直接通过配置文件中的默认值进行部署。但你依然可以修改更多可选配置来进一步开发该静态网站项目。\n\n以下是静态网站 Website 组件的 `serverless.yml`部分配置说明：\n\n```yml\n# serverless.yml\n\ncomponent: website # (必填) 引用 component 的名称，当前用到的是 tencent-website 组件\nname: websitedemo # (必填) 该 website 组件创建的实例名称\napp: websiteApp # (可选) 该 website 应用名称\nstage: dev # (可选) 用于区分环境信息，默认值是 dev\n\ninputs:\n  src:\n    src: ./src\n    index: index.html\n    # dist: ./dist\n    # hook: npm run build\n    # websitePath: ./\n  region: ap-guangzhou\n  bucket: my-bucket\n  protocol: https\n```\n\n点此查看[全量配置及配置说明](https://github.com/serverless-components/tencent-website/blob/master/docs/configure.md)\n\n当你根据该配置文件更新配置字段后，再次运行 `serverless deploy` 或者 `serverless` 就可以更新配置到云端。\n\n### 5. 开发调试\n\n部署了静态网站应用后，可以通过开发调试能力对该项目进行二次开发，从而开发一个生产应用。在本地修改和更新代码后，不需要每次都运行 `serverless deploy` 命令来反复部署。你可以直接通过 `serverless dev` 命令对本地代码的改动进行检测和自动上传。\n\n可以通过在 `serverless.yml`文件所在的目录下运行 `serverless dev` 命令开启开发调试能力。\n\n`serverless dev` 同时支持实时输出云端日志，每次部署完毕后，对项目进行访问，即可在命令行中实时输出调用日志，便于查看业务情况和排障。\n\n### 6. 查看状态\n\n在`serverless.yml`文件所在的目录下，通过如下命令查看部署状态：\n\n```\n$ serverless info\n```\n\n### 7. 移除\n\n在`serverless.yml`文件所在的目录下，通过以下命令移除部署的静态网站 Website 服务。移除后该组件会对应删除云上部署时所创建的所有相关资源。\n\n```\n$ serverless remove\n```\n\n和部署类似，支持通过 `sls remove --debug` 命令查看移除过程中的实时日志信息，`sls`是 `serverless` 命令的缩写。\n\n## 账号配置\n\n当前默认支持 CLI 扫描二维码登录，如您希望配置持久的环境变量/秘钥信息，也可以本地创建 `.env` 文件\n\n```console\n$ touch .env # 腾讯云的配置信息\n```\n\n在 `.env` 文件中配置腾讯云的 SecretId 和 SecretKey 信息并保存\n\n如果没有腾讯云账号，可以在此[注册新账号](https://cloud.tencent.com/register)。\n\n如果已有腾讯云账号，可以在[API 密钥管理](https://console.cloud.tencent.com/cam/capi)中获取 `SecretId` 和`SecretKey`.\n\n```\n# .env\nTENCENT_SECRET_ID=123\nTENCENT_SECRET_KEY=123\n```\n\n## 使用文档\n\n[使用文档](./docs/README.md)\n\n## License\n\nMIT License\n\nCopyright (c) 2020 Tencent Cloud, Inc.\n","funding_links":[],"categories":["组件"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverless-components%2Ftencent-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserverless-components%2Ftencent-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverless-components%2Ftencent-website/lists"}