Oracle Cloud Infrastructure-Dokumentation

Free Tier: Node Express auf einer Oracle Linux-Instanz installieren

In diesem Tutorial richten Sie mit einem Oracle Cloud Infrastructure Free Tier-Account eine Oracle Linux-Compute-Instanz ein. Anschließend installieren Sie eine Node Express-Anwendung und greifen über das Internet auf Ihre neue Anwendung zu. Dieses Tutorial enthält alle erforderlichen Schritte zum Einrichten eines virtuellen Netzwerks für Ihren Host und zum Verbinden des Hosts mit dem Internet.

Zu den wichtigsten Aufgaben gehören:

  • Richten Sie ein Compartment für Ihre Entwicklungsarbeit ein.
  • Installieren Sie Ihre Oracle Linux-Instanz, und verbinden Sie sie mit Ihrem virtuellen Cloud-Netzwerk (VCN).
    • Richten Sie ein virtuelles Cloud-Netzwerk in Oracle Cloud Infrastructure und zugehörige Netzwerkservices ein, die für die Verbindung Ihres Hosts mit dem Internet erforderlich sind.
    • Richten Sie SSH-Verschlüsselungsschlüssel für den Zugriff auf Ihren Oracle Linux-Server ein.
  • Konfigurieren Sie Ingress-Regeln für das VCN.
  • Konfigurieren Sie Node.js mit einem Express-Framework auf Ihrer Instanz.

Im Folgenden finden Sie ein vereinfachtes Diagramm des Setups für Ihre Linux-Instanz.

Ein Diagramm der Komponenten, die zum Ausführen einer Node.js-Anwendung mit einem Express-Framework auf Oracle Cloud Infrastructure erforderlich sind

Weitere Informationen finden Sie hier:

Bevor Sie beginnen

Um dieses Tutorial erfolgreich abzuschließen, benötigen Sie Folgendes:

Anforderungen

1. Compartment für Entwicklung einrichten

Konfigurieren Sie ein Compartment für Ihre Entwicklung.

Compartment erstellen

Erstellen Sie ein Compartment für die Ressourcen, die Sie in diesem Tutorial erstellen.

  1. Melden Sie sich bei der Oracle Cloud Infrastructure -Konsole an.
  2. Öffnen Sie das Navigationsmenü, und klicken Sie auf Identität und Sicherheit. Klicken Sie unter Identität auf Compartments.
  3. Klicken Sie auf Compartment erstellen.
  4. Geben Sie die folgenden Informationen ein:
    • Name: <your-compartment-name>
    • Beschreibung: Compartment for <your-description>.
    • Übergeordnetes Compartment: <your-tenancy>(root)
  5. Klicken Sie auf Compartment erstellen.

Referenz: Compartment erstellen

2. Virtuelles Cloud-Netzwerk installieren

Verwenden Sie den Workflow VCN-Assistenten starten, um ein neues virtuelles Cloud-Netzwerk (VCN) zu erstellen.

Der Workflow führt bei der Installation des VCN mehrere Schritte aus:

  • Erstellt ein VCN.
  • Fügt ein Internetgateway hinzu, das Internetverbindungen aktiviert.
  • Erstellt und konfiguriert öffentliche und private Subnetze für das VCN.
  • Richtet Routentabellen und Sicherheitslisten für die Subnetze ein.

Weitere Informationen zu VCNs finden Sie unter VCN- und Subnetzverwaltung.

Installationsschritte prüfen

So erstellen Sie ein VCN:

Wichtig

Die angegebenen Schritte gelten für einen Free Tier-Account. Wenn Sie einen kostenpflichtigen Account verwenden, können sich die Schritte von den hier beschriebenen unterscheiden.
  1. Öffnen Sie das Navigationsmenü , und wählen Sie Networking aus. Wählen Sie dann Virtuelle Cloud-Netzwerke aus.
  2. Wählen Sie bei Bedarf das Compartment im Steuerelement Compartment in der linken Navigation aus.
  3. Klicken Sie auf VCN-Assistenten starten.
  4. Wählen Sie VCN mit Internetverbindung erstellen aus.
  5. Klicken Sie auf VCN-Assistenten starten.
  6. Konfigurieren Sie das VCN. Das Dialogfeld "Konfigurieren" enthält die folgenden Abschnitte.

    Basisinformationen

    Geben Sie den VCN-Namen ein, und wählen Sie ein Compartment aus.

    • Name: <name-for-the-vcn>

      Geben Sie einen Namen für Ihr VCN ein. Geben Sie dabei keine vertraulichen Informationen ein.

    • Compartment: <your-compartment-name>

      Wählen Sie das Compartment aus.

    VCN konfigurieren

    • Behalten Sie die Standardwerte für den VCN-IPv4 CIDR-Block und die DNS-Auflösung bei.

    Öffentliches Subnetz konfigurieren

    • Behalten Sie die Standardwerte für IP-Adresstyp und IPv4 CIDR-Block bei.

    Privates Subnetz konfigurieren

    • Behalten Sie die Standardwerte für IP-Adresstyp und IPv4 CIDR-Block bei.
  7. Klicken Sie auf Weiter.
  8. Prüfen Sie die Auswahl. Klicken Sie auf Zurück, um zurückzugehen und Änderungen vorzunehmen.
  9. Klicken Sie auf Erstellen, um das VCN zu erstellen.

    Das System erstellt das VCN und alle zugehörigen Ressourcen. Das kann einen Moment dauern.

    Nachdem die Erstellung abgeschlossen ist, klicken Sie auf VCN anzeigen, um das neue VCN anzuzeigen.

