Apollo 配置

一、背景介绍

　　pollo（阿波罗）是携程框架部门研发的配置管理平台，能够集中化管理应用不同环境、不同集群的配置，配置修改后能够实时推送到应用端，并且具备规范的权限、流程治理等特性。

服务端基于 Spring Boot 和 Spring Cloud 开发，打包后可以直接运行，不需要额外安装 Tomcat 等应用容器。

Java 客户端不依赖任何框架，能够运行于所有 Java 运行时环境，同时对 Spring 环境也有较好的支持。

.Net 客户端不依赖任何框架，能够运行于所有 .Net 运行时环境。

更多产品介绍参见 Apollo配置中心介绍

本地快速部署请参见 Quick Start

二、配置界面

三、功能介绍

  • 统一管理不同环境、不同集群的配置

    • Apollo 提供了一个统一界面集中式管理不同环境（environment）、不同集群（cluster）、不同命名空间（namespace）的配置。

    • 同一份代码部署在不同的集群，可以有不同的配置，比如zk的地址等

    • 通过命名空间（namespace）可以很方便的支持多个不同应用共享同一份配置，同时还允许应用对共享的配置进行覆盖

  • 配置修改实时生效（热发布）

    • 用户在 Apollo 修改完配置并发布后，客户端能实时（1秒）接收到最新的配置，并通知到应用程序。

  • 版本发布管理

    • 所有的配置发布都有版本概念，从而可以方便的支持配置的回滚。

  • 灰度发布

    • 支持配置的灰度发布，比如点了发布后，只对部分应用实例生效，等观察一段时间没问题后再推给所有应用实例。

  • 权限管理、发布审核、操作审计

    • 应用和配置的管理都有完善的权限管理机制，对配置的管理还分为了编辑和发布两个环节，从而减少人为的错误。

    • 所有的操作都有审计日志，可以方便的追踪问题。

  • 客户端配置信息监控

    • 可以方便的看到配置在被哪些实例使用

  • 提供Java和.Net原生客户端

    • 提供了 Java 和 .Net 的原生客户端，方便应用集成

    • 支持 Spring Placeholder 和 Annotation，方便应用使用（需要 Spring 3.1.1+）

    • 同时提供了 Http 接口，非 Java 和 .Net 应用也可以方便的使用

  • 提供开放平台 API

    • Apollo 自身提供了比较完善的统一配置管理界面，支持多环境、多数据中心配置管理、权限、流程治理等特性。

    • 不过 Apollo 出于通用性考虑，对配置的修改不会做过多限制，只要符合基本的格式就能够保存。

    • 在我们的调研中发现，对于有些使用方，它们的配置可能会有比较复杂的格式，如 xml, json，需要对格式做校验。

    • 还有一些使用方如 DAL，不仅有特定的格式，而且对输入的值也需要进行校验后方可保存，如检查数据库、用户名和密码是否匹配。

    • 对于这类应用，Apollo 支持应用方通过开放接口在 Apollo 进行配置的修改和发布，并且具备完善的授权和权限控制

  • 部署简单

    • 配置中心作为基础服务，可用性要求非常高，这就要求 Apollo 对外部依赖尽可能地少

    • 目前唯一的外部依赖是 MySQL，所以部署非常简单，只要安装好 Java 和 MySQL 就可以让 Apollo 跑起来

    • Apollo 还提供了打包脚本，一键就可以生成所有需要的安装包，并且支持自定义运行时参数

四、使用文档

  1. Apollo使用指南

  2. Java客户端使用指南

  3. .Net客户端使用指南

  4. 其它语言客户端接入指南

  5. Apollo开放平台接入指南

五、设计

六、部署

七、发布历史

八、FAQ

九、安装部署

apollo 依赖环境

java 1.8.2+

mysql 5.7+

为此我们准备2台服务器 

10.3.1.141   

　　主要部署服务  

　　mysql

docker run -d 
-it 
-p 3306:3306 
--name mysql 
-v /etc/mysql/:/etc/cd/conf.d 
-v /data/mysql/logs:/logs 
-v /data/mysql/data:/var/lib/mysql 
-e MYSQL_ROOT_PASSWORD=123456 
--restart always 
mysql:5.7

　初始化数据库脚本

   下载脚本　https://github.com/ctripcorp/apollo/tree/master/scripts/sql　　

   执行脚本  apolloconfigdb.sql  apolloportaldb.sql

   修改环境列表   

　　USE ApolloPortalDB;
　　UPDATE ServerConfig SET `Value` ='dev,pro' WHERE `Key` ='apollo.portal.envs';

　   apollo-adminservice   

