[Hyperledger Fabric v1.0] 7. CONTRIBUTING(기여): Setting up the development environment(개발 환경 설정)

해당 글은 Hyperledger Fabric 페이지의 게시글을 번역 및 정리한 자료입니다.

원본 사이트 : http://hyperledger-fabric.readthedocs.io/en/release/dev-setup/devenv.html

 Setting up the development environment(개발 환경 설정)

Overview(개요)

v1.0.0 릴리스 이전에는 개발 환경에서 Ubuntu 이미지를 실행하여 MacOS, Windows, Linux 및 Windows와 같은 다양한 플랫폼에서 작업하는 개발자를위한 일관된 환경을 보장하는 수단으로 Docker 컨테이너를 시작했습니다. 또는 무엇이든. Docker의 고급 기능 덕분에 가장 인기있는 개발 플랫폼 인 macOS 및 Windows에 대한 기본 지원이 활성화되었습니다. 따라서 우리는 이러한 발전을 최대한 활용하기 위해 빌드를 수정했습니다. Docker가 지원하지 않는 이전 버전의 macOS 및 Windows에서 사용할 수있는 Vagrant 기반 접근 방식을 계속 유지하면서도 비 애매한 개발 설정을 사용하는 것이 좋습니다.

Vagrant 기반 개발 설정은 클라우드 컨텍스트에서 사용할 수 없지만 Docker 기반 빌드는 AWS, Azure, Google 및 IBM과 같은 클라우드 플랫폼을 지원합니다. 아래의 Ubuntu 빌드 지침을 따르십시오.

Prerequisites(선결요건)

• Git client
• Go - 1.7 or later(for releases before v1.0, 1.6 or later)
• For macOS, Xcode 반드시 설치해야한다.
• Docker - 1.12 or later
• Docker Compose - 1.8.1 or later
• Pip
• (mac OS)macOS에는 bsdtar가 기본으로 제공되기 때문에 gnutar를 설치해야 할 수도 있지만 빌드에서는 gnutar 플래그를 사용합니다. Homebrew를 사용하여 다음과 같이 설치할 수 있습니다.
• (only if using Vagrant) - Vagrant - 1.7.04 later
• (only if using Vagrant) - VirtualBox - 5.0 or later
• BIOS Enabled Virtualization Varies based on hardware
• 참고 : BIOS Enabled Virtualization은 BIOS의 CPU 또는 보안 설정 내에 있을 수 있습니다.

  brew install gnu-tar --with-default-names
  




pip, behave and docker-compose

pip install --upgrade pip
pip install behave nose docker-compose
pip install -I flask==0.10.1 python-dateutil==2.2 pytz==2014.3 pyyaml==3.10 couchdb==1.0 flask-cors==2.0.1 requests==2.4.3 pyOpenSSL==16.2.0 pysha3==1.0b1 grpcio==1.0.4

#PIP packages required for some behave tests
pip install urllib3 ndg-httpsclient pyasn1 ecdsa python-slugify grpcio-tools jinja2 b3j0f.aop six

Steps(순서)

Set your GOPATH(GOPATH 설정)

호스트의 GOPATH 환경 변수를 올바르게 설정했는지 확인하십시오. 이를 통해 호스트와 VM을 모두 구축 할 수 있습니다.

Go 배포본이 가정하는 표준 위치와 다른 위치에 Go를 설치 한 경우 GOROOT 환경 변수도 설정해야합니다.

Note to Windows users(Windows 사용자 참고 사항)

git clone 명령을 실행하기 전에 Windows를 실행하는 경우 다음 명령을 실행하십시오.

git config --get core.autocrlf

core.autocrlf가 true로 설정된 경우 실행하여 false로 설정해야합니다.

git config --global core.autocrlf false

If you continue with core.autocrlf set to true, the vagrant up command will fail with the error:

./setup.sh: /bin/bash^M: bad interpreter: No such file or directory

Cloning the Fabric project(Fabric 프로젝트 복제)