3. Oracle Linux-Instanz installieren

Mit dem Workflow VM-Instanz erstellen können Sie eine neue Compute-Instanz erstellen.

Der Workflow führt bei der Installation der Instanz mehrere Schritte aus:

  • Erstellt und installiert eine Compute-Instanz mit Oracle Linux.
  • Wählen Sie das VCN und das öffentliche Subnetz aus, um die Oracle Linux-Instanz mit dem Internet zu verbinden.
  • Erstellt ein SSH-Schlüsselpaar, mit dem Sie eine Verbindung zur Instanz herstellen können.
Installationsschritte prüfen

Führen Sie die folgenden Schritte aus, um mit der Installation einer Instanz mit dem Workflow VM-Instanz erstellen zu beginnen:

Wichtig

Die angegebenen Schritte gelten für einen Free Tier-Account. Wenn Sie einen kostenpflichtigen Account verwenden, können sich die Schritte von den hier beschriebenen unterscheiden.
  1. Öffnen Sie das Navigationsmenü , und wählen Sie Compute aus. Wählen Sie unter Compute die Option Instanzen aus.
  2. Klicken Sie auf Instanz erstellen.

    Die Seite Compute-Instanz erstellen wird angezeigt.

  3. Wählen Sie den Namen und das Compartment aus.

    Anfängliche Optionen

    • Name: <name-for-the-instance>

      Geben Sie einen Namen für die Instanz ein. Geben Sie dabei keine vertraulichen Informationen ein.

    • Erstellen in Compartment: <your-compartment-name>

      Wählen Sie das Compartment aus. Verwenden Sie das im vorherigen Schritt erstellte Compartment.

  4. Prüfen Sie die Einstellungen für Placement.
    • Übernehmen Sie die Standardwerte. Eine Availability-Domain wird Ihnen zugewiesen.

    Die Standardwerte sind in etwa wie folgt:

    • Availability-Domain: AD-1
    • Kapazitätstyp: On-Demand-Kapazität
    • Faultdomain: Auswahl der optimalen Faultdomain durch Oracle zulassen
    Hinweis

    Verwenden Sie für Free Tier für die Availability-Domain die Option "Always Free" ausgewählt.
  5. Prüfen Sie die Einstellungen für Sicherheit.
    • Übernehmen Sie die Standardeinstellungen.

    Die Standardwerte sind in etwa wie folgt:

    • Abgeschirmte Instanz: Deaktiviert
    • Confidential Computing: Deaktiviert
  6. Prüfen Sie die Einstellungen für Image und Ausprägung. Klicken Sie auf Bearbeiten.
    Hinweis

    Im Folgenden finden Sie Beispieldaten für eine virtuelle Ampere-Maschine A1. Die tatsächlichen Werte können sich davon unterscheiden.
    • Behalten Sie das Standardimage von Oracle Linux 8 bei.
    • Klicken Sie auf Ausprägung ändern.
    • Wählen Sie Virtuelle Maschine aus.
    • Wählen Sie für Ausprägungsreihen Ampere aus.
    • Wählen Sie VM.Standard.A1. Flex der Ausprägung "Immer kostenlos".
    • Wählen Sie 1 OCPUs aus.
    • Klicken Sie auf Ausprägung auswählen.

    Die ausgewählten Werte ähneln den folgenden:

    • Image: Oracle Linux 8
    • Image Build: <current-build-date>
    • Ausprägung: VM.Standard.A1. FlexFeld
    • OCPU: 1
    • Speicher (GB): 6
    • Netzwerkbandbreite (Gbit/s): 1
    Hinweis

    Verwenden Sie für Free Tier die Ausprägungsoption "Immer kostenlos" verfügbar.
  7. Prüfen Sie die Einstellungen für Networking. Wählen Sie das VCN aus, das Sie im vorherigen Schritt erstellt haben. Die Netzwerkwerte ähneln den folgenden Werten:
    • Virtuelles Cloud-Netzwerk: <your-vcn>
    • Subnetz: <pubic-subnet-for-your-vcn>
    • Startoptionen: -
    • DNS-Datensatz: Ja
    • Netzwerksicherheitsgruppen zur Kontrolle des Traffics verwenden: Nein
    • Öffentliche IPv4-Adresse zuweisen: Ja
    • Private IPv4-Adresse: Wird beim Erstellen automatisch zugewiesen
    • IPv6-Adresse: Nicht verfügbar
  8. Prüfen Sie die Einstellungen für SSH-Schlüssel hinzufügen. Übernehmen Sie die vom Workflow vorgegebenen Standardwerte.
    • Wählen Sie die Option Schlüsselpaar für mich generieren aus.
    • Klicken Sie auf Private Key speichern und Public Key speichern, um den privaten und öffentlichen SSH-Schlüssel für diese Compute-Instanz zu speichern.

    Wenn Sie Ihre eigenen SSH-Schlüssel verwenden möchten, wählen Sie eine der Optionen aus, um Ihren Public Key bereitzustellen.

    Hinweis

    Legen Sie Ihre Private- und Public-Key-Dateien an einem sicheren Speicherort ab. Sie können die Schlüssel nicht mehr abrufen, nachdem die Compute-Instanz erstellt wurde.
  9. Prüfen Sie die Einstellungen für das Boot-Volume.

    Wählen Sie die Einstellung Verschlüsselung während der Übertragung verwenden aus. Lassen Sie die beiden anderen Einstellungen leer.

  10. Prüfen Sie die Block-Volume-Einstellungen. Übernehmen Sie die vom Workflow bereitgestellten Standardwerte, die keine Block-Volumes auswählen. Sie können Block-Volumes später hinzufügen.
  11. Klicken Sie auf Erstellen, um die Instanz zu erstellen. Das Provisioning des Systems kann einige Minuten dauern.

