摘要：只有當(dāng)觸發(fā)了或才能終止進(jìn)程退出。退出時執(zhí)行如下操作會將挖礦功能停止，網(wǎng)絡(luò)停止等操作。

作者：Derek

Github地址：https://github.com/Bytom/bytom

Gitee地址：https://gitee.com/BytomBlockc...

本章介紹bytom代碼啟動、節(jié)點(diǎn)初始化、及停止的過程

作者使用MacOS操作系統(tǒng)，其他平臺也大同小異
Golang Version: 1.8

詳細(xì)步驟見官方 bytom install

開啟debug輸出文件、函數(shù)、行號等詳細(xì)信息

export BYTOM_DEBUG=debug

初始化

./bytomd init --chain_id testnet

bytomd目前支持兩種網(wǎng)絡(luò)，這里我們使用測試網(wǎng)
mainnet：主網(wǎng)
testnet：測試網(wǎng)

啟動bytomd

./bytomd node --mining --prof_laddr=":8011"

--prof_laddr=":8080" // 開啟pprof輸出性能指標(biāo)
訪問：http://127.0.0.1:8080/debug/pprof/

入口函數(shù)
cmd/bytomd/main.go

func init() {
    log.SetFormatter(&log.TextFormatter{FullTimestamp: true, DisableColors: true})

    // If environment variable BYTOM_DEBUG is not empty,
    // then add the hook to logrus and set the log level to DEBUG
    if os.Getenv("BYTOM_DEBUG") != "" {
        log.AddHook(ContextHook{})
        log.SetLevel(log.DebugLevel)
    }
}

func main() {
    cmd := cli.PrepareBaseCmd(commands.RootCmd, "TM", os.ExpandEnv(config.DefaultDataDir()))
    cmd.Execute()
}

init函數(shù)會在main執(zhí)行之前做初始化操作，可以看到init中bytomd加載BYTOM_DEBUG變量來設(shè)置debug日志輸出

command cli傳參初始化
bytomd的cli解析使用cobra庫

cmd/bytomd/commands

cmd/bytomd/commands/root.go

初始化--root傳參。bytomd存儲配置、keystore、數(shù)據(jù)的root目錄。在MacOS下，默認(rèn)路徑是~/Library/Bytom/

cmd/bytomd/commands/init.go

初始化--chain_id傳參。選擇網(wǎng)絡(luò)類型，在啟動bytomd時我們選擇了testnet也就是測試網(wǎng)絡(luò)

cmd/bytomd/commands/version.go

初始化version傳參

cmd/bytomd/commands/run_node.go

初始化node節(jié)點(diǎn)運(yùn)行時所需要的傳參

初始化默認(rèn)配置
用戶傳參只有一部分參數(shù)，那節(jié)點(diǎn)所需的其他參數(shù)需要從默認(rèn)配置中加載。
cmd/bytomd/commands/root.go

var (
    config = cfg.DefaultConfig()
)

在root.go中有一個config全局變量加載了node所需的所有默認(rèn)參數(shù)

// Default configurable parameters.
func DefaultConfig() *Config {
    return &Config{
        BaseConfig: DefaultBaseConfig(),  // node基礎(chǔ)相關(guān)配置
        P2P:        DefaultP2PConfig(),   // p2p網(wǎng)絡(luò)相關(guān)配置
        Wallet:     DefaultWalletConfig(),   // 錢包相關(guān)配置
        Auth:       DefaultRPCAuthConfig(),  // 驗證相關(guān)配置
        Web:        DefaultWebConfig(),   // web相關(guān)配置
    }
}

后面的文章會一一介紹每個配置的作用

cmd/bytomd/commands/run_node.go

func runNode(cmd *cobra.Command, args []string) error {
    // Create & start node
    n := node.NewNode(config)
    if _, err := n.Start(); err != nil {
        return fmt.Errorf("Failed to start node: %v", err)
    } else {
        log.WithField("nodeInfo", n.SyncManager().Switch().NodeInfo()).Info("Started node")
    }

    // Trap signal, run forever.
    n.RunForever()

    return nil
}

runNode函數(shù)有三步操作：
node.NewNode：初始化node運(yùn)行環(huán)境
n.Start：啟動node
n.RunForever：監(jiān)聽退出信號，收到ctrl+c操作則退出node。在linux中守進(jìn)程一般監(jiān)聽SIGTERM信號(ctrl+c)作為退出守護(hù)進(jìn)程的信號

在bytomd中有五個db數(shù)據(jù)庫存儲在--root參數(shù)下的data目錄

accesstoken.db // 存儲token相關(guān)信息(錢包訪問控制權(quán)限)

trusthistory.db // 存儲p2p網(wǎng)絡(luò)同步相關(guān)信息

txdb.db // 存儲交易相關(guān)信息

txfeeds.db //

wallet.db // 存儲錢包相關(guān)信息

node/node.go

