【亲测免费】 AgileConfig 开源项目安装与使用指南

一、项目的目录结构及介绍

在克隆或下载 AgileConfig 项目后, 你会看到以下主要目录及其功能:

• src: 包含了项目的主要源代码.

  • AgileConfig.Server: 主服务程序, 提供了API接口.
  • AgileConfig.Client: .NET客户端库用于读取配置.

• docs: 文档目录, 包括README, 贡献者指南和其他帮助文档.

• test: 测试相关文件夹, 包含单元测试代码.

• scripts: 包含自动化脚本如构建, 部署脚本.

此外还有 .gitignore, .editorconfig 等常规的配置文件以及 LICENSE 文件.

二、项目的启动文件介绍

Docker 启动方式

如果你熟悉Docker, 可以通过以下命令来运行 AgileConfig 服务:

sudo docker run \
--name agile_config \
-e TZ=Asia/Shanghai \
-e adminConsole=true \
-e db__provider=sqlite \
-e db__conn="Data Source=agile_config.db" \
-p 5000:5000 \
-v /etc/localtime:/etc/localtime \
-d kklldog/agile_config:latest

以上命令中, -e 参数定义环境变量, 指定了时区、是否启用控制台模式(即允许从界面管理配置), 数据库类型和连接字符串等参数; -p 将容器内5000端口映射到主机相同端口, 最后的 -d 表示后台运行.

直接编译运行

对于非 Docker 用户, 编译并运行 AgileConfig.Server 即可启动服务. 在 Visual Studio 或 VS Code 中打开解决方案, 构建并运行即可.

三、项目的配置文件介绍

AgileConfig 主要依赖两个配置文件:

• appsettings.json: 此文件包含了整个服务的基本配置选项, 包括数据库连接, 控制台模式开关, 日志级别等.

  典型的内容示例如下:

  {
    "Logging": {
      "LogLevel": {
        "Default": "Information",
        "Microsoft": "Warning"
      }
    },
    "AllowedHosts": "*",
    "AgileConfig": {
      "appId": "app",
      "secret": "xxx",
      "nodes": ["http://localhost:5000"]
    }
  }
  

• docker-compose.yml: 如果你使用Docker Compose进行部署, 则此YAML文件定义了容器的服务、网络、卷和环境变量.

  其中的 environment 字段对应着上面 docker run 命令中的 -e 参数, 用于传递环境变量给容器.

通过理解上述内容, 你可以更好地掌握如何启动和配置 AgileConfig. 如果遇到任何问题, 记得查阅项目的官方文档和社区讨论以获取更多帮助.