Sie haben erfolgreich eine Oracle Linux-Instanz zum Ausführen des Apache-Webservers erstellt.

4. Internetzugriff aktivieren

Der Assistent VM-Instanz erstellen erstellt automatisch ein VCN für Ihre Instanz. Sie fügen Ihrem Subnetz eine Ingress-Regel hinzu, um Internetverbindungen auf Port 3000 zuzulassen.

Ingress-Regel für das VCN erstellen

Führen Sie die folgenden Schritte aus, um das öffentliche Subnetz des VCN auszuwählen und die Ingress-Regel hinzuzufügen.

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Networking, Virtuelle Cloud-Netzwerke.
  2. Wählen Sie das von Ihnen erstellte VCN aus.
  3. Wenn das neue VCN angezeigt wird, klicken Sie auf den Link für das Subnetz <yoursubnet-name>.

    Die Informationen zum öffentlichen Subnetz werden unten auf der Seite mit den Sicherheitslisten angezeigt. Ein Link zur Standardsicherheitsliste für Ihr VCN wird angezeigt.

  4. Klicken Sie auf den Link Standardsicherheitsliste.

    Die Standard-Ingressregeln für das VCN werden angezeigt.

  5. Klicken Sie auf Ingress-Regeln hinzufügen.

    Das Dialogfeld Ingress-Regeln hinzufügen wird angezeigt.

  6. Geben Sie die folgenden Informationen für die Ingress-Regel ein.

    Geben Sie die Ingress-Regel wie folgt ein:

    • zustandslos: Aktiviert
    • Quelltyp: CIDR
    • Quell-CIDR: 0.0.0.0/0
    • IP-Protokoll: TCP
    • Quellportbereich: (leer lassen)
    • Zielportbereich: 3000
    • Beschreibung: HTTP-Verbindungen zulassen
  7. Klicken Sie auf Ingress-Regeln hinzufügen.
    Jetzt sind HTTP-Verbindungen zulässig. Das VCN ist für Node Express konfiguriert.
Sie haben erfolgreich eine Ingress-Regel erstellt, die Ihre Instanz über das Internet verfügbar macht.

5. Node Express-Anwendung erstellen

Richten Sie als Nächstes ein Express-Framework auf Ihrer Oracle Linux-Instanz ein. Erstellen Sie anschließend eine Node.js-Anwendung, und führen Sie sie aus.

Node Express installieren und einrichten

