Luniverse User Guide

루니버스 사용을 환영합니다!
이 페이지에서는 루니버스 서비스 사용 가이드를 제공합니다.
루니버스를 사용하여 다양한 디앱(DApp)을 제작해보세요.

Welcome to Luniverse!
This page provides a guide to using the Luniverse service.
Try to create various DApps by utilizing Luniverse.

Guides

루니버스 콘솔에서 체인코드 배포하기

루니버스에서는 GUI를 통해 단 몇번의 클릭만으로 하이퍼레저 네트워크에 체인코드(Chain Code)를 배포할 수 있습니다.

  1. 루니버스 콘솔에서 체인코드를 배포하고자 하는 경우 네트워크 탭을 선택한 뒤 배포하려는 채널의 [Detail] 버튼을 클릭하여 채널의 상세 정보 페이지로 이동합니다. (Free Trial의 경우 Hyperledger Free Trial 탭을 선택한 후 mychannel을 클릭합니다.)

하이퍼레저 패브릭 Standard

하이퍼레저 패브릭 Free Trial

  1. [Chaincode] 메뉴를 클릭하여 체인코드 리스트(Chaincode List) 페이지로 이동합니다.
    체인코드 리스트(Chaincode List) 페이지에서는 현재 배포 중이거나 이미 배포 된 체인코드의 리스트를 확인 하실 수 있습니다.
  1. [Add New Chaincode] 버튼을 클릭합니다 (Free Trial 의 경우에는 [Create Chain Code] 버튼을 클릭). 그러면 아래 화면과 같이 체인코드를 등록하는 화면이 나옵니다. 이 페이지에서 배포하고자 하는 체인코드의 정보를 입력합니다.
  • 체인코드 이름
    • 2-50자 이내의 영문/숫자와 특수문자 중 언더바(_)와 대쉬(-)를 입력할 수 있습니다.
    • 특수문자의 경우 첫 번째 자리와 마지막 자리에는 입력 할 수 없습니다.
      Ex) _1contract (X) 1contract- (X) 1-contract (O)
  • 체인코드 설명(Description)
    • 체인코드에 대한 간략한 설명을 입력합니다.
  • 체인코드 버전(Version)
    • 영문/숫자와 언더바(_), 마침표(.), 대쉬(-)를 입력할 수 있습니다. 단, 특수문자의 경우 첫번째 자리에는 입력할 수 없습니다.
  • (Free Trial일 경우) 체인코드 초기값
    • 체인코드의 init 함수에 들어갈 인자(Argument)정보를 JSON Array 형식으로 입력합니다.
  • 체인코드 소스 파일
    • 체인코드 소스가 포함된 디렉토리 전체를 .zip으로 압축하여 업로드합니다.
    • MAC 사용자는 터미널을 통해서 zip 명령어로 압축해주세요. 그렇지 않으면 체인코드 배포를 실패할 수 있습니다.
    • 루니버스에서는 하이퍼레저 패브릭 공식 지원 언어인 Go, Java, Node.js 총 세 가지 언어를 모두 지원합니다.
    • 언어는 별도로 설정할 필요 없이 자동으로 설정되어 배포됩니다.
  1. [Create] 버튼을 클릭하여 체인코드를 생성하면 체인코드가 등록되며 체인코드 리스트 화면에서 방금 등록한 체인코드를 확인할 수 있습니다.
    [주의 사항]
    Free Trial 체인의 경우, 이 단계에서 체인코드를 피어(Peer)에 설치(Install) 및 인스턴스화(Instantiate)까지 자동으로 진행하므로 약 1분 내외의 시간이 소요되며, 배포 과정에 따라 체인코드 상태(Status)가 [Deploying]에서 [Deployed]로 변경됩니다. 체인코드 배포 도중 에러가 발생하여 실패하는 경우, 상태가 [Failed]로 나오고 실패 원인에 대한 메시지가 표시됩니다. 단, 'init parameter error'의 경우에는 실제로 체인코드 인스턴스화는 성공을 했으나 초기화에만 실패한 경우로 [Deployed] 상태로 되면서 에러 메시지가 표시됩니다. 이 경우 DApp 개발 시 최초 한 번 초기화 트랜잭션을 전송해 주어야 합니다.

이후 단계는 Free Trial 체인이 아닌 경우에만 해당됩니다.

  1. 위 단계에서 체인코드는 아직 채널에 배포되지 않습니다. 체인코드를 채널에 배포하기 위해서 체인코드 리스트 화면에서 체인코드를 선택하여 클릭합니다. 그러면 아래 그림과 같이 체인코드의 배포 현황을 볼 수 있는 화면이 나옵니다. 체인코드가 어느 피어(Peer) 노드에 설치(Install)되었는지 현황을 볼 수 있으며, 또한 채널에 체인코드가 인스턴스화(Instantiate)되었는지 확인할 수 있습니다.
  1. [Install] 버튼을 클릭하면 체인 코드가 피어(Peer) 노드에 설치되기 시작합니다. 설치는 약 1분 이내의 시간이 소요되며 설치 과정에 따라 상태(Status)가 [Installing]에서 [Installed]로 변경됩니다. 정상적으로 설치가 되면 이제 Channel에 체인코드를 인스턴스화 시킬 차례입니다. 체인코드를 활성화하고 싶은 채널을 선택하여 [Instantiate] 버튼을 클릭합니다.
  1. [Instantiate] 버튼을 클릭하면 다음과 같이 체인코드의 초기값을 입력하는 화면이 나옵니다. 체인코드의 init 함수에 들어갈 인자(Argument)정보를 JSON Array 형식으로 입력합니다.
  1. 인자(Argument)를 입력하고 [Instantiate] 버튼을 클릭하면 채널에 체인코드 인스턴스화(Instantiation)를 시작합니다. 인스턴스화는 약 1분 이내의 시간이 소요되며 과정에 따라 상태(Status)가 [Instantiating]에서 [Instantiated]로 변경됩니다.

체인코드의 설치와 인스턴스화가 모두 끝난 상태

  1. 자 이제 체인코드 배포가 모두 끝났습니다. 이제 하이퍼레저 패브릭 SDK를 사용하여 DApp에서 체인코드를 호출할 수 있습니다.

Updated about a month ago

루니버스 콘솔에서 체인코드 배포하기


루니버스에서는 GUI를 통해 단 몇번의 클릭만으로 하이퍼레저 네트워크에 체인코드(Chain Code)를 배포할 수 있습니다.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.