携程 apollo 项目 golang 客户端

方便Golang快捷接入携程配置中心框架 Apollo 所开发的Golang版本客户端。

功能

• 实时同步配置
• 灰度配置
• 客户端容灾
• 多命名空间支持
• 无多余依赖
• 支持自定义日志打印

安装

Golang Module 在项目中引入，执行下面命令即可：

go mod tidy

其他包管理

go get github.com/lifei6671/goapollo

使用

自定义客户端

package main

import (
	"context"
	"github.com/lifei6671/goapollo"
	"log"
	"os"
)

func main() {
	//1. 初始化一个客户端
    c := goapollo.New("host", "6e77bd897fe903ad", "default")
    //2. 添加多个命名空间
	c.AddNamespace("application").AddNamespace("wechat")
    //3. 启动并运行客户端
	c.Run(context.Background())
	val,_ := c.GetValue("zookeeper_timeout")
	log.Printf("zookeeper_timeout:%s",val)
	log.Printf("keys -> %+v",c.AllKeys("application"))
	//4.监控变更通知
	for {
		select {
		case change := <-c.WatchUpdate():
			log.Printf("配置更新通知%s\n", change)
		}
	}
}

使用环境变量初始化默认客户端

package main

import (
	"context"
	"github.com/lifei6671/goapollo"
	"log"
)

func main() {
	ctx,cancel := context.WithCancel(context.Background())
	defer cancel()
	if err := goapollo.Run(ctx);err != nil {
		log.Fatalf("启动客户端失败->%s",err)
	}
	for {
		select {
		case change := <-goapollo.WatchUpdate():
			log.Printf("配置更新通知%s\n", change)
		}
	}
}

其中，需要设置如下环境变量：

• APOLLO_HOST Apollo 服务器地址
• APOLLO_APP_ID 需要监听的APPID
• APOLLO_CLUSTER 需要今天的集群
• APOLLO_NAMESPACE 需要监听的命名空间，多个可用;分隔

自定义序列化器

系统支持自定义序列化器，方便接入时根据实际需求来序列化和反序列化配置信息。

目前系统内置了两种序列化器：json 和 gob。

默认情况下，使用 json 做序列化器，也可以在添加命名空间时指定自己实现的序列化器。