由于EOS的版本在不断的更新迭代,本地编译最新版本的方式更新比较繁琐,而且容易出问题。
因此,我们推荐使用Docker容器的方式配置EOS本地测试环境,这样方便维护升级,而且简单。 此外,EOS的Docker Image会每天定时更新并被推送到dockerhub,可以直接去拉取官方的最新版本Image使用。
下面的步骤会以Mac系统为例,由于我们使用Docker环境,理论上不依赖具体的操作系统环境,只要使用的系统能够安装Docker即可。
系统配置要求:
硬盘存储空间 > 8GB
内存 > 4GB
安装docker和docker-compose
可以到Docker官方网站下载Docker,推荐以下版本: 下载安装后,启动Docker服务,不同的系统启动Docker服务方式不同,请具体查看启动方式。 确认docker安装成功并且docker服务启动之后,再继续进行下一步。
不熟悉Docker的同学,可以去查一下Docker的简单命令介绍,这里我们给出CentOS下面常用的命令:
yum install docker 安装服务systemctl start docker.service 启动服务systemctlenabledocker.service 开机启动服务docker pull centos 下载映像到本地docker images centos 查看映像列表docker run -i -t centos /bin/bash 以交互式启动容器docker run centosecho'Hello World'
其他参考资料:docker 命令
如果使用的是Mac系统版本的Docker,docker-compose会跟随docker一起被安装。 如果使用的是CentOS等其他Linux系统,需要单独安装docker-compose,参考安装:
sudo curl -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m)-o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-composedocker-compose --version
推荐的docker-compose版本是:(docker-compose的版本差异影响并不大,安装新版本即可)
$docker-compose -vdocker-compose version 1.21.2, build a133471
获得eos的Docker Image
eos的Docker Image 有多种版本,适应于不同的应用场景:
eosio/builder : 包含编译eos的所有依赖库,是eos编译的一个完整环境,这样开发者就无需安装各种工具和依赖库,准备eos的编译环境了。
eosio/eos : 主网节点使用,比较轻量级,镜像中不包含编译智能合约的依赖库。
eosio/eos-dev : 适用于开发者的定制环境,其中包含编译智能合约需要的相关工具和依赖库。
其中eosio/eos 和 eosio/eos-dev 都是继承了 eosio/builder 然后编译出来的定制化镜像。 由于我们是开发者,因此我们选用eosio/eos-dev 这个Image。 当然,如果大家只是想启动一个节点,加入主网中,可以直接使用eosio/eos,这个我们在后面会详细介绍。
根据前面的介绍,这里大家可以直接从官方拉取Image:
docker pull eosio/eos-dev:v1.0.8
docker tag eosio/eos-dev:v1.0.8 eosio/eos-dev:latest
此外,也可以自己获取eos最新代码之后,在本地使用Dockerfile build出eos-dev Image, 进入eos/Docker/dev目录,执行:
docker build.-t eosio/eos-dev:latest
注意
如果不对eos/Docker/dev/Dockerfile 做修改的情况下,使用的事master分支的代码构建的Image
启动本地节点的测试环境
创建volume,供nodeos和keosd挂载使用:
docker volume create --name=local-nodeos-data-volume
docker volume create --name=local-keosd-data-volume
在blockchain/eos/04/docker目录下,启动nodeos和keosd:
docker-compose -f docker-compose-local-eosio1.0.yaml up -d
可以查看log日志:
docker logs -f docker_nodeosd_1
得到如下类似日志:
给cleos命令配置alias
由于我们不希望每次执行cleos命令都进入docker container中执行,因此我们配置了简短的cleos的alias来代替docker命令:
aliascleos='docker-compose -f docker-compose-local-eosio1.0.yaml exec keosd /opt/eosio/bin/cleos -u http://nodeosd:8888 --wallet-url http://localhost:8900'
(可以将此alias的定义添加到~/.bash_profile 中,这样每次终端启动时候都会自动定义alias) 测试cleos命令是否可用:
cleos get info
注意
以后cleos命令的执行必须在docker-compose-local-eosio1.0.yaml文件所在目录才可以。
此时也可以通过http的请求,直接访问查询:
curl http://localhost:8888/v1/chain/get_info
分享一个EOS开发视频教程,https://www.lanzous.com/b325759/ 密码:d55l