라리월드

* 본 포스팅은 하이퍼레저 패브릭 docs를 번역한 내용으로, 번역 과정에서 잘못된 부분이 있을 수 있습니다.

상세 내용은 하단 링크를 참조 부탁드리며, 잘못된 내용에 대한 피드백은 언제든 환영합니다 : ) 

https://hyperledger.github.io/composer/latest/playground/id-cards-playground

비즈니스 네트워크카드는 블록체인 비즈니스 네트워크에 연결하는데 필요한 모든 정보들을 담고 있습니다. 블록체인 비즈니스 네트워크로의 접근은 유효한 비즈니스 네트워크 카드로만 가능합니다. 비즈니스 네트워크 카드는 배포된 비즈니스 네트워크 내 single 참가자용 identity를 포함하고 있습니다. 비즈니스 네트워크 카드는 하이퍼레저 컴포저 플레이그라운드에서 배포된 비즈니스 네트워크데 연결할 때 사용됩니다. 하나의 비즈니스 네트워크에 대해 여러 개의 비즈니스 네트워크 카드를 가질 수도 있으며, 여러 개의 비즈니스 네트워크 카드들은 여러 참가자들이 소유하고 있습니다.

비즈니스 네트워크 카드는 Connection Profile 하에 그룹화됩니다. 또 각 카드는 표시된 identity로 Connect now 옵션을 통해 접속할 수 있는 비즈니스 네트워크를 보여줍니다. 비즈니스 네트워크 카드는 카드에 나타난 아이콘을 사용해 삭제되거나 export될 수 있습니다.

아래 예시 그림은 'my-business-network'라는 비즈니스 네트워크에 'New User' Identity를 사용해 접속할 수 있는 비즈니스 네트워크 카드입니다.

비즈니스 네트워크 카드는 플레이그라운드 내에서 identity가 발행될 때 생성됩니다. 이 비즈니스 네트워크 카드는 다른 사람들에게 공유되거나 export될 수 있으며 이를 통해 다른 사람들이 발행된 identity를 사용해 비즈니스 네트워크에 접속할 수 있게 해줍니다. 만약 어떤 사용자가 관리자에 의해 비즈니스 네트워크 내 유효한 identity에 대응하는 등록된 ID와 Secet을 부여받았다면, 비즈니스 네트워크 카드는 플레이그레운드에 표시될 것입니다. 직접 비즈니스 네트워크를 생성하는 것 또한 가능합니다.

Creating a peer admin card using Playground

처음으로 하이퍼레저 패브릭 객체에 비즈니스 네트워크를 배포하기 위해서는 관련된 하이퍼레저 패브릭 피어에 하이퍼레저 컴포터 체인코드가 설치되어야 합니다. 그 다음 채널에서 비즈니스 네트워크를 객체화합니다. 이 과정에는 피어나 채널 관리자에 의한 하이퍼레저 패브릭의 특별한 권한이 필요합니다.

피어 관리자 비즈니스 네트워크 카드는 하이퍼레저 컴포저 비즈니스 네트워크를 하이퍼레저 패브릭 객체에 배포하기 위해 생성되어야 합니다. 피어 관리자 비즈니스 네트워크 카드를 만들기 위해서는:

1. My Business Networks 화면에서 Create a Business Network Card를 선택하세요.
2. Hyperledger Fabric v1.2를 선택한 다음 Next를 클릭하세요.
3. connection profile의 상세화면으로 들어갑니다. connection profile을 생성하는 것에 대한 더 자세한 내용은 아래 Deploying a Hyperledger Composer blockchain business network to Hyperledger Fabric for a single organization 내용을 참고하세요. Next를 클릭합니다.
4. Certificates를 선택한 후 피어 관리자 신원에 대한 certificate와 private key 정보를 업로드하세요. 마찬가지로 Deploying a Hyperledger Composer..... 아래 링크에서 올바른 certificate를 찾는 방법을 알려줍니다. 
5. 비즈니스 네트워크 카드의 이름을 입력하세요.
6. Admin Card를 선택한 다음 Peer Admin과 Channel Admin을 선택하세요.
7.  Next를 클릭하세요.

https://ralee-world.tistory.com/entry/Deploying-a-Hyperledger-Composer-blockchain-business-network-to-Hyperledger-Fabric-for-a-single-organization?category=719808

피어 관리자 카드는 이제 My Business Networks 화면에 나타납니다. 이제 플레이그라운드를 사용해비즈니스 네트워크를 하이퍼레저 패브릭 객체에 배포할 수 있습니다.

Providing Access To Your Business Network With a Business Network Card

비즈니스 네트워크에 대한 접근 권한은 비즈니스 네트워크 카드를 통해 다른 사용자에게 부여될 수 있습니다. 비즈니스 네트워크 카드가 한번 생성되면 카드를 생성한 사용자에게 export하거나 제공할 수 있습니다.

비즈니스 네트워크 카드를 생성하는데 필요한 Identity를 bind하기 위해서는 비즈니스 네트워크 내 participant가 존재해야 합니다.

