Visual Studio Code용 Blockchain App Builder Extension 설치 및 구성

필수 조건

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

주:

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

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

필요 조건

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으로 테스트됨), npm v8.x 또는 9.x(9.5.0 및 9.5.1로 테스트됨)
다음 명령을 실행하여 Node.js 버전을 확인합니다. node --version

다음 명령을 실행하여 npm 버전을 확인합니다. npm --version

nvm 또는 nodenv과 같은 관리자를 사용하여 Node.js 및 npm을 설치하는 경우 기본/전역 버전을 설정한 다음 사전 요구 사항 페이지에서 버전이 감지되도록 Visual Studio 코드를 다시 시작합니다.

Node.js 버전 18 이전 또는 이후 버전은 사용하지 마십시오.
v1.23.2 이상으로 이동하되 v1.24 이상으로 이동하지 마십시오. Blockchain App Builder를 설치한 후 Go Chaincode 프로젝트에 대한 추가 설정을 참조하십시오.
다음 명령을 실행하여 Go 버전을 확인합니다. go version
Blockchain App Builder의 동기화 기능을 사용하려면 Git을 설치하고 다음 명령에 표시된 것처럼 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자메일 주소를 지정합니다.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 버전 1.66.0 이상
다음 명령을 실행하여 Visual Studio 코드 버전을 확인합니다. code --version

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

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

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

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

해당 파일에 ~/.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

로그아웃했다가 운영 체제에 다시 로그인합니다.
다음 명령을 입력하여 nvm 설치를 확인합니다.
```
nvm version
```
다음 명령을 입력하여 Node.js 및 npm을 설치합니다.
```
nvm install 18.16.0
```
다음 명령을 입력하여 Node.js 18.16.0을 nvm의 기본값으로 설정합니다.
```
nvm alias default 18.16.0
```
이 명령의 출력은 다음 텍스트입니다.
```
default -> 18.16.0 (-> v18.16.0)
```

필요 조건

Docker v18.09.0 이상
Docker Compose v1.23.0 이상
Node.js 버전 18의 최신 릴리스(18.15.0 및 18.16.0으로 테스트됨), npm v8.x 또는 v9.x(9.5.0 및 9.5.1로 테스트됨)
다음 명령을 실행하여 Node.js 버전을 확인합니다. node --version

다음 명령을 실행하여 npm 버전을 확인합니다. npm --version

nvm 또는 nodenv과 같은 관리자를 사용하여 Node.js 및 npm을 설치하는 경우 기본/전역 버전을 설정한 다음 사전 요구 사항 페이지에서 버전이 감지되도록 Visual Studio 코드를 다시 시작합니다.

Node.js 버전 18 이전 또는 이후 버전은 사용하지 마십시오.
v1.23.2 이상으로 이동하되 v1.24 이상으로 이동하지 마십시오. Blockchain App Builder를 설치한 후 Go Chaincode 프로젝트에 대한 추가 설정을 참조하십시오.
다음 명령을 실행하여 Go 버전을 확인합니다. go version
Blockchain App Builder의 동기화 기능을 사용하려면 Git을 설치하고 다음 명령에 표시된 것처럼 사용자 이름과 이메일을 구성하십시오. <your_name> 및 <email> 위치에 사용자 이름과 전자메일 주소를 지정합니다.
```
git config --global user.name "<your_name>" 
```
```
git config --global user.email "<email>"
```
Visual Studio Code 버전 1.66.0 이상
다음 명령을 실행하여 Visual Studio 코드 버전을 확인합니다. code --version

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

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

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

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

해당 파일에 ~/.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

로그아웃했다가 운영 체제에 다시 로그인합니다.
다음 명령을 입력하여 nvm 설치를 확인합니다.
```
nvm version
```
다음 명령을 입력하여 Node.js 및 npm을 설치합니다.
```
nvm install 18.16.0
```
다음 명령을 입력하여 Node.js 18.16.0을 nvm의 기본값으로 설정합니다.
```
nvm alias default 18.16.0
```
이 명령의 출력은 다음 텍스트입니다.
```
default -> 18.16.0 (-> v18.16.0)
```

필요 조건

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을 설치하려면 다음 단계를 완료하십시오.

로컬 컴퓨터에 Docker가 설치되어 있으면 완전히 제거합니다.
Rancher Desktop을 다운로드하고 설치합니다.
설치 마법사가 완료되면 Rancher Desktop을 열기 전에 다음 명령을 실행합니다.
```
wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
```
Rancher Desktop을 열어 설치 프로세스를 완료합니다.
Rancher Desktop을 설치한 후 컨테이너 런타임이 dockerd (moby)로 설정되어 있는지 확인합니다. Rancher Desktop 1.19.3에서 컨테이너 런타임을 확인하려면 Kubernetes 설정 > 컨테이너 런타임을 누릅니다.

Blockchain App Builder 확장 설치

Oracle Blockchain Platform 콘솔의 블록체인 앱 빌더 창에 있는 개발자 도구 탭에서 확장을 다운로드합니다. 블록체인 앱 빌더 창의 다운로드 섹션에서 Visual Studio 코드 확장을 선택합니다.
Visual Studio 코드에서 확장 패널을 열고 추가 작업 메뉴에서 VSIX에서 설치를 선택합니다.
다운로드한 oracle-ochain-extension-x.x.x.vsix 파일을 찾은 다음 설치를 누릅니다. 설치 중인 버전의 .vsix 파일 이름을 조정합니다.
Visual Studio 코드를 다시 시작하여 확장 설치를 완료합니다.
사양 파일을 입력할 때 자동으로 검증하는 사양 파일 검증 기능을 사용하려면 Red Hat에서 YAML 확장자를 설치합니다. 확장 패널을 열고, YAML을 검색하고, YAML 언어 지원 확장을 설치한 다음, Visual Studio 코드를 다시 시작합니다.

설치 후 Visual Studio 코드 왼쪽에 있는 Oracle Blockchain App Builder 아이콘을 사용하여 블록체인 앱 빌더 패널을 열 수 있습니다.

아직 별도로 설치하지 않은 경우 Blockchain App Builder 명령줄 인터페이스(CLI)가 Visual Studio 코드 확장의 일부로 자동으로 설치됩니다. CLI 명령은 Visual Studio Code 콘솔 창을 포함하여 모든 터미널 응용 프로그램에서 실행할 수 있습니다. Blockchain App Builder는 전역적으로 설치되므로 파일 시스템의 모든 위치에서 CLI 명령을 실행할 수 있습니다.

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

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

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를 생성합니다.