TypeScripttutoriel pourAWS Cloud9

Ce didacticiel vous montre comment travailler avecTypeScriptdans unAWS Cloud9environnement de développement.

La suite de ce didacticiel et la création de cet exemple peuvent entraîner des frais pour votreAWScompte. Il peut s'agir de frais pour des services tels qu'Amazon EC2 et Amazon S3. Pour en savoir plus, consultez les sections Tarification Amazon EC2 et Tarification Amazon S3.

Prérequis

Avant d'utiliser cet exemple, vérifiez que votre configuration respecte les conditions requises suivantes :

• Vous devez disposer d'un environnement de développement AWS Cloud9 EC2 existant. Cet exemple suppose que vous disposez déjà d'un environnement EC2 connecté à une instance Amazon EC2 s'exécutant sur Amazon Linux ou Ubuntu Server. Si vous utilisez un autre type d'environnement ou de système d'exploitation, vous devrez peut-être adapter les instructions de cet exemple pour configurer les outils associés. Pour plus d'informations, veuillez consulter Création d'un environnement dans AWS Cloud9.

• L'IDE AWS Cloud9 correspondant à l'environnement existant est déjà ouvert. Lorsque vous ouvrez un environnement, AWS Cloud9 ouvre l'IDE associé à cet environnement dans votre navigateur web. Pour plus d'informations, veuillez consulter Ouverture d'un environnement dans AWS Cloud9.

Étape 1 : Installer les outils requis

Au cours de cette étape, vous installezTypeScriptà l'aide du gestionnaire de packages Node ( npm ). Pour installer npm , vous utilisez Node Version Manager ( nvm ). Si vous ne disposez pas de nvm , vous devez d'abord l'installer dans cette étape.

1. Lors d'une session de terminal dansAWS Cloud9IDE, confirmez siTypeScriptest déjà installé en exécutant la ligne de commandeTypeScriptcompilateur avec --version option. (Pour démarrer une nouvelle séance de terminal, dans la barre de menus, choisissez Window (Fenêtre), New Terminal (Nouveau terminal).) Si c'est le cas, la sortie contient le numéro de version TypeScript. SiTypeScriptest installé, passez directement àÉtape 2 : Ajouter du code.

   tsc --version

2. Vérifiez si npm est déjà installé en exécutant npm avec l'option --version . Si c'est le cas, la sortie contient le numéro de version npm . Si npm est installé, passez directement à l'étape 10 de cette procédure pour utiliser npm à installerTypeScript.

   npm --version

3. Exécutez la commande yum update (pour Amazon Linux) ou la commande apt update (pour Ubuntu Server) afin d'être sûr que les mises à jour de sécurité et les correctifs les plus récents sont installés.

   Pour Amazon Linux :

   sudo yum -y update

   Pour Ubuntu Server :

   sudo apt update

4. Pour installer npm , commencez par exécuter la commande suivante pour télécharger le gestionnaire de versions de Node ( nvm ) . ( nvm est un script shell Bash simple qui est utile pour installer et gérer les versions de Node.js. Pour plus d'informations, voirGestionnaire de versions de nœudssur leGitHubsite Web.)

   curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash

5. Pour commencer à utiliser nvm , fermez la session de terminal et démarrez-la à nouveau, ou approvisionnez le fichier ~/.bashrc qui contient les commandes pour charger nvm .

   . ~/.bashrc

6. Vérifiez que nvm est installé en exécutant nvm avec l'option --version .

   nvm --version

7. Installez la dernière version 16 de Node.js en exécutant nvm . ( npm est inclus dans Node.js.)

   nvm install v16

8. Confirmez que Node.js est installé en exécutant la version de ligne de commande de Node.js avec l'option --version .

   node --version

9. Vérifiez que npm est installé en exécutant npm avec l'option --version .

   npm --version

10. InstallationTypeScripten courant npm avec le -g option. Cela installeTypeScripten tant que package global dans l'environnement.

    npm install -g typescript

11. Confirmez queTypeScriptest installé en exécutant la ligne de commandeTypeScriptcompilateur avec --version option.

    tsc --version

Étape 2 : Ajouter du code

1. Dans l'IDE AWS Cloud9, créez un fichier nommé hello.ts. (Pour créer un fichier, dans la barre de menus, choisissez Fichier, Nouveau fichier. Pour l'enregistrer, choisissez Fichier, Enregistrer.)

2. Dans un terminal de l'IDE, depuis le même répertoire que le fichier hello.ts, exécutez npm pour installer la bibliothèque @types/node.

   npm install @types/node

   Cela ajoute un dossier node_modules/@types/node dans le même répertoire que le fichier hello.ts. Ce nouveau dossier contient les définitions de type Node.js quiTypeScriptdoit être utilisé plus loin dans cette procédure pourconsole.logetprocess.argvpropriétés que vous allez ajouter auhello.tsdossier.

