EOS开发环境搭建,如何编译安装构建EOSIO

获取代码

下载所有的EOSIO代码,clone eos库和所有的子模块。

shell 命令如下:

git clone https://github.com/EOSIO/eos --recursive

如果忘记加 --recursive 参数也没关系,随后也可以用命令 clone 所有子模块。

git submodule update --init --recursive

安装构建设置

EOSIO可以在多个平台上安装构建,并有各种路径进行安装构建。大多数用户更喜欢使用自动化脚本或docker,而更高级的用户或希望部署公共节点的用户可能需要手动方法。构建内容生成在eos/build文件夹中。可执行文件可以在eos/build/programs文件夹的子文件夹中找到。

  • 自动化脚本 :适合于大多数开发人员,这个脚本是基于Mac OS和许多Linux版本的。
  • docker-compose方式 :到目前为止最快的安装方法,可以在两分钟内启动并运行一个节点。也就是说,它需要一些额外的本地配置来进行开发,以便顺利运行并遵循我们提供的教程。
  • 手动安装构建:适用于那些可能对自动化脚本有冲突的环境,或者希望对其构建进行更多控制的开发者。
  • 可执行文件安装构建:一个可选的make install步骤,可以使本地开发更加友好。

如果你是新手,建议直接看通过docker快速构建安装EOSIO

自动化脚本安装

有一个自动化的构建脚本,可以安装所有依赖项并构建EOSIO。脚本支持以下操作系统。

我们正在支持和将来发布会支持的Linux/UNIX发行版。

  • Amazon 2017.09 和更高版本。
  • Centos 7。
  • Fedora 25和更高版本(推荐 Fedora 27)。
  • Mint 18。
  • Ubuntu 16.04(推荐 Ubuntu 16.10)。
  • MacOS Darwin 10.12和更高版本(推荐 MacOS 10.13.x)。

eos目录运行安装构建脚本:

cd eos
./eosio_build.sh

docker-compose方式构建

如果你只是想跑起来,可能通过docker快速构建安装EOSIO更适合。否则你想了解更高级的构建,那么继续。

安装依赖项
Docker的要求
  • 至少7GB RAM(DOCK->首选项->高级->内存->7GB或以上)
  • 如果安装构建失败,请确保你已经调整了Docker内存设置,然后再试一次。
构建eos镜像
git clone https://github.com/EOSIO/eos.git --recursive  --depth 1
cd eos/Docker
docker build . -t eosio/eos

以上将在默认情况下构建对主分支的最新提交。如果想针对特定的分支/tag,可以使用生成参数。例如,如果希望根据v1.0.0 tag生成Docker镜像,可以执行以下操作:

docker build -t eosio/eos:v1.0.0 --build-arg branch=v1.0.0 .

默认情况下,eosio.system的 symbol 设置为SYS。在构建Docker镜像时,可以使用 symbol 参数来做到这一点。

docker build -t eosio/eos --build-arg symbol=ABC.
在 docker 中启动 nodeos
docker run --name nodeos -p 8888:8888 -p 9876:9876 -t eosio/eos nodeosd.sh -e arg1 arg2

默认情况下,所有数据都保存在docker卷中。如果数据过时或损坏,则可以删除它:

$ docker inspect --format '{{ range .Mounts }}{{ .Name }} {{ end }}' nodeos
fdc265730a4f697346fa8b078c176e315b959e79365fc9cbd11f090ea0cb5cbc
$ docker volume rm fdc265730a4f697346fa8b078c176e315b959e79365fc9cbd11f090ea0cb5cbc

或者,可以直接将宿主目录安装到docker中。

docker run --name nodeos -v /path-to-data-dir:/opt/eosio/bin/data-dir -p 8888:8888 -p 9876:9876 -t eosio/eos nodeosd.sh -e arg1 arg2
获取区块链信息
curl http://127.0.0.1:8888/v1/chain/get_info
在docker中启动nodeos和keosd
docker volume create --name=nodeos-data-volume
docker volume create --name=keosd-data-volume
docker-compose up -d

docker-compose -d之后,将启动nodeoskeosd两个服务。nodeos服务会将端口8888和9876提供给主机。kesod服务不向主机公开任何端口,只有当在cleos容器中运行cleos时,cleos才可以访问它。

