TypeScripttutorial untukAWS Cloud9

Tutorial ini menunjukkan kepada Anda bagaimana bekerja denganTypeScriptdalam sebuahAWS Cloud9lingkungan pengembangan.

Mengikuti tutorial ini dan membuat sampel ini dapat mengakibatkan biaya untuk AndaAWSakun. Ini termasuk kemungkinan biaya untuk layanan seperti Amazon EC2 dan Amazon S3. Untuk informasi selengkapnya, lihat Harga Amazon EC2 dan Harga Amazon S3.

Prasyarat

Sebelum Anda menggunakan sampel ini, pastikan bahwa pengaturan Anda memenuhi persyaratan berikut:

• Anda harus memilikiAWS Cloud9Lingkungan pengembangan EC2. Contoh ini mengasumsikan bahwa Anda sudah memiliki lingkungan EC2 yang terhubung ke instans Amazon EC2 yang menjalankan Amazon Linux atauUbuntuServer. Jika Anda memiliki jenis lingkungan atau sistem operasi yang berbeda, Anda mungkin perlu menyesuaikan petunjuk sampel ini untuk menyiapkan alat terkait. Untuk informasi selengkapnya, lihat Menciptakan lingkungan di AWS Cloud9.

• Anda memilikiAWS Cloud9IDE untuk lingkungan yang ada sudah terbuka. Saat Anda membuka lingkungan, AWS Cloud9 membuka IDE untuk lingkungan itu di peramban web Anda. Untuk informasi selengkapnya, lihat Membuka lingkungan di AWS Cloud9.

Langkah 1: Pasang alat yang diperlukan

Pada langkah ini, Anda menginstalTypeScriptdengan menggunakan Node Package Manager ( npm ). Untuk memasang npm , Anda menggunakan Node Version Manager ( nvm ). Jika Anda tidak memiliki nvm , Anda memasangnya pada langkah ini terlebih dulu.

1. Dalam sesi terminal diAWS Cloud9IDE, konfirmasikan apakahTypeScriptsudah terinstal dengan menjalankan command lineTypeScriptcompiler dengan --version pilihan. (Untuk memulai sesi terminal baru, pada bilah menu, pilih Jendela, Terminal Baru.) Jika berhasil, output berisiTypeScriptnomor versi. JikaTypeScriptdipasang, lewati ke depanLangkah 2: Menambahkan kode.

   tsc --version

2. Konfirmasi apakah npm sudah terpasang dengan menjalankan npm dengan opsi --version . Jika berhasil, output berisi nomor versi npm . Jika npm diinstal, lewati ke langkah 10 dalam prosedur ini untuk digunakan npm untuk menginstalTypeScript.

   npm --version

3. Jalankan perintah yum update untuk (Amazon Linux) atau apt update untuk (Ubuntu Server) untuk membantu memastikan pembaruan keamanan terbaru dan perbaikan bug terpasang.

   Untuk Amazon Linux:

   sudo yum -y update

   Untuk Ubuntu Server:

   sudo apt update

4. Untuk menginstal npm , mulai dengan menjalankan perintah berikut untuk men-download Node Version Manager ( nvm ) . ( nvm adalah skrip shell Bash sederhana yang berguna untuk menginstal dan mengelola versi Node.js. Untuk informasi lebih lanjut, lihatManajer Versi NodepadaGitHubsitus web.)

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

5. Untuk mulai menggunakan nvm , tutup sesi terminal dan mulai lagi, atau cari file ~/.bashrc yang berisi perintah untuk memuat nvm .

   . ~/.bashrc

6. Konfirmasi apakah nvm sudah terpasang dengan menjalankan nvm dengan opsi --version .

   nvm --version

7. Instal versi terbaru 16 dari Node.js dengan menjalankan nvm . ( npm termasuk dalam Node.js.)

   nvm install v16

8. Konfirmasi bahwa Node.js terpasang dengan menjalankan versi baris perintah dari Node.js dengan opsi --version .

   node --version

