[Hyperledger Fabric v2.x] #1. 소개 + 실습 환경 구성

 

 

2020년 한 해 동안 Hyperledger Fabric v2.x 을 활용하여 개발한 내용들에 대해서 정리를 하고자 글을 올립니다.

Hyperledger Fabric 에 대한 접근성을 어려워 하는 분들을 위해 실제 코드레벨에서의 소스 코드 분석 보다는 기본적인 활용에 대한 내용을 간단히 소개 할 예정입니다.

 

목차는 아래와 같습니다. (추후 글을 작성하며 링크를 채워 갈 예정입니다.)

목차

대분류	소분류	링크
Hyperledger Fabric Network	실습 환경 구성
	네트워크 구성 파일 설정
	네트워크 구성 및 구축	namho46.tistory.com/23
Hyperledger Fabric Chaincode	Golang based 체인코드 작성
	체인코드 배포
	체인코드 실행
Hyperledger Fabric Gateway	Golang based 트랜잭션 게이트웨이 개발
Hyperledger Tools	Hyperledger Caliper
	Hyperledger Explorer

실습 환경 구성

하이퍼레저를 간편히 실행 시킬 수 있는 방법은 Docker 혹은 Docker Compose 를 활용하여 할 수 있다. 소스코드에 대한 수정을 원하는 분들은 따로 소스를 깃헙 링크 에서 받아서 빌드하면 됩니다.

 

---

Install Prerequisites

Hyperledger Fabric v2.x 을 Docker Compose 로 실행 했을 때 아래와 같은 것들이 사전에 설치가 요구됩니다.

1. git
2. curl
3. docker and docker compose

각각의 설치 방법의 커맨드는 Ubuntu 18.04 기준으로 아래와 같습니다.

Install git

$ sudo apt update && sudo apt upgrade
$ sudo apt-get install git
$ git --version

Install cURL

$ sudo apt install curl
$ curl --version

Install Docker

$ sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    gnupg-agent \
    software-properties-common
$ sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
$ sudo docker run hello-world

Install Docker Compose

$ ssudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
$ sudo chmod +x /usr/local/bin/docker-compose
$ docker-compose --version

run docker daemon

$ sudo systemctl start docker
$ sudo systemctl enable docker
$ sudo usermod -a -G docker <username>
$ sudo chmod 666 /var/run/docker.sock
$ sudo systemctl restart docker

 

Install fabric-samples

본 문서에서는 Hyperledger Fabric 에서 제공하는 fabric-samples 를 주로 다룰 것 입니다.

1. 프로젝트 디렉토리 생성

$ mkdir ~/fabric-lecture && cd ~/fabric-lecture

2. fabric-samples 가져오기

$ curl -sSL https://bit.ly/2ysbOFE | bash -s

정상적으로 가져왔다면 다음과 같은 경로 ~/fabric-lecture/fabric-samples/bin 에 아래의 바이너리 파일들이 받아진 것을 볼 수 있습니다.

• configtxgen,
• configtxlator,
• cryptogen,
• discover,
• idemixgen
• orderer,
• peer,
• fabric-ca-client,
• fabric-ca-server

3. profile 에 binary 경로 설정

바이너리를 통한 작업의 편의성을 위해 가져온 바이너리들을 PATH 에 설정합니다.

$ sudo vi ~/.profile

// Add fabric-samples binary files to PATH
PATH=$HOME/fabric-lecture/fabric-samples/bin:$PATH

$ source ~/.profile

마무리

지금까지 Hyperledger Fabric v2.x 활용을 위한 실습 환경 구성을 완료했습니다.

다음 내용에서는 Hyperledger Fabric Network 구축에 대해 알아보겠습니다.