执行cleos命令

你可以运行cloes通过bash别名

alias cleos='docker-compose exec keosd /opt/eosio/bin/cleos -u http://nodeosd:8888 --wallet-url http://localhost:8900'
cleos get info
cleos get account inita

如果你想在任何地方使用cleos命令,你可以在docker-compose.yml指定路径:

alias cleos='docker-compose -f path-to-eos-dir/Docker/docker-compose.yml exec keosd /opt/eosio/bin/cleos -u http://nodeosd:8888 --wallet-url http://localhost:8900'

提交exchange示例合约:

cleos set contract exchange contracts/exchange/

如果你不需要keosd,可以停止使用keosd服务:

docker-compose stop keosd
开发构建客户合约

由于eosio/eos镜像不包含合约开发所需的依赖关系(这样设计是为了保持较小镜像尺寸),所以需要使用 eosio/eos-dev镜像。此镜像包含使用eosiocpp构建合约的所需二进制文件和依赖项。

可以使用Docker Hub上可用的镜像或进入到dev文件夹并手动构建镜像。

cd dev
docker build -t eosio/eos-dev .
修改默认配置

可以使用docker compose更改默认配置。例如,创建一个备用配置文件config2.inidocker-compose.override.yml,内容如下:

version: "2"

services:
  nodeos:
    volumes:
      - nodeos-data-volume:/opt/eosio/bin/data-dir
      - ./config2.ini:/opt/eosio/bin/data-dir/config.ini

然后重启docker:

docker-compose down
docker-compose up
删除data-dir

docker-compose创建的data卷可以被删除:

docker volume rm nodeos-data-volume
docker volume rm keosd-data-volume
Docker Hub

Docker Hub 镜像来自docker hub

建立一个新的docker-compose.yaml文件内容如下:

version: "3"

services:
  nodeosd:
    image: eosio/eos:latest
    command: /opt/eosio/bin/nodeosd.sh --data-dir /opt/eosio/bin/data-dir -e
    hostname: nodeosd
    ports:
      - 8888:8888
      - 9876:9876
    expose:
      - "8888"
    volumes:
      - nodeos-data-volume:/opt/eosio/bin/data-dir

  keosd:
    image: eosio/eos:latest
    command: /opt/eosio/bin/keosd --wallet-dir /opt/eosio/bin/data-dir --http-server-address=127.0.0.1:8900
    hostname: keosd
    links:
      - nodeosd
    volumes:
      - keosd-data-volume:/opt/eosio/bin/data-dir

volumes:
  nodeos-data-volume:
  keosd-data-volume:

注意:默认版本是最新版本,可以将其更改为你想要的版本。

  • 运行: docker pull eosio/eos:latest
  • 运行: docker-compose up
EOSIO 1.0 Testnet

我们可以很容易地建立一个EOSIO 1.0本地Testnet测试链,使用docker镜像。只需运行以下命令:

注意:如果你想使用mongo db插件,你必须首先在data-dir/config.ini启用它。

# pull images
docker pull eosio/eos:v1.0.0

# create volume
docker volume create --name=nodeos-data-volume
docker volume create --name=keosd-data-volume
# start containers
docker-compose -f docker-compose-eosio1.0.yaml up -d
# get chain info
curl http://127.0.0.1:8888/v1/chain/get_info
# get logs
docker-compose logs -f nodeosd
# stop containers
docker-compose -f docker-compose-eosio1.0.yaml down

默认情况下,blocks数据存储在--data-dir下,默认情况下钱包文件存储在--wallet-dir下,当然,你可以根据需要更改这些文件路径。

关于MongoDB插件

目前,MongoDB插件在config.ini中被禁用,默认情况下,必须在config.ini中手动更改它,或者可以在docker-compose文件中将config.ini文件mount到/opt/eosio/bin/data-dir/config.ini

手动安装构建

若要手动生成,请使用以下步骤在eos文件夹中创建build文件夹,然后执行build。下面的步骤假设eos存储库被clone到home(即,~)文件夹中。还假定已经安装了必要的依赖项。请参见手动安装依赖项

cd ~
mkdir -p ~/eos/build && cd ~/eos/build

在Linux平台上,使用这个cmake命令:

