Blockchain App Builder CLI 설치 및 구성

지원되는 플랫폼은 다음과 같습니다.

• macOS
• Oracle Linux 8.0 또는 9.0
• Microsoft Windows 10 또는 11

설치 프로세스를 완료한 후 다음을 수행합니다.

• 설치를 확인합니다.
• Go 체인코드 프로젝트를 사용하는 경우 추가 구성 단계를 완료합니다.

필수 조건

로컬 시스템에 Blockchain App Builder CLI를 설치하기 전에 필요 조건을 설치해야 합니다.

주:

Blockchain App Builder는 Oracle Blockchain Platform 및 해당 컴파일러와 조정됩니다. 다음 절에 언급된 것 이외의 필요 조건 버전을 사용하는 경우 체인코드를 원격 Oracle Blockchain Platform 네트워크에 배포하지 못할 수 있습니다.

블록체인 앱 빌더를 설치할 때 필요 조건 검사가 먼저 실행됩니다. 필요 조건 검사가 실패하면 설치 프로세스가 중지됩니다.

• macOS
• Linux
• Windows

필요 조건

• Rancher Desktop(1.19.3으로 테스트) Blockchain App Builder는 또한 Docker와 함께 작동 할 수 있지만 Rancher Desktop으로 테스트 및 검증되었습니다. Rancher Desktop을 사용하려는 경우 Rancher Desktop을 설치하기 전에 Docker를 완전히 제거하십시오. Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되어 있는지 확인합니다. Rancher Desktop 1.19.3에서 컨테이너 런타임을 확인하려면 Kubernetes 설정 > 컨테이너 런타임을 누릅니다.
• Node.js 버전 18의 최신 릴리스(18.15.0 및 18.16.0으로 테스트됨) Node.js 버전 18 이전 또는 이후 버전은 사용하지 마십시오.
• npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)
• v1.23.2 이상으로 이동하되 v1.24 이상으로 이동하지 마십시오. Blockchain App Builder를 설치한 후 Go Chaincode 프로젝트에 대한 추가 설정을 참조하십시오.
• Blockchain App Builder의 동기화 기능을 사용하려면 Git을 설치 한 다음 다음 명령에 표시된 것처럼 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자메일 주소를 지정합니다.

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

nvm을 사용하여 Node.js 및 npm 설치

nvm을 사용하여 Node.js 및 npm을 설치하면 sudo 없이 더 많은 명령을 실행할 수 있습니다.

1. 다음 명령을 입력하여 nvm을 설치합니다.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

2. 해당 파일에 ~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 코드 조각을 추가합니다.

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. 로그아웃했다가 운영 체제에 다시 로그인합니다.
4. 다음 명령을 입력하여 nvm 설치를 확인합니다.

   nvm version

5. 다음 명령을 입력하여 Node.js 및 npm을 설치합니다.

   nvm install 18.16.0

6. 다음 명령을 입력하여 Node.js 18.16.0을 nvm의 기본값으로 설정합니다.

   nvm alias default 18.16.0

필요 조건

• Docker v20.10.0 이상
• Docker Compose v1.23.0 이상
• Node.js 버전 18의 최신 릴리스(18.15.0 및 18.16.0으로 테스트됨) Node.js 버전 18 이전 또는 이후 버전은 사용하지 마십시오.
• npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)
• v1.23.2 이상으로 이동하되 v1.24 이상으로 이동하지 마십시오. Blockchain App Builder를 설치한 후 Go Chaincode 프로젝트에 대한 추가 설정을 참조하십시오.
• Blockchain App Builder의 동기화 기능을 사용하려면 Git을 설치 한 다음 다음 명령에 표시된 것처럼 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자메일 주소를 지정합니다.

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

nvm을 사용하여 Node.js 및 npm 설치

nvm을 사용하여 Node.js 및 npm을 설치하면 sudo 없이 더 많은 명령을 실행할 수 있습니다.

1. 다음 명령을 입력하여 nvm을 설치합니다.

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash

2. 해당 파일에 ~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 코드 조각을 추가합니다.

   export NVM_DIR="$HOME/.nvm"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

3. 로그아웃했다가 운영 체제에 다시 로그인합니다.
4. 다음 명령을 입력하여 nvm 설치를 확인합니다.

   nvm version

5. 다음 명령을 입력하여 Node.js 및 npm을 설치합니다.

   nvm install 18.16.0

6. 다음 명령을 입력하여 Node.js 18.16.0을 nvm의 기본값으로 설정합니다.

   nvm alias default 18.16.0

Docker 설치

dnf가 업데이트되고 커널을 기반으로 현재 저장소를 가리키는지 확인합니다.

1. 다음 명령을 입력하여 저장소 목록에 Docker를 추가합니다.

   sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo

2. 다음 명령을 입력하여 Docker를 설치합니다.

   dnf install docker-ce -y --allowerasing

3. 다음 명령을 입력하여 서비스로 Docker를 시작합니다.

   sudo systemctl enable --now docker

4. 현재 사용자에게 Docker에 대한 액세스 권한이 있는지 확인하려면 다음 명령을 입력합니다.

   sudo groupadd docker
   sudo usermod -aG docker $USER

5. 시스템을 재시작하려면 다음 명령을 입력합니다.

   sudo reboot

Docker Compose 설치

