aspera connect sdk js

JavaScript용 공식 Aspera Connect SDK

웹 애플리케이션이 Aspera 파일 전송 기능을 활용할 수 있도록 합니다.

문서는 GitHub 페이지를 확인하세요.

설치

npm에서 설치:

$ npm install --save @ibm-aspera/connect-sdk-js

소스에서 설치:

$ git clone https://github.com/IBM/aspera-connect-sdk-js.git
$ cd aspera-connect-sdk-js
$ npm install

CDN에서 로드:

 < script src =" https://d3gcli72yxqn2z.cloudfront.net/@ibm-aspera/connect-sdk-js/latest/connect-sdk.js " > </ script >

최신 버전을 사용하는 대신 특정 버전을 사용하는 CDN을 통해 Connect SDK를 포함하는 경우 적극 권장됩니다. 최신 Connect SDK는 언제든지 주요 변경 사항으로 변경될 수 있으며, 이로 인해 웹 사이트에 잠재적으로 영향을 미칠 수 있습니다.

용법

Connect 데스크톱 애플리케이션을 실행하고 연결을 설정합니다.

 import { Connect } from '@ibm-aspera/connect-sdk-js' ;

const connectClient = new Connect ( ) ;
connectClient . initSession ( ) ;

다운로드 시작:

 try {
  const transferSpec = {
    authentication : 'token' ,
    paths : [
      {
        source : 'my_awesome_movie.drp'
      }
    ] ,
    remote_host : 'example.com' ,
    remote_user : 'foo' ,
    token : 'ATV7_HtfhDa-JwWfc6RkTwhkDUqjHeLQePiOHjIS254_LJ14_7VTA' ,
    direction : 'receive'
  } ;

  const response = await connectClient . startTransferPromise ( transferSpec ) ;
  console . log ( `Transfer started: ${ response } ` ) ;
} catch ( err ) {
  throw new Error ( `Could not start transfer: ${ err } ` ) ;
}

더 많은 코드 샘플을 보려면 제공된 예제를 확인하세요.

3.x/4.x에서 5.0.0으로 마이그레이션

코드를 v5.0.0 으로 업데이트할 때 필요한 변경 사항을 보려면 마이그레이션을 참조하세요.

개발

전제 조건

• Node.js v12+
  • macOS를 사용하는 경우 nvm과 같은 패키지 관리자를 통해 Node.js를 설치하는 것이 좋습니다.
• 힘내

짓다

$ git clone https://github.com/IBM/aspera-connect-sdk-js.git
$ cd aspera-connect-sdk-js
$ npm install
$ npm run build

Connect 데스크탑 설치 프로그램을 로컬로 호스팅

사용자가 Cloudfront에서 Connect를 다운로드하도록 하는 대신 설치 프로그램을 로컬에서 호스팅할 수 있습니다. 이는 서버가 오프라인 환경에서 실행 중이거나(즉, 사용자가 Cloudfront에 액세스할 수 없음) 사용자가 서버에서 Connect를 다운로드하기를 원하는 경우에 특히 유용합니다.

connect-deployer Docker 이미지를 다운로드하려면 다음 안내를 따르세요.

$ docker pull icr.io/ibmaspera/connect-deployer:latest

버전 태그는 Connect 4.2.2부터 사용할 수도 있습니다(예: docker pull icr.io/ibmaspera/connect-deployer:4.2.2 ).

기본 웹 서버에서 설치 프로그램을 호스팅하려면:

$ docker run -it --rm -d -p 8080:80 icr.io/ibmaspera/connect-deployer:latest

위 명령을 사용하면 http://127.0.0.1:8080/aspera/connect 통해 Connect 설치 프로그램을 사용할 수 있습니다. 이 URL에서 Connect 설치 프로그램을 제공하도록 Connect SDK를 구성하려면 sdkLocation 위의 URL로 업데이트해야 합니다.

보안 웹 서버를 통해 설치 프로그램을 호스팅하려면:

$ docker run -it --rm -d -p 8443:443  -v /path/to/your/ssl/certs:/etc/ssl/certs icr.io/ibmaspera/connect-deployer:latest

참고: 서버 인증서와 개인 키의 이름은 각각 cert.pem 및 key.pem 이어야 합니다.

기여

우리는 버그 수정, 새로운 기능 구축 또는 프로젝트 문서 개선에 도움을 줄 수 있는 기여자를 항상 찾고 있습니다. 관심이 있으시면 기여 가이드를 확인해 보세요.

문제 해결

브라우저의 Developer Console에서 AW4.Logger.setLevel(2) 실행하여 추적 로깅을 활성화합니다.

Connect 데스크탑 애플리케이션에 관한 도움을 받으려면 IBM 지원 센터를 방문하십시오.