cmake -DBINARYEN_BIN=~/binaryen/bin -DWASM_ROOT=~/wasm-compiler/llvm -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl -DOPENSSL_LIBRARIES=/usr/local/opt/openssl/lib -DBUILD_MONGO_DB_PLUGIN=true ..

在MacOS上,使用这个cmake命令:

cmake -DBINARYEN_BIN=~/binaryen/bin -DWASM_ROOT=/usr/local/wasm -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl -DOPENSSL_LIBRARIES=/usr/local/opt/openssl/lib -DBUILD_MONGO_DB_PLUGIN=true ..

然后在所在平台上执行:

make -j$( nproc )

也支持Out-of-source安装构建。若要在编译器中重写默认选择,请将这些标志添加到CMake命令:

-DCMAKE_CXX_COMPILER=/path/to/c++ -DCMAKE_C_COMPILER=/path/to/cc

对于调试模式的安装构建,添加-DCMAKE_BUILD_TYPE=Debug。其他常见的构建类型包括ReleaseRelWithDebInfo

可执行文件安装构建

为了便于智能合约开发,可以使用make install将目标内容安装到/usr/local中。此步骤要从build目录下运行的。需要适当的安装权限。

cd build
sudo make install

系统需求(包括所有平台)

  • 内存 7GB
  • 硬盘 20GB

安装构建的验证

可选地,可以对我们的构建运行一组测试,以执行一些基本验证。要在构建后运行测试套件,启动mongod然后运行make test

在 Linux 平台上:

~/opt/mongodb/bin/mongod -f ~/opt/mongodb/mongod.conf &

在 MacOS 平台上:

/usr/local/bin/mongod -f /usr/local/etc/mongod.conf &

然后执行下面的操作:

cd build
make test

另:**《EOS智能合约与DApp开发入门》**教程已经上线,欢迎大家关注:

EOS教程

本教程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用React和EOS的各知识点完成一个便签DApp的开发。

汇智网原创翻译,转载请标明出处。原文

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏腾讯云TStack专栏

惊!Docker竟有这些不为人知的bug

| 作者简介 ? | Docker容器生成僵尸进程 现象 公司开发服务器上使用Docker跑了几个容器,这些容器都是长时间运行的。偶然发现服务器上有大量僵尸进...

99110
来自专栏达观数据

达观数据Docker 集群部署实例

1 docker简介 Docker 是个划时代的开源项目,它彻底释放了计算虚拟化的威力,极大提高了应用的运行效率,降低了云计算资源供应的成本! 使用 Dock...

316100
来自专栏张善友的专栏

IIS 7.0的六大安全新特性为你的Web服务器保驾护航

文章来自:WindowsITPro  2009年2月期 当你启用一台Web服务器的时候,你就把你公司的一部分完全展现给了公众,任凭他人摆布。Web服务器上的那些...

244100
来自专栏Rainbond开源「容器云平台」

【Docker】Docker学习记录: Shipyard+Swarm+Consul+Service Discover 搭建教程

24360
来自专栏Linux启动过程

基于Linux的pc启动过程

作为一个Android开发者,了解整个系统架构是必须的,所以这篇就总结一下Android手机从按下开机键到启动这一过程发生了什么。

21500
来自专栏魏艾斯博客www.vpsss.net

Linode SSH 无法登录的解决办法

47420
来自专栏北京马哥教育

手把手教你用永恒之蓝(Eternalblue)勒索病毒漏洞的高阶用法

? 作者:7sDream 来源: https://www.zybuluo.com/7sDream/note/729295 安装 MSF Linux & Ma...

51580
来自专栏13blog.site

将数据的初始化放到docker中的整个工作过程(问题记录)

由于是打算作为个人博客,所以对于install这个步骤,我从一开始就打算删掉的,前面一个多星期一直在修bug,到前天才开始做这个事情. 过程中也是碰到了各种问...

36050
来自专栏张戈的专栏

Nexus3最佳实践系列:搭建Docker私有仓库

容器仓库是容器化管理中非常重要的一环,相当于 SVN 在程序研发、运维发布中的地位。因此,一个稳定、可靠的容器仓库尤为重要。

92630
来自专栏自由而无用的灵魂的碎碎念

最近几天玩freebsd奋斗成果总结

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/

12820

扫码关注云+社区

领取腾讯云代金券