# ce-cloud-service

**Repository Path**: MJYyyyy/ce-cloud-service

## Basic Information

- **Project Name**: ce-cloud-service
- **Description**: 基于自己写的ce-cloud框架，这个项目会偏向于业务开发，做一些东西
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-24
- **Last Updated**: 2024-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ce-cloud-service
- [English Version](README.en.md)

#### 介绍
基于自己写的ce-cloud框架结合go-micro/v4，这个项目会偏向于业务开发，做一些东西

#### 软件架构
1.  go-micros: go-micro/v4
2.  ce-cloud
3.  gin、Gorm、swagger
4.  docker
5.  C++、CMakeLists、VCPKG(如果需要使用C++开发时才需要)

#### 安装教程

1. git clone https://gitee.com/MJYyyyy/ce-cloud.git
2. go-micro安装
   - 2.1. $ go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
   - 2.2. $ go install github.com/go-micro/generator/cmd/protoc-gen-micro@latest
   - 2.3. $ go mod tidy 
   - 2.4. go install 后的文件放入GO/ROOT/bin中
3. 亦或是将 /cmd/environmental_attachments 中的文件拷贝到GO/ROOT/bin中
4. 需要使用C++相关的配置时，需请参考 https://learn.microsoft.com/zh-cn/cpp/build/cmake-projects-in-visual-studio?view=msvc-170&viewFallbackFrom=vs-2019

#### 使用前置环境

1. 需要ce-cloud框架做支持
2. 需要能够执行make指令(当前使用的是cygwin:gcc-core、gcc-g++、binutils、perl、gzip、tar、bash、coreutils)，能够执行sshpass(cygwin:sshpass)
3. 需要配置go-micro所需的环境
4. 需要能够执行docker相关的指令
5. 需要使用C++时，请安装C++23相关的环境，或可使用visual studio及参考其官方的CMakeList及VCPKG的安装说明即可(vcpkg国内镜像https://gitee.com/jackboosy/vcpkg)

#### 微服务创建说明

1. 创建服务
   1.1. 在/internal/services中创建对应服务的业务文件夹
   1.2. 在/internal/proto中创建对应服务的proto文件夹
   1.3. 在/internal/proto/<服务proto文件夹>中添加 <服务>.proto

2. 使用 $ protoc --go_out=. --micro_out=. <服务>.proto 进行编译生成对应的pb文件

3. 在/internal/services/<服务文件夹>中添加并创建go-micro实例

#### 特此说明，本项目使用go-micro/v4

#### 编译 Proto 文件(在/internal/proto/{对应服务文件夹中使用})
```shell
protoc --go_out=. --micro_out=. <服务>.proto
```

#### 打包服务至服务器(在/cmd/script中使用make)
```shell
#打包基础服务
make docker SVC=<服务>
#打包网关服务
make dockerapi SVC=<服务>
```