3. Ajoutez le code suivant au fichier hello.ts :

   console.log('Hello, World!');
   
   console.log('The sum of 2 and 3 is 5.');
   
   const sum: number = parseInt(process.argv[2], 10) + parseInt(process.argv[3], 10);
   
   console.log('The sum of ' + process.argv[2] + ' and ' +
     process.argv[3] + ' is ' + sum + '.');

Étape 3 : Exécuter le code

1. Dans le terminal, depuis le même répertoire que lehello.tsfichier, exécutez leTypeScriptcompilateur. Spécifiez le fichier hello.ts et les bibliothèques supplémentaires à inclure.

   tsc hello.ts --lib es6

   TypeScriptutilise lehello.tsfichier et un ensemble de fichiers de bibliothèque ECMAScript 6 (ES6) pour transpiler leTypeScriptcode dans lehello.tsfichier en équivalentJavaScriptcode dans un fichier nomméhello.js.

2. Dans la fenêtre Environment (Environnement), ouvrez le fichier hello.js.

3. Dans la barre de menus, choisissez Exécuter, Configurations d'exécution, Nouvelle configuration d'exécution.

4. Dans l'onglet [New] - Idle ([Nouveau] - Inactif), choisissez Runner: Auto (Exécuteur : Auto), puis Node.js.