플레이그라운드로 identity가 발행될 때, Business Networks 화면에서 사용할 수 있도록 identity를 저장하는 옵션이 있습니다. 이 옵션을 선택하면 현재 비즈니스 네트워크에 유효한 발행된 identity에 대한 비즈니스 네트워크 카드가 생성됩니다. 로그아웃할 경우 비즈니스 네트워크 카드는 Business Networks 화면에 나타나며, 이 위치에서 export하거나 다른 사용자와 공유할 수도 있습니다.

Creating a Business Network Card

1. Business Networks 화면에서 비즈니스 네트워크에 접속할 identity를 선택하세요. (주의: 새로운 identity 생성 권한을 가진 identity를 선택해야 합니다.)
2. 필요할 경우, identity를 할당할 새 participant를 생성하세요.
   • Test 탭을 선택하고 Create New Participant를 클릭하세요.
   • Participant 정의를 작성한 다음 Create New를 클릭하세요.
3. 우측 상단의 identity 이름을 선택하고 드롭다운 메뉴에서 ID Registry를 클릭하세요.
4. +Issue New ID를 클릭하세요.
5. ID Name을 선택하고 새 Identity와 연결할 기존 participant를 집어넣으세요. 알려진 참가자를 자동완성 하기위해 미리보기 서비스가 제공됩니다.
6. Create New를 클릭하세요.
7. Add to My Wallet을 클릭하세요. 비즈니스 네트워크 카드를 Business Networks 페이지에 추가함으로써 비즈니스 네트워크에 접속하거나 다른 사람이 사용할 수 있게 하기 위해 export할 수 있습니다.

Business Networks 화면은 이제 새 비즈니스 네트워크 카드를 보여줍니다.

Exporting a Business Network Card

비즈니스 네트워크 카드는 플레이그라운드의 Business Networks 페이지에서 export됩니다. 이는 export하고자하는 비즈니스 네트워크 카드와 한 단계의 상호작용으로 이루어집니다.

• Business Networks 페이지에서 export하고자 하는 비즈니스 네트워크 카드의 Export 아이콘을 클릭하세요. 비즈니스 네트워크 카드는 .card 파일로 다운로드될 것입니다.

주의: 예를 들어 새로운 참가자에게 보내기 위해 한번도 사용된 적이 없는 비즈니스 네트워크 카드를 export한다면, Participant의 신원을 확인하는데 사용되는 certificate와 private key를 획득하기 위해 등록 ID와 Secret을 포함해야 합니다. 반대로 이전에 사용된 적 있는 비즈니스 네트워크 카드를 export한다면, 이미 certificate와 private key를 포함하고 있습니다. Participant와 Identity에 관한 더 많은 정보를 확인하려면 아래 링크를 참고하세요.

https://hyperledger.github.io/composer/latest/managing/participantsandidentities.html

중요: export된 identity 카드는 주의해서 다뤄야 합니다. 왜냐하면 이는 보호되지 않은 credential을 포함하고 있기 때문입니다. encrypt된 identity 카드만 보내는 것을 추천합니다.

Gaining Access To A Business Network

Importing a Business Network Card

비즈니스 네트워크 카드를 import하면 배포된 비즈니스 네트워크에 접속할 수 있습니다.

1. Business Networks 화면에서 우측 상단의 Import Business Network Card를 클릭하세요.
2. import할 비즈니스 네트워크 카드(.card) 파일을 드래그앤드랍하거나 찾아보기를 통해 선택하고 import를 클릭하세요.

비즈니스 네트워크 카드가 Business Networks 화면에 표시됩니다. 이제 배포된 비즈니스 네트워크에 접속할 수 있습니다.

Connecting using Credentials

Business Networks 화면에서 비즈니스 네트워크 카드를 생성하는 두 가지 방법이 있습니다.

비즈니스 네트워크 카드는 다음 항목을 요구하는 인증을 사용해 생성될 수 있습니다.

• certificate & private key: 비즈니스 네트워크 관리자에 의해 제공
• name: 비즈니스 네트워크 카드 이름
• business network name: credentials이 유효한 비즈니스 네트워크 이름
• connection profile: 대상 비즈니스 네트워크가 배포되는 런타임에 대한 세부정보

Business Networks 화면에서 certificates를 사용해 비즈니스 네트워크를 생성하려면 다음 절차를 따릅니다.

1. certificate와 private key를 받은 다음, Business Networks 페이지 우측 상단 Connect using credentials 버튼을 클릭합니다. 
2. 배포된 런타임에서 이미 접속한 적이 있다면 화면에 나타난 리스트 중 그것을 클릭하고 Next를 선택한 후 4번으로 넘어갑니다. 접속한 적이 없다면 새 블록체인에 접속하는 radio옵션을 선택하고 Next를 선택합니다.
3. Connection Profile 세부사항을 명시하고 Save를 누릅니다.
4. certificate와 private key, 비즈니스 네트워크 카드 이름, 비즈니스 네트워크 이름을 입력한 후 Create를 클릭합니다.

