AWS Cloud9 n'est plus disponible pour les nouveaux clients. Les clients existants de AWS Cloud9 peuvent continuer à utiliser le service normalement. En savoir plus »
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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
Rubriques
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.
-
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
-
Vérifiez si
npm
est déjà installé en exécutantnpm
avec l'option--version
. Si c'est le cas, la sortie contient le numéro de versionnpm
. Sinpm
est installé, passez directement à l'étape 10 de cette procédure pour utilisernpm
à installerTypeScript.npm --version
-
Exécutez la commande
yum update
(pour Amazon Linux) ou la commandeapt 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
-
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
-
Pour commencer à utiliser
nvm
, fermez la session de terminal et démarrez-la à nouveau, ou approvisionnez le fichier~/.bashrc
qui contient les commandes pour chargernvm
.. ~/.bashrc
-
Vérifiez que
nvm
est installé en exécutantnvm
avec l'option--version
.nvm --version
-
Installez la dernière version 16 de Node.js en exécutant
nvm
. (npm
est inclus dans Node.js.)nvm install v16
-
Confirmez que Node.js est installé en exécutant la version de ligne de commande de Node.js avec l'option
--version
.node --version
-
Vérifiez que
npm
est installé en exécutantnpm
avec l'option--version
.npm --version
-
InstallationTypeScripten courant
npm
avec le-g
option. Cela installeTypeScripten tant que package global dans l'environnement.npm install -g typescript
-
Confirmez queTypeScriptest installé en exécutant la ligne de commandeTypeScriptcompilateur avec
--version
option.tsc --version
Étape 2 : Ajouter du code
-
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.) -
Dans un terminal de l'IDE, depuis le même répertoire que le fichier
hello.ts
, exécuteznpm
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 fichierhello.ts
. Ce nouveau dossier contient les définitions de type Node.js quiTypeScriptdoit être utilisé plus loin dans cette procédure pourconsole.log
etprocess.argv
propriétés que vous allez ajouter auhello.ts
dossier. -
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
-
Dans le terminal, depuis le même répertoire que le
hello.ts
fichier, exécutez leTypeScriptcompilateur. Spécifiez le fichierhello.ts
et les bibliothèques supplémentaires à inclure.tsc hello.ts --lib es6
TypeScriptutilise le
hello.ts
fichier et un ensemble de fichiers de bibliothèque ECMAScript 6 (ES6) pour transpiler leTypeScriptcode dans lehello.ts
fichier en équivalentJavaScriptcode dans un fichier nomméhello.js
. -
Dans la fenêtre Environment (Environnement), ouvrez le fichier
hello.js
. -
Dans la barre de menus, choisissez Exécuter, Configurations d'exécution, Nouvelle configuration d'exécution.
-
Dans l'onglet [New] - Idle ([Nouveau] - Inactif), choisissez Runner: Auto (Exécuteur : Auto), puis Node.js.
-
Pour Commande), saisissez
hello.js 5 9
. Dans le code,5
représenteprocess.argv[2]
, et9
représenteprocess.argv[3]
. (process.argv[0]
représente le nom de l'exécution (node
), etprocess.argv[1]
représente le nom du fichier (hello.js
).) -
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.js
fichier 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 AWS services à 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.
-
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
. -
À partir d'un terminal duAWS Cloud9IDE, dans le même répertoire que le
s3.ts
fichier, activez le code pour appeler les opérations Amazon S3 de manière asynchrone en exécutantnpm
deux fois pour installer la bibliothèque asynchrone pourTypeScriptet encore une fois pourJavaScript.npm install @types/async # For TypeScript. npm install async # For JavaScript.
-
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
-
Dans le terminal, depuis le même répertoire que le
s3.ts
fichier, exécutez leTypeScriptcompilateur. Spécifiez le fichiers3.ts
et les bibliothèques supplémentaires à inclure.tsc s3.ts --lib es6
TypeScriptutilise le
s3.ts
fichier, leAWSSDK pourJavaScriptdans Node.js, la bibliothèque asynchrone et un ensemble de fichiers de bibliothèque ECMAScript 6 (ES6) pour transpiler leTypeScriptcode dans les3.ts
fichier en équivalentJavaScriptcode dans un fichier nommés3.js
. -
Dans la fenêtre Environment (Environnement), ouvrez le fichier
s3.js
. -
Dans la barre de menus, choisissez Exécuter, Configurations d'exécution, Nouvelle configuration d'exécution.
-
Dans l'onglet [New] - Idle ([Nouveau] - Inactif), choisissez Runner: Auto (Exécuteur : Auto), puis Node.js.
-
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, etTHE_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), utilisezus-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.
-
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.