상품 경매 네트워크 데모 에서 하이퍼레저 패브릭 네트워크에 비즈니스 네트워크를 배포하고, 배포된 비즈니스 네트워크에 REST API 서버를 연결하는 방법을 배웠다면,

이번 과정에서는 하이퍼레저 패브릭 네트워크에서 이벤트가 발생하면, 외부 어플리케이션에서 웹소켓 이벤트 리스너를 통해 Web UI를 업데이트하는 방법을 알아보자.

아카이브 생성

저장소 복제:

1

git clone https://github.com/IBM/BlockchainEvents-CompositeJourney.git

아카이브 파일(.bna) 생성:

1

npm install

{projectDir}/dist에 events.bna파일이 생성되었다.

프로젝트 디렉토리에서 npm test 명령을 실행하면 test/productAuction.js에 작성된 테스트 코드로 유닛테스트가 가능하다.

로컬 패브릭에서 실행되는 하이퍼레저 컴포저에 아카이브 배포

로컬 패브릭을 시작한 뒤 events.bna 파일이 들어있는 dist 디렉토리에서 다음 명령어를 통해 비즈니스 네트워크를 설치/시작한다:

1
2
3

composer network install --card PeerAdmin@hlfv1 --archiveFile events.bna
composer network start --networkName events --networkVersion 0.0.1 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card
composer card import --file networkadmin.card

다음 명령을 통해 네트워크가 잘 배포되었는지 확인할 수 있다:

1

composer network ping --card admin@events

이제 프로젝트 디렉토리로 이동해서 REST API 서버를 시작한다:

1
2
3
4
5
6
7

➜  BlockchainEvents-CompositeJourney git:(master) ✗ composer-rest-server
? Enter the name of the business network card to use: admin@events
? Specify if you want namespaces in the generated REST API: never use namespaces
? Specify if you want to use an API key to secure the REST API: No
? Specify if you want to enable authentication for the REST API using Passport:No
? Specify if you want to enable event publication over WebSockets: Yes
? Specify if you want to enable TLS security for the REST API: No

각 질문에 대해 답하면 이에 맞는 REST API 서버가 시작된다.

• 비즈니스 네트워크 카드 이름: admin@events
• 생성된 API에서 네임스페이스 사용 여부: Never use namespaces
• API key 사용 여부: No
• Passport를 통한 인증 허용 여부: No
• 웹소켓을 통한 이벤트 퍼블리싱 허용 여부: Yes
• TLS 보안 허용 여부: No

REST API 서버가 정상적으로 시작된 경우 웹브라우저로 http://localhost:3000/explorer 로 이동하면 API를 볼 수 있다.

웹 UI 시작

새 터미널을 열어서 프로젝트 디렉토리 내 Web 디렉토리로 이동한다.

npm install 를 통해 모듈 설치 후 node server.js 명령을 사용해 노드 서버를 시작한다.

http://localhost:8000/seller.html, http://localhost:8000/buyer.html 에서 각각 판매자와 구매자의 이벤트에 대한 대시보드를 볼 수 있다.

트랜잭션 submit

경매 네트워크 데모 실습에서는 composer playground를 이용해 트랜잭션을 발생시켜 보았으니, 이번 실습에서는 REST API를 이용해 보겠다.

참여자 생성

참여자는 Seller 1명, Member 2명을 생성한다.

먼저 POST /Seller를 통해 Seller를 생성한다:

1
2
3
4
5
6
7

{
  "$class": "org.acme.product.auction.Seller",
  "organisation": "ACME",
  "email": "auction@acme.org",
  "balance": 100,
  "products": []
}

파라미터 부분에 Seller 생성을 위한 JSON Data를 입력하고 Try it out! 버튼을 클릭하면 아래에 API 실행 결과가 나온다.

Member 생성도 동일한 방법으로 POST /Member를 통해 생성한다.

생성한 참여자들에게는 POST /system/identities/issue 를 통해 ID를 발급한다.

1
2
3
4
5

{
  "participant": "resource:org.acme.product.auction.Seller#auction@acme.org",
  "userID": "seller",
  "options": {}
}

memberA, memberB도 동일한 API를 통해 ID를 발급해준다.

상품 추가

POST /AddProduct를 통해 상품을 등록한다.

1
2
3
4
5
6