비즈니스 네트워크 카드가 Business Networks 화면에 표시됩니다.

Manually Creating Business Network Card

비즈니스 네트워크 카드는 3가지 요소를 포함한 아카이브(.zip) 파일입니다.

• Connection Profile (.json)
• 비즈니스 네트워크에 접속하는데 사용되는 identity에 대한 정보를 포함하는 메타데이터 (metadata.json)
• (optional) certificate와 private key를 포함하는 credential 폴더

주의: credentials 폴더가 없다면, 메타데이터 파일은 enrollmentSecret이라는 필드에 Enrollment Secret 속성을 갖고 있어야 합니다. enrollmentSecret이 명시되면 certificate를 가진 credentials 폴더가 생성되며 비즈니스 네트워크 카드가 export될 때 사용됩니다.

메타데이터 파일은 아래 형식을 따라야 합니다.

{
    "name": "PeerAdmin",
    "description": "A valid Business Network Card",
    "businessNetwork": "basic-sample-network",
    "enrollmentId": "UserID",
    "enrollmentSecret": "UserSecret",
    "roles": [

    ]
}

businessNetworkName, image, enrollmentSecret, roles 속성은 optional입니다. 사용가능한 roles는 PeerAdmin 또는 ChannelAdmin입니다.

비즈니스 네트워크 카드 파일을 생성하려면 Connection Profile, 메타데이터 파일, 그리고 선택적으로 credentials 폴더를 압축하세요. 그리고나서 파일 유형을 .card로 변경합니다.

비즈니스 네트워크 카드는 이제 하이퍼레저 컴포저 플레이그라운드를 사용해 import되었습니다.

* 본 포스팅은 하이퍼레저 패브릭 docs를 번역한 내용으로, 번역 과정에서 잘못된 부분이 있을 수 있습니다.

상세 내용은 하단 링크를 참조 부탁드리며, 잘못된 내용에 대한 피드백은 언제든 환영합니다 : ) 

https://hyperledger.github.io/composer/latest/playground/playground-index

Using Playground

하이퍼레저 컴포저의 플레이그라운드는 비즈니스 네트워크 환경설정, 배포, 테스팅에 대한 사용자 인터페이스를 제공합니다. 이외 플라이그라운드의 고급기능은 사용자가 비즈니스 네트워크 보안을 관리하게 해주거나, 비즈니스 네트워크에 참가자들을 초대하거나 여러 블록체인 네트워크를 연결할 수 있도록 해주기도 합니다.

플레이그라운드를 처음 사용한다면, 아래 플레이그라운드 튜토리얼을 추천합니다. 해당 튜토리얼은 비즈니스 네트워크 카드로 상호작용하기 전 새로운 블록체인 비즈니스 네트워크를 생성하고 배포하고 테스트하는 방법을 알려줍니다.

https://ralee-world.tistory.com/entry/Hyperledger-Composer-Playground-Tutorial?category=719808

주의: 두 명 이상의 사용자가 하이퍼레저 컴포저 플레이그라운드를 사용해 동일한 하이퍼레저 패브릭 객체에 접속하려 한다면, 각 사용자는 비즈니스 네트워크 정의가 다른 유저에 의해 업데이트 된 후 브라우저를 새로고침해야만 합니다. 브라우저를 새로고침하면 다른 사용자에 의해 변경된 비즈니스 네트워크 정의가 반영됩니다. 다른 사용자가 변화한 내용을 업데이트하지 않고 비즈니스 네트워크를 변경하면, 해당 내용은 손실됩니다.

Navigating Playground

The Business Networks page

비즈니스 네트워크 페이지는 플레이그라운드를 시작하는 기본 화면입니다. 여기서 사용할 수 있는 모든 비즈니스 네트워크 카드를 볼 수 있습니다. 각 비즈니스 네트워크 카드는 블록체인 비즈니스 네트워크에 접속하는데 필요한 모든 정보를 갖고 있습니다. 유효한 비즈니스 네트워크 카드로만 블록체인 비즈니스 네트워크에 접속할 수 있습니다. 한번 배포된 비즈니스 네트워크에 접속하면 Define 페이지를 볼 수 있습니다.

이 페이지에서 할 수 있는 것들은 다음과 같습니다:

