[DID] trustbloc/sandbox v0.1.6 실행방법

■ 사전 준비

sandbox 프로젝트를 실행하기 위해서는 다음이 필요합니다.

- Go 1.15

- Docker

- Docker Compose

- Make

- jq

 

● 설치 확인

설치를 확인합니다.

# go 버전 확인 (version: go1.15)
go version

# Docker 설치 확인 (version: 19.03.8)
docker version

# Docker Compose 설치 확인 (version: 1.11.2)
docker-compose -v

# Make 설치 확인
make --help

# jq 설치 확인
jq --help

go 버전이 맞지 않는 경우에는 버전을 맞춰주어야 합니다.

 

 

■ 기본 환경 설정

trustbloc의 Docker 이미지를 사용하기 위해서는 github 토큰 값을 가지고 Docker에 로그인해야 합니다. 

github 토큰 발급에 대한 상세한 내용은 [generate-github-token.md](generate-github-token.md) 파일을 참고하세요.

# 소스 코드 복제
cd /opt/gopath/src/github.com/honeybee
git clone https://github.com/trustbloc/sandbox

# v0.1.6 버전 세팅
git checkout v0.1.6 

# Docker 로그인
docker login -u <github 계정명> -p <github 토큰(read:packages 및 repo 권한이 포함되어야함)> docker.pkg.github.com

# /etc/profile에 다음 내용 추가 후 시스템 재시작
sudo vi /etc/profile
export GITHUB_TOKEN="<github 토큰>"
source /etc/profile

# /etc/profile 적용 확인
cat /etc/profile
echo $GITHUB_TOKEN

 

● 인증서 설정

최초 한 번만 발급받으면 됩니다. (지우고 다시 발급받아도 인증서 내용이 동일)   

디렉터리가 변경되거나, 처음 실행 시 세팅해주어야 합니다.

# 인증서 발급
cd /opt/gopath/src/github.com/honeybee/sandbox
make trustbloc-local-setup

# 발급받은 인증서를 로컬 인증서 경로에 복사
cd ~/.trustbloc-local/sandbox/certs
sudo cp trustbloc-dev-ca.crt /usr/local/share/ca-certificates

# SSL 인증서 추가
cd /usr/local/share/ca-certificates
sudo update-ca-certificates

 

● hosts 파일 설정

도메인 설정을 위해 /etc/hosts 파일에 ~/.trustbloc-local/sandbox/hosts의 내용을 추가해주어야 합니다. 이 부분을 추가하지 않으면 connection이 원활하게 이루어지지 않습니다.   

이 과정은 한 번만 진행하면 됩니다.

# /etc/hosts 파일에 다음 내용 추가
sudo vi /etc/hosts

# trustbloc/sandbox v0.1.6 기준
127.0.0.1 rp.trustbloc.local
127.0.0.1 issuer.trustbloc.local
127.0.0.1 ucis-rp.trustbloc.local
127.0.0.1 cbp-rp.trustbloc.local
127.0.0.1 benefits-dept-rp.trustbloc.local
127.0.0.1 cms.trustbloc.local
127.0.0.1 myagent.trustbloc.local
127.0.0.1 myagent-support.trustbloc.local
127.0.0.1 router.trustbloc.local
127.0.0.1 hydra.trustbloc.local
127.0.0.1 consent-login.trustbloc.local
127.0.0.1 peer0-org1.trustbloc.local
127.0.0.1 peer1-org1.trustbloc.local
127.0.0.1 peer0-org2.trustbloc.local
127.0.0.1 peer1-org2.trustbloc.local
127.0.0.1 peer0-org3.trustbloc.local
127.0.0.1 peer1-org3.trustbloc.local
127.0.0.1 stakeholder-one.trustbloc.local
127.0.0.1 sidetree-mock.trustbloc.local
127.0.0.1 uni-resolver-web.trustbloc.local
127.0.0.1 did-resolver.trustbloc.local
127.0.0.1 org1.trustbloc.local
127.0.0.1 org2.trustbloc.local
127.0.0.1 org3.trustbloc.local
127.0.0.1 testnet.trustbloc.local
127.0.0.1 issuer-adapter.trustbloc.local
127.0.0.1 rp-adapter.trustbloc.local
127.0.0.1 rp-adapter-hydra.trustbloc.local
127.0.0.1 edv.trustbloc.local
127.0.0.1 edv-oathkeeper-proxy.trustbloc.local
127.0.0.1 shared.couchdb
127.0.0.1 auth-rest.trustbloc.local
127.0.0.1 auth-rest-hydra.trustbloc.local
127.0.0.1 oathkeeper-auth-keyserver.trustbloc.local
127.0.0.1 oathkeeper-ops-keyserver.trustbloc.local
127.0.0.1 uni-registrar-web.trustbloc.local
127.0.0.1 issuer-vcs.trustbloc.local
127.0.0.1 rp-vcs.trustbloc.local
127.0.0.1 holder-vcs.trustbloc.local
127.0.0.1 governance-vcs.trustbloc.local
127.0.0.1 did-method.trustbloc.local
127.0.0.1 ucis-comparator.trustbloc.local
127.0.0.1 cbp-comparator.trustbloc.local
127.0.0.1 benefits-dept-comparator.trustbloc.local
127.0.0.1 vault.trustbloc.local
127.0.0.1 csh.trustbloc.local
127.0.0.1 vault-kms.trustbloc.local

# /etc/hosts 파일 수정 확인
cat /etc/hosts

# /etc/hosts 파일 적용
/etc/init.d/networking restart
# 위의 명령어를 실행할 수 없는 경우, 서버 재시작 필요

 

● 크롬에 인증서 추가

크롬에서 실행하기 위해서는 인증서 추가가 필요함

 

1. chrome://settings/certificates 페이지 접속 후 '인증 기관' 탭에서 가져오기 버튼 클릭

2. /opt/gopath/src/github.com/honeybee/edge-sandbox/test/bdd/fixtures/keys/tls/trustbloc-dev-ca.crt 파일 선택

3. 신뢰 설정 부분의 모든 체크박스 체크 후 '확인' 버튼 클릭

4. 크롬에 인증서 설정 완료

 

 

■ 실행 및 종료

● sandbox 실행

# sandbox 실행
cd /opt/gopath/src/github.com/honeybee/sandbox
make demo-start-with-sidetree-fabric

 

● sandbox 종료

# 종료
cd /opt/gopath/src/github.com/honeybee/sandbox
make demo-stop
docker container ls -a
docker container rm -f $(docker container ls -aq)
docker volume rm $(docker volume ls -q)
docker rmi $(docker images -f "dangling=true" -q)

make clean