개발 환경 설정하기

사전 필요 사항

절차

사전 필요 사항 설치

맥OS를 위해 저희는 개발 사전 필요 사항을 관리하는데 Homebrew 를 사용하기를 권합니다. Xcode 커맨드 라인 도구는 Homebrew 설치의 일부로 설치될 겁니다.

Homebrew가 준비되면 사전 필요 사항을 설치하는 것은 매우 쉽습니다:

brew install git go jq softhsm
brew cask install --appdir="/Applications" docker

도커 데스크탑은 설치 완료를 위해 반드시 실행되어야 하므로 설치 후에 실행하는 것을 잊지 마세요:

open /Applications/Docker.app

윈도우즈 상에서 개발하기

윈도우즈 10 상에서 여러분은 네이티브 도커 배포판을 사용하면서, 윈도우즈 파워쉘을 사용할 수 있습니다. 그러나, binaries 명령이 잘 실행되려면 uname 명령이 계속 잘 실행되어야 할 겁니다. 여러분은 Git의 일부로 이를 얻을 수 있습니다만, 64비트 버전만 지원함을 알아두세요.

git clone 명령을 실행하기 전에, 다음을 실행하세요:

git config --global core.autocrlf false
git config --global core.longpaths true

다음 명령으로 이 파라미터들이 잘 설정되었는지 확인할 수 있습니다:

git config --get core.autocrlf
git config --get core.longpaths

이들은 각각 false 그리고 true 여야 합니다.

Git과 도커 도구상자로부터 받는 curl 명령은 오래되어서 시작하기 내에서 사용된 리다이렉션을 제대로 처리하지 않습니다. 여러분이 cURL 다운로드 페이지 에서 받을 수 있는 더 최신 버전을 사용하는지 꼭 확인하세요.

하이퍼레저 패브릭 소스코드 복제

먼저 https://github.com/hyperledger/fabric 에 들어가서 오른쪽 위 코너에 있는 fork 버튼을 사용해서 fabric 저장소를 포크하세요. 포크 후에는 이 저장소를 복제하세요.

mkdir -p github.com/<여러분의_github_userid>
cd github.com/<여러분의_github_userid>
git clone https://github.com/<여러분의_github_userid>/fabric

주석

윈도우즈를 사용 중이라면, 저장소를 복제하기 전에 다음 명령을 실행하세요:

git config --get core.autocrlf

core.autocrlf 이 true 로 설정되어 있으면, 다음을 실행해서 반드시 false 로 설정하세요:

git config --global core.autocrlf false

SoftHSM 설정

PKCS #11 암호화 토큰 구현이 유닛 테스트를 돌리는데 필요합니다. PKCS #11 API는 패브릭의 bccsp 컴포넌트가 암호화 정보를 저장하고, 암호화 계산을 수행하는 하드웨어 보안 모듈 (HSM: Hardware security modules) 과 통신하는데 사용됩니다. 테스트 환경에서는 SoftHSM이 이 요구사항을 만족시킬 수 있습니다.

SoftHSM은 사용 전에 일반적으로 추가 설정이 필요합니다. 예를 들면, 기본 설정은 권한이 없는 사용자가 저장할 수 없는 시스템 디렉토리 내에 토큰 데이터를 저장하려고 시도할 겁니다.

SoftHSM 설정은 보통 /etc/softhsm2.conf 를 $HOME/.config/softhsm2/softhsm2.conf 로 복사하고 directories.tokendir 를 적당한 위치로 바꾸는 것을 포함합니다. 자세한 사항은 softhsm2.conf 의 man 페이지를 보세요.

SoftHSM이 설정되고 난 후에, 다음 명령이 유닛 테스트에 필요한 토큰을 초기화하는데 사용될 수 있습니다.

softhsm2-util --init-token --slot 0 --label "ForFabric" --so-pin 1234 --pin 98765432

테스트가 여러분의 환경에서 libsofthsm2.so를 찾지 못한다면, 라이브러리 경로, PIN, 그리고 여러분의 토큰 레이블을 적절한 환경 변수 내에 지정하세요. 맥OS를 예로 들면:

export PKCS11_LIB="/usr/local/Cellar/softhsm/2.6.1/lib/softhsm/libsofthsm2.so"
export PKCS11_PIN=98765432
export PKCS11_LABEL="ForFabric"

개발 도구 설치

저장소를 복제하고 나면, 여러분은 개발 환경에서 사용되는 몇가지 도구를 설치하기 위해 make 를 사용할 수 있습니다. 기본적으로 이 도구들은 $HOME/go/bin 내에 설치될 겁니다. 여러분의 PATH 가 이 디렉토리를 포함하고 있는지 확인하세요.

make gotools

도구들을 설치하고 나서, 몇가지 명령을 실행해서 빌드 환경을 검증할 수 있습니다.

make basic-checks integration-test-prereqs
ginkgo -r ./integration/nwo

이 명령들이 완전히 성공하면 출발할 준비가 된 겁니다!

하이퍼레저 패브릭 애플리케이션 SDK를 사용하려고 한다면, Node.js SDK README 와 Java SDK README 내의 사전 필요 사항도 확인하는 것을 잊지 마세요.