ethereum-testnet-docker 基于docker的以太坊集群的私有链开发环境
使用docker-machine进行对docker集群部署以太坊私有链
源码: https://github.com/HuaRongSAO/ethereum-testnet-docker
作者环境:
- ubuntu 16.04
目录
- 使用本地搭建
- docker 安装
- docker-compose 安装
- 搭建eth私有链
- 简单测试
- 使用docker-machine搭建集群
- docker 集群创建
- docker-machine 安装
1.docker
安装地址: https://docs.docker.com/install/
如果觉得安装步骤太麻烦,官方提供一件安装脚本:
Linux下可以运行:
# 下载脚本
curl -fsSL get.docker.com -o get-docker.sh
# 运行脚本
sudo sh get-docker.sh安装成功后:
- 启动服务:
- ubuntu: systemctl start docker
- centos: service docker start
- window: 直接打开windowd的客户端
# 运行 docker version
$ docker version
Client:
Version: 18.03.0-ce
API version: 1.37
Go version: go1.9.4
Git commit: 0520e24
Built: Wed Mar 21 23:10:01 2018
OS/Arch: linux/amd64
Experimental: false
Orchestrator: swarm
Server:
Engine:
Version: 18.03.0-ce
API version: 1.37 (minimum version 1.12)
Go version: go1.9.4
Git commit: 0520e24
Built: Wed Mar 21 23:08:31 2018
OS/Arch: linux/amd64
Experimental: false
2.docker-compose
Docker Compose 是 Docker 官方编排（Orchestration）项目之一，负责快速的部署分布式应用。
文档: https://docs.docker.com/compose/
安装: Linux系统下:
$ sudo curl -L https://github.com/docker/compose/releases/download/1.17.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose- python环境可以使用pip安装:
sudo pip install -U docker-compose其他系统请看
- (官网)[https://docs.docker.com/compose/install/]
- (Docker — 从入门到实践)[https://yeasy.gitbooks.io/docker_practice/content/compose/install.html]
运行:
$ docker-compose --version
docker-compose version 1.17.0, build ac53b733.搭建eth私有链
下载仓库: https://github.com/HuaRongSAO/ethereum-testnet-docker
git clone https://github.com/HuaRongSAO/ethereum-testnet-docker --depth 1
cd ethereum-testnet-docker 文件目录结构:
.
├── docker-compose-standalone.yml # 单独启动一个eth节点
├── docker-compose.yml # 单独启动一个eth节点， 一个初始节点， 一个网络状态
├── eth-netstats # 网络状态
│ └── Dockerfile
├── genesis # 初始化配置
│ ├── genesis.json
│ ├── keystore # 初始化 配置账户
│ │ ├── UTC--2018-03-20T06-02-05.635648305Z--d6e2f555878f29ca190b8ef6bf7de334e1c47e51
├── geth-node # 以太坊节点+api
│ ├── app.json
│ ├── Dockerfile
│ └── start.sh
├── install-compose.sh
└── readme.md
运行:
# 进入ethereum-testnet-docker
cd ethereum-testnet-docker
# 在ethereum-testnet-docker目录下运行 启动以太坊
# 第一次运行可能会加载时间相对长,以后就快了
docker-compose up -d
# 查看运行状态
docker ps
# 运行状态如下
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
59380c23b730 ethereumdocker_eth "/root/start.sh '--d…" 5 seconds ago Up 3 seconds 8545-8546/tcp, 30303/tcp, 30303-30304/udp ethereumdocker_eth_1
fbe34c9110b1 ethereumdocker_bootstrap "/root/start.sh '--d…" 5 seconds ago Up 4 seconds 0.0.0.0:8545->8545/tcp, 0.0.0.0:30303->30303/tcp, 8546/tcp, 0.0.0.0:30303->30303/udp, 30304/udp bootstrap
4d77ae7e987e ethereumdocker_netstats "npm start" 6 seconds ago Up 4 seconds 0.0.0.0:3000->3000/tcp netstats折就是运行成功了,接下来你可以直接打开浏览器访问: http://127.0.0.1:3000
界面仓库:https://github.com/cubedro/eth-netstats
你就可以查看到运行状态了
现在你就能看到两个节点:
- bootstrap # 初始化节点
- e69fe54d216d # 新加入的节点
接下来添加多个节点
# docker-compose scale 作用是启动多个eth服务
docker-compose scale eth=3出现了三个新的node节点:
- e69fe54d216d
- 55f0f83728db
- 1770aec8a167
使用geth
使用docker exec进行与geth的交互
# 格式 docker exec -it ethereumdocker_eth_{第几个节点} geth attach ipc://root/.ethereum/devchain/geth.ipc
docker exec -it ethereumdocker_eth_1 geth attach ipc://root/.ethereum/devchain/geth.ipc进入docker内部的geth就可以正常的使用geth的功能了.
阅读geth文档:
Welcome to the Geth JavaScript console!
instance: Geth/v1.8.3-unstable-faed47b3/linux-amd64/go1.10
coinbase: 0xd6e2f555878f29ca190b8ef6bf7de334e1c47e51
at block: 0 (Thu, 01 Jan 1970 00:00:00 UTC)
datadir: /root/.ethereum/devchain
modules: admin:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 rpc:1.0 txpool:1.0 web3:1.0
> admin.nodeInfo.enode
"enode://3732c434c5330205b12ef83e31e59dd36b6d04fc8392770057a05b678483524c2c5649932bc3cc8bced54d94befbd0fda6daae988243489ce0faecfa7a5b0914@[::]:30303"
> # geth cli开始挖矿
节点是默认不挖矿的需要手动开启挖矿:
docker exec -it ethereumdocker_eth_1 geth attach ipc://root/.ethereum/devchain/geth.ipc
# 开始挖矿
miner.start()等带一段时间后,就能重127.0.0.1:3000看到区块了.
# eth 查看用户
eth.accounts# stop 停止挖矿
miner.stop()到此以太坊的local本机就开发好了,但是会出现其他的问题
- 以太坊钱包冲突,因为以太坊钱包的端口也是30303,8545
解决方法:
- 你可以修改docker-compose里的端口映射
或者使用docker-machine进行docker隔离(强推)
使用docker-machine搭建私有链集群
Docker Machine 可以在多种操作系统平台上安装，包括 Linux、macOS，以及 Windows。
1.安装docker-machine
Linux下直接:
base=https://github.com/docker/machine/releases/download/v0.14.0 &&
curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/tmp/docker-machine &&
sudo install /tmp/docker-machine /usr/local/bin/docker-machine看到输出就是安装成功
$ docker-machine -v
docker-machine version 0.13.0, build 9ba6da92.使用docker-machine
创建一台eth的测试虚拟机: linux 下:
docker-machine create -d virtualbox --engine-opt dns=114.114.114.114 --engine-registry-mirror https://registry.docker-cn.com --virtualbox-memory 2048 --virtualbox-cpu-count 2 eth参数解析:
-
--engine-opt dns=114.114.114.114 配置 Docker 的默认 DNS
-
--engine-registry-mirror https://registry.docker-cn.com 配置 Docker 的仓库镜像
-
--virtualbox-memory 2048 配置主机内存
-
--virtualbox-cpu-count 2 配置主机 CPU
mac和window系统请阅读: mac和window,其他系统
查看是否创建成功:
docker-machine ls
# 输出
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
eth - virtualbox Running tcp://192.168.99.100:2376 v18.03.0-ce搭建eth服务
远程到你创建的虚拟机
# 远程到虚拟机
docker-machine ssh eth
# 为用户设置管理员密码
sudo passwd
# 设置密码
root
root拉取项目到你的虚拟机
# 拉取本项目的代码
git clone https://github.com/HuaRongSAO/ethereum-testnet-docker --depth 1
# 跳转目录
cd ethereum-testnet-docker
# 为脚本添加权限
sudo chmod +x ./install-compose.sh
# 运行脚本
./install-compose.sh这里解释一下脚本: 只是用来安装docker-compose
搭建私有链集群
# 跳转目录
cd ethereum-testnet-docker
# 启动 docker-以太坊 节点
docker-compose up -d
# 添加多节点
docker-compose scale eth=3
# 查看是否运行
docker ps到这里虚拟机的私有链就安装成功了
访问
在退出虚拟机的情况下(使用exit退出,)获取虚拟机的ip
docker-machine ip eth
# 输出ip 这就是你虚拟机的ip
192.168.99.100打开浏览器:输入192.168.99.100:3000,就能看到挖矿节点的信息
geth交互
- 先远程登入虚拟机
docker-machine ssh eth
- 运行
# 格式 docker exec -it ethereumdocker_eth_{第几个节点} geth attach ipc://root/.ethereum/devchain/geth.ipc
docker exec -it ethereumdocker_eth_1 geth attach ipc://root/.ethereum/devchain/geth.ipc
# 其他操作
...
到这里集群就安装完毕,你的以太坊私有链的地址就不在是127.0.0.1:30303和8545就不会和本地的钱包发生冲突了,你就可以使用钱包链接到本地192.168.99.100的私有链了.
文献参考: