Sui全节点-Docker方式

硬件要求

CPU：>= 2
RAM: >= 8G
Storages: >= 50G

Tips: 按照官方说法，每两周会重置一次数据

软件要求

操作系统建议采用Linux，发行版建议采用 Debian 或 Ubuntu，官方测试的版本是：Ubuntu version 18.04 (Bionic Beaver)，建议使用 Ubunt 18.04。

依赖包（可选：需要本地构建则安装）

$ apt-get update \
    && DEBIAN_FRONTEND=noninteractive TZ=Etc/UTC && \
    apt-get install -y --no-install-recommends \
    tzdata \
    git \
    ca-certificates \
    curl \
    build-essential \
    libssl-dev \
    pkg-config \
    libclang-dev \
    cmake

配置全节点

配置全节点有两种方式，第一种方式是通过 Docker，第二种方式采用 源码编译

Docker方式

下面介绍采用docker的方式运行全节点

安装 docker 运行环境

移除旧版本（可选）

如果系统自带了docker，建议删除，因为系统自带的docker一般版本都比较低，删除命令如下：

$ sudo apt-get remove docker docker-engine docker.io containerd runc

设置docker官方仓库

1、更新apt源，并安装相关工具

$ sudo apt-get update \
        &&apt-get install \
        ca-certificates \
        curl \
        gnupg \
        lsb-release

2、增加 docker 官方 GPG key

 sudo mkdir -p /etc/apt/keyrings
 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

3、使用以下命令设置存储库

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装docker engine

1、更新 apt 包索引，以及安装docker、containerd、以及docker-compose

$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

查看docker 服务运行状态

systemctl status docker

配置 Sui Full Node

首先建议创建一个目录用于存放相关的配置文件，这里我会创建一个 /blockchain/sui/devtest 目录，并 cd /blockchain/sui/devnet 进入该目录

Tips: 后续所有的操作均在该目录中执行

配置 tmux（可选）

为了防止由于网络中断导ssh断开，我一般会使用 tmux工具进行session的管理，防止网络断开。

1、安装 tmux

2、创建 session

tmux new -s "sui-devnet-docker-full-node"

Tips: 命名规则项目-网络-运行环境-服务

下载 docker-compose 配置文件

wget https://github.com/MystenLabs/sui/blob/main/docker/fullnode/docker-compose.yaml

下载全节点配置文件

wget https://github.com/MystenLabs/sui/raw/main/crates/sui-config/data/fullnode-template.yaml

下载创世文件

wget https://github.com/MystenLabs/sui-genesis/raw/main/devnet/genesis.blob

启动 full node

docker-compose up

Tips: 这个过程会同步全网的交易信息，需要等待同步完成。

测试节点是否正常启动

一旦全节点启动并运行，测试一些 JSON-RPC 接口。

获取最近的五笔交易

curl --location --request POST 'http://127.0.0.1:9000/' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "jsonrpc":"2.0", "id":1, "method":"sui_getRecentTransactions", "params":[5] }'

获取特定的交易详情

curl --location --request POST 'http://127.0.0.1:9000/' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "jsonrpc":"2.0", "id":1, "method":"sui_getTransaction", "params":["$RECENT_TXN_FROM_ABOVE"] }'

使用浏览器访问全节点

!image-20220719142855225

常用 docker 命令

后台方式启动docker

docker-compose up -d

停止节点

docker-compose stop

重置环境

重置之前建议备份您的相关配置文件

docker-compose down --volumes

检查运行状态

获取容器id

进入容器

docker exec -it -u 0 $CONTAINER_ID /bin/bash

检查数据库

ls -la suidb/

调用本地 RPC 连接问题

更新全节点配置中的 json-rpc-address 以监听所有地址：

sed -i 's/127.0.0.1/0.0.0.0/' fullnode-template.yaml

-json-rpc-address: "127.0.0.1:9000"
+json-rpc-address: "0.0.0.0:9000"

devops