Visual Studio 코드를 사용하여 래퍼 API 생성

향상된 버전의 Blockchain App Builder를 사용하면 Visual Studio Code에서 래퍼 API를 생성할 수 있습니다.

Visual Studio 코드에서 래퍼 API를 생성하는 경우 선택 위치에 있는 이전 래퍼 API 패키지를 겹쳐쓸지 여부를 묻는 메시지가 표시됩니다.

API Gateway는 단일 배치에서 생성할 수 있는 경로 수를 50개로 제한합니다. 50개가 넘는 래퍼 API를 생성하려고 하면 여러 게이트웨이를 생성할지 여부를 묻는 메시지가 표시됩니다. 동일한 배치 경로 접두어로 여러 게이트웨이를 생성하면 모든 래퍼 API 끝점에서 일관된 기본 경로가 유지됩니다. 여러 게이트웨이를 생성하지 않도록 선택하면 래퍼 API 생성이 취소됩니다. 다음 단계에 설명된 대로 기존 게이트웨이를 재사용할 수도 있습니다.

  1. 체인코드 창에서 체인코드 프로젝트를 선택합니다.
  2. 체인코드 이름을 마우스 오른쪽 버튼으로 누르고 래퍼 API 패키지 생성을 선택합니다. Oracle Blockchain Platform - 래퍼 API 패키지 생성 창이 열립니다.
  3. 다음 표에 설명된 대로 구성 변수를 입력합니다.
    필드 설명 기본값
    컴파트먼트 OCID OCI(Oracle Cloud Infrastructure)의 컴파트먼트의 OCID입니다. 없음
    컴파트먼트 이름 OCI 컴파트먼트의 이름입니다. 없음
    ID 도메인 사용할 ID 도메인입니다. 없음
    블록 체인 채널 체인코드가 배포되는 Oracle Blockchain Platform 채널의 이름입니다. 없음
    블록체인 URL 체인코드 배포와 연계된 Oracle Blockchain Platform URL입니다. 없음
    위치 래퍼 API 패키지를 생성할 시스템 디렉토리입니다. 없음
    새 API 게이트웨이 API 게이트웨이를 생성하려면 예를 선택한 다음 게이트웨이 표시 이름을 지정합니다. 기존 API 게이트웨이를 재사용하려면 아니오를 선택한 후 기존 API 게이트웨이에 대해 다음 형식으로 재사용할 Oracle Cloud 식별자(OCID) 배열을 지정합니다. 래퍼 API 50개당 하나의 게이트웨이를 지정해야 합니다. 
    ["ocid1.apigateway.xxx", "ocid1.apigateway.yyy"]
    		 예
    배치 경로 접두어 경로가 배치되는 경로를 지정하는 API Gateway의 배치 경로 접두어입니다. 배치 경로 접두어는 슬래시(/)로 시작해야 합니다. /<ChaincodeName>
    블록체인 동기화 API 호출에 대한 페이로드에 포함할 동기화 값입니다. true
    블록체인 시간 초과 API 호출에 대한 페이로드에 포함할 시간 초과 값입니다. 6,000
    정책 이름 조직의 그룹 및 구획에 대해 정의된 권한을 통해 API에 대한 제어 관리 및 액세스를 사용으로 설정하는 정책의 이름입니다. ChaincodeName
    VCN 표시 이름 OCI 가상 클라우드 네트워크의 표시 이름입니다. ChaincodeName
    애플리케이션 표시명 OCI 애플리케이션의 표시 이름입니다. ChaincodeName
    게이트웨이 표시 이름 API 게이트웨이의 표시 이름입니다. ChaincodeName
    배치 표시 이름 API 게이트웨이의 표시 이름입니다. ChaincodeName
    OCI 저장소 이름 OCI 레지스트리 저장소 이름으로, 모두 소문자여야 합니다. ChaincodeName(소문자)
  4. 저장을 누릅니다.
  5. 매핑 탭을 누릅니다. 매핑 창에는 체인 코드에서 사용할 수 있는 모든 컨트롤러 API의 테이블이 표시됩니다. 각 메소드에는 필요에 따라 편집할 수 있는 해당 API 끝점이 있습니다. 래퍼 API 패키지에 컨트롤러 API를 포함하려면 해당하는 래퍼 API 생성 체크박스를 선택합니다. 모든 컨트롤러 API를 포함하려면 모두 선택을 누릅니다.
  6. 저장을 누릅니다.
  7. 생성을 누릅니다. 래퍼 API 패키지 및 연관된 Postman 컬렉션이 생성됩니다.