{
  "$class": "org.acme.product.auction.AddProduct",
  "productId": "iphone",
  "description": "sample product",
  "owner": "resource:org.acme.product.auction.Seller#auction@acme.org"
}

POST /StartBidding을 통해 경매를 시작한다.

1
2
3
4
5
6

{
  "$class": "org.acme.product.auction.StartBidding",
  "listingId": "sampleListingId",
  "reservePrice": 50,
  "product": "resource:org.acme.product.auction.Product#iphone"
}

경매 입찰

Member는 POST /Offer를 통해 경매에 참여할 수 있다.

1
2
3
4
5
6

{
  "$class": "org.acme.product.auction.Offer",
  "bidPrice": 180,
  "listing": "resource:org.acme.product.auction.ProductListing#sampleListingId",
  "member": "resource:org.acme.product.auction.Member#memberA@acme.org"
}

1
2
3
4
5
6

{
  "$class": "org.acme.product.auction.Offer",
  "bidPrice": 300,
  "listing": "resource:org.acme.product.auction.ProductListing#sampleListingId",
  "member": "resource:org.acme.product.auction.Member#memberB@acme.org"
}

Web UI를 통한 경매 현황 확인

웹소켓을 통한 이벤트 퍼블리싱 허용 여부: Yes

우리가 REST API 서버를 시작할 때 선택한 옵션 중 다음 옵션에 의해서 API 호출 시 발생하는 이벤트를 노드 서버에서 받을 수 있다.

대시보드를 보여주는 웹 어플리케이션의 루트 디렉토리인 Web 디렉토리의 내부를 보면 Web/scripts/events.js 가 있다.

이 스크립트는 ws://localhost:3000에 대한 이벤트 리스너가 정의되어 있고 이를 통해 이벤트가 발생할 때 Web UI를 업데이트 시켜준다.

아래는 지금까지의 경매 현황을 보여주는 Seller와 Member의 대시보드이다.

최소 금액 50으로 경매가 시작되고, memberA와 memberB가 입찰한 정보가 표시된다.

경매 종료

POST /StartBidding을 통해 경매를 시작하였다면, 경매 종료는 POST /CloseBidding을 이용한다.

1
2
3
4

{
  "$class": "org.acme.product.auction.CloseBidding",
  "listing": "sampleListingId"
}

경매가 종료되면 최고금액인 300을 입찰한 memberB가 낙찰받게 되며 이 정보는 노드 서버의 이벤트 리스너에 의해 http://localhost:8000/buyer.html, http://localhost:8000/seller.html 의 UI에 자동으로 업데이트된다.

Part 2는 하이퍼레저 컴포저를 사용하여 간단한 경매 네트워크를 실습해 보는 과정이다.

앞선 튜토리얼과 유사하지만 판매자와 입찰자 권한을 나누고, 각 권한에 맞는 트랜잭션을 submit 할 수 있다. 판매자는 상품을 등록한 후에 경매를 시작하고, 각 입찰 참여자들은 경매 원하는 입찰가를 포함하는 트랜잭션을 발생시킨다.

최종적으로 판매자가 경매를 종료하면 최고 입찰가를 제출한 입찰자의 잔액이 작성했던 입찰가 만큼 줄어들고 상품 소유자가 되며, 판매자는 입찰가만큼 잔액이 증가한다. 즉, 별도의 중개인이 없이 판매자와 입찰자간의 거래가 성사되는 것이다.

공식 사이트에서 쿼리 튜토리얼을 보기 전에 한글로 정리된 예제를 한두개 더 보는게 내용 정리하는데 도움이 될 것 같아 검색을 하다 발견한 데모인데 이렇게 한글로 잘 설명된 가이드를 찾게 되서 다행이다!!

아카이브 생성

하이퍼레저 컴포저 개발 툴 설치 후 저장소를 복제한다.

1

git clone https://github.com/IBM/BlockchainSmartContractTrading-CompositeJourney.git

저장소에서 복제한 디렉토리로 이동 후 다음 명령을 사용하여 네트워크 아카이브(.bna)를 생성한다:

1

npm install

명령을 실행하면 아래와 같은 결과가 나온다:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

> mkdirp ./dist && composer archive create --sourceType dir --sourceName . -a ./dist/product-auction.bna

Creating Business Network Archive

Looking for package.json of Business Network Definition
Input directory: /Users/LeeJaeSeok/demo/BlockchainSmartContractTrading-CompositeJourney

