ESFramework介绍之（22）―― 服务器系统自动升级

    （本文名字取为“服务器系统自动升级”，实际上适用于所有应用程序自动升级的情况。）
    前文介绍了在服务器或客户端应用程序运行的过程中，插件如何自动升级、更新。基于前文相同的理由，AS、FS、IRAS也需要有自动升级的功能。
     与插件在运行时动态更新不同，服务器系统无法在运行时动态更新，只有在服务器系统重新启动的时候，才是自动升级的切入点。
（1）对于功能服务器FS，可以采用持续/逐个更新的方式，即依次重启每个功能服务器。这样可以避免功能服务被中断的情况发生。需要注意的是，只有当目标FS上没有功能请求时，才可重启该FS，否则，会导致终端出现发出请求没有响应的糟糕的用户体验。解决方案是：在FS重启之前，FS向对应的AS报告自己马上将重启，这样，AS不会再将请求分派到该FS上，一段时间后，本FS上就没有功能请求了，于是可以顺利重启了。
（2）对于IRAS与AS，则需要在重启前满足本系统中没有功能请求的条件，这可以通过一段时间不接受终端连接请求来做到。如果不能停止AS服务，则可以在升级本区域AS的时候，先启用备用AS（可以通过端口映射在主AS和备用AS之间切换），当升级完成后，再切换回来。

    上面已经提到，当服务器重启的时候是系统升级的切入点，这个切入点一般在Main函数中，并且位于Application.Run之前。如下面示例代码所示：

                #region 系统升级                
                 if(MainClass.AsConfig.UpdateEnabled)
                {
                    DataCenterBase.Common.DataCenterHelper dataCenterHelper = (DataCenterBase.Common.DataCenterHelper)MainClass.SpringContext.GetObject("dataCenterHelper") ;
                        
                    //如果有新版本
                    if(dataCenterHelper.GetAppServerNewVersion() > MainClass.Version)
                    {
                        string dir = System.IO.Path.GetDirectoryName(System.Windows.Forms.Application.ExecutablePath) ;
                        //升级程序的路径
                        string updateExePath = dir + "\\" + MainClass.AsConfig.UpdateExeFileName ;
                        //启动升级程序、并退出Main
                        EnterpriseServerBase.Common.AdvancedFunction.StartApplication(updateExePath) ;                
                        return ;
                    }
                }                
                #endregion

    需要自动升级的系统（比如上面的AS）中与升级相关的代码大致就这么多，而本文我们重点要关注的是升级程序的实现。升级程序中核心接口是IAutoUpdator，位于ESFramework.Deploy命名空间中：

    public interface IAutoUpdator
    {
        void Start() ;
        void Cancel() ;

        IUpdateAssistant UpdateAssistant{set ;}
        IUiReporter      UiReporter{set ;} 

        event CbSimple UpdateFinished ;
    }

    Start方法将启动升级过程，当升级完成的时候，将触发UpdateFinished事件。升级开始时，IAutoUpdator读取本地配置文件中中应用程序和各个dll及相关文件的版本信息，然后与获取的最新版本信息相比较，以决定要升级哪些exe或dll，要删除哪些dll，要新下载哪些exe或dll。针对每个exe或dll（甚至是有升级需要的重要文件），都有一个OneUpdate对象与之对应。

    public class OneUpdate
    {
        public UpdatingType UpdateType =  UpdatingType.Keep ;
        public string URL ;
        public string FilePath ;
        public string FileName ;
        public float  NewVersion ;
    }

    /// <summary>
    /// UpdatingType 升级类型
    /// </summary>
    public enum UpdatingType
    {
        Add ,Remove ,Update ,Keep //keep 表示不需更新
    }

    这与前文的插件升级是相同的。有人会问，为什么插件升级和应用程序升级不做成一样的组件，这样可以更多的复用啊？那是因为它们升级的模式是不一样的，插件是动态升级的，而应用程序本身只能是静态升级的（当然，即使你动态升级了这个应用程序中加载的插件）。
    如果要顺利的完成升级，有些必要的信息需要获取，比如最新版本的版本号，最新版本的服务器系统exe及相关dll的下载地址等等，这些是通过IUpdateAssistant接口提供的：

    public interface IUpdateAssistant
    {
        IUpdateInformation[] GetUpdateInformation() ; //获取最新版本文件（exe、dll等）的下载地址信息
        FileInfo[]           GetFileInfoToUpdate() ;  //获取要升级文件（exe、dll等）的当前版本
        string               GetFileDirectory() ;

        // 通常操作本地配置文件
        void                 ReviseFileVersion(string fileName ,float newVer) ; //增加或修改
        void                 RemoveFileVersion(string fileName) ;
    }

    public class FileInfo
    {
        public string FileName ;
        public float  Version ;        
    }

    public interface IUpdateInformation
    {
        string FileName {get ;set ;}
        string URL {get ;set ;}
        float  Version {get ;set ;}
        string FileType {get ;set ;}         
        bool   IsValid{get ;set ;}
    }

    不同的应用对IUpdateAssistant的实现是不同的。比如有的把最新版本的服务器系统exe及相关dll存放在数据库中，有的则可能放在某个Web上，以通过URL下载获取，等等。 有时新版本的应用程序可能需要删除旧版本中的某些不再需要的dll或其它辅助文件，RemoveFileVersion用于这个目的。而当应用程序及相关dll升级完成后，就需要更改本地配置中的相应版本号，ReviseFileVersion提供了此功能。    
    IAutoUpdator通过IUiReporter接口将升级的进度信息通知给UI，这样用户就对升级的进程就了然于胸了。

    public interface IUiReporter
    {
        void Initialize(int minVal ,int MaxVal ,int val) ;
        void Set(int val) ;
 
        void ShowMessage(string msg) ;
    }

    当有重要事件发生（比如网络断开）而导致升级失败，IUpdateAssistant会通过IUiReporter的ShowMessage方法给出通知。借助于上述的各个辅助接口，实现IAutoUpdator就非常easy了，实现源码参见SFramework.Deploy.AutoUpdator类。

    在AutoUpdator的帮助下实现你自己的自动升级程序可以这样做，首先建立一个新的WinForm项目，根据你应用的需要，实现上面列出的各个辅助接口，然后将这些实现装配给AutoUpdator，就像这样：

        public Form1()
        {            
            InitializeComponent();

            this.autoUpdator = new AutoUpdator() ;
            this.autoUpdator.UiReporter = this ;
            this.autoUpdator.UpdateAssistant = new UpdateAssistant() ;
            this.autoUpdator.UpdateFinished += new CbUpdate(autoUpdator_UpdateFinished);
        }

    然后在Load事件中启动升级：

        private void Form1_Load(object sender, System.EventArgs e)
        {
            this.autoUpdator.Start() ;
        }

    最后，当升级完成时，需要重新启动新版本的应用程序：

        private void autoUpdator_UpdateFinished()
        {
            MessageBox.Show("升级完成！") ;

            string apppath = System.IO.Directory.GetParent(Application.ExecutablePath).ToString();
            EnterpriseServerBase.Configure.XmlParser xmlParser = new EnterpriseServerBase.Configure.XmlParser(apppath + "\\" + "VersionInfo.xml");    

            //启动新版本的应用程序
            Process downprocess = new Process();            
            downprocess.StartInfo.FileName = string.Format("{0}\\{1}" , apppath ,xmlParser.GetConfigValue("HostInfo" ,"StartAppName")) ;
            downprocess.Start();

            this.Close() ;
        }

    当前的设计，主要支持从Url下载最新版本的文件（这可从IUpdateInformation接口的URL属性看出），这也是最常见的方式。当然你可以将最新版本的文件存放在数据库中，这时就需要将IUpdateInformation接口定义修改一下即可适应。发挥你的创造力吧，欢迎和我交流你的想法！
    感谢关注！

上一篇文章：ESFramework介绍之（20）―― 插件自动升级

转到  ：ESFramework 可复用的通信框架（序）