• 비즈니스 네트워크에 접속하기. 이미 배포된 비즈니스 네트워크와 그에 대한 비즈니스 네트워크 카드가 준비되었다면, 해당 비즈니스 네트워크에 접속하기 위해 Connect now를 클릭할 수 있습니다.
• 비즈니스 네트워크 배포하기. 플레이그라운드를 처음 사용하거나 새로운 네트워크를 시작하려 한다면 자신만의 네트워크를 시작할 수 있습니다. 새로운 비즈니스 네트워크를 시작할 때 샘플 네트워크를 기반으로 비즈니스 네트워크를 정의하거나 작업물에서 스스로 생성할 수도 있습니다.
• 비즈니스 네트워크 카드로 상호작용하기. 비즈니스 네트워크 카드는 이미 존재하는 비즈니스 네트워크에 접속하는데 사용됩니다. 또한 비즈니스 네트워크 카드는 connection profile과 identity의 조합입니다. 이 카드는 identity나 카드를 삭제하거나, 카드를 export하거나, 대응하는 비즈니스 네트워크에 연결하는 기능을 제공합니다.
• 비즈니스 네트워크 카드 import하기. 컴퓨터에 있는 .card 파일을 import하는 가장 간단한 방법은 비즈니스 네트워크 페이지에서 비즈니스 네트워크 카드를 추가하는 것입니다.
• user ID와 secret 사용해서 접속하기. 네트워크 관리자로부터 ID와 secret을 부여받았다면, Connect using credentials를 클릭해서 접속하고 비즈니스 네트워크 카드를 생성할 수 있습니다.
• 플레이그라운트 튜토리얼을 사용해 실행하기. 어디서부터 시작해야할지 모르겠다면 플레이그라운드 튜토리얼을 통해 비즈니스 네트워크를 새엇ㅇ하고 기본 동작들을 수행해볼 수 있습니다.

Business network options

비즈니스 네트워크 카드를 사용해 한번 비즈니스 네트워크에 접속하면, Define 탭이나 Test 탭에 사용할 수 있는 여러가지 옵션들이 있습니다.

• 좌측 상단은 사용중인 connection profile 이름이며 접속한 비즈니스 네트워크입니다. 위의 예제에서 connection profile은 Web이라 불리고 비즈니스 네트워크 이름은 basic-sample-network입니다.
• Define 및 Test 탭으로의 링크. Define 탭에서는 비즈니스 네트워크 내용을 추가, 수정, 삭제할 수 있고, Test 탭에서는 Define 탭에 정의되어 있는 asset이나 participant를 생성할 수 있으며, 비즈니스 네트워크의 기능들을 테스트 할 수 있습니다.
• 우측 상단의 드롭다운메뉴는 비즈니스 네트워크에 접속하는데 사용되는 identity를 나타냅니다. 드롭다운메뉴는 Identity Registry에 대한 링크를 포함합니다. 또 비즈니스 네트워크에서 로그아웃하고 비즈니스 네트워크 페이지로 돌아갈 수도 있습니다.

The Define tab

Define 탭은 비즈니스 네트워크를 생성, 편집, 수정하는데 사용됩니다.

Define탭의 왼쪽은 현재 비즈니스 네트워크 정의 파일 리스트를 나타냅니다. 파일 내용을 보려면 파일을 클릭하면 되고, 그러면 편집모드로 나타납니다. Add a file 버튼을 통해 비즈니스 네트워크에 새로운 파일을 추가할 수도 있습니다. 모델파일, 스크립트파일, 접근제어파일, 쿼리파일이 비즈니스 네트워크에 추가될 수 있습니다.

비즈니스 네트워크 정의에 파일을 추가하거나 수정하면 네트워크에 변경된 내용을 Deploy changes 버튼을 통해 변경된 내용을 배포할 수 있습니다. Deploy changes 버튼을 누른 후에는 Test 탭에서 변경된 내용을 시험해볼 수 있습니다. Export 버튼은 현재 비즈니스 네트워크를 .bna 파일로 다운로드할 수 있게 해줍니다.

주의: 두 명 이상의 사용자가 하이퍼레저 컴포저 플레이그라운드를 사용해 동일한 하이퍼레저 패브릭 객체에 접속하려 한다면, 각 사용자는 비즈니스 네트워크 정의가 다른 유저에 의해 업데이트 된 후 브라우저를 새로고침해야만 합니다. 브라우저를 새로고침하면 다른 사용자에 의해 변경된 비즈니스 네트워크 정의가 반영됩니다. 다른 사용자가 변화한 내용을 업데이트하지 않고 비즈니스 네트워크를 변경하면, 해당 내용은 손실됩니다.

The Test tab

Test 탭은 Define 탭에서 정의한 asset, participant, transaction를 사용해 배포된 비즈니스 네트워크를 테스트할 수 있습니다.

Test 탭의 왼족에는 각 participant와 asset 타입이 나열되어 있습니다. participant, asset 혹은 All Transactions를 클릭하면 해당 타입에 활성화되어있는 모든 객체를 보여주는 registry가 나옵니다. 예를 들어 SampleParticipant를 클릭하면 생성된 모든 SampleParticipants를 보여주는 registry가 나옵니다. 많일 Test탭을 처음 사용한다면 registry들은 비어있을 것입니다.

각 registry에서 대응하는 asset, participant를 생성하거나 transaction을 제출할 수 있습니다.

All transactions registry는 Historian이라고도 알려져 있습니다. 여기서는 비즈니스 네트워크에서 발생하는 각 트랜잭션 기록을 확인할 수 있으며, 이 기록은 participant나 asset 생성같은 시스템 이벤트도 포함합니다. transaction registry에서는 트랜잭션을 제출하고 어떤 리소스가 변경되었는지 확인함으로써 그 트랜잭션의 영향을 확인할 수 있습니다.

제주도 가볼만한 곳을 찾다가 발견한

