Composer Installing

* 본 포스팅은 하이퍼레저 패브릭 docs를 번역한 내용으로, 번역 과정에서 잘못된 부분이 있을 수 있습니다.

상세 내용은 하단 링크를 참조 부탁드리며, 잘못된 내용에 대한 피드백은 언제든 환영합니다 : ) 

https://hyperledger.github.io/composer/latest/installing/installing-index

Installing | Hyperledger Composer

[Installing pre-requisites] - Ubuntu

Hyperledger Composer 및 Hyperledger Fabric을 실행하려면 최소 4GB의 메모리가 필요합니다.

 

다음은 필수 개발도구를 설치하기 위한 조건입니다:

• Operating Systems: 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 (note version 9 and higher is not supported)
• npm: v5.x
• git: 2.9.x or higher
• Python: 2.7.x
• A code editor of your choice, we recommend VSCode.

** Linux를 사용하여 Hyperledger Composer를 설치하는 경우, 다음 조언을 따르십시오:

• Login as a normal user, rather than root.
• Do not su to root.
• When installing prerequisites, use curl, then unzip using sudo.
• Run prereqs-ubuntu.sh as a normal user. It may prompt for root password as some of it's actions are required to be run as root.
• Do not use npm with sudo or su to root to use it.
• Avoid installing node globally as root.

Ubuntu를 사용할 경우, 다음 command를 통해 다운로드 받을 수 있습니다.

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

다음으로 스크립트를 실행하십시오. 실행 중에 sudo를 잠시 사용하기 때문에 암호를 입력하라는 메시지가 나타납니다.

./prereqs-ubuntu.sh

---

[Installing the development environment]

다음 지침에 따라 Hyperledger Composer 개발 도구 (주로 비즈니스 네트워크를 만드는데 사용됨)를 설치하고 Hyperledger Fabric (주로 비즈니스 네트워크를 로컬로 실행/배포하는데 사용됨)을 설치하십시오. 제작한 비즈니스 네트워크는 다른 환경에서 Hyperledger Fabric 런타임에도, 예를 들어 클라우드 플랫폼 같은 곳에도 배포할 수 있습니다.

 

Before you begin

pre-requisites 설치 지침에 따라 필수 사전 요구사항을 설치했는지 확인하십시오.

 

이 가이드에서는 이전에 도구를 설치한 적이 없다고 가정합니다. 그렇지 않은 경우, 이 가이드를 따라하기 전에 이전 설정이 완전히 지워졌는지 확인할 수 있습니다. 이를 수행하는 방법을 배우려면 부록으로 이동합니다.

 

Composer는 유연성을 제공하고 개발자, 테스트 및 배포 시나리오의 수를 최대화하기 위해 npm으로 설치할 수 있는 구성요소 세트가 제공되며 CLI에서 제어할 수 있습니다. 이 가이드는 모든 것을 먼저 설치한 다음 개발환경을 제어하는 방법을 알려줍니다.

---

Installing components

Step1 : Install the CLI tools

Composer 개발자를 위한 몇 가지 유용한 CLI 도구가 있습니다. 가장 중요한 것은 모든 필수 작업을 포함하고 있는 composer-cli입니다. 이것을 먼저 설치한 다음 우리는 generator-hyperledger-composer, composer-rest-server, Yeoman을 설치합니다. 마지막 3가지는 개발환경의 핵심파트는 아니지만 비즈니스 네트워크와 상호작용하는 애플리케이션을 개발할 때나 튜토리얼을 따라할 때 유용할 것입니다.

 

다음 npm 명령에는 su 또는 sudo를 사용하지 마십시오.

1. 필수 CLI 도구:

npm install -g composer-cli@0.20

2. RESTful API로 비즈니스 네트워크를 노출하기 위해 컴퓨터에서 REST 서버를 실행하는 유틸리티:

npm install -g composer-rest-server@0.20

3. application 자산을 생성하는데 유용한 유틸리티:

npm install -g generator-hyperledger-composer@0.20

4. Yeoman은 generator-hyperledger-composer를 사용하는 애플리케이션 생성 도구입니다.

npm install -g yo

---

Step2 : Install Playground

이미 Composer를 온라인으로 사용해본 적 있다면, "Playground"라는 브라우저 앱을 본 적 있을 것입니다. 개발 컴퓨터에서 로컬로도 실행할 수 있으며, 비즈니스 네트워크를 보여주는 UI가 제공됩니다.

 

1. 간단한 비즈니스 네트워크 편집 및 테스트를 위한 브라우저 애플리케이션 :

npm install -g composer-playground@0.20

---

Step 3 : Set up your IDE

브라우저 앱을 사용하여 비즈니스 네트워크 코드에서 작업할 수 있지만 대부분 사용자는 IDE로 작업하는 것을 선호합니다. Composer extension이 가능한 VSCode가 가장 좋습니다.

 

1. 다음 URL에서 VSCode를 설치하십시오. 

https://code.visualstudio.com/download

Download Visual Studio Code - Mac, Linux, Windows

2. VSCode를 열고 Extensions로 이동한 다음 마켓플레이스에서 Hyperledger Composer extension을 검색하여 설치하십시오.

---

Step 4 : Install Hyperledger Fabric

이 단계는 비즈니스 네트워크를 배포할 로컬 Hyperledger Fabric 런타임을 제공합니다.

 

1. 원하는 디렉토리 (~/fabric-dev-servers로 가정) 에서 Hyperledger Fabric을 설치할 수 있는 도구가 들어있는 .tar.gz 파일을 획득하세요.

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

원하는 경우 zip도 사용할 수 있습니다. .tar.gz파일을 fabric-dev-servers.zip으로 바꾸고 tar -xvf 명령을 unzip 명령으로 바꿉니다.

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

2. 다운로드하여 추출한 스크립트를 사용해 Hyperledger Fabric v1.2 런타임을 다운로드하십시오:

 

축하합니다. 이제 일반적인 개발환경에 필요한 모든 것을 설치했습니다. 이 환경에서 블록체인 비즈니스 네트워크를 개발하고 테스트하기 위해 할 수 있는 가장 일반적인 것들에 대해 알아보세요.

---

[Controlling your dev environment]

Starting and stopping Hyperledger Fabric

기본 설정을 따르면 ~/fabric-dev-servers에서 찾을 수 있는 스크립트들을 사용해 런타임을 제어합니다.

 

처음으로 새 런타임을 시작할 때는 시작 스크립트를 실행한 다음 PeerAdmin 카드를 생성해야 합니다:

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 카드를 만들어야 합니다.

 

로컬 런타임은 개발 용도로 자주 시작, 중지 및 해제하기 위한 것입니다. 좀 더 영구적인 상태의 런타임을 원한다면 dev 환경 외부에서 하나를 실행하고 비즈니스 네트워크를 배포할 수 있습니다. 예를 들어 Kubernets를 통해 실행하거나 IBM Cloud 같은 관리 플랫폼에서 실행할 수 있습니다.

---

[Start the web app ("Playground")]

웹앱을 시작하기 위해 다음 명령어를 실행하세요:

composer-playground

보통 다음 주소에서 브라우저를 자동으로 엽니다.

http://localhost:8080/login

웹 애플리케이션의 "My Business Network" 화면에서 createPeerAdminCard 스크립트로 만든 PeerAdmin@hlfv1 카드를 볼 수 있습니다. 이 카드가 보이지 않으면 런타임이 제대로 시작된 것이 아닙니다.

 

축하합니다. 모든 구성요소가 실행중입니다. 또한 dev 세션을 끝내면 중지하고 해제하는 방법을 알 수 있습니다.