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 네트워크에 체인 코드를 배포하지 못할 수 있습니다.

Blockchain App Builder를 설치하면 필수 조건 검사가 먼저 실행됩니다. 필요 조건 검사를 실패하면 설치 프로세스가 중지됩니다.

• macOS
• Linux
• Windows

필요 조건

• Rancher Desktop(1.4.1로 테스트됨) Blockchain App Builder는 또한 Docker와 함께 작동 할 수 있지만 Rancher Desktop을 사용하여 테스트 및 검증되었습니다. Rancher Desktop을 사용하려면 Rancher Desktop을 설치하기 전에 Docker를 완전히 제거하십시오. Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되었는지 확인합니다. Rancher Desktop 1.4.1에서 컨테이너 런타임을 확인하려면 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.20.10으로 이동합니다. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
• 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. 다음 명령을 입력하여 nvm에서 Node.js 18.16.0을 기본값으로 설정합니다.

   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.20.10으로 이동합니다. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
• 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. 다음 명령을 입력하여 nvm에서 Node.js 18.16.0을 기본값으로 설정합니다.

   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 작성 설치

1. 다음 curl 명령을 입력하여 Docker 작성 가져오기:

   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 Compose에 실행 가능한 권한을 추가합니다.

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

필요 조건

• Rancher Desktop(1.4.1로 테스트됨) 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.20.10으로 이동합니다. Blockchain App Builder를 설치한 후 Additional Setup for Go Chaincode Projects을 참조하십시오.
• 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.4.1에서 컨테이너 런타임을 확인하려면 Kubernetes 설정, 컨테이너 런타임을 차례로 누릅니다.

블록체인 앱 빌더 설치

Oracle Blockchain Platform 콘솔의 Blockchain App Builder 창에 있는 개발자 도구 탭에서 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 Projects에 대한 추가 설정

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

• macOS
• Linux
• Windows

GOPATH 환경 변수를 설정하기 전에 go/ 폴더가 $HOME 디렉토리에 있는지 확인합니다. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 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 환경 변수를 설정하기 전에 go/ 폴더가 $HOME 디렉토리에 있는지 확인합니다. 그렇지 않은 경우 다음 명령을 입력하여 홈 디렉토리에 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.