여미지 식물원

식물원이라고 해서 재미없을 줄 알았는데

정말 기대이상입니다.

개장 시간 및 요금은 아래와 같습니다.

↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

※ 개장시간 : 09:00 ~ 18:00 (매표마감 17:30)

※ 연중무휴

※ 관람소요시간 : 1시간 20분

<안내사항> 

식물원 입장은 오후 5:30분까지 가능합니다.

온실식물원 관람은 오후 6시까지, 

옥외식물원 관람은 일몰시까지 가능합니다.

동절기(11월~2월)에는 일몰 시간을 감안하여

오후 5시까지 입장하셔야 식물원 전체를 관람하실 수 있습니다. 

입장권은 당일 유효하며 중복할인은 적용되지 않습니다.

※ 입장요금

어른(20세 이상~65세 이하)

- 개인 10,000원 / 단체 7,000원 -

청소년(14세 이상~19세 이하) & 군경(현역병 및 전경-병장이하)

- 개인 7,000원 / 단체 5,000원 -

어린이(36개월 이상~13세 이하)

- 개인 6,000원 / 단체 4,000원 -

경로(66세 이상)

- 개인 8,000원 / 단체 6,000원

* 단체는 20인 이상부터 적용됩니다.

*할인은 제주도민, 국가유공자, 참전용사, 복지카드소지자에 한해

어른 7,000원 / 청소년 5,000원 / 어린이 4,000원 / 경로 6,000원입니다.

식물원 입구에는 나무 모양의 조형물이 있습니다.

안쪽으로 쭉 들어가면 매표소가 나와요~

매표소에서 표를 구매하고 팜플렛을 챙겨 입장합니다!

여미지 식물원 안에는 옥외식물원을 한바퀴 도는

유람동차가 있습니다.

거의 1시간마다 운행하고,

탑승권은 온실입구 무인발권기에서 구매할 수 있어요.

가격은 14세 이상 1,000원

36개월 이상 500원

36개월 미만 무료

입니다.

온실식물원 바로 앞에 유람동차가 대기하고 있네요~

유람동차를 타면 중앙홀에서 온실정원을 중심으로

한바퀴 쭉 돌면서 안내음성을 들을 수 있습니다.

에어컨은 나오지 않아요 ㅋㅋㅋㅋㅋ

옥외식물원은 14곳의 전시장으로 구성되어 있습니다.

숙근초원, 일본정원, 멸종위기식물전시원, 한국정원,

왕벚나무숲길, 제주자생식물원, 이태리정원, 프랑스정원,

만병초원, 습지원, 호스타원, 허브정원, 잔다광장, 소철원

온실식물원에서 밖으로 나가는 통로가 연결되어 있어

유람동차를 타고 설명을 들으시다가

가보고 싶은 곳만 골라서 다녀와도 좋겠네요.

저는 한바퀴 모두 돌아봤습니다 ㅎㅎ

지나가다보면 물고기들이 있는데

다리를 건너갈 때마다 밥주는 줄 아는지

사람을 따라옵니다!!! ㅇ_ㅇ.... 똑똑한데요?

예쁘게 모양 낸 정원도 있구요.

저기 물이 흘러내리는 곳 안에서 바깥쪽을 바라보면

또 다른 느낌입니다.

온실식물원 내부로 들어가는 길입니다.

꽃의 정원, 물의 정원, 선인장 정원,

열대 정원, 열대 과수원이 있습니다.

꽃의 정원부터 순서대로 관람하시면 됩니다.

각 정원별로 컨셉에 맞게 다양한 식물들이 있습니다.

마지막으로 전망대!

온실식물원 가운데 엘리베이터를 타면

중앙 전망대로 올라가서 식물원 전경을 바라볼 수 있습니다.

느낀점은 우선 관리가 엄청 잘되고 있다는 점입니다.

식물원 구석구석을 다 돌아봤는데

거미줄 하나 못봤어요.

중간중간 식물원 관리하시는 분들이 계시구요.

정말 깔끔하게!!! 잘 관리되고 있다는 느낌이 들었습니다.

권장 관람시간은 1시간 20분이라고 적혀있었으나

저는 2~3시간 정도 머무른 것 같아요.

그만큼 볼거리도 많았고

맑은 날 가서 사진도 잘나오고 좋았습니다.

마지막으로 위치 첨부할게요 : )

GS편의점에 새로운 도시락이 나와서 먹어보았습니다.

대만식 고기덮밥 \3,900 

우리나라에서는 대만 진과스 광부도시락으로 유명한 음식이죠!

진과스는 옛날에 탄광촌으로 유명한 황금마을인데요.

여기서 광부들이 먹던 도시락이라고 해서

현재는 관광지 인기 음식으로 알려져 있습니다.

광부도시락을 모티브로 나온 편의점 도시락인 것 같네요.

포장을 뜯으면 수저와 함께

밥, 고기, 반찬 + 참기름이 들어있어요.

비닐을 벗겨 반찬통을 뺀 다음 전자레인지에 2분!!!