9. Konfirmasi apakah npm sudah terpasang dengan menjalankan npm dengan opsi --version .

   npm --version

10. InstalTypeScriptdengan menjalankan npm dengan -g pilihan. Penginstalan iniTypeScriptsebagai paket global di lingkungan.

    npm install -g typescript

11. Konfirmasikan bahwaTypeScriptdiinstal dengan menjalankan baris perintahTypeScriptcompiler dengan --version pilihan.

    tsc --version

Langkah 2: Menambahkan kode

1. Di AWS Cloud9 IDE, buat file dengan nama hello.ts. (Untuk membuat file, pada bilah menu, pilih File, File Baru. Untuk menyimpan file, pilih File, Simpan.)

2. Di sebuah terminal di IDE, dari direktori yang sama seperti file hello.ts, jalankan npm untuk memasang pustaka @types/node.

   npm install @types/node

   Hal ini menambahkan folder node_modules/@types/node dalam direktori yang sama dengan file hello.ts. Folder baru ini berisi definisi tipe Node.js yangTypeScriptperlu nanti dalam prosedur ini untukconsole.logdanprocess.argvproperti yang akan Anda tambahkan kehello.tsberkas.

3. Tambahkan kode berikut ke file 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 + '.');

Langkah 3: Jalankan kode

1. Di terminal, dari direktori yang sama denganhello.tsfile, jalankanTypeScriptkompiler. Menentukan file hello.ts dan pustaka tambahan untuk disertakan.

   tsc hello.ts --lib es6

   TypeScriptmenggunakanhello.tsfile dan satu set ECMAScript 6 (ES6) file perpustakaan untuk transpileTypeScriptkode dihello.tsfile menjadi setaraJavaScriptkode dalam sebuah file bernamahello.js.

2. Di jendela Lingkungan, buka file hello.js.

3. Pada bilah menu, pilih Jalankan, Jalankan Konfigurasi, Jalankan Konfigurasi Baru.

4. Di tab [Baru] - Diam, pilih Runner: Otomatis, lalu pilih Node.js.

5. Untuk Perintah, ketik hello.js 5 9. Dalam kode, 5 mewakili process.argv[2], dan 9 mewakili process.argv[3]. (process.argv[0]mewakili nama runtime (node), dan process.argv[1] mewakili nama file (hello.js).)

6. Pilih Jalankan, dan bandingkan output Anda. Setelah Anda selesai, pilih Berhenti.

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

catatan

Alih-alih membuat konfigurasi run baru di IDE, Anda juga dapat menjalankan kode ini dengan menjalankan perintah node hello.js 5 9 dari terminal.

Langkah 4: Instal dan konfigurasikanAWSSDK untukJavaScriptdi Node.js

Anda dapat meningkatkan sampel ini untuk menggunakanAWSSDK untukJavaScriptdi Node.js untuk membuat bucket Amazon S3, cantumkan bucket yang tersedia, lalu hapus bucket yang baru saja Anda buat.

Pada langkah ini, Anda menginstal dan mengkonfigurasiAWSSDK untukJavaScriptdi Node.js. SDK menyediakan cara mudah untuk berinteraksiAWSlayanan seperti Amazon S3, dariJavaScriptkode. Setelah Anda menginstalAWSSDK untukJavaScriptdi Node.js, Anda harus menyiapkan manajemen kredensil di lingkungan Anda. SDK membutuhkan kredensial ini untuk berinteraksi dengan layanan AWS.

Untuk menginstalAWSSDK untukJavaScriptdi Node.js

Dalam sesi terminal diAWS Cloud9IDE, dari direktori yang sama denganhello.jsfile dariLangkah 3: Jalankan kode, lari npm untuk menginstalAWSSDK untukJavaScriptdi Node.js.

npm install aws-sdk

Perintah ini menambahkan beberapa folder ke folder node_modules dari Langkah 3: Jalankan kode. Folder ini berisi kode sumber dan dependensi untukAWSSDK untukJavaScriptdi Node.js. Untuk informasi lebih lanjut, lihatMenginstal SDK untukJavaScriptdi dalamAWS SDK for JavaScriptPanduan Pengembang.

Untuk mengatur pengelolaan kredensial di lingkungan Anda

Setiap kali Anda menggunakanAWSSDK untukJavaScriptdi Node.js untuk memanggilAWSlayanan, Anda harus memberikan satu set kredenial dengan panggilan. Kredensil ini menentukan apakahAWSSDK untukJavaScriptdi Node.js memiliki izin yang sesuai untuk melakukan panggilan itu. Jika kredensial tidak mencakup izin yang sesuai, panggilan akan gagal.

Pada langkah ini, Anda menyimpan kredensial Anda di dalam lingkungan. Untuk melakukannya, ikuti petunjuk di MeneleponLayanan AWS dari lingkungan diAWS Cloud9, lalu kembali ke topik ini.

Untuk informasi tambahan, lihat Mengatur Kredensial di Node.js di Panduan Developer AWS SDK for JavaScript.

Langkah 5: Menambahkan kode AWS SDK

Pada langkah ini, Anda menambahkan beberapa kode lagi, kali ini untuk berinteraksi dengan Amazon S3 untuk membuat bucket, daftarkan bucket Anda yang tersedia, lalu hapus bucket yang baru saja Anda buat. Anda akan menjalankan kode ini nanti.

1. Di AWS Cloud9 IDE, dalam direktori yang sama dengan file hello.js pada langkah sebelumnya, buat berkas dengan nama s3.ts.

2. Dari terminal diAWS Cloud9IDE, di direktori yang sama dengans3.tsfile, aktifkan kode untuk memanggil operasi Amazon S3 secara asinkron dengan menjalankan npm dua kali untuk menginstal pustaka async untukTypeScriptdan lagi untukJavaScript.

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

3. Menambahkan kode berikut ke file 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
   ]);

Langkah 6: Jalankan kode AWS SDK

1. Di terminal, dari direktori yang sama dengans3.tsfile, jalankanTypeScriptkompiler. Menentukan file s3.ts dan pustaka tambahan untuk disertakan.

   tsc s3.ts --lib es6

   TypeScriptmenggunakans3.tsfile,AWSSDK untukJavaScriptdi Node.js, perpustakaan async, dan satu set file perpustakaan ECMAScript 6 (ES6) untuk transpileTypeScriptkode dis3.tsfile menjadi setaraJavaScriptkode dalam sebuah file bernamas3.js.

2. Di jendela Lingkungan, buka file s3.js.

3. Pada bilah menu, pilih Jalankan, Jalankan Konfigurasi, Jalankan Konfigurasi Baru.

4. Di tab [Baru] - Diam, pilih Runner: Otomatis, lalu pilih Node.js.

5. Untuk Perintah, ketik s3.js YOUR_BUCKET_NAME THE_AWS_REGION , di mana YOUR_BUCKET_NAME adalah nama bucket yang ingin Anda buat lalu hapus, dan THE_AWS_REGION adalah ID dari Wilayah AWS tempat membuat bucket. Sebagai contoh, untuk Wilayah US East (Ohio)., gunakan us-east-2. Untuk ID lainnya, lihatLayanan Penyimpanan Sederhana Amazon (Amazon S3)di dalamReferensi Umum Amazon Web Services.

   catatan

   Nama bucket Amazon S3 harus unik di seluruh AWS—bukan hanya akun AWS Anda.

6. Pilih Jalankan, dan bandingkan output Anda. Setelah Anda selesai, pilih Berhenti.

   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:

Langkah 7: Membersihkan

Untuk mencegah tagihan berkelanjutan ke akun AWS Anda setelah Anda selesai menggunakan sampel ini, Anda harus menghapus lingkungan. Untuk instruksi, lihat Menghapus lingkungan di AWS Cloud9.