# go-project-sample

**Repository Path**: wfsd/go-project-sample

## Basic Information

- **Project Name**: go-project-sample
- **Description**: 通过一个完整的项目的示例，从项目的结构、分层思想、依赖注入、错误处理、单元测试、服务治理、框架选择等方面介绍Go语言项目的最佳实践经验.(a sample of golang project)
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2020-10-28
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


通过一个完整的项目的示例，从项目的结构、分层思想、依赖注入、错误处理、单元测试、服务治理、框架选择等方面介绍Go语言项目的最佳实践经验.
项目分为products、details、ratings、reviews四个微服务,依赖关系如下.

![dependency](https://sdgmf.github.io/images/goproject_dep.jpg)

## 准备

安装docker,go,[jsonnet](https://jsonnet.org/)

## 快速开始
下载项目
```bash
    git clone https://github.com/sdgmf/go-project-sample.git
    cd go-project-sample
    git submodule init
    git submodule update
    make docker-compose
```

* **访问接口**： http://localhost:8080/product/1
* **consul**: http://localhost:8500/
* **grafana**: http://localhost:3000/ 
* **jaeger**: http://localhost:16686/search
* **Prometheus**: http://localhost:9090/graph
* **AlertManager**: http://localhost:9093


## 截图

Grafana Dashboard,可以自动生成!

![dashboard](./doc/images/grafana_dashboard.jpg)

![dashboard1](./doc/images/grafana_dashboard1.jpg)

Prometheus Alert 监控告警,自动生成！

![alert](./doc/images/alert.jpg)

![alert](./doc/images/alert1.jpg)

调用链跟踪

![jaeger](./doc/images/jaeger.jpg)

![jaeger](./doc/images/jaeger1.jpg)



## [中文文档](https://sdgmf.github.io/goproject/)