# alipaycloudrun-demo-for-golang

**Repository Path**: alipay-cloudrun/alipaycloudrun-demo-for-golang

## Basic Information

- **Project Name**: alipaycloudrun-demo-for-golang
- **Description**: 支付宝小程序云托管golang框架模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-04-13
- **Last Updated**: 2024-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Alipay Cloudrun

小程序云golang模版，提供gin框架快速搭建，实现简易http接口调用、数据库访问、redis缓存、依赖注入等功能。


## 云托管部署
#### 1.下载代码
#### 2.快速部署
登录[小程序云托管平台](https://cloudrun.alipay.com/cloudrun),
参照[小程序云托管快速部署](https://opendocs.alipay.com/pre-open/04n0zd),
可选择手工打镜像上传、直接上传代码文件夹、自定义流水线部署，服务端口及探活端口填写80
#### 3.服务访问
在部署完成之后，前往云托管平台下的**服务列表**，找到自己的服务并进入，在**服务设置**开启公网域名，之后在浏览器里访问公网域名即进入欢迎页面。
#### 4.数据库连接
用户需要前往云托管平台开通[数据库服务](https://opendocs.alipay.com/pre-open/06t5ww?pathHash=d4c5d8b5),
设置账号密码并建库表，表创建可参考
```sql
USE database;
CREATE TABLE IF NOT EXISTS  `record_info` (
    `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
    `gmt_create` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `gmt_modified` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
    `record` varchar(64) NOT NULL COMMENT '记录信息',
    PRIMARY KEY (`id`)
    )DEFAULT CHARSET = utf8mb4 COMMENT = '操作信息';
```
建表之后，还需要在环境变量里设置自己的数据库账号、密码、数据库端口、数据库名称，设置步骤：
前往云托管平台下的**服务列表**，找到自己的服务并进入，在**服务设置**里找到**环境变量**并添加如下KV
```text
DATABASE_USERNAME:申请的数据库账号
DATABASE_PASSWORD:账号对应密码
DATABASE_HOST:数据库域名(需带端口，示例127.0.0.1:3306),在数据库服务申请成功时可以拿到
DATABASE_NAME:建立的数据库
```
最后便可以在欢迎页面上的测试数据库访问对该表进行操作。
#### 5.redis缓存
前往云托管平台：首先去开通**缓存服务**，之后在可以在服务设置中设置如下key\value对
```text
REDIS_HOST:redis服务域名，可在开通缓存服务后查到，示例127.0.0.1
REDIS_PORT:redis端口号，可在开通缓存服务后查到，默认6379
REDIS_PASSWORD:缓存服务密码，开通缓存服务时的密码
```
#### 6.查看日志
前往云托管平台：首先在**服务列表**下找到自己的服务并进入，之后在**部署版本**里找到**发布详情**点击进入，找到**实例数量**点击之后会有引导登录实例机器，
登入之后，输入
```powershell
cd /app/logs
```
即可看到相关日志文件。
#### 7.查看资源监控
前往云托管平台：点击进入**资源监控**，可以选择自己的服务依次查看各项监控
```text
服务监控:查看服务器的CPU和内存等指标
数据库监控:查看数据库的查询、事务等指标
缓存监控:查看缓存读写情况
```

## 本地调试
#### 1.下载代码
下载代码至本地。
#### 2.服务访问
运行cmd目录中的main方法，快速启动，[本地访问](http://localhost)会弹出欢迎页面
#### 3.数据库连接
前往app目录下的db.go文件，将InitDB方法中默认的数据库连接参数替换为本地数据库的连接参数。
```go
// 用户名
user := util.GetEnvDefault("DATABASE_USERNAME", "root")
// 密码
pwd := util.GetEnvDefault("DATABASE_PASSWORD", "123456")
// 数据库连接地址及端口
addr := util.GetEnvDefault("DATABASE_HOST", "127.0.0.1:3306")
// 数据库名
dataBase := util.GetEnvDefault("DATABASE_NAME", "test")
```

**示例建表语句**(注意database需要替换为自己的数据库)：
```sql
USE database;
CREATE TABLE IF NOT EXISTS  `record_info` (
    `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键',
    `gmt_create` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `gmt_modified` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
    `record` varchar(64) NOT NULL COMMENT '记录信息',
    PRIMARY KEY (`id`)
    )DEFAULT CHARSET = utf8mb4 COMMENT = '操作信息';
```
之后，可在欢迎页面上的测试数据库访问对该表进行操作。
#### 4.redis缓存
前往redis.go文件，修改以下默认参数
```text
REDIS_HOST:redis域名，示例127.0.0.1
REDIS_PORT:redis端口号，默认6379
REDIS_PASSWORD:redis密码，有的话可修改，没有的话可将该字段注释掉
```
## 目录结构说明

~~~
.
├── Dockerfile
├── LEGAL.md
├── README.md
├── api
│   ├── handlers
│   │   ├── http_handler.go
│   │   ├── record_handler.go
│   │   └── redis_handler.go
│   └── router.go
├── app
│   ├── db.go
│   ├── gin_engine.go
│   ├── redis.go
│   └── server.go
├── cmd
│   ├── main.go
│   ├── wire.go
│   └── wire_gen.go
├── go.mod
├── go.sum
├── internal
│   └── service
│       ├── db_service.go
│       ├── http_service.go
│       ├── redis_service.go
│       └── service.go
├── models
│   └── record.go
├── repo
│   ├── record_repo.go
│   └── repo.go
├── static
│   ├── img
│   │   └── logo.png
│   ├── index.html
│   └── js
│       └── jquery-1.11.1.min.js
├── tree.txt
└── util
    └── os_util.go
~~~

### LICENSE
MIT