돌려 참기름을 뿌려 먹으라고 되어 있습니다.

저는 고기와 밥을 전자레인지에 돌린다음

반찬들도 다 부어주었습니다.

참기름을 두르니 맛있는 냄새가 솔솔 ㅎㅎ

단무지가 중간중간 아삭한 식감을 내주고

고기에 짭조롬한 맛과 김치의 살짝 매콤한 맛이 잘 어울리네요.

진짜 대만식 광부덮밥은 못먹어봤지만

편의점 도시락 중엔 맛있는 편입니다.

다만, 여러가지 반찬을 즐기시는 분들은

아쉬울 수도 있겠지만요.

한 그릇 음식 좋아하시는 분들은

입에 잘 맞으실 것 같아요!

크게 맵지도 짜지도 않고 딱 적당합니다.

* 본 포스팅은 하이퍼레저 캘리퍼 docs를 번역한 내용으로, 번역 과정에서 잘못된 부분이 있을 수 있습니다.

상세 내용은 하단 링크를 참조 부탁드리며, 잘못된 내용에 대한 피드백은 언제든 환영합니다 : ) 

https://hyperledger.github.io/caliper/docs/2_Architecture.html

Architecture

Adaptation Layer

Adaptation Layer는 기존 블록체인 시스템을 캘리퍼 프레임워크에 통합하는데 사용됩니다. 각 어댑터는 블록체인의 native SDK나 RESTful API를 사용해 'Caliper Blockchain NBIs'를 구현합니다. 하이퍼레저 패브릭 1.0과 소투스가 현재 지원되며 이더리움 및 다른 블록체인 시스템도 지원 예정입니다.

Interface & Core Layer

인터페이스 및 코어 레이어는 핵심 기능을 구현하고 상위 애플리케이션을 위한 인터페이스를 제공합니다. 네 종류의 NBI가 제공됩니다.

• Blockchain operating interfaces: 벡엔드 블록체인에 있는 스마트 컨트랙트를 배포하거나, 컨트랙트를 호출하거나, 원장의 상태를 쿼리하는 것 등의 동작을 포함합니다.
• Resource Monitor: 모니터를 시작 혹은 중지하고 CPU, 메모리, 네트워크 IO 등 벡엔드 블록체인 시스템의 리소스 사용 상태를 가져오는 작업을 포함합니다. 현재 두 종류의 모니터를 제공하며, 하나는 로컬 / 원격 도커 컨테이너의 상태를 확인하는 것이고, 또 다른 하나는 로컬 프로세스의 상태를 확인하는 것입니다. 추후에 더 많은 모니터들이 구현될 예정입니다.
• Performance Analyzer: 미리 정의된 성능 수치 (TPS, 지연, 성공률 등) 를 읽고 벤치마크 결과를 출력합니다. 주요 지표는 블록체인 NBIs를 호출하는 동안 기록됩니다. 예를 들어 생성 시간, 트랜잭션 커밋 시간, 트랜잭션 결과 등이 있습니다. 이러한 들은 결과를 생성하는 데 사용됩니다.
• Report Generator: 테스트 결과를 HTML 로 생성하는 기능을 포함합니다.

Application Layer

애플리케이션 레이어는 일반적인 블록체인 시나리오를 테스팅하는 것을 포함합니다. 각 테스트는 벡엔트 블록체인 네트워크와 테스트 인자를 정의하는 환경설정 파일을 갖고 있습니다. 이 테스트는 블록체인 시스템의 성능을 테스느하는데 사용할 수 있습니다.

기본 블록체인 엔진은 개발자들이 프레임워크를 이해하고 스스로 빠르게 테스트를 할 수 있도록 구현되어 있습니다. 벤치마크 엔진을 어떻게 사용하는지는 이후에 설명합니다. 물론, 개발자들은 프레임워크 없이 NBIs를 직접 사용해 테스트를 할 수도 있습니다.

Benchmark Engine

Configuration File

두 종류의 환경설정 파일이 사용됩니다. 하나는 벤치마크 설정 파일인데, 워크로드같은 벤치마크 인자를 정의합니다. 또 다른 하나는 블록체인 설정 파일로 SUT와 상호작용하는 것을 돕는데 필요한 정보를 정의합니다.

아래는 벤치마크 설정 파일 예입니다.

test:
  name: simple
  description: This is an example benchmark for caliper
  clients:
    type: local
    number: 5
  rounds:
  - label: open
    txNumber:
    - 5000
    - 5000
    - 5000
    rateControl:
    - type: fixed-rate
      opts: 
        tps: 100
    - type: fixed-rate
      opts:
        tps: 200
    - type: fixed-rate
      opts:
        tps: 300
    arguments:
      money: 10000
    callback: benchmark/simple/open.js
  - label: query
    txNumber:
    - 5000
    - 5000
    rateControl:
    - type: fixed-rate
      opts:
        tps: 300
    - type: fixed-rate
      opts:
        tps: 400
    callback" : benchmark/simple/query.js