5. Pour Commande), saisissez hello.js 5 9. Dans le code, 5 représente process.argv[2], et 9 représente process.argv[3]. (process.argv[0] représente le nom de l'exécution (node), et process.argv[1] représente le nom du fichier (hello.js).)

6. Choisissez le bouton Run (Exécuter) et comparez la sortie. Lorsque vous avez terminé, choisissez Stop (Arrêter).

   Hello, World!
   The sum of 2 and 3 is 5.
   The sum of 5 and 9 is 14.

Note

Au lieu de créer une nouvelle configuration d'exécution dans l'IDE, vous pouvez également exécuter ce code en exécutant la commande node hello.js 5 9 à partir du terminal.

Étape 4 : Installation et configuration duAWSSDK pourJavaScriptdans Node.js

Vous pouvez améliorer cet exemple pour utiliser leAWSSDK pourJavaScriptdans Node.js pour créer un compartiment Amazon S3, listez vos compartiments disponibles, puis supprimez le compartiment que vous venez de créer.

Au cours de cette étape, vous allez installer et configurer leAWSSDK pourJavaScriptdans Node.js. Le SDK fournit un moyen pratique d'interagir avecAWSdes services tels qu'Amazon S3, depuis votreJavaScriptcode. Après avoir installé leAWSSDK pourJavaScriptdans Node.js, vous devez configurer la gestion des informations d'identification dans votre environnement. Le kit SDK a besoin de ces informations d'identification pour interagir avec les services AWS.

Pour installer leAWSSDK pourJavaScriptdans Node.js

Lors d'une session de terminal dansAWS Cloud9IDE, depuis le même répertoire que lehello.jsfichier deÉtape 3 : Exécuter le code, courir npm pour installer leAWSSDK pourJavaScriptdans Node.js.

npm install aws-sdk

Cette commande ajoute plusieurs dossiers au dossier node_modules de l'Étape 3 : Exécuter le code. Ces dossiers contiennent le code source et les dépendances duAWSSDK pourJavaScriptdans Node.js. Pour plus d'informations, voirInstallation du SDK pourJavaScriptdans leAWS SDK for JavaScriptGuide du développeur.

Pour configurer la gestion des informations d'identification dans votre environnement

Chaque fois que vous utilisez leAWSSDK pourJavaScriptdans Node.js pour appeler unAWSservice, vous devez fournir un ensemble d'informations d'identification avec l'appel. Ces informations d'identification déterminent siAWSSDK pourJavaScriptin Node.js possède les autorisations appropriées pour effectuer cet appel. Si les informations d'identification ne sont pas associées aux autorisations nécessaires, l'appel échoue.

Au cours de cette étape, vous allez stocker vos informations d'identification dans l'environnement. Pour ce faire, suivez les instructions de la rubrique Appel des Services AWS à partir d'un environnement dans AWS Cloud9, puis revenez à cette rubrique.

Pour plus d'informations, consultez Setting Credentials in Node.js dans le Guide du développeur AWS SDK for JavaScript.

Étape 5 : Ajouter du code SDK AWS

Au cours de cette étape, vous allez ajouter du code supplémentaire pour interagir avec Amazon S3, créer un compartiment, répertorier les compartiments disponibles, puis supprimer le compartiment que vous venez de créer. Vous exécuterez ce code ultérieurement.

1. Dans l'IDE AWS Cloud9, dans le même répertoire que le fichier hello.js dans les étapes précédentes, créez un fichier nommé s3.ts.

2. À partir d'un terminal duAWS Cloud9IDE, dans le même répertoire que les3.tsfichier, activez le code pour appeler les opérations Amazon S3 de manière asynchrone en exécutant npm deux fois pour installer la bibliothèque asynchrone pourTypeScriptet encore une fois pourJavaScript.

   npm install @types/async # For TypeScript.
   npm install async        # For JavaScript.

3. Ajoutez le code suivant au fichier s3.ts :

   import * as async from 'async';
   import * as AWS from 'aws-sdk';
   
   if (process.argv.length < 4) {
     console.log('Usage: node s3.js <the bucket name> <the AWS Region to use>\n' +
       'Example: node s3.js my-test-bucket us-east-2');
     process.exit(1);
   }
   
   const AWS = require('aws-sdk'); // To set the AWS credentials and AWS Region.
   const async = require('async'); // To call AWS operations asynchronously.
   
   const s3: AWS.S3 = new AWS.S3({apiVersion: '2006-03-01'});
   const bucket_name: string = process.argv[2];
   const region: string = process.argv[3];
   
   AWS.config.update({
     region: region
   });
   
   const create_bucket_params: any = {
     Bucket: bucket_name,
     CreateBucketConfiguration: {
       LocationConstraint: region
     }
   };
   
   const delete_bucket_params: any = {
     Bucket: bucket_name
   };
   
   // List all of your available buckets in this AWS Region.
   function listMyBuckets(callback): void {
     s3.listBuckets(function(err, data) {
       if (err) {
   
       } else {
         console.log("My buckets now are:\n");
   
         for (let i: number = 0; i < data.Buckets.length; i++) {
           console.log(data.Buckets[i].Name);
         }
       }
   
       callback(err);
     });
   }
   
   // Create a bucket in this AWS Region.
   function createMyBucket(callback): void {
     console.log("\nCreating a bucket named '" + bucket_name + "'...\n");
   
     s3.createBucket(create_bucket_params, function(err, data) {
       if (err) {
         console.log(err.code + ": " + err.message);
       }
   
       callback(err);
     });
   }
   
   // Delete the bucket you just created.
   function deleteMyBucket(callback): void {
     console.log("\nDeleting the bucket named '" + bucket_name + "'...\n");
   
     s3.deleteBucket(delete_bucket_params, function(err, data) {
       if (err) {
         console.log(err.code + ": " + err.message);
       }
   
       callback(err);
     });
   }
   
   // Call the AWS operations in the following order.
   async.series([
     listMyBuckets,
     createMyBucket,
     listMyBuckets,
     deleteMyBucket,
     listMyBuckets
   ]);

Étape 6 : Exécuter le code du kit SDK AWS

1. Dans le terminal, depuis le même répertoire que les3.tsfichier, exécutez leTypeScriptcompilateur. Spécifiez le fichier s3.ts et les bibliothèques supplémentaires à inclure.

   tsc s3.ts --lib es6

   TypeScriptutilise les3.tsfichier, leAWSSDK pourJavaScriptdans Node.js, la bibliothèque asynchrone et un ensemble de fichiers de bibliothèque ECMAScript 6 (ES6) pour transpiler leTypeScriptcode dans les3.tsfichier en équivalentJavaScriptcode dans un fichier nommés3.js.

2. Dans la fenêtre Environment (Environnement), ouvrez le fichier s3.js.

3. Dans la barre de menus, choisissez Exécuter, Configurations d'exécution, Nouvelle configuration d'exécution.

4. Dans l'onglet [New] - Idle ([Nouveau] - Inactif), choisissez Runner: Auto (Exécuteur : Auto), puis Node.js.

5. Pour Command (Commande), saisissez s3.js YOUR_BUCKET_NAME THE_AWS_REGION , où YOUR_BUCKET_NAME correspond au nom du compartiment que vous souhaitez créer puis supprimer, et THE_AWS_REGION correspond à l'ID de la région AWS dans laquelle vous souhaitez créer le compartiment. Par exemple, pour la région USA Est (Ohio), utilisez us-east-2. Pour plus d'ID, consultez la section Amazon Simple Storage Service (Amazon S3) de la Référence générale d'Amazon Web Services.

   Note

   Les noms des compartiments Amazon S3 doivent être uniques dans l'ensemble d'AWS, pas seulement dans votre compte AWS.

6. Choisissez le bouton Run (Exécuter) et comparez la sortie. Lorsque vous avez terminé, choisissez Stop (Arrêter).

   My buckets now are:
   
   Creating a new bucket named 'my-test-bucket'...
   
   My buckets now are:
   
   my-test-bucket
   
   Deleting the bucket named 'my-test-bucket'...
   
   My buckets now are:

Étape 7 : nettoyer

Afin d'éviter des frais permanents sur votre compte AWS une fois que vous avez fini d'utiliser cet exemple, vous devez supprimer l'environnement. Pour obtenir des instructions, consultez Suppression d'un environnement dans AWS Cloud9.