1. 다음 curl 명령을 입력하여 Docker Compose를 가져옵니다.

   sudo curl -L https://github.com/docker/compose/releases/download/v2.5.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compos

2. 다음 명령을 입력하여 Docker 작성에 실행 가능한 권한을 추가합니다.

   sudo chmod +x /usr/local/bin/docker-compose

필요 조건

• Rancher Desktop(1.19.3으로 테스트) Blockchain App Builder는 또한 Docker와 함께 작동 할 수 있지만 Rancher Desktop으로 테스트 및 검증되었습니다.
• Node.js 버전 18의 최신 릴리스(18.15.0 및 18.16.0으로 테스트됨) Node.js 버전 18 이전 또는 이후 버전은 사용하지 마십시오.
• npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)
• v1.23.2 이상으로 이동하되 v1.24 이상으로 이동하지 마십시오. Blockchain App Builder를 설치한 후 Go Chaincode 프로젝트에 대한 추가 설정을 참조하십시오.
• Blockchain App Builder의 동기화 기능을 사용하려면 Git을 설치하고 다음 명령에 표시된 것처럼 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자메일 주소를 지정합니다.

  git config --global user.name "<your_name>" 
  

  git config --global user.email "<email>"

Rancher Desktop 설치

Microsoft Windows에 Rancher Desktop을 설치하려면 다음 단계를 완료하십시오.

1. 로컬 컴퓨터에 Docker가 설치되어 있으면 완전히 제거합니다.
2. Rancher Desktop을 다운로드하고 설치합니다.
3. 설치 마법사가 완료되면 Rancher Desktop을 열기 전에 다음 명령을 실행합니다.

   wsl --install
   wsl --set-default-version 2
   wsl --setdefault rancher-desktop

4. Rancher Desktop을 열어 설치 프로세스를 완료합니다.
5. Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되어 있는지 확인합니다. Rancher Desktop 1.19.3에서 컨테이너 런타임을 확인하려면 Kubernetes 설정 > 컨테이너 런타임을 누릅니다.

블록체인 앱 빌더 설치

Oracle Blockchain Platform 콘솔의 블록체인 앱 빌더 창에 있는 개발자 도구 탭에서 Blockchain App Builder CLI 패키지(oracle-ochain-cli-x.x.x.tgz)를 다운로드합니다.

• macOS
• Linux
• Windows

1. 다음 명령을 입력하여 Xcode 또는 XCode 명령줄 도구(xcode-select)를 설치합니다.

   sudo xcode-select –install

2. 다음 명령을 입력하여 Blockchain App Builder를 설치합니다(설치 중인 버전에 대한 .tgz 파일 이름 조정).

   npm install -g oracle-ochain-cli-x.x.x.tgz

Mac OS Catalina는 xcode-select에 문제가있을 수 있습니다. 이러한 문제가 발생하면 다음 명령을 사용하여 xcode-select를 재설정하고 다시 시작합니다.

xcode-select –-reset

1. 다음 명령을 입력하여 Blockchain App Builder를 설치합니다(설치 중인 버전에 대한 .tgz 파일 이름 조정).

   npm install -g oracle-ochain-cli-x.x.x.tgz

2. 현재 유저로 로그아웃한 다음 그룹 멤버쉽이 적용되도록 다시 로그인합니다.

모든 필요 조건 소프트웨어를 설치한 후 다음 명령을 입력하여 Blockchain App Builder를 설치합니다(설치 중인 버전에 대한 .tgz 파일 이름 조정).

npm install -g oracle-ochain-cli-x.x.x.tgz

설치 검증

터미널에 ochain -v를 입력합니다. 출력에는 Blockchain App Builder CLI 사용, 옵션 및 명령이 표시됩니다.

Go Chaincode 프로젝트에 대한 추가 설정

Go 프로젝트를 개발하려면 GOPATH 환경 변수를 설정해야 합니다. 이렇게 하면 Go에서 작업 영역을 찾아 코드를 실행할 수 있습니다.

• macOS
• Linux
• Windows

GOPATH 환경 변수를 설정하기 전에 $HOME 디렉토리에 go/ 폴더가 있는지 확인하십시오. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 go/ 디렉토리를 생성합니다.

mkdir $HOME/go

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 변수를 해당 파일에 추가하여 GOPATH 환경 변수를 설정합니다.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

파일을 편집한 후 다음 명령을 실행하여 변경 사항을 즉시 적용합니다.

source ~/.bash_profile

또는 이전 변수를 /etc/bashrc 파일에 추가하여 시스템 전체에 변경 사항을 적용할 수 있습니다.

GOPATH 환경 변수를 설정하기 전에 $HOME 디렉토리에 go/ 폴더가 있는지 확인하십시오. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 go/ 디렉토리를 생성합니다.

mkdir $HOME/go

~/.bash_profile, ~/.profile, ~/.bashrc 또는 ~/.zshrc 변수를 해당 파일에 추가하여 GOPATH 환경 변수를 설정합니다.

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

파일을 편집한 후 다음 명령을 실행하여 변경 사항을 즉시 적용합니다.

source ~/.bash_profile

또는 이전 변수를 /etc/bashrc 파일에 추가하여 시스템 전체에 변경 사항을 적용할 수 있습니다.

홈 디렉토리에 go/ 디렉토리 C:\Users\<username>\go를 생성합니다.