monitor:
  type:
  - docker
  - process
  docker:
    name:
    - peer0.org1.example.com
    - http://192.168.1.100:2375/orderer.example.com
  process:
  - command: node
    arguments: local-client.js
    multiOutput: avg
  interval: 1

• test: 테스트 메타데이터와 지정된 워크로드에 대한 다수의 테스트 수행을 정의합니다.
  • name&description: 사람이 읽을 수 있는 형태의 벤치마크에 대한 이름 및 설명입니다. 이는 리포트 생성기가 테스트 리포트를 생성할 때 사용합니다.
  • clients: 클라이언트 타입 및 관련 인자를 정의합니다. 'type' 속성은 'local' 혹은 'zookeeper' 이어야 합니다.
    1. local: 이 경우, 로컬 프로세스가 fork되어 블록체인 클라이언트처럼 행동합니다. fork된 클라이언트 수는 'number' 속성에 정의되어야 합니다.
    2. zookeeper: 이 경우, 클라이언트는 다른 머신에 위치하며 마스터 주키퍼를 통해 태스크를 수행합니다. 주키퍼 서버 주소 및 주키퍼 클라이언트에 의해 로컬에서 실행되어 시뮬레이팅할 블록체인 클라이언트 수가 정의되어야 합니다. 주키퍼 환경설정의 예는 아래와 같습니다.
       "type" : "zookeeper",
       "zoo" : {
           "server" : "10.229.42.159:2181",
           "clientPerHost" : 5
       }
  • label: 테스트에 대한 힌트입니다. 예를 들어, 성능을 테스트하기 위해 주로 사용될 트랜잭션을 언급하기 위해 트랜잭션 이름을 라벨 이름으로 사용할 수 있습니다. 또한 이 값은 blockchain.getContext()의 컨텍스트 이름으로 사용됩니다. 예를 들어, 개발자가 다른 패브릭 채널에 대해 성능을 측정하고 싶을 때, 다른 패브릭 채널에 대해 각각 다른 라벨로 테스트를 수행할 수 있습니다.
  • txNumber: 각 테스트 차수에서 수행될 다른 트랜잭션 수를 배열로 정의합니다. 예를 들어, [5000, 400]은 총 5000개의 트랜잭션이 첫 번째 차수에서생성될 것이며 두 번째 테스트에서는 400개가 생성될 것임을 의미합니다.
  • txDuration: 각 테스트 차수에서 실행할 시간을 배열로 정의합니다. 예를 들어 [150, 400]은 두 번의 테스트가 진행될 것을 의미하며, 첫 번째는 150초동안, 두 번째는 400초 동안 수행될 것임을 의미합니다. txNumber와 함께 지정하면 txDuration 옵션이 우선 적용됩니다.
  • rateControl: 각 테스트 차수에서 벤치마크 테스트를 하는 동안 사용자가 정의한 rate control을 배열로 정의합니다. 정의하지 않을 경우 기본 값은 'fixed-rate'이며 이는 벤치마킹을 1 TPS rate로 설정합니다. 정의되었다면, rate control 메카니즘이 존재해야 하며, 어느 메시지가 보내지고, 혹은 메세지 속도 프로파일을 지정하는 데 사용할 수 있는 옵션이 제공 것입니다. 각 테스트 차수에서 txNumver나 txDuration이 정의되어 있다면 이에 대응하는 rate control item을 rateControl 배열에 갖고 있어야 합니다. 사용 가능한 속도 컨트롤러 및 사용자 정의 속도 컨트롤러에 대한 사항은 Rate Controller 섹션을 참고하세요.
  • trim: 테스트 리포트에 포함되는 warm-up 및 cool-down 단계를 제거하기 위해 클라이언트 결과에 트리밍 기능을 수행합니다. 이 기능을 지정했다면, 트림 옵션은 차수 별 측정을 고려합니다. 예를 들어 txNumber가 30으로 수행된다면 각 클라이언트로 부터 온 초기 30개의 트랜잭션과 제일 마지막 30개의 트랜잭션 결과는 결과 통계를 생성할 때 무시됩니다. txDuration이 사용된 경우, 초기 및 마지막 30초의 결과는 무시됩니다.
  • arguments: 사용자 정의 테스트 모듈로 전달되는 인자를 정의합니다.
  • callback: 이 테스트 차수에서 사용되는 사용자 정의 모듈을 정의합니다. 더 자세한 사항은 User Defined test module 섹션을 참고하세요.