Found:
Description: Sample product auction network
Name: product-auction
Identifier: product-auction@0.0.1

Written Business Network Definition Archive file to
Output file: ./dist/product-auction.bna

Command succeeded

composer archive create 명령을 통해 dist 폴더에 product-auction.bna 파일이 생성되었다.

프로젝트 디렉토리 내에는 dist 폴더 외에도 test 폴더에 productAuction.js 라는 비즈니스 네트워크를 테스트 할 수 있는 스크립트가 있다.

이 테스트 스크립트는 프로젝트 디렉토리에서 아래 명령을 통해 실행 할 수 있다:

1

npm test

이 명령은 아래와 같이 Node.js의 테스트 프레임워크인 Mocha를 통해 현재 경로의 test/디렉토리에 있는 모든 .js파일의 테스트를 진행한다:

1
2
3
4
5
6
7
8
9
10
11

> product-auction@0.0.1 test C:\Users\LeeJaeSeok\demo\BlockchainSmartContractTrading-CompositeJourney
> nyc mocha -t 0 test/*.js

#org.acme.product.auction
  √ Authorized owner should start the bidding (75ms)
  √ Members bid for the product (199ms)
  √ Close bid for the product (243ms)
  
3 passing (4s)

...

컴포저 플레이그라운드를 이용한 경매 네트워크 데모

플레이그라운드를 열어 product-auction.bna 파일을 배포한다.

이전에 플레이그라운드를 사용한 적이 있다면, 웹브라우저 콘솔에서 localStorage.clear()를 사용해 웹브라우저 로컬 저장소를 지운다.

참여자 생성

Test 탭에서 비즈니스 네트워크를 테스트 하려면:

PARTICIPANTS > Seller 에 새 참여자를 생성한다.

1
2
3
4
5
6
7

{
    "$class": "org.acme.product.auction.Seller",
    "organisation": "ACME",
    "email": "auction@acme.org",
    "balance": 100,
    "products": []
}

PARTICIPANTS > Member 에는 다음의 두명의 참여자를 생성한다.

1
2
3
4
5
6
7
8

{
    "$class": "org.acme.product.auction.Member",
    "firstName": "Amy",
    "lastName": "Williams",
    "email": "memberA@acme.org",
    "balance": 1000,
    "products": []
}

1
2
3
4
5
6
7
8

{
    "$class": "org.acme.product.auction.Member",
    "firstName": "Billy",
    "lastName": "Thompson",
    "email": "memberB@acme.org",
    "balance": 1000,
    "products": []
}

이제 admin 탭을 클릭하여 새로운 ID를 생성한다.

참고한 가이드에는 ID생성 > 월렛에 추가 하는 방식으로 설명되어 있는데 컴포저나 플레이그라운드 버전이 바뀌면서 변경된 것인지 ID 생성과 함께 월렛에 추가되었다는 notification을 볼 수 있어 별도 월렛 추가 과정은 필요하지 않았다.

ID 추가에는 위 화면과 같이 ID NAME과 Participant가 필요하다. 앞에서 생성한 1개의 seller 정보와 memberA, memberB의 정보를 이용하여 3개의 ID를 생성한다.

1
2

ID NAME : seller
Participant : resource:org.acme.product.auction.Seller#auction@acme.org

1
2

ID NAME : memberA
Participant : resource:org.acme.product.auction.Member#memberA@acme.org

1
2

ID NAME : memberB
Participant : resource:org.acme.product.auction.Member#memberB@acme.org

상품 등록 및 경매 시작

ID 생성 후 seller를 사용하도록 선택하고 test 탭으로 이동하여 Submit Transaction을 클릭하여 AddProduct 및 StartBidding 트랜잭션을 수행한다.

owner에는 seller ID 생성시 입력한 participant 정보를 입력하면 된다.

참고한 가이드에는 JSON Data에 productId는 없는데 원하는 값을 입력하거나 팝업 하단의 Generate Random Data를 클릭하면 자동으로 값이 채워진다.

이 버튼을 이용할 경우 다음에 수행할 StartBidding 트랜잭션에 사용하기 위해 productId값을 복사해 두는 것이 좋다.

StartBidding 트랜잭션도 가이드에서는 listingId값에 대한 설명이 언급되지 않지만 임의의 값이 필요하다.

JSON Data의 product 에는 위에서 복사해 둔 productId값이 사용되며, resource:org.acme.product.auction.Product#<productId> 의 형태로 입력하면 된다.

reservePrice는 경매 예상가격이다.

seller는 이 두 트랜잭션을 통해 상품을 경매에 등록한 것이다. Test 탭의 ProductListing에서 상품 리스트를 볼 수 있다.

경매 입찰

이제 Member에 속하는 memberA와 memberB는 경매에 참여하기 위해 Offer 트랜잭션을 submit할 수 있다.

각각 ID 리스트에서 member ID 를 선택하고 Submit Transaction 버튼을 클릭하여 경매에 참여한다.

테스트를 위해 아래와 같이 경매 입찰가격을 다르게 하여 memberA 와 memberB가 Offer 트랜잭션을 submit했다.

1
2
3
4
5
6
7

// memberA
{
    "$class": "org.acme.product.auction.Offer",
    "bidPrice": 50, // 경매 입찰가
    "listing": "resource:org.acme.product.auction.ProductListing#<ListingId>", // ProductListing에서의 listingId
    "member": "resource:org.acme.product.auction.Member#memberA@acme.org"
}

1
2
3
4
5
6
7

// memberB
{
    "$class": "org.acme.product.auction.Offer",
    "bidPrice": 100, // 경매 입찰가
    "listing": "resource:org.acme.product.auction.ProductListing#<ListingId>", // ProductListing에서의 listingId
    "member": "resource:org.acme.product.auction.Member#memberB@acme.org"
}

ProductListing 에서 모든 입찰 내역을 확인 할 수 있다.

offers에는 경매에 참여한 모든 입찰자들의 입찰정보가 포함된다.

경매 종료

이제 다시 seller ID를 선택하여 CloseBidding 트랜잭션을 통해 경매를 종료시킨다.

트랜잭션 JSON Data 내용은 위의 StartBidding 트랜잭션 JSON Data 입력하는 방법을 참고하면 쉽게 작성할 수 있다.

경매 종료 후 ProductListing으로 이동하면 아래와 같이 상품의 판매상태가 FOR_SALE 에서 SOLD로 변경된 것을 확인할 수 있다.

Product에서 판매된 상품의 owner가 경매 최고입찰가를 제시한 memberB로 변경된 것을 확인할 수 있다.

Member를 보면 memberB의 잔액(balance)이 입찰가인 100 만큼 줄어들었고 products에 구매한 상품이 추가된 것을 볼 수 있다.

• 튜토리얼 가이드 : Developer tutorial for creating a Hyperledger Composer solution

Prerequisites

이 튜토리얼은 개발 환경 설치가 완료된 후 진행하였으며, 에디터는 VSCode를 사용했다.

Skeleton Business Network 생성

앞서 설치한 Yeoman generator를 이용해 스켈레톤 비즈니스 네트워크를 생성한다. Yeoman을 이용하면 비즈니스 네트워크에 필요한 컴포넌트들을 포함한 디렉토리를 생성해준다.

1

$ yo hyperledger-composer:businessnetwork

비즈니스 네트워크 정의

위에서 생성한 스켈레톤 비즈니스 네트워크는 다음의 파일들로 구성된다.

• 모델(.cto) - 자산(assets), 참가자(participants), 트랜잭션(transactions)에 대한 클래스 정의
• 스크립트(logic.js) - 트랜잭션 프로세서 function
• 엑세스컨트롤(permissions.acl) - 권한 제어 규칙
• JSON(package.json) - 비즈니스 네트워크 메타데이터

모델 파일 수정

assets, participants, transactions의 클래스 정의를 위해 모델 파일을 아래와 같이 수정한다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

/**

 * My commodity trading network
 */