Führen Sie die folgenden Schritte aus, um Ihre Instanz einzurichten und Ihre Anwendung zu erstellen:

  1. Öffnen Sie das Navigationsmenü, und klicken Sie auf Compute. Klicken Sie unter Compute auf Instanzen.
  2. Klicken Sie auf den Link zu der Instanz, die Sie im vorherigen Schritt erstellt haben.

    Gehen Sie auf der Seite Instanzdetails zum Abschnitt Instanzzugriff. Kopieren Sie die öffentliche IP-Adresse, die das System erstellt hat. Mit dieser IP-Adresse können Sie eine Verbindung zu Ihrer Instanz herstellen.

  3. Öffnen Sie das Fenster Terminal oder Prompt.
  4. Wechseln Sie in das Verzeichnis, in dem Sie die SSH-Verschlüsselungsschlüssel gespeichert haben, die Sie für dieses Tutorial erstellt haben.
  5. Stellen Sie mit diesem SSH-Befehl eine Verbindung zur Instanz her: 
    ssh -i <your-private-key-file> opc@<x.x.x.x>

    Da Sie den Public Key beim Erstellen der Instanz angegeben haben, werden Sie mit diesem Befehl bei der Instanz angemeldet. Sie können jetzt sudo-Befehle ausgeben, um den Server zu installieren und zu starten.

  6. Aktivieren Sie die HTTP-Verbindung auf Port 3000. 
    
sudo firewall-cmd --permanent --add-port=3000/tcp
    sudo firewall-cmd --reload
  7. Installieren Sie die neueste Version von Node.js. 
    sudo yum update
    sudo yum install -y nodejs
    node --version
  8. Erstellen Sie ein Verzeichnis für Ihre Anwendung. 
    mkdir node-hello-app
  9. Wechseln Sie in das Verzeichnis node-hello-app. 
    cd node-hello-app
  10. Verwenden Sie npm, um die Datei package.json zu erstellen: 
    npm init

    Geben Sie wie folgt Informationen ein:

    • Name: node-hello-app
    • Version: 1.0.0
    • Beschreibung: Node Express Hello-Anwendung
    • Einstiegspunkt: app.js (Standard nicht verwenden.)
    • Testbefehl: (leer lassen)
    • Git-Repository: git://github.com/username/repository.git (oder durch ein gültiges Git-Repository ersetzen)
    • Schlüsselwörter: (leer lassen)
    • Autor: Beispielbenutzer <username@example.com>
    • Lizenz: UPL-1.0

    Zeigen Sie eine Vorschau der Informationen in package.json an.

    About to write to /home/opc/node-hello-app/package.json:

{
  "name": "node-hello-app",
  "version": "1.0.0",
  "description": "Node Express Hello application",
  "main": "app.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "repository": {
    "type": "git",
    "url": "git://github.com/username/repository.git"
  },
  "author": "Example User <username@example.com>",
  "license": "UPL-1.0",
  "bugs": {
    "url": "https://github.com/username/repository/issues"
  },
  "homepage": "https://github.com/username/repository#readme"
}

    Geben Sie Yes ein, um Ihre Antworten zu akzeptieren.

  11. Installieren Sie Express, und speichern Sie es in der Abhängigkeitsliste von package.json. 
    npm install express --save
  12. Stellen Sie sicher, dass "express" als Abhängigkeit in package.json hinzugefügt wird. 
    cat package.json
    "dependencies": {
    "express": "^4.17.1"
}
  13. Erstellen Sie eine "Hello, World!"-Anwendung.

    Erstellen Sie die Datei:

    vi app.js

    Geben Sie in der Datei folgenden Text ein, und speichern Sie die Datei:

    const express = require('express')
const app = express()

app.get('/', function (req, res) {
  res.send('Hello World!')
})

app.listen(3000, function() {
  console.log('Hello World app listening on port 3000!');
})
  14. Führen Sie das Node.js-Programm aus: 
    node app.js
  15. Testen Sie die Anwendung mit der Befehlszeile oder einem Browser:
    • Für einen Test mit curl melden Sie sich von einem neuen Terminal mit Ihren SSH-Schlüsseln bei Ihrer Ubuntu-Instanz an, und geben Sie dann in der Befehlszeile Folgendes ein: curl -X GET http://localhost:3000
    • Stellen Sie über einen Browser eine Verbindung zur öffentlichen IP-Adresse her, die Ihrer Instanz zugewiesen ist: http://<x.x.x.x>:3000
    Die Node-Anwendung gibt Hello World! auf Ihrer Instanz oder in Ihrem Browser zurück.

Sie haben erfolgreich eine lokale Node.js-Anwendung in einem Express-Framework auf einer Oracle Cloud Infrastructure-Instanz erstellt.

Referenzen:

Weitere Informationen zu Express finden Sie unter:

Weitere Schritte

Sie haben erfolgreich eine Node Express-Anwendung auf Oracle Cloud Infrastructure mit einer Linux-Instanz installiert und bereitgestellt.

Weitere Informationen zur Entwicklung mit Oracle-Produkten finden Sie unter: