{"id":20714623,"url":"https://github.com/vangie/tz-time","last_synced_at":"2025-04-23T10:34:06.102Z","repository":{"id":42316556,"uuid":"215262863","full_name":"vangie/tz-time","owner":"vangie","description":"Aliyun FunctionCompute CI/CD Example","archived":false,"fork":false,"pushed_at":"2023-01-04T22:44:55.000Z","size":313,"stargazers_count":7,"open_issues_count":14,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-29T23:22:32.078Z","etag":null,"topics":["aliyun","ci-cd","fc","fun","funcraft","functioncompute","oss","ros","serverless"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vangie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-15T09:45:53.000Z","updated_at":"2020-11-16T03:32:45.000Z","dependencies_parsed_at":"2023-02-02T22:31:25.971Z","dependency_job_id":null,"html_url":"https://github.com/vangie/tz-time","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vangie%2Ftz-time","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vangie%2Ftz-time/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vangie%2Ftz-time/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vangie%2Ftz-time/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vangie","download_url":"https://codeload.github.com/vangie/tz-time/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250417402,"owners_count":21427211,"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":["aliyun","ci-cd","fc","fun","funcraft","functioncompute","oss","ros","serverless"],"created_at":"2024-11-17T02:33:03.648Z","updated_at":"2025-04-23T10:34:06.079Z","avatar_url":"https://github.com/vangie.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Funcraft + OSS + ROS 进行 CI/CD\n\n## 前言\n\n首先介绍下在本文出现的几个比较重要的概念：\n\n\u003e **函数计算（Function Compute）**：函数计算是一个事件驱动的服务，通过函数计算，用户无需管理服务器等运行情况，只需编写代码并上传。函数计算准备计算资源，并以弹性伸缩的方式运行用户代码，而用户只需根据实际代码运行所消耗的资源进行付费。函数计算更多信息[参考](https://help.aliyun.com/product/50980.html)。\n\n\u003e **Funcraft**：Funcraft 是一个用于支持 Serverless 应用部署的工具，能帮助您便捷地管理函数计算、API 网关、日志服务等资源。它通过一个资源配置文件（template.yml），协助您进行开发、构建、部署操作。Fun 的更多文档[参考](https://github.com/aliyun/fun)。\n\n\u003e **OSS**: 对象存储。海量、安全、低成本、高可靠的云存储服务，提供99.9999999999%的数据可靠性。使用RESTful API 可以在互联网任何位置存储和访问，容量和处理能力弹性扩展，多种存储类型供选择全面优化存储成本。\n\n\u003e **ROS**：资源编排（ROS）是一种简单易用的云计算资源管理和自动化运维服务。用户通过模板描述多个云计算资源的依赖关系、配置等，并自动完成所有资源的创建和配置，以达到自动化部署、运维等目的。编排模板同时也是一种标准化的资源和应用交付方式，并且可以随时编辑修改，使基础设施即代码（Infrastructure as Code）成为可能。\n\n\u003e **CI/CD**: CI/CD 是一种通过在应用开发阶段引入自动化来频繁向客户交付应用的方法。CI/CD 的核心概念是持续集成、持续交付和持续部署。\n\n## 目标\n\n本文打算以一个简单的函数计算项目为例，在此基础上编写测试用例，进行配置，让其支持 CI/CD 工作流程。实现如下四个小目标：\n\n1. CI 被 git commit 提交触发\n2. 执行测试（单元、集成和端对端）\n3. 函数打包上传到 OSS\n4. 通过 ROS 部署函数到 Staging 环境\n\n## 工作流程图\n\n![image.png](https://ata2-img.cn-hangzhou.oss-pub.aliyun-inc.com/6beeb2a22af78cf7059a1158d40c7726.png)\n\n这里以大家熟悉的 Github 仓库为例，并结合 Travis CI 。当用户往示例项目 push 或者 PR（Pull Request）时，会自动触发 Travis CI 的工作任务，进行单元测试、构建打包和部署发布。\n\n## 示例项目\n\n示例项目地址为：https://github.com/vangie/tz-time , 该项目是基于 FC Http trigger 实现的简单 web 函数，访问放函数是会返回指定时区的当前时间。项目目录结构如下\n\n```text\ntz-time\n├── .funignore\n├── .travis.yml\n├── Makefile\n├── bin\n│   ├── delRosStack.sh\n│   ├── deployE2EStack.sh\n│   └── waitForServer.sh\n├── deploy.log\n├── index.e2e-test.js\n├── index.integration-test.js\n├── index.js\n├── index.test.js\n├── jest.config.e2e.js\n├── jest.config.integration.js\n├── package-lock.json\n├── package.json\n└── template.yml\n```\n\n部分文件作用介绍：\n\n* `.funignore`  - Funcraft 部署时忽然的文件清单\n* `.travis.yml` - Travis CI 配置文件\n* `index.js` - 函数入口文件\n* *.test.js - 单元测试相关文件\n* *.integraion-test.js - 集成测试相关文件\n* *.e23-test.js - 端对端测试相关文件\n* template.yml - ROS 描述文件，用于描述函数和其他云服务\n\n## 自动化测试\n\n测试通常非常如下三类：单元测试、集成测试和 E2E 测试。在函数计算场景下，这三类测试可以通过如下方法实现。\n\n* 单元测试 - 使用 Mock 类测试函数，验证输入输出参数\n* 集成测试 - 使用 `fun local invoke/start` 模拟运行函数\n* E2E 测试 - 使用 fun deploy 部署一套 test 环境，然后通过 fun invoke 进行模拟调用或者通过 curl 直接发送\n\n本例子只实现了单元测试，集成测试和 E2E 测试对于 travis 示例来说触发方法类似，实现方法可以参见上面的方法提示进行配置。\n\n### 单元测试\n\nFC 函数的单元测试和普通的函数并无二致。采用熟悉的单元测试框架即可，本例中使用了 jest 进行测试。下面看看一个测试用例的代码片段\n\n```javascript\njest.mock('moment-timezone');\n\nconst { tz } = require('moment-timezone');\nconst { handler } = require('./index');\n\nconst EXPECTED_DATE = '2018-10-01 00:00:00';\nconst TIMEZONE = 'America/New_York';\n\ndescribe('when call handle', () =\u003e {\n    it('Should return the expected date if the provied timezone exists', () =\u003e {\n        const mockReq = {\n            queries: {\n                tz: TIMEZONE\n            }\n        }\n        const mockResp = {\n            setHeader: jest.fn(),\n            send: jest.fn()\n        }\n\n        tz.names = () =\u003e [TIMEZONE];\n        tz.mockImplementation(() =\u003e {\n            return {\n                format: () =\u003e EXPECTED_DATE \n            }\n        })\n\n        handler(mockReq, mockResp, null);\n\n        expect(mockResp.setHeader.mock.calls.length).toBe(1);\n        expect(mockResp.setHeader.mock.calls[0][0]).toBe('content-type');\n        expect(mockResp.setHeader.mock.calls[0][1]).toBe('application/json');\n\n        expect(mockResp.send.mock.calls.length).toBe(1);\n        expect(mockResp.send.mock.calls[0][0]).toBe(JSON.stringify({\n            statusCode: '200',\n            message: `The time in ${TIMEZONE} is: ${EXPECTED_DATE}`\n        }, null, '    '));\n\n    });\n});\n```\n\n通过 jest.mock 对 moment-timezone 进行 mock，让 tz 被调用的时候返回预先设定好的值，而不是一个动态变化的时间。\n\n通常该类单元测试分为三步：\n\n1. mock 依赖的值或者参数\n2. 调用测试函数\n3. 断言返回结果和被调用的参数\n\n如果依赖包不存在原生依赖（依赖 linux 下的可执行文件或者 so 库文件）的使用 npm test 触发测试即可，如果有原生依赖，那测试需要跑在 fun 提供的 sbox 模拟环境里，使用如下命令触发\n\n```bash\nfun install sbox -f tz-time --cmd 'npm install'\n```\n\n### 集成测试\n\n本例子中的集成测试会借助 fun local start 命令把函数在本地启动起来，由于函数配置了 http trigger，所以可以通过 http 请求调用函数。\n\n集成测试我们还是才是 jest 框架进行编写，为了区别于单元测试文件 `*.test.js` ，集成测试文件使用 `.integration-test.js` 文件后缀。为了让 jest 命令独立的跑集成测试用例而不是和单元测试混和在一起，需要编撰如下文件 jest.config.integration.js \n\n```javascript\nmodule.exports = {\n    testMatch: [\"**/?(*.)integration-test.js\"]\n};\n```\n\n然后在 package.json 中配置 scripts \n\n```javascript\n\"scripts\": {\n    \"integration:test\": \"jest -c jest.config.integration.js\"\n}\n```\n\n于是可以通过执行 npm run integration:test 来执行集成测试。\n\n然后在此基础上在 Makefile 中添加 integration-test 目标：\n\n```Makefile\nfunlocal.PID:\n\tfun local start \u0026 echo $$! \u003e $@\n\nintegration-test: funlocal.PID \n\tbin/waitForServer.sh http://localhost:8000/2016-08-15/proxy/tz-time/tz-time/\n\tnpm run integration:test\n\tkill -2 `cat $\u003c` \u0026\u0026 rm $\u003c\n```\n\nintegration-test 目标依赖 funlocal.PID 目标，后者负责启动一个 fun local 进程，该进程会在本地启动 8000 端口。解读一下上面的 Makefile 代码\n\n* `fun local start \u0026 echo $$! \u003e $@` 启动 fun local 进程，并将进程 PID 写入到目标同名文件 funlocal.PID\n* `bin/waitForServer.sh http://localhost:8000/2016-08-15/proxy/tz-time/tz-time/` 通过一个 url 测试 fun local 进程是否启动完成。\n* ``kill -2 `cat $\u003c` \u0026\u0026 rm $\u003c`` 测试完成以后销毁 fun local 进程。\n\n`npm run integration:test` 会启动若干的测试用例，其中一个测试用例如下:\n\n```javascript\nconst request = require('request');\n\nconst url = 'http://localhost:8000/2016-08-15/proxy/tz-time/tz-time/';\n\ndescribe('request url', () =\u003e {\n    it('without tz', (done) =\u003e {\n        request(url, (error, response, data) =\u003e {\n            if (error) {\n                fail(error);\n            } else {\n                const resData = JSON.parse(data);\n                expect(resData.statusCode).toBe(200);\n                expect(resData.message).toContain('Asia/Shanghai');\n            }\n            done();\n        });\n    });\n});\n```\n\n### 端对端测试\n\n端对端测试和集成测试的测试用例非常的类似，区别在于测试的服务端，端对端测试部署一套真实的环境，集成测试通过 fun local 本地模拟。\n\n本例中借助 `fun deploy --use-ros` 部署一套环境，环境名称为 `tz-e2e-` 前缀带上时间戳，这样每次测试都会部署一套新的环境，不同环境之间相互不会影响。测试完成再通过 aliyun-cli 工具把 ROS 的 stack 删除即可。\n\n下面端对端测试的 Makefile 目标：\n\n```Makefile\nstack_name := tz-e2e-$(shell date +%s)\n\ne2e-test:\n\t# deploy e2e \n\tbin/deployE2EStack.sh $(stack_name)\n\t# run test\n\tnpm run e2e:test\n\t# cleanup\n\tbin/delRosStack.sh $(stack_name)\n```\n\n* `bin/deployE2EStack.sh $(stack_name)` 负责部署一个新的 ROS stack。部署之前需要使用 fun package 构建交付物，具体如何构建交付物可以参考下一小节。\n* `npm run e2e:test` 运行端对端测试\n* `bin/delRosStack.sh $(stack_name)` 测试完成之后，清理部署的 ROS stack，会释放掉响应的云资源。\n\n## 构建交付物\n\n`fun package` 命令可被用于构建交付物，`fun package` 需要指定一个 OSS 的 bucket。fun package 命令会完成如下步骤：\n\n1. 将代码编译打包成 Zip 文件。\n2. 上传代码包到 OSS bucket。\n3. 生成新的文件 template.packaged.yml，其中代码本地地址改为 OSS bucket 地址。\n\n生成的 template.packaged.yml 文件就是最终交付物，可以通过 fun deploy 命名进行部署。\n\n## 持续部署\n\n当构建环节生成了交付物以后，就可以通过 fun deploy 进行部署了。持续部署需要解决如下两个问题：\n\n1. 支持全新部署和升级部署\n2. 一套资源描述支持部署多套，比如 test 环境、staging 环境和 production 环境。\n\n`fun deploy` 借助于 ROS，可以轻松的解决上述问题。\n\n```bash\nfun deploy --use-ros --stack-name tz-staging --assume-yes\n```\n\n其中：\n\n* `--use-ros` 表示借助于 ROS 进行部署，其工作机制是将 template.yml 推送到 ROS 服务，由 ROS 服务执行每个服务的新建和更新操作。如果没有该参数，fun 就会在本地解析 template.yml，调用 API 进行资源创建。ROS 有个额外的好处是可以进行部署的回滚，失败的时候能自动进行回滚。\n* `--stack-name` 指定一个 stack 的名称，stack 是 ROS 的概念，可以理解为一套环境。\n* `--assume-yes` 用于无人值守模式，跳过确认提示。\n\n## 小结\n\n上面所有步骤的脚本化配置可以参考 Makefile 和 .travis.yml 文件。通过上述两个文件可以实现 Github 和 Travis CI 的联动，实现基于代码提交触发的 CI/CD。\n\n本文讲述了 FC 函数\n\n1. 如何进行测试，特别是单元测试的自动化\n2. 如何构建交付物，通过 fun package 将代码文件上传到 OSS Bucket，让交付物编程一个文本描述文件 template.packaged.yml\n3. 如何持续部署，借助于 ROS 部署多套环境，多次更新同一套环境。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvangie%2Ftz-time","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvangie%2Ftz-time","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvangie%2Ftz-time/lists"}