namespace org.example.mynetwork
asset Commodity identified by tradingSymbol {
    o String tradingSymbol
    o String description
    o String mainExchange
    o Double quantity
    --> Trader owner
}
participant Trader identified by tradeId {
    o String tradeId
    o String firstName
    o String lastName
}
transaction Trade {
    --> Commodity commodity
    --> Trader newOwner
}

트랜잭션 로직 스크립트 수정

3-1에서 정의한 Trade 트랜잭션이 실행할 자바스크립트 로직을 로직 스크립트에 추가한다.

1
2
3
4
5
6
7
8
9
10
11
12

/**

 * Track the trade of a commodity from one trader to another
 * @param {org.example.mynetwork.Trade} trade - the trade to be processed
 * @transaction
    */
    async function tradeCommodity(trade) {
    trade.commodity.owner = trade.newOwner;
    let assetRegistry = await getAssetRegistry('org.example.mynetwork.Commodity');
    await assetRegistry.update(trade.commodity);
    }
    

access control 규칙 수정

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

/**

 * Access control rules for tutorial-network
 */
rule Default {
    description: "Allow all participants access to all resources"
    participant: "ANY"
    operation: ALL
    resource: "org.example.mynetwork.*"
    action: ALLOW
}

rule SystemACL {
  description:  "System ACL to permit all access"
  participant: "ANY"
  operation: ALL
  resource: "org.hyperledger.composer.system.**"
  action: ALLOW
}

