部署

单体架构

ECS服务器

克隆项目代码到服务器上
将代码编译成二进制可执行文件

export GDD_ENV=prod && go build -o api cmd/main.go

启动可执行文件，推荐用screen命令或pm2在新窗口打开，这里以screen命令为例，先创建一个窗口screen -S app，窗口名字叫app，启动程序./app。ctrl + a + d可以退出screen，screen -r app可以打开刚才创建的app窗口，查看命令行终端输出的日志。

提示

如果是Centos服务器，screen的安装命令是yum install -y screen。

想看当前开启的窗口列表，可用screen -ls命令

➜  ~ screen -ls   
There is a screen on:
	16048.app	(Detached)
1 Socket in /var/run/screen/S-root.

1
2
3
4

如果想删掉app窗口，可以先执行命令screen -r app登录进去，再输入exit回车，就退出并且删除app窗口了。

➜  ~ screen -r app
[screen is terminating]
➜  ~  
➜  ~ screen -ls   
No Sockets found in /var/run/screen/S-root.

1
2
3
4
5

一般程序员日常开发掌握这几个命令已经做够了。

Docker

你可以直接使用go-doudou svc init命令生成的Dockerfile，也可以根据实际项目需求修改。

先下载依赖到vendor文件夹

go mod vendor

再打包镜像

docker build -t myservice .

最后执行docker run命令

docker run -it -d -p 6060:6060 myservice

需要把myservice改成你自己的镜像名称。

Kubernetes

go-doudou开箱支持k8s部署。

执行go-doudou svc push命令可以打包镜像并推送到远程镜像仓库，最后生成两份k8s部署文件，一个用于部署无状态服务，一个用于部署有状态服务。

go-doudou svc push --pre godoudou_ -r wubin1989

可以通过--pre参数设置镜像名称前缀。需要将wubin1989改成你自己的远程镜像仓库地址。

每次执行此命令都会自动更新镜像的版本号，命名规则为v + yyyyMMddHHmmss，同时自动更新k8s部署文件里的镜像名称。

执行go-doudou svc deploy命令。此命令默认采用_statefulset.yaml后缀的文件部署有状态服务。你可以通过-k参数设置其他k8s部署文件路径，如_deployment.yaml后缀的无状态服务的部署文件。

go-doudou svc deploy -k helloworld_deployment.yaml

需要将helloworld_deployment.yaml改成你自己的部署文件路径。

微服务架构

架构总览

microservice

网络安全

如果采用go-doudou内置的memberlist作为服务注册与发现机制，尽管你可以通过设置GDD_MEM_CIDRS_ALLOWED环境变量来设置允许加入集群的节点ip范围以确保网络安全，但我们建议对外网关闭memberlist监听端口（默认7946），仅允许内网访问。

集群种子

如果采用go-doudou内置的memberlist作为服务注册与发现机制，必须要先启动一个或多个服务作为种子节点来让其他节点加入。任意一个采用go-doudou开发的服务都可以作为种子节点。然后将种子节点连接地址，ip地址或dns地址皆可，设置到GDD_MEM_SEED环境变量，多个地址用英文逗号分隔。

为了避免种子节点因代码修改而重新部署所带来的不稳定，推荐部署一个或多个无任何实际业务功能的go-doudou服务作为种子节点。种子节点的作用仅仅是让其他节点加入构成集群。节点间的通信机制和服务调用机制完全是p2p的，不经过任何种子节点。

Prometheus服务发现

目前Prometheus还没有对go-doudou的官方支持，所以我们基于官方的一篇文章 Implementing Custom Service Discovery在新窗口打开实现了对go-doudou微服务的Prometheus服务发现机制。源码已开源在这在新窗口打开，还提供了docker镜像供下载使用。

docker pull wubin1989/go-doudou-prometheus-sd:v1.0.2

下面是一个docker-compose.yml文件的例子

version: '3.9'

services:
  wordcloud-prometheus:
    container_name: wordcloud-prometheus
    hostname: wordcloud-prometheus
    image: wubin1989/go-doudou-prometheus-sd:v1.0.2
    environment:
      - GDD_SERVICE_NAME=wordcloud-prometheus
      - PROM_REFRESH_INTERVAL=15s
      - GDD_MEM_CIDRS_ALLOWED=172.28.0.0/16
    volumes:
      - ./prometheus/:/etc/prometheus/
    ports:
      - "9090:9090"
    restart: always
    healthcheck:
      test: [ "CMD", "curl", "-f", "http://localhost:9090" ]
      interval: 10s
      timeout: 3s
      retries: 3
    networks:
      - tutorial

networks:
  tutorial:
    name: tutorial
    ipam:
      driver: default
      config:
        - subnet: 172.28.0.0/16

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

挂载到容器的./prometheus/文件夹的目录结构示例如下

├── alert.rules
├── prometheus.yml
└── sd
    └── go-doudou.json

1
2
3
4

看一下prometheus.yml文件的内容

global:
  scrape_interval: 15s
  evaluation_interval: 15s

rule_files:
  - 'alert.rules'

scrape_configs:
  - job_name: "go-doudou-wordcloud"
    basic_auth:
      username: admin
      password: admin
    metrics_path: /go-doudou/prometheus
    file_sd_configs:
      - files:
          - sd/go-doudou.json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

第13~16的内容不要改，需要自己改一下username和password的值，其他内容都可以根据实际需求修改。

Kubernetes

部署服务的方式请参考单体架构的 kubernetes 章节。这里主要是做几点补充说明。

你可以利用k8s的服务发现和负载均衡机制，将go-doudou服务全部按单体服务部署，然后将dns服务地址配置到环境变量里，服务间接口调用通过dns服务地址，由k8s为我们做实例间负载均衡。如果服务需要暴露到外网，可以配置自行配置ingress
你可以利用k8s的ConfigMaps在新窗口打开机制来做配置管理
如果你仍打算采用go-doudou内置的memberlist服务发现机制，就有两种部署方案：无状态服务和有状态服务
go-doudou微服务架构同时支持无状态服务和有状态服务，可以根据实际业务需求全部部署成某一种类型或者混合两种类型
推荐至少将担当种子节点的服务以有状态服务类型部署。因为有状态服务相比无状态服务，容器名和hostname是固定的，可以通过配置headless服务，获得一个可以定位到该容器的dns域名。域名构成规则是container-hostname.service-metadata-name.my-namespace.svc.cluster-domain.example，例如seed-2.seed-svc-headless.default.svc.cluster.local。这样的话，当种子节点容器因各种原因重启以后，连接地址不会发生改变，其他服务的GDD_MEM_SEED环境变量不需要重新配置，集群更稳定，维护更方便。需要了解更多，请参考DNS for Services and Pods在新窗口打开
前文介绍的go-doudou-prometheus-sd服务本身就是一个go-doudou服务，可以当做种子节点，以有状态服务类型部署一个或多个实例。这里假设部署了3个种子实例，那么所有服务实例（包括种子实例本身）的GDD_MEM_SEED环境变量配置如下

GDD_MEM_SEED=prometheus-0.prometheus-svc.default.svc.cluster.local,prometheus-1.prometheus-svc.default.svc.cluster.local,prometheus-2.prometheus-svc.default.svc.cluster.local

# 部署

# 单体架构

# ECS服务器

# Docker

# Kubernetes

# 微服务架构

# 架构总览

# 网络安全

# 集群种子

# Prometheus服务发现

# Kubernetes

部署

单体架构

ECS服务器

Docker

Kubernetes

微服务架构

架构总览

网络安全

集群种子

Prometheus服务发现

Kubernetes