Fabric 프로젝트는 Go 프로젝트이므로 Fabric Repo를 $ GOPATH / src 디렉토리에 복제해야합니다. $ GOPATH에 경로 구성 요소가 여러 개인 경우 첫 번째 경로 구성 요소를 사용하는 것이 좋습니다. 약간의 설정이 필요합니다.

cd $GOPATH/src
mkdir -p github.com/hyperledger
cd github.com/hyperledger

Recall that we are using Gerrit for source control, which has its own internal git repositories. Hence, we will need to clone from Gerrit. For brevity, the command is as follows:

자체적 인 git 저장소가있는 소스 컨트롤에 Gerrit을 사용하고 있음을 상기하십시오. 그러므로 우리는 Gerrit로부터 복제해야 할 것입니다. 간결함을 위해 명령은 다음과 같습니다.

git clone ssh://LFID@gerrit.hyperledger.org:29418/fabric && scp -p -P 29418 LFID@gerrit.hyperledger.org:hooks/commit-msg fabric/.git/hooks/

참고 : 물론 LFID를 자신의 Linux Foundation ID로 바꾸는 것이 좋습니다.

Bootstrapping the VM using Vagrant(Vagrant를 사용하여 VM 부트 스트랩하기)

Vagrant 개발자 환경을 사용할 계획이면 다음 단계가 적용됩니다. 다시 말하지만 Mac이나 Windows 용 Docker에서 지원하지 않는 이전 버전의 macOS 및 Windows에 제한된 개발자를 제외하고는 사용하지 않는 것이 좋습니다.

cd $GOPATH/src/github.com/hyperledger/fabric/devenv
vagrant up

가서 커피를 마시고 ... 몇 분이 걸릴 것입니다. 완료되면 방금 생성 한 Vagrant VM에 ssh 할 수 있어야합니다.

vagrant ssh

VM 내부에서 $GOPATH/src/github.com/hyperledger/fabric 아래에서 피어 프로젝트를 찾을 수 있습니다. 또한 / hyperledger로 마운트됩니다.

Building the fabric(패브릭 만들기)

일단 모든 종속성을 설치하고 저장소를 복제하면, fabric을 빌드하고 테스트 할 수 있습니다.

Notes(참고)

※ 로컬 패브릭 디렉토리 ($ $GOPATH/src/github.com/hyperledger/fabric)에있는 파일을 변경할 때마다 업데이트가 VM 패브릭 디렉토리에서 즉시 사용할 수 있습니다.

※ HTTP 프록시 뒤에서 개발 환경을 실행하려면 프로비저닝 프로세스가 완료 될 수 있도록 게스트를 구성해야합니다. vagrant-proxyconf 플러그인을 통해이를 수행 할 수 있습니다. vagrant plugin install vagrant-proxyconf 를 설치 한 다음 vagrant up를 실행하기 전에 VAGRANT_HTTP_PROXY 및 VAGRANT_HTTPS_PROXY 환경 변수를 설정하십시오. 자세한 내용은 https://github.com/tmatilai/vagrant-proxyconf/에서 확인할 수 있습니다.

※ 이 명령을 처음 실행하면 완료하는 데 꽤 오랜 시간이 걸릴 수 있으며 (환경에 따라 30 분 이상 소요될 수 있음) 시간이 지남에 따라 아무 것도하지 않는 것처럼 보일 수 있습니다. 오랫동안 오류 메시지를 남기지 않는 한 모든 것이 좋다. 단지 크랭크 작업 일 뿐이다.

Windows 10 사용자 참고 사항 : Windows 10의 유조기에는 알려진 문제점이 있습니다 (seemitchellh / vagrant # 6754). vagrant up 명령이 실패하면 Microsoft Visual C ++ 재배포 가능 패키지가 설치되어 있지 않을 수 있습니다. 누락 된 패키지는 다음 주소에서 다운로드 할 수 있습니다. http://www.microsoft.com/en-us/download/details.aspx?id=8328