아카이브 생성

정의된 비즈니스 네트워크를 배포하기 위해서는 비즈니스 네트워크 아카이브(.bna)파일로 패키지화 되어야 한다.

tutorial-network 디렉토리로 이동한 후 아래 명령어를 수행한다.

1

composer archive create -t dir -n .

커맨드가 실행되면 디렉토리 내에 `tutorial-network@0.0.1.bna` 와 같이 아카이브 파일이 생성된다.

비즈니스 네트워크 배포

생성된 .bna 파일은 composer network install명령을 통해 Hyperledger Fabric 인스턴스에 배포할 수 있다.

이 명령을 사용하려면 PeerAdmin 비즈니스 네트워크 카드가 필요하지만 개발 환경 설치 과정에서 이미 생성된 것이 있다.

1. 비즈니스 네트워크 설치를 위해 tutorial-network로 이동해서 아래 명령을 실행한다.

   1	composer network install --card PeerAdmin@hlfv1 --archiveFile tutorial-network@0.0.1.bna

   composer network install 명령을 사용하려면 PeerAdmin 비즈니스 네트워크 카드, 비즈니스 네트워크가 정의된 .bna파일의 경로가 필요하다.

2. 설치한 컴포저 네트워크는 composer network start 명령을 통해 실행할 수 있다.

   1	composer network start --networkName tutorial-network --networkVersion 0.0.1 --networkAdmin admin --networkAdminEnrollSecret adminpw --card PeerAdmin@hlfv1 --file networkadmin.card

3. 사용 가능한 비즈니스 네트워크 카드로 네트워크 관리자 ID를 가져오려면 composer network start 명령에서 지정한 파일명을 이용해 다음 명령을 실행하면 된다.

   1	composer card import --file networkadmin.card

4. 아래 명령을 입력하면 비즈니스 네트워크가 성공적으로 배포되었는지 확인할 수 있다.

   1	composer network ping --card admin@tutorial-network

REST 서버 생성

Hyperledger Composer는 배포된 비즈니스 네트워크 기반의 REST API 서버를 생성 할 수 있다.

tutorial-network 디렉토리로 이동 후 composer-rest-server 명령을 입력한 후 REST API 생성 방법을 설정한다.

composer-rest-server가 성공적으로 시작되었다면 http://localhost:3000/explorer 로 이동하면 아래와 같은 웹브라우저 화면을 볼 수 있다.

어플리케이션 생성

Hyperledger Composer는 REST API를 이용하는 Angular 어플리케이션 생성도 가능하다.

tutorial-network 디렉토리에서 yo hyperledger-composer:angular 명령어를 실행하면 된다.

어플리케이션 생성이 성공적으로 완료되면 아래와 같은 메시지를 볼 수 있다.

npm install 후 npm start를 실행하면 어플리케이션이 실행된다.

npm start 명령은 해당 어플리케이션의 package.json의 scripts에 있는 start 명령어를 실행한다.

웹브라우저를 통해 http://localhost:4200 로 이동하면 어플리케이션이 생성 된 것을 볼 수 있다.

docker와 docker-compose 의 버전 문제였는데.. Hyperledger Composer & Fabric 설치에 필요한 사전 요구사항에 표기된 버전을 참고하여 설치되어 있는 버전이 낮을 경우 업그레이드 해줘야 한다.

검색해 보니 docker-compose의 경우 설치된 docker 버전에 따라 설치 가능한 latest 버전에 제한이 있는 것 같다.

