# cloud-native-run-dotnet 云原生构建平台(CNB - Cloud Native Build)开发 .NET Core 框架模版,实现简单的计数器读写接口,使用云原生构建平台环境运行 MySQL 进行读写、记录计数值。 ![README](aspnetapp/wwwroot/README.png) ## 快速开始 点击 云原生开发 按钮,打开云原生开发线上环境,开箱即使用 docker-compose 自动运行应用!一键启动!Come on! ![gogogo](aspnetapp/wwwroot/gogogo.png) ## 本地构建并调试 下载代码在本地构建并调试,请参考[微软dotnet使用手册](https://aka.ms/dotnet)。 ## 项目结构说明 ``` . ├── aspnetapp ├── docker-compose.yml ├── Dockerfile ├── .gitignore ├── README.md └── mysql-init └── init.sql └── mysql-config └── my.cnf ``` - `docker-compose.yml`: Docker Compose 配置文件 - `aspnetapp`:dotnet项目入口,实现主要的读写 API - `Dockerfile`:容器配置文件 - `mysql-init/init.sql`: MySQL 初始化脚本 ## 服务 API 文档 ### `GET /api/count` 获取当前计数 #### 请求参数 无 #### 响应结果 - `code`:错误码 - `data`:当前计数值 ##### 响应结果示例 ```json { "code": 0, "data": 42 } ``` #### 调用示例 ``` curl https://<云环境对外暴露的域名>/api/count ``` ### `POST /api/count` 更新计数,自增或者清零 #### 请求参数 - `action`:`string` 类型,枚举值 - 等于 `"inc"` 时,表示计数加一 - 等于 `"clear"` 时,表示计数重置(清零) ##### 请求参数示例 ``` { "action": "inc" } ``` #### 响应结果 - `code`:错误码 - `data`:当前计数值 ##### 响应结果示例 ```json { "code": 0, "data": 42 } ``` #### 调用示例 ``` curl -X POST -H 'content-type: application/json' -d '{"action": "inc"}' https://<云环境对外暴露的域名>/api/count ``` ## License [MIT](./LICENSE)