Hyperledger Fabric(v0.6) Network Configuration
Hyperledger Fabric v0.6에 대한 Fabric Network 구성 방법을 정리한다. 아쉽게도 이 글은 아직 미완성이다. 그런데, 얼마전 Hyperledger Fabric v1.0이 릴리즈 되었고, v1.0에 대한 Configuration Cheat Sheet을 작성해서 따로 포스팅했다. v1.0은 운영(production) 버전으로 불리고 있고, v0.6과 차이가 많기 때문에 굳이 v0.6을 사용해야 하는 상황이 아니라면 v1.0을 구성할 것을 권고한다.
Ubuntu를 기준으로 Hyperledger를 설치하는 방법을 기술한다. Ubuntu의 버전은 16.04.2 LTS 이며, VMware Player에 설치하였다. 또한, 모든 작업은 root 권한으로 실행하였다.
Hyperledger의 설치는 Docker를 얼마나 능숙하게 사용할 수 있느냐에 달려있다고 해도 과언이 아니다. Docker에 익숙하지 않다면, Docker에 먼저 익숙해 지는 것이 좋다.
아주 많은 글을 참고하였으나, 가장 많이 참고한 글은 IBM Developer Center의 “먼저 시작해 보는 블록체인“이다. 이 글을 보고 따라하면, 개발 모드에서 블록을 생성해 보는 것은 어렵지 않을 것이다.
먼저 도커부터 설치하자. 우분투에서 도커를 설치하는 건 어렵지 않다.
|
1 2 3 |
apt install docker.io ln -sf /usr/bin/docker.io /usr/local/bin/docker apt install docker-compose // 요녀석은 여러 도커 이미지를 한 번에 컨테이너로 생성할 수 있게 해주는 툴이다. |
아래는 Docker-Machine 설치와 관련한 명령어이다. 그러나, Docker-Machine의 설치는 일단 보류한다. Ubuntu에서는 불필요한 것으로 판단된다.
|
1 2 3 |
curl -L https://github.com/docker/machine/releases/download/v0.12.0/docker-machine-`uname -s`-`uname -m` >/tmp/docker-machine && chmod +x /tmp/docker-machine && sudo cp /tmp/docker-machine /usr/local/bin/docker-machine // Reference : https://docs.docker.com/machine/install-machine/#installing-machine-directly |
이제 도커로 Hyperledger 이미지를 다운로드하자. 일단 블록이 생성되는 걸 보고 싶다면, 더 높은 버전이 있더라도 똑같은 버전으로 설치하는 걸 권장한다.
|
1 2 3 4 |
docker pull hyperledger/fabric-baseimage:x86_64-0.1.0 docker pull hyperledger/fabric-membersrvc:x86_64-0.6.1-preview docker pull hyperledger/fabric-peer:latest docker tag hyperledger/fabric-baseimage:x86_64-0.1.0 hyperledger/fabric-baseimgae:latest // 이건 태그를 생성하는 명령인데, 나중에 운영모드에서 REST API로 Deploy할 때 반드시 필요하다. |
이제 멤버서비스(membersrvc)와 피어(peer) 이미지로 컨테이너를 생성해야 하는데, Docker-Compose를 사용한다. Docker-Compose를 사용하기 위해서는 docker-compose.yml 를 만들어야 한다. 파일 생성 위치는 아무 곳이나 상관없다. docker-compose.yml를 만들 때 주의해야 할 사항은 들여쓰기이다. 탭(tab)을 사용하지 말고 스페이스(space)를 이용하는 것이 좋다.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
membersrvc: image: hyperledger/fabric-membersrvc:x86_64-0.6.1-preview ports: - "7054:7054" command: membersrvc vp0: image: hyperledger/fabric-peer:latest ports: - "7050:7050" - "7051:7051" - "7053:7053" environment: - CORE_PEER_ADDRESSAUTODETECT=true - CORE_LOGGING_LEVEL=DEBUG - CORE_PEER_ID=vp0 - CORE_PEER_PKI_ECA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TCA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TLSCA_PADDR=membersrvc:7054 - CORE_SECURITY_ENABLED=true - CORE_SECURITY_ENROLLID=test_vp0 // ID는 membersrvc 이미지의 membersrvc.yml 파일에 설정되어 있다. - CORE_SECURITY_ENROLLSECRET=MwYpmSRjupbT // 비밀번호도 ID와 동일한 파일에 설정되어 있다. links: - membersrvc command: sh -c "sleep 5; peer node start --peer-chaincodedev" // --peer-chaincodedev 옵션을 붙이면 개발 모드로 컨테이너가 생성된다. |
매핑된 포트는 아래와 같은 역할을 수행한다.
|
1 2 3 4 5 |
7050: REST service listening port (Recommened to open at non-validating node) 7051: Peer service listening port 7052: CLI process use it for callbacks from chain code 7053: Event service on validating node // Reference : https://hub.docker.com/r/yeasy/hyperledger-peer/ |
일단 개발 모드에서 블록이 생성되는 걸 보자. docker-compose.yml 파일을 생성한 위치에서 아래 명령을 실행한다.
|
1 2 3 |
docker-compose up // 아래 메시지가 출력되면 정상 실행 vp0_1 | 09:50:27.129 [rest] StartOpenchainRESTServer -> INFO 054 Initializing the REST service on 0.0.0.0:7050, TLS is disabled. |
블록이 만들어졌다고 해도, 확인할 방법이 없다. 물론 피어에 REST API로 요청하면 볼 수 있긴한데 불편하니 Hyperledger Explorer를 설치하자.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
// Explorer Image 다운로드 ubuntu> docker pull yeasy/blockchain-explorer:latest // Explorer Image 실행 ubuntu> docker run -i -t yeasy/blockchain-explorer /bin/bash // Dependancy 설치 docker> npm install npm bower grunt-cli graceful-fs@4.1.5 minimatch@3.0.2 -g docker> npm install grunt grunt-auto-install grunt-contrib-uglify grunt-contrib-copy // 에러 발생하면, 이미지 다시 실행 docker> grunt docker> exit ubuntu> docker run -p 9090:9090 -e HYP_REST_ENDPOINT=http://172.17.0.3:7050 yeasy/blockchain-explorer // References https://hub.docker.com/r/yeasy/blockchain-explorer/ https://github.com/hyperledger/blockchain-explorer/tree/master/explorer_1?cm_mc_uid=29555844367114966345979&cm_mc_sid_50200000=1498133286&cm_mc_sid_52640000=1498133690 |
블록체인의 스마트 컨트랙트를 Hyperledger에서 구현하기 위한 코드를 체인코드라고 한다. Hyperledger에서 블록을 생성하려면, 체인코드를 Deploy해야 한다. 체인코드는 Go나 Java를 사용할 수 있다.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
// Go 설치 ubuntu> apt install golang // Git 설치 ubuntu> apt install git // Chaincode build ubuntu> pwd /root ubuntu> mkdir chaincode ubuntu> export GOPATH=/root/chaincode ubuntu> mkdir -p $GOPATH/src/github.com/hyperledger ubuntu> cd $GOPATH/src/github.com/hyperledger ubuntu> git clone https://github.com/hyperledger/fabric.git ubuntu> cd fabric ubuntu> git checkout v0.6.1-preview ubuntu> cd $GOPATH/src/github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02 ubuntu> go build ubuntu> CORE_CHAINCODE_ID_NAME=mycc CORE_PEER_ADDRESS=172.17.0.3:7051 ./chaincode_example02 // 아래 메시지가 출력되면 성공 09:42:13.987 [shim] DEBU : Received REGISTERED, ready for invocations |
이제부터 운영 모드를 다룰 것이다. 많은 시행착오가 있었지만 막상 정리하려고 보니, 개발 모드와 큰 차이점은 없다. docker-compose.yml의 설정이 변경되는 것이 거의 전부다. 아래는 Validating Peer를 4개 구성하기 위한 docker-compose.yml의 예시이다. vp0 환경 설정의 CORE_VM_ENDPOINT가 핵심이다.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 |
membersrvc: image: hyperledger/fabric-membersrvc:x86_64-0.6.1-preview ports: - "7054:7054" hostname: membersrvc container_name: membersrvc command: membersrvc vp0: image: hyperledger/fabric-peer:latest ports: - "7050:7050" - "7051:7051" - "7053:7053" environment: - CORE_PEER_ADDRESSAUTODETECT=true - CORE_VM_ENDPOINT=http://192.168.255.147:2375 // 이 녀석이 핵심! - CORE_LOGGING_LEVEL=ERROR - CORE_PEER_ID=vp0 - CORE_PEER_PKI_ECA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TCA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TLSCA_PADDR=membersrvc:7054 - CORE_SECURITY_ENABLED=true - CORE_SECURITY_ENROLLID=test_vp0 - CORE_SECURITY_ENROLLSECRET=MwYpmSRjupbT hostname: vp0 container_name: vp0 links: - membersrvc command: sh -c "sleep 5; peer node start" vp1: image: hyperledger/fabric-peer:latest ports: - "7061:7061" environment: - CORE_PEER_ADDRESSAUTODETECT=true - CORE_LOGGING_LEVEL=ERROR - CORE_PEER_ID=vp1 - CORE_PEER_ADDRESS=0.0.0.0:7061 - CORE_PEER_LISTENADDRESS=0.0.0.0:7061 - CORE_PEER_PKI_ECA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TCA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TLSCA_PADDR=membersrvc:7054 - CORE_SECURITY_ENABLED=true - CORE_SECURITY_ENROLLID=test_vp1 - CORE_SECURITY_ENROLLSECRET=5wgHK9qqYaPy - CORE_PEER_DISCOVERY_ROOTNODE=vp0:7051 hostname: vp1 container_name: vp1 links: - membersrvc - vp0 command: sh -c "sleep 5; peer node start" vp2: image: hyperledger/fabric-peer:latest ports: - "7071:7071" environment: - CORE_PEER_ADDRESSAUTODETECT=true - CORE_LOGGING_LEVEL=ERROR - CORE_PEER_ID=vp2 - CORE_PEER_ADDRESS=0.0.0.0:7071 - CORE_PEER_LISTENADDRESS=0.0.0.0:7071 - CORE_PEER_PKI_ECA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TCA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TLSCA_PADDR=membersrvc:7054 - CORE_SECURITY_ENABLED=true - CORE_SECURITY_ENROLLID=test_vp2 - CORE_SECURITY_ENROLLSECRET=vQelbRvja7cJ - CORE_PEER_DISCOVERY_ROOTNODE=vp0:7051 hostname: vp2 container_name: vp2 links: - membersrvc - vp0 command: sh -c "sleep 5; peer node start" vp3: image: hyperledger/fabric-peer:latest ports: - "7081:7081" environment: - CORE_PEER_ADDRESSAUTODETECT=true - CORE_LOGGING_LEVEL=ERROR - CORE_PEER_ID=vp3 - CORE_PEER_ADDRESS=0.0.0.0:7081 - CORE_PEER_LISTENADDRESS=0.0.0.0:7081 - CORE_PEER_PKI_ECA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TCA_PADDR=membersrvc:7054 - CORE_PEER_PKI_TLSCA_PADDR=membersrvc:7054 - CORE_SECURITY_ENABLED=true - CORE_SECURITY_ENROLLID=test_vp3 - CORE_SECURITY_ENROLLSECRET=9LKqKH5peurL - CORE_PEER_DISCOVERY_ROOTNODE=vp0:7051 hostname: vp3 container_name: vp3 links: - membersrvc - vp0 command: sh -c "sleep 5; peer node start" |
운영 모드에서 체인 코드의 배포는 개발 모드와 많은 차이가 있다. 먼저 개발 모드에서는 체인 코드를 로컬에서 빌드하고 VP로 전달하였다. 하지만 운영 모드에서는 이런 과정이 생략된다. 체인 코드의 빌드는 지금까지 한 번도 등장하지 않았던 baseimage가 담당한다. 순서는 다음과 같다.
- 체인코드를 VP의 $GOPATH/src 아래에 저장한다.
- REST API로 위의 경로를 포함하여 deploy 한다.
- VP는 Docker의 Docker Remote API를 호출하여, baseimage 컨테이너를 생성한다.
- baseimage는 체인코드를 빌드하고, 다른 VP에게 전달한다.
이런 순서로 동작하는데, 3번의 Docker Remote API를 호출하기 위해서 CORE_VM_ENDPOINT 설정이 필요하다. 위에서 docker-compose.yml이 거의 전부라고 했다. 남아있는 건, Docker Remote API의 설정이다. 다음과 같이 설정해 주고 도커 서비스를 재시작 한다.
|
1 |
ubuntu> echo 'DOCKER_OPTS="--api-cors-header="*" -H tcp://0.0.0.0:2375" >> /etc/default/docker |