$ docker -v , $ docker-compose -v 명령을 통해 각각의 버전을 확인 후 최신 버전으로 업그레이드가 필요한 경우 다음의 커맨드를 이용하여 업그레이드가 가능하다.

• docker upgrade

1
2

$ sudo apt-get update
$ sudo apt-get upgrade

• docker-compose upgrade

1
2

$ sudo apt-get -y install python-pip
$ sudo pip install --upgrade pip setuptools docker-compose

업그레이드 이후 다시 ./startFabric.sh 스크립트를 실행 시키고 docker ps 를 통해 컨테이너 상태를 확인 할 수 있었다.

Yeoman 설치

1

$ npm install -g yo

1. global installation을 위한 NPM default directory 생성

우선 Permission 문제에 대한 문서 NPM docs - getting-started - fixing-npm-permissions 를 참고하여 npm의 Default Directory를 수정한다.

1. global installation을 위한 디렉토리 생성

1

$ mkdir ~/.npm-global

2. 디렉토리 경로를 npm config에 세팅

1
2

$ npm config set prefix '~/.npm-global'
$ npm config get prefix # config prefix 세팅이 잘 되었는지 확인

3. 환경변수 설정

1

$ vi ~/.profile # .profile 수정(사용하는 에디터에 따라 명령어가 다를 수 있다)

1

$ export PATH=~/.npm-global/bin:$PATH # 위에서 생성한 npm global install을 위한 dir경로

.profile 수정 후에는 변경사항을 적용시켜야 한다.

1

$ source ~/.profile

2. 디렉토리 권한 수정

1번의 과정을 거친 후에도 다시 npm install -g yo 실행 시 아래와 같은 오류 발생

오류 내용이 길어서 전체 내용 확인이 필요한 경우 에러 내용에 명시된 로그파일 /home/hyper/.npm/_logs/2018-08-17T02_14_30_188Z-debug.log을 통해 확인할 수 있다.

1. 에러 로그

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

npm WARN checkPermissions Missing write access to /home/hyper/.npm-global/lib/node_modules/yo
npm WARN checkPermissions Missing write access to /home/hyper/.npm-global/lib/node_modules/yo/node_modules
npm ERR! path /home/hyper/.npm-global/lib/node_modules/yo
npm ERR! code EACCES
npm ERR! errno -13
npm ERR! syscall access
npm ERR! Error: EACCES: permission denied, access '/home/hyper/.npm-global/lib/node_modules/yo'
npm ERR!  { Error: EACCES: permission denied, access '/home/hyper/.npm-global/lib/node_modules/yo'
npm ERR!   stack: 'Error: EACCES: permission denied, access \'/home/hyper/.npm-global/lib/node_modules/yo\'',
npm ERR!   errno: -13,
npm ERR!   code: 'EACCES',
npm ERR!   syscall: 'access',
npm ERR!   path: '/home/hyper/.npm-global/lib/node_modules/yo' }
npm ERR!
npm ERR! The operation was rejected by your operating system.
npm ERR! It is likely you do not have the permissions to access this file as the current user
npm ERR!
npm ERR! If you believe this might be a permissions issue, please double-check the
npm ERR! permissions of the file and its containing directories, or try running
npm ERR! the command again as root/Administrator (though this is not recommended).

npm ERR! A complete log of this run can be found in:
npm ERR!     /home/hyper/.npm/_logs/2018-08-17T02_14_30_188Z-debug.log

2. 에러 로그에 명시된 access 오류가 발생하는 디렉토리 권한 수정

1
2
3

$ sudo chown -R hyper /home/hyper/.npm-global
$ npm cache clean -f
npm WARN using --force I sure hope you know what you are doing.

3. Yeoman 설치

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

$ npm install -g yo
/home/hyper/.npm-global/bin/yo -> /home/hyper/.npm-global/lib/node_modules/yo/lib/cli.js
/home/hyper/.npm-global/bin/yo-complete -> /home/hyper/.npm-global/lib/node_modules/yo/lib/completion/index.js

> yo@2.0.5 postinstall /home/hyper/.npm-global/lib/node_modules/yo
> yodoctor

Yeoman Doctor
Running sanity checks on your system

✔ Global configuration file is valid
✔ NODE_PATH matches the npm root
✔ Node.js version
✔ No .bowerrc file in home directory
✔ No .yo-rc.json file in home directory
✔ npm version
✔ yo version

