agollo 项目使用教程

1. 项目的目录结构及介绍

agollo 项目的目录结构如下：

agollo/
├── README.md
├── LICENSE
├── go.mod
├── go.sum
├── agollo.go
├── client/
│   ├── client.go
│   ├── client_test.go
│   └── ...
├── config/
│   ├── config.go
│   ├── config_test.go
│   └── ...
├── env/
│   ├── env.go
│   ├── env_test.go
│   └── ...
├── example/
│   ├── main.go
│   └── ...
└── ...

目录结构介绍

• README.md: 项目介绍文档。
• LICENSE: 项目许可证文件。
• go.mod 和 go.sum: Go 模块文件，用于管理依赖。
• agollo.go: 项目的主文件。
• client/: 包含客户端相关的文件。
• config/: 包含配置相关的文件。
• env/: 包含环境相关的文件。
• example/: 包含示例代码。

2. 项目的启动文件介绍

项目的启动文件是 example/main.go，该文件展示了如何使用 agollo 客户端来获取配置。

example/main.go 文件内容

package main

import (
    "fmt"
    "github.com/shima-park/agollo/v4"
    "github.com/shima-park/agollo/v4/env/config"
)

func main() {
    c := &config.AppConfig{
        AppID:         "testApplication_yang",
        Cluster:       "dev",
        IP:            "http://106.54.227.205:8080",
        NamespaceName: "dubbo",
        IsBackupConfig: true,
        Secret:        "6ce3ff7e96a24335a9634fe9abca6d51",
    }
    client, _ := agollo.StartWithConfig(func() (*config.AppConfig, error) {
        return c, nil
    })
    fmt.Println("初始化Apollo配置成功")

    // 使用你的 apollo key 来测试
    cache := client.GetConfigCache(c.NamespaceName)
    value, _ := cache.Get("your_key")
    fmt.Println("配置值:", value)
}

启动文件介绍

• 导入必要的包。
• 创建一个 config.AppConfig 对象，包含 Apollo 配置的详细信息。
• 使用 agollo.StartWithConfig 方法启动 agollo 客户端。
• 从配置缓存中获取配置值并打印。

3. 项目的配置文件介绍

项目的配置文件主要是 config/config.go，该文件定义了 AppConfig 结构体，用于存储 Apollo 配置的详细信息。

config/config.go 文件内容

package config

type AppConfig struct {
    AppID         string
    Cluster       string
    IP            string
    NamespaceName string
    IsBackupConfig bool
    Secret        string
}

配置文件介绍

• AppID: 应用的唯一标识。
• Cluster: 集群名称。
• IP: Apollo 服务器的地址。
• NamespaceName: 命名空间名称。
• IsBackupConfig: 是否备份配置。
• Secret: 访问秘钥。

通过这些配置信息，agollo 客户端可以连接到 Apollo 配置中心并获取相应的配置。