docker run -d 
    --name apollo-adminservice 
    --net=host 
    --restart always 
    -v /tmp/logs:/opt/logs 
    -e SPRING_DATASOURCE_URL="jdbc:mysql://10.3.1.141:3306/ApolloConfigDB_Dev?characterEncoding=utf8&serverTimezone=GMT&useSSL=false" 
    -e SPRING_DATASOURCE_USERNAME=root 
    -e SPRING_DATASOURCE_PASSWORD=123456 
    -e EVN=dev 
    apolloconfig/apollo-adminservice

　　apollo-configserver

docker run -d 
    --name apollo-configservice 
    --net=host 
    --restart always 
    -v /tmp/logs:/opt/logs 
    -e SPRING_DATASOURCE_URL="jdbc:mysql://10.3.1.141:3306/ApolloConfigDB_Dev?characterEncoding=utf8&serverTimezone=GMT&useSSL=false" 
    -e SPRING_DATASOURCE_USERNAME=root 
    -e SPRING_DATASOURCE_PASSWORD=123456 
    -e EVN=dev 
    apolloconfig/apollo-configservice

　　apollo-protal

docker run -d 
    --name apollo-adminservice 
    --net=host 
    --restart always 
    -v /tmp/logs:/opt/logs 
    -e SPRING_DATASOURCE_URL="jdbc:mysql://10.3.1.141:3306/ApolloConfigDB_Dev?characterEncoding=utf8&serverTimezone=GMT&useSSL=false" 
    -e SPRING_DATASOURCE_USERNAME=root 
    -e SPRING_DATASOURCE_PASSWORD=123456 
    -e EVN=dev 
    apolloconfig/apollo-adminservice

10.3.1.184

　　主要部署服务  

　　apollo-configserver

docker run -d 
    --name apollo-configservice 
    --net=host 
    --restart always 
    -v /tmp/logs:/opt/logs 
    -e SPRING_DATASOURCE_URL="jdbc:mysql://10.3.1.141:3306/ApolloConfigDB_Pro?characterEncoding=utf8&serverTimezone=GMT&useSSL=false" 
    -e SPRING_DATASOURCE_USERNAME=root 
    -e SPRING_DATASOURCE_PASSWORD=123456 
    -e EVN=pro 
    apolloconfig/apollo-configservice

　　apollo-adminservice

docker run -d 
    --name apollo-adminservice 
    --net=host 
    --restart always 
    -v /tmp/logs:/opt/logs 
    -e SPRING_DATASOURCE_URL="jdbc:mysql://10.3.1.141:3306/ApolloConfigDB_Pro?characterEncoding=utf8&serverTimezone=GMT&useSSL=false" 
    -e SPRING_DATASOURCE_USERNAME=root 
    -e SPRING_DATASOURCE_PASSWORD=123456 
    -e EVN=pro 
    apolloconfig/apollo-adminservice

访问http://10.3.1.141:8070，账号/密码：apollo/admin。

九、.net core 配置使用

依赖携程包

Install-Package Com.Ctrip.Framework.Apollo.Configuration

修改配置文件

"Apollo": {
    "AppId": "libra",
    "Env": "DEV",
    "MetaServer": "http://10.3.1.141:8080",
    "ConfigServer": [ "http://10.3.1.141:8080" ]
  }

注入服务

 public static IHostBuilder CreateHostBuilder(string[] args) =>
            Microsoft.Extensions.Hosting.Host.CreateDefaultBuilder(args)
                .ConfigureAppConfiguration((hostingContext, builder) =>
                {
                    LogManager.UseConsoleLogging(LogLevel.Trace);
                    builder.AddApollo(builder.Build().GetSection("Apollo"))
                        .AddDefault()
                        .AddNamespace("TEST1.vb")
                        .AddNamespace("op", Com.Ctrip.Framework.Apollo.Enums.ConfigFileFormat.Json);
                })
                .ConfigureWebHostDefaults(webBuilder =>
                {
                    webBuilder.UseStartup<Startup>();
                });
   public void ConfigureServices(IServiceCollection services)
        {
            services.Configure<ApolloConfig>(Configuration);
            services.AddControllers();
        }

编写测试代码

    [ApiController]
    [Route("[controller]")]
    public class HomeController : ControllerBase
    {
        private readonly IOptionsSnapshot<ApolloConfig> _options;

        public HomeController(IOptionsSnapshot<ApolloConfig> options)
        {
            _options = options;
        }

        [HttpGet]
        public IActionResult Index()
        {
            var options = new JsonSerializerOptions
            {
                Encoder = JavaScriptEncoder.Create(UnicodeRanges.All)
            };
            return new JsonResult(_options.Value, options);
        }
    }
   public class ApolloConfig
    {
        public string Name { get; set; }

        public string Gender { get; set; }
    }
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/liuxiaoji/p/15080024.html