aspera connect sdk js Télécharger - aspera connect sdk js Téléchargement du code source

aspera connect sdk js

Autre code source

v5.0.3

Télécharger

SDK Aspera Connect officiel pour JavaScript

Permet aux applications Web d'utiliser les fonctionnalités de transfert de fichiers d'Aspera.

Consultez les pages GitHub pour la documentation.

Installation

Installer depuis npm :

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

Installer à partir des sources :

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

Charger depuis le CDN :

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

Il est fortement recommandé si vous intégrez le SDK Connect via CDN d'utiliser une version spécifique au lieu d'utiliser la dernière. Le dernier SDK Connect est susceptible d'être modifié à tout moment avec des modifications importantes, ce qui pourrait potentiellement affecter votre site Web.

Usage

Lancez et établissez une connexion à l'application de bureau Connect :

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

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

Démarrer un téléchargement :

 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 } ` ) ;
}

Consultez les exemples fournis pour plus d’exemples de code.

Migration de 3.x/4.x vers 5.0.0

Reportez-vous à MIGRATION pour voir les modifications requises lors de la mise à jour de votre code vers v5.0.0 .

Développement

Conditions préalables

Node.js v12+
- Si vous êtes sous macOS, nous vous recommandons d'installer Node.js via un gestionnaire de packages tel que nvm.
Git

Construire

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

Hébergement local des installateurs de bureau Connect

Plutôt que de demander aux utilisateurs de télécharger Connect depuis Cloudfront, il est possible d'héberger les installateurs localement. Ceci est particulièrement utile si votre serveur fonctionne dans un environnement hors ligne (c'est-à-dire que les utilisateurs n'auront pas accès à Cloudfront) ou si vous préférez simplement que les utilisateurs téléchargent Connect depuis votre serveur.

Pour télécharger l’image Docker connect-deployer :

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

Les balises de version sont également disponibles à partir de Connect 4.2.2 (ex : docker pull icr.io/ibmaspera/connect-deployer:4.2.2 ).

Pour héberger les installateurs sur un serveur Web de base :

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

Avec la commande ci-dessus, les programmes d'installation de Connect seront disponibles sur http://127.0.0.1:8080/aspera/connect . Pour configurer le SDK Connect afin qu'il serve les installateurs Connect à partir de cette URL, vous devez mettre à jour sdkLocation vers l'URL ci-dessus.

Pour héberger les programmes d'installation sur un serveur Web sécurisé :

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

Remarque : Le certificat du serveur et la clé privée doivent être nommés respectivement cert.pem et key.pem .

Contribuer

Nous sommes toujours à la recherche de contributeurs pour nous aider à corriger des bugs, à créer de nouvelles fonctionnalités ou à améliorer la documentation du projet. Si vous êtes intéressé, consultez certainement notre Guide de contribution.