Everything looks all right!
+ yo@2.0.5
removed 1 package and updated 6 packages in 27.231s
hyper@DESKTOP-BOKQP6N:~$

Hyperledger Composer & Fabric 설치에 필요한 개발 툴

• OS : Ubuntu Linux 14.04 / 16.04 LTS (both 64-bit), or Mac OS 10.12
• Docker Engine : Version 17.03 or higher
• Docker-Compose : Version 1.8 or higher
• Node : 8.9 or higher (version 9 is not supported)
• npm : v5.x
• git : 2.9.x or higher
• Python : 2.7.x
• Editor : A code editor of user choice, recommend VSCode

1. 개발 환경 설치

Windows 10 pro 설정

제어판 > 프로그램 > 프로그램 및 기능 > Windows 기능 켜기/끄기 > Hyper-V 체크

• Hyper-V

• Windows GIT client & shell 설치

• Node.js 설치

prerequisites 다운로드

위에 명시된 hyperledger composer 설치를 위해 필요한 시스템 패키지를 다운로드한다.

1
2
3

curl -O https://hyperledger.github.io/composer/latest/prereqs-ubuntu.sh
chmod u+x prereqs-ubuntu.sh
./prereqs-ubuntu.sh

패키지별 버전 확인을 통해 잘 설치되었는지 체크한다.

1
2
3
4
5
6
7
8
9
10
11

nodejs -v # node version check

npm -v # npm version check

git --version # git version check

python --version # python version check

docker -v # docker version check

docker-compose -v # docker-compose version check

3. 컴포넌트 설치

composer-cli는 필수 CLI 툴이고, 나머지는 개발 환경 구성에 꼭 필요한 부분은 아니다.

하지만 공식 사이트에서는 튜토리얼을 진행하거나 어플리케이션 개발을 할 때 유용하므로 함께 설치할 것을 권장하고 있다.

CLI 툴 설치

1. 코어 CLI 툴

   1	npm install -g composer-cli@0.20

2. RESTful API Server를 띄워주는 기능

   1	npm install -g composer-rest-server@0.20

3. 어플리케이션 assets 생성에 유용

   1	npm install -g generator-hyperledger-composer@0.20

4. generator-hyperledger-composer 같은 기능을 이용한 어플리케이션 생성을 위한 툴 Yeoman

   1	npm install -g yo

Playground 설치

1. Playground - 간단한 수정, 테스팅을 브라우저 UI 환경에서 제공

   1	npm install -g composer-playground@0.20

Hyperledger Fabric 설치

1
2
3
4

mkdir ~/fabric-dev-servers && cd ~/fabric-dev-servers

curl -O https://raw.githubusercontent.com/hyperledger/composer-tools/master/packages/fabric-dev-servers/fabric-dev-servers.tar.gz
tar -xvf fabric-dev-servers.tar.gz

1
2
3

cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./downloadFabric.sh

Hyperledger Fabric 시작/종료

런타임을 처음 시작하는 경우 start 스크립트 실행 후 PeerAdmin card를 생성해야 한다.

1
2
3
4

cd ~/fabric-dev-servers
export FABRIC_VERSION=hlfv12
./startFabric.sh
./createPeerAdminCard.sh

이후 런타임을 시작하거나 정지시킬 때는 ~/fabric-dev-servers/stopFabric.sh, ~/fabric-dev-servers/startFabric.sh을 이용하면 된다.

개발 세션을 종료할 경우엔 ~/fabric-dev-servers/stopFabric.sh 실행 후에 ~/fabric-dev-servers/teardownFabric.sh를 사용하면 된다. 만약 teardown 스크립트를 실행한다면, 다음에 런타임을 시작할 때 처음 런타임 시작과 같이 새로운 PeerAdmin card를 생성해줘야한다.

Playground 실행

playground web app을 실행하는 방법

1

composer-playground

브라우저가 다음의 주소를 갖고 자동으로 열린다. http://localhost:8080/login

“My Business Networks” 화면에서 createPeerAdminCard 스크립트를 통해 생성한 PeerAdmin@hlfv1 카드가 보이지 않는다면 런타임이 정상적으로 시작되지 않은 것이다.

참고자료

• [Hyperledger] 개발 환경 구축하기(설치) | 잡동사니 수집광
• Installing pre-requisites | Hyperledger
• Installing development-tools | Hyperledger