• monitor: 리소스 모니터 유형과 모니터 객체, 모니터링 시간 간격을 정의합니다.
  • docker: 도커 모니터는 로컬 혹은 원격 호스트에 있는 도커 컨테이너를 모니터링하는데 사용됩니다. Docker Remote API는 원격 컨테이너의 상태를 수집하는데 사용됩니다. 예약된 컨테이너 이름이 'all'인 경우 호스트의 모든 컨테이너는 모니터링 됩니다. 위의 예제에서, 모니터가 초 당 두 개의 컨테이너 상태를 수집한다면, 하나는 로컬 컨테이너인 'peer0.org1.example.com'이고 다른 하나는 '192.168.1.100'에서 도커 리스닝 포트가 2375인 원격지 컨테이너 'orderer.example.com' 입니다.
  • process: 프로세스 모니터는 로컬 프로세스를 모니터할 때 사용됩니다. 예를 들어, 사용자는 블록체인 클라이언트를 시뮬레이팅할 때 리소스 사용량을 모니터하기 위해 이 모니터를 사용할 수 있습니다. 'command'와 'argument' 속성은 프로세스를 정의합니다. 'multiOutput' 속성은 여러 프로세스일 경우 정의합니다. 'avg'는 이 프로세스들의 리소스 사용량에 대한 평균값을 나타내며 'sum' 은 총 합계를 나타냅니다.
  • others: 구현중

Master

마스터는 3단계로 구성된 기본 테스트를 구현한다.

• Preparing stage: 이 단계에서, 마스터는 블록체인 환경설정 파일로 내부 블록체인 객체를 생성하고 초기화한다. 또 환경설정에 정의된 스마트 컨트랙트를 배포하고 벡엔드 블록체인 시스템의 리소스 사용량을 모니터링하기위한 모니터 객체를 시작한다.
• Testing stage: 이 단계에서, 마스터는 벤치마크 환경설정 파일에 따라 테스트를 수행하기 위해 루프를 시작한다. 작업은 정의된 워크로드에 따라 생성되고 클라이언트들에게 할당된다. 클라이언트들로부터 수집된 성능 통계는 이후 분석을 위해 저장된다.
• Reporting stage: 각 테스트 차수로부터 클라이언트들에게서 수집된 결과가 분석된다. 이는 자동으로 HTML 형태의 리포트를 생성한다. 리포트 샘플은 다음과 같다.

Clients

Local Clients

이 모드에서 마스터는 로컬에 실제 테스팅 작업을 수행하는 여러 개의 클라이언트(자식 프로세스)를 포크하기위해 Node.js 클러스터 모듈을 사용한다. Node.js는 기본적으로 단일쓰레드이므로, 로컬 클러스터는 멀티코어머신에서 클라이언트의 성능을 향상시키기 위해 사용될 수 있다.

전체 워크로드는 자식 프로세스들에게 동등하게 나뉘어서 할당된다. 자식 프로세스는 벡엔드 블록체인과 상호작용할 수 있는 임시로 생성된 컨텍스트를 사용해 블록체인 클라이언트처럼 행동한다. 컨텍스트는 보통 클라이언트의 신원 및 암호화 정보를 가지고 있으며 이는 테스팅 작업이 끝나면 반환된다.

• 하이퍼레저 패브릭에서 컨텍스트는 또한 특정 채널에 바인딩될 수 있다. 이 관계는 패브릭 환경설정 파일에 정의된다.

클라이언트는 사용자가 정의한 테스팅 로직을 갖고 있는 테스트 모듈을 호출한다. 모듈에 대해서는 이후에 설명한다.

로컬 클라이언트는 첫 번째 테스트 차수가 시작될 때 한 번만 시작될 수 있으며, 테스트가 모두 끝나면 삭제된다.

Zookeeper Clients

이 모드에서 여러 개의 주키퍼 클라이언트는 독립적으로 실행된다. 주키퍼 클라이언트는 실행된  테스팅 작업을 모니터링하기위해 스스로 등록한다. 테스트가 끝나면 성능 통계 결과를 갖고 있는 znode가 생성된다.

주키퍼 클라이언트는 또한 여러 개의 자식 프로세스 (로컬 클라이언트) 를 포크하여 위 테스팅 작업을 실질적으로 수행한다.

더 자세한 내용은 Zookeeper Client Design 섹션에서 확인할 수 있다.

User Defined Test Module

테스트 모듈은 트랜잭션을 생성하고 제출하는 함수가 구현된 것이다. 이렇게 함으로써 개발자들은 자신의 테스팅 로직을 구현할 수 있고, 이를 벤치마크 엔진에 통합할 수 있다.

세 가지 함수가 구현 및 export 되며, 모든 함수들은 약속된 객체를 반환한다.

• init: 각 테스트 차수가 시작할 때 클라이언트에 의해 호출되며, 주어진 블록체인 객체, 컨텍스트, 사용자 지정 인자를 벤치마크 환경설정 파일에서 읽어온다. 블록체인 객체 및 컨텍스트는 이후 사용을 위해 저장되어야 하며 다른 초기 작업은 여기서 실행된다.
• run: 실제로 트랜잭션이 생성 및 제출되며, 이 때 캘리퍼의 블록체인 API를 사용한다. 클라이언트는 워크로드에 따라 이 함수를 반복적으로 호출한다. 각 호출에서 하나의 트랜잭션만 제출되는 것을 추천하지만, 필수 사항은 아니다. 여러 개의 트랜잭션이 매번 제출되면 실제 워크로드는 구성된 워크로드와 다를 것이다. 함수는 비동기 방식으로 실행되어야 한다.
• end: 각 테스트 차수의 끝에 호출되며 모든 클리닝 작업은 여기서 수행된다.