Node.js-Tutorial für AWS Cloud9

In diesem Tutorial können Sie einige Node.js-Skripte in einer - AWS Cloud9 Entwicklungsumgebung ausführen.

Wenn Sie dieses Tutorial befolgen und dieses Beispiel erstellen, kann Ihr AWS Konto belastet werden. Dies umfasst mögliche Kosten für Services wie Amazon EC2 und Amazon S3. Weitere Informationen finden Sie unter Amazon EC2 – Preise und Amazon S3 – Preise.

Voraussetzungen

Bevor Sie dieses Beispiel verwenden, stellen Sie sicher, dass Ihre Einrichtung die folgenden Anforderungen erfüllt:

• Sie müssen über eine vorhandene AWS Cloud9 EC2-Entwicklungsumgebung verfügen. Bei diesem Beispiel wird davon ausgegangen, dass Sie bereits eine EC2-Umgebung eingerichtet haben, die mit einer Amazon-EC2-Instance verbunden ist, die Amazon Linux oder Ubuntu Server ausführt. Wenn Sie ein andere Art von Umgebung oder ein anderes Betriebssystem verwenden, müssen Sie die Anweisungen dieses Beispiels zum Einrichten zugehöriger Tools möglicherweise anpassen. Weitere Informationen finden Sie unter Schaffung einer Umgebung in AWS Cloud9.

• Sie haben die AWS Cloud9 IDE für die vorhandene Umgebung bereits geöffnet. Wenn Sie eine Umgebung öffnen, AWS Cloud9 öffnet die IDE für diese Umgebung in Ihrem Webbrowser. Weitere Informationen finden Sie unter Öffnen einer Umgebung in AWS Cloud9.

Schritt 1: Installieren der erforderlichen Tools

In diesem Schritt installieren Sie Node.js, das erforderlich ist, um dieses Beispiel auszuführen.

1. Überprüfen Sie in einer Terminalsitzung in der AWS Cloud9 IDE, ob Node.js bereits installiert ist, indem Sie den node --version Befehl ausführen. (Um eine neue Terminalsitzung zu starten, wählen Sie in der Menüleiste Window (Fenster), New Terminal (Neues Terminal) aus. Bei Erfolg enthält die Ausgabe die Node.js-Versionsnummer. Wenn Node.js installiert ist, fahren Sie mit Schritt 2: Code hinzufügen fort.

2. Führen Sie den Befehl yum update für (Amazon Linux) oder apt update für (Ubuntu Server) aus, um sicherzustellen, dass die Sicherheitsupdates und Fehlerbehebungen auf dem aktuellen Stand sind.

   Für Amazon Linux:

   sudo yum -y update

   Für Ubuntu Server:

   sudo apt update

3. Um Node.js zu installieren, führen Sie zunächst diesen Befehl aus, um Node Version Manager (nvm) herunterzuladen. (nvm ist ein einfaches Bash-Shell-Skript, das für die Installation und Verwaltung von Node.js-Versionen nützlich ist. Weitere Informationen finden Sie unter Node Version Manager auf der - GitHub Website.)

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

4. Um mit nvm zu beginnen, schließen Sie entweder die Terminalsitzung und starten Sie sie erneut oder verwenden Sie die Datei ~/.bashrc, die die Befehle zum Laden von nvm enthält.

   . ~/.bashrc

5. Führen Sie diesen Befehl aus, um Node.js 16 auf Amazon Linux 2, Amazon Linux 1 und Ubuntu 18.04 zu installieren. Amazon Linux 1- und Ubuntu 18.04-Instances unterstützen nur Node.js bis v16.

   nvm install 16

   Führen Sie diesen Befehl aus, um die neueste Version von Node.js auf Amazon Linux 2023 und Ubuntu 22.04 zu installieren:

   nvm install --lts && nvm alias default lts/*

   Anmerkung

   Auf dem neuesten AL2023 AWS Cloud9 image ist Node.js 20 installiert und auf dem neuesten Amazon Linux 2 AWS Cloud9 image ist Node.js 18 installiert. Wenn Sie Node.js 18 auf Amazon Linux 2 AWS Cloud9 manuell installieren möchten, führen Sie den folgenden Befehl im AWS Cloud9 IDE-Terminal aus:

   C9_NODE_INSTALL_DIR=~/.nvm/versions/node/v18.17.1
   C9_NODE_URL=https://d3kgj69l4ph6w4.cloudfront.net/static/node-amazon/node-v18.17.1-linux-x64.tar.gz
   mkdir -p $C9_NODE_INSTALL_DIR
   curl -fSsl $C9_NODE_URL  | tar xz --strip-components=1 -C "$C9_NODE_INSTALL_DIR"
   nvm alias default v18.17.1
   nvm use default
   echo -e 'nvm use default' >> ~/.bash_profile

Schritt 2: Code hinzufügen

Erstellen Sie in der AWS Cloud9 IDE eine Datei mit diesem Inhalt und speichern Sie die Datei mit dem Namen hello.js. (Um eine Datei zu erstellen, wählen Sie in der Menüleiste File (Datei), New File (Neue Datei) aus. Um die Datei zu speichern, wählen Sie Datei, Save (Speichern).)

console.log('Hello, World!');

console.log('The sum of 2 and 3 is 5.');

var sum = parseInt(process.argv[2], 10) + parseInt(process.argv[3], 10);

console.log('The sum of ' + process.argv[2] + ' and ' +
  process.argv[3] + ' is ' + sum + '.');

Schritt 3: Ausführen des Codes

1. Wählen Sie in der AWS Cloud9 IDE in der Menüleiste Ausführen, Ausführen von Konfigurationen, Neue Ausführungskonfiguration aus.

2. Wählen Sie auf der Registerkarte [New] - Idle ([Neu] - Leerlauf) die Option Runner: Auto und dann Node.js aus.

3. Geben Sie für Command (Befehl) hello.js 5 9 ein. Im Code stellen 5 process.argv[2] und 9 process.argv[3] dar. (process.argv[0] steht für den Namen der Laufzeit (node), und process.argv[1] für den Namen der Datei (hello.js).)

4. Klicken Sie auf Run (Ausführen) und vergleichen Sie die Ausgabe.

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

Schritt 4: Installieren und Konfigurieren des AWS SDK für JavaScript in Node.js

Wenn Sie Node.js-Skripte in ausführen AWS Cloud9, können Sie zwischen AWS dem SDK für JavaScript Version 3 (V3) und dem älteren AWS SDK für JavaScript Version 2 (V2) wählen. Wie bei V2, V3 einfache Arbeit mit Amazon Web Services, wurde aber in TypeScript geschrieben und fügt mehrere häufig angeforderte Funktionen hinzu, z. B. modularisierte Pakete.

AWS SDK for JavaScript (V3)

Sie können dieses Beispiel erweitern, um das AWS SDK für JavaScript in Node.js zu verwenden, um einen Amazon S3-Bucket zu erstellen, Ihre verfügbaren Buckets aufzulisten und dann den soeben erstellten Bucket zu löschen.

In diesem Schritt installieren und konfigurieren Sie das Amazon S3-Service-Clientmodul des AWS SDK für JavaScript in Node.js, das eine bequeme Möglichkeit bietet, über Ihren JavaScript Code mit dem Amazon S3 AWS -Service zu interagieren.

Wenn Sie andere - AWS Services verwenden möchten, müssen Sie diese separat installieren. Weitere Informationen zum Installieren von AWS Modulen finden Sie unter im -AWS Entwicklerhandbuch (V3). Informationen zu den ersten Schritten mit Node.js und AWS SDK für JavaScript (V3) finden Sie unter Erste Schritte mit Node.js im AWS SDK for JavaScript Developers Guide (V3).

Nachdem Sie das AWS SDK für JavaScript in Node.js installiert haben, müssen Sie die Verwaltung der Anmeldeinformationen in Ihrer Umgebung einrichten. Das AWS SDK für JavaScript in Node.js benötigt diese Anmeldeinformationen, um mit AWS -Services zu interagieren.

So installieren Sie das AWS SDK für JavaScript in Node.js

Verwenden Sie npm, um den Befehl install auszuführen.

npm install @aws-sdk/client-s3
                  

Weitere Informationen finden Sie unter Installieren des SDK für JavaScript im AWS SDK for JavaScript Entwicklerhandbuch für .

So richten Sie die Anmeldeinformationsverwaltung in Ihrer Umgebung ein

Jedes Mal, wenn Sie das AWS SDK für JavaScript in Node.js verwenden, um einen - AWS Service aufzurufen, müssen Sie beim Aufruf eine Reihe von Anmeldeinformationen angeben. Diese Anmeldeinformationen bestimmen, ob das AWS SDK für JavaScript in Node.js über die entsprechenden Berechtigungen für diesen Aufruf verfügt. Wenn die Anmeldeinformationen nicht die entsprechenden Berechtigungen haben, schlägt der Aufruf fehl.

In diesem Schritt speichern Sie Ihre Anmeldeinformationen innerhalb der Umgebung. Folgen Sie dazu den Anweisungen unter Aufrufen von AWS -Services aus einer Umgebung in AWS Cloud9 und kehren Sie dann zu diesem Thema zurück.

Weitere Informationen finden Sie unter Festlegen von Anmeldeinformationen in Node.js imAWS SDK for JavaScript Entwicklerhandbuch.

AWS SDK for JavaScript (V2)

Sie können dieses Beispiel erweitern, um das AWS SDK für JavaScript in Node.js zu verwenden, um einen Amazon S3-Bucket zu erstellen, Ihre verfügbaren Buckets aufzulisten und dann den soeben erstellten Bucket zu löschen.

In diesem Schritt installieren und konfigurieren Sie das AWS SDK für JavaScript in Node.js, das eine bequeme Möglichkeit bietet, über Ihren JavaScript Code mit - AWS Services wie Amazon S3 zu interagieren. Nachdem Sie das AWS SDK für JavaScript in Node.js installiert haben, müssen Sie die Verwaltung der Anmeldeinformationen in Ihrer Umgebung einrichten. Das AWS SDK für JavaScript in Node.js benötigt diese Anmeldeinformationen, um mit AWS -Services zu interagieren.

So installieren Sie das AWS SDK für JavaScript in Node.js

Verwenden Sie npm, um den Befehl install auszuführen.

npm install aws-sdk
                  

Weitere Informationen finden Sie unter Installieren des SDK für JavaScript im AWS SDK for JavaScript Entwicklerhandbuch für .

So richten Sie die Anmeldeinformationsverwaltung in Ihrer Umgebung ein

Jedes Mal, wenn Sie das AWS SDK für JavaScript in Node.js verwenden, um einen - AWS Service aufzurufen, müssen Sie beim Aufruf eine Reihe von Anmeldeinformationen angeben. Diese Anmeldeinformationen bestimmen, ob das AWS SDK für JavaScript in Node.js über die entsprechenden Berechtigungen für diesen Aufruf verfügt. Wenn die Anmeldeinformationen nicht die entsprechenden Berechtigungen haben, schlägt der Aufruf fehl.

In diesem Schritt speichern Sie Ihre Anmeldeinformationen innerhalb der Umgebung. Folgen Sie dazu den Anweisungen unter Aufrufen von AWS -Services aus einer Umgebung in AWS Cloud9 und kehren Sie dann zu diesem Thema zurück.

Weitere Informationen finden Sie unter Festlegen von Anmeldeinformationen in Node.js imAWS SDK for JavaScript Entwicklerhandbuch.

Schritt 5: Hinzufügen von AWS SDK-Code

AWS SDK for JavaScript (V3)

In diesem Schritt fügen Sie weiteren Code hinzu. Dieses Mal für die Interaktion mit Amazon S3, um einen Bucket zu erstellen, Ihre verfügbaren Buckets aufzulisten und anschließend den Bucket zu löschen, den Sie zuvor erstellt haben. Sie führen diesen Code später aus.

Erstellen Sie in der AWS Cloud9 IDE eine Datei mit diesem Inhalt und speichern Sie die Datei mit dem Namen s3.js.

import {
  CreateBucketCommand,
  DeleteBucketCommand,
  ListBucketsCommand,
  S3Client,
} from "@aws-sdk/client-s3";

const wait = async (milliseconds) => {
  return new Promise((resolve) => setTimeout(resolve, milliseconds));
};

export const main = async () => {
  const client = new S3Client({});
  const now = Date.now();
  const BUCKET_NAME = `easy-bucket-${now.toString()}`;

  const createBucketCommand = new CreateBucketCommand({ Bucket: BUCKET_NAME });
  const listBucketsCommand = new ListBucketsCommand({});
  const deleteBucketCommand = new DeleteBucketCommand({ Bucket: BUCKET_NAME });

  try {
    console.log(`Creating bucket ${BUCKET_NAME}.`);
    await client.send(createBucketCommand);
    console.log(`${BUCKET_NAME} created`);

    await wait(2000);

    console.log(`Here are your buckets:`);
    const { Buckets } = await client.send(listBucketsCommand);
    Buckets.forEach((bucket) => {
      console.log(` • ${bucket.Name}`);
    });

    await wait(2000);

    console.log(`Deleting bucket ${BUCKET_NAME}.`);
    await client.send(deleteBucketCommand);
    console.log(`${BUCKET_NAME} deleted`);
  } catch (err) {
    console.error(err);
  }
};

main();
               

AWS SDK for JavaScript (V2)

In diesem Schritt fügen Sie weiteren Code hinzu. Dieses Mal für die Interaktion mit Amazon S3, um einen Bucket zu erstellen, Ihre verfügbaren Buckets aufzulisten und anschließend den Bucket zu löschen, den Sie zuvor erstellt haben. Sie führen diesen Code später aus.

Erstellen Sie in der AWS Cloud9 IDE eine Datei mit diesem Inhalt und speichern Sie die Datei mit dem Namen s3.js.

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

var AWS = require("aws-sdk"); // To set the AWS credentials and region.
var async = require("async"); // To call AWS operations asynchronously.

AWS.config.update({
  region: region,
});

var s3 = new AWS.S3({ apiVersion: "2006-03-01" });
var bucket_name = process.argv[2];
var region = process.argv[3];

var create_bucket_params = {
  Bucket: bucket_name,
  CreateBucketConfiguration: {
    LocationConstraint: region,
  },
};

var delete_bucket_params = { Bucket: bucket_name };

// List all of your available buckets in this AWS Region.
function listMyBuckets(callback) {
  s3.listBuckets(function (err, data) {
    if (err) {
    } else {
      console.log("My buckets now are:\n");

      for (var i = 0; i < data.Buckets.length; i++) {
        console.log(data.Buckets[i].Name);
      }
    }

    callback(err);
  });
}

// Create a bucket in this AWS Region.
function createMyBucket(callback) {
  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) {
  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,
]);

Schritt 6: Ausführen des AWS SDK-Codes

1. Ermöglichen Sie dem Code das Aufrufen von Amazon S3-Operationen, indem Sie npm verwenden, um den Befehl install auszuführen.

   npm install async

2. Wählen Sie in der AWS Cloud9 IDE in der Menüleiste Ausführen, Ausführen von Konfigurationen, Neue Ausführungskonfiguration aus.

3. Wählen Sie auf der Registerkarte [New] - Idle ([Neu] - Leerlauf) die Option Runner: Auto und dann Node.js aus.

4. Wenn Sie AWS SDK für JavaScript (V3) verwenden, für Befehlstyp s3.js. Wenn Sie AWS SDK for Javascript (v2) für Befehlstyp verwendens3.js my-test-bucket us-east-2, wobei der Name des Buckets my-test-bucket ist, den Sie erstellen und dann löschen möchten, und die ID der AWS Region us-east-2 ist, in der Sie den Bucket erstellen möchten. Weitere IDs finden Sie unter Amazon Simple Storage Service (Amazon S3) im Allgemeine Amazon Web Services-Referenz.

   Anmerkung

   Amazon S3-Bucket-Namen müssen über hinweg eindeutig sein AWS, nicht nur über Ihr AWS -Konto.

5. Klicken Sie auf Run (Ausführen) und vergleichen Sie die Ausgabe.

   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:

Schritt 7: Bereinigen

Um laufende Gebühren für Ihr AWS Konto nach Verwendung dieses Beispiels zu vermeiden, sollten Sie die Umgebung löschen. Detaillierte Anweisungen finden Sie unter Löschen einer Umgebung in AWS Cloud9.