func NewNode(config *cfg.Config) *Node {
    ctx := context.Background()
    initActiveNetParams(config)
    // Get store 初始化txdb數(shù)據(jù)庫
    txDB := dbm.NewDB("txdb", config.DBBackend, config.DBDir())
    store := leveldb.NewStore(txDB)

  // 初始化accesstoken數(shù)據(jù)庫
    tokenDB := dbm.NewDB("accesstoken", config.DBBackend, config.DBDir())
    accessTokens := accesstoken.NewStore(tokenDB)

  // 初始化event事件調(diào)度器，也叫任務(wù)調(diào)度器。一個任務(wù)可以被多次調(diào)用
    // Make event switch
    eventSwitch := types.NewEventSwitch()
    _, err := eventSwitch.Start()
    if err != nil {
        cmn.Exit(cmn.Fmt("Failed to start switch: %v", err))
    }

  // 初始化交易池
    txPool := protocol.NewTxPool()
    chain, err := protocol.NewChain(store, txPool)
    if err != nil {
        cmn.Exit(cmn.Fmt("Failed to create chain structure: %v", err))
    }

    var accounts *account.Manager = nil
    var assets *asset.Registry = nil
    var wallet *w.Wallet = nil
    var txFeed *txfeed.Tracker = nil

  // 初始化txfeeds數(shù)據(jù)庫
    txFeedDB := dbm.NewDB("txfeeds", config.DBBackend, config.DBDir())
    txFeed = txfeed.NewTracker(txFeedDB, chain)

    if err = txFeed.Prepare(ctx); err != nil {
        log.WithField("error", err).Error("start txfeed")
        return nil
    }

  // 初始化keystore
    hsm, err := pseudohsm.New(config.KeysDir())
    if err != nil {
        cmn.Exit(cmn.Fmt("initialize HSM failed: %v", err))
    }

  // 初始化錢包，默認(rèn)wallet是開啟狀態(tài)
    if !config.Wallet.Disable {
        walletDB := dbm.NewDB("wallet", config.DBBackend, config.DBDir())
        accounts = account.NewManager(walletDB, chain)
        assets = asset.NewRegistry(walletDB, chain)
        wallet, err = w.NewWallet(walletDB, accounts, assets, hsm, chain)
        if err != nil {
            log.WithField("error", err).Error("init NewWallet")
        }

        // Clean up expired UTXO reservations periodically.
        go accounts.ExpireReservations(ctx, expireReservationsPeriod)
    }
    newBlockCh := make(chan *bc.Hash, maxNewBlockChSize)

  // 初始化網(wǎng)絡(luò)節(jié)點(diǎn)同步管理
    syncManager, _ := netsync.NewSyncManager(config, chain, txPool, newBlockCh)

  // 初始化pprof，pprof用于輸出性能指標(biāo)，需要制定--prof_laddr參數(shù)來開啟，在文章開頭我們已經(jīng)開啟該功能
    // run the profile server
    profileHost := config.ProfListenAddress
    if profileHost != "" {
        // Profiling bytomd programs.see (https://blog.golang.org/profiling-go-programs)
        // go tool pprof http://profileHose/debug/pprof/heap
        go func() {
            http.ListenAndServe(profileHost, nil)
        }()
    }

  // 初始化節(jié)點(diǎn)，填充節(jié)點(diǎn)所需的所有參數(shù)環(huán)境
    node := &Node{
        config:       config,
        syncManager:  syncManager,
        evsw:         eventSwitch,
        accessTokens: accessTokens,
        wallet:       wallet,
        chain:        chain,
        txfeed:       txFeed,
        miningEnable: config.Mining,
    }

  // 初始化挖礦
    node.cpuMiner = cpuminer.NewCPUMiner(chain, accounts, txPool, newBlockCh)
    node.miningPool = miningpool.NewMiningPool(chain, accounts, txPool, newBlockCh)

    node.BaseService = *cmn.NewBaseService(nil, "Node", node)

    return node
}

目前bytomd只支持cpu挖礦，所以在代碼中只有cpuminer的初始化信息

node/node.go

// Lanch web broser or not
func lanchWebBroser() {
    log.Info("Launching System Browser with :", webAddress)
    if err := browser.Open(webAddress); err != nil {
        log.Error(err.Error())
        return
    }
}

func (n *Node) initAndstartApiServer() {
    n.api = api.NewAPI(n.syncManager, n.wallet, n.txfeed, n.cpuMiner, n.miningPool, n.chain, n.config, n.accessTokens)

    listenAddr := env.String("LISTEN", n.config.ApiAddress)
    env.Parse()
    n.api.StartServer(*listenAddr)
}

func (n *Node) OnStart() error {
    if n.miningEnable {
        n.cpuMiner.Start()
    }
    n.syncManager.Start()
    n.initAndstartApiServer()
    if !n.config.Web.Closed {
        lanchWebBroser()
    }

    return nil
}

OnStart() 啟動node進(jìn)程如下：

啟動挖礦功能

啟動p2p網(wǎng)絡(luò)同步

啟動http協(xié)議的apiserver服務(wù)

打開瀏覽器訪問bytond的交易頁面

bytomd在啟動時執(zhí)行了n.RunForever()函數(shù)，該函數(shù)是由tendermint框架啟動了監(jiān)聽信號的功能：
vendor/github.com/tendermint/tmlibs/common/os.go

func TrapSignal(cb func()) {
    c := make(chan os.Signal, 1)
    signal.Notify(c, os.Interrupt, syscall.SIGTERM)
    go func() {
        for sig := range c {
            fmt.Printf("captured %v, exiting...
", sig)
            if cb != nil {
                cb()
            }
            os.Exit(1)
        }
    }()
    select {}
}

TrapSignal函數(shù)監(jiān)聽了SIGTERM信號，bytomd才能成為不退出的守護(hù)進(jìn)程。只有當(dāng)觸發(fā)了ctrl+c或kill bytomd_pid才能終止bytomd進(jìn)程退出。退出時bytomd執(zhí)行如下操作
node/node.go

func (n *Node) OnStop() {
    n.BaseService.OnStop()
    if n.miningEnable {
        n.cpuMiner.Stop()
    }
    n.syncManager.Stop()
    log.Info("Stopping Node")
    // TODO: gracefully disconnect from peers.
}

bytomd會將挖礦功能停止，p2p網(wǎng)絡(luò)停止等操作。