Erste Schritte mit Node.js in Compute Engine

In dieser Anleitung werden die ersten Schritte mit Compute Engine erläutert. Im Zuge dieser Anleitung stellen Sie eine in Node.js geschriebene "Hello World"-Webanwendung in Compute Engine bereit. Hilfe zu den ersten Schritten mit App Engine finden Sie in der App Engine-Standardumgebung.

Lernziele

  • "Hello World"-Beispielanwendung mit Cloud Shell herunterladen und bereitstellen
  • "Hello World"-Beispielanwendung in einer einzelnen Compute Engine-Instanz bereitstellen

Kosten

In dieser Anleitung werden die folgenden kostenpflichtigen Komponenten von Google Cloud verwendet:

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Hinweise

  1. Melden Sie sich bei Ihrem Google-Konto an.

    Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

  2. Wählen Sie in der Cloud Console auf der Seite für die Projektauswahl ein Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Compute Engine API.

    Aktivieren Sie die API

  5. Öffnen Sie die Anwendung in der Google Cloud Console über Cloud Shell.

    Zu Cloud Shell

    Cloud Shell bietet Ihnen direkt über den Browser Befehlszeilenzugriff auf Ihre Cloud-Ressourcen. Öffnen Sie Cloud Shell im Browser und klicken Sie auf Fortfahren, um den Beispielcode herunterzuladen und ins Anwendungsverzeichnis zu wechseln.

  6. Konfigurieren Sie in Cloud Shell das gcloud-Tool, um das neue Google Cloud-Projekt zu verwenden:
    # Configure gcloud for your project
    gcloud config set project YOUR_PROJECT_ID
    

Anwendung in Cloud Shell ausführen

  1. Installieren Sie die Abhängigkeiten:

    npm install
    
  2. Führen Sie die Anwendung aus:

    npm start
    
  3. Klicken Sie in Cloud Shell auf Webvorschau und wählen Sie dann Vorschau auf Port 8080 aus. Ein neues Fenster mit der ausgeführten Anwendung wird geöffnet.

Drücken Sie Strg+C, um den lokalen Webserver zu beenden.

Auf einer einzelnen Instanz bereitstellen

In diesem Abschnitt wird die Ausführung einer einzelnen Instanz der Anwendung in Compute Engine beschrieben.

Bereitstellung einer einzelnen Instanz

Mit Cloud Shell können Sie eine einzelne Instanz in einer Compute Engine-VM bereitstellen, auf der Ihre Anwendung ausgeführt wird.

Instanz mithilfe eines Startskripts initialisieren

Sie müssen Ihre Instanz anweisen, den Code herunterzuladen und auszuführen. Eine Instanz kann ein Startskript haben, das bei jedem Start oder Neustart der Instanz ausgeführt wird.

Hier sehen Sie das Startskript, das in der "Hello World"-Beispielanwendung enthalten ist:

set -v

# Talk to the metadata server to get the project id
PROJECTID=$(curl -s "http://metadata.google.internal/computeMetadata/v1/project/project-id" -H "Metadata-Flavor: Google")
REPOSITORY="[YOUR-REPOSITORY]"

# Install logging monitor. The monitor will automatically pick up logs sent to
# syslog.
curl -s "https://storage.googleapis.com/signals-agents/logging/google-fluentd-install.sh" | bash
service google-fluentd restart &

# Install dependencies from apt
apt-get update
apt-get install -yq ca-certificates git build-essential supervisor

# Install nodejs
mkdir /opt/nodejs
curl https://nodejs.org/dist/v8.12.0/node-v8.12.0-linux-x64.tar.gz | tar xvzf - -C /opt/nodejs --strip-components=1
ln -s /opt/nodejs/bin/node /usr/bin/node
ln -s /opt/nodejs/bin/npm /usr/bin/npm

# Get the application source code from the Google Cloud Repository.
# git requires $HOME and it's not set during the startup script.
export HOME=/root
git config --global credential.helper gcloud.sh
git clone https://source.developers.google.com/p/${PROJECTID}/r/${REPOSITORY} /opt/app

# Install app dependencies
cd /opt/app/gce
npm install

# Create a nodeapp user. The application will run as this user.
useradd -m -d /home/nodeapp nodeapp
chown -R nodeapp:nodeapp /opt/app

# Configure supervisor to run the node app.
cat >/etc/supervisor/conf.d/node-app.conf << EOF
[program:nodeapp]
directory=/opt/app/gce
command=npm start
autostart=true
autorestart=true
user=nodeapp
environment=HOME="/home/nodeapp",USER="nodeapp",NODE_ENV="production"
stdout_logfile=syslog
stderr_logfile=syslog
EOF

supervisorctl reread
supervisorctl update

# Application should now be running under supervisor

Das Startskript führt die folgenden Aktionen aus:

  • Installiert den Cloud Logging-Agent. Der Agent erfasst automatisch Logs aus syslog.

  • Installiert Supervisor, um die Anwendung als Daemon auszuführen.

  • Klont den Quellcode der Anwendung aus Cloud Source Repositories und installiert Abhängigkeiten.

  • Konfiguriert Supervisor zum Ausführen der Anwendung. Supervisor sorgt dafür, dass die Anwendung neu gestartet wird, wenn sie unerwartet beendet oder von einem Administrator oder einem anderen Prozess abgebrochen wird. Außerdem sendet Supervisor die Standarddatenströme stdout und stderr an syslog, damit sie vom Logging-Agent erfasst werden.

Compute Engine-Instanz erstellen und konfigurieren

  1. Erstellen Sie eine Compute Engine-Instanz:

    Linux/macOS

    gcloud compute instances create my-app-instance \
        --image-family=debian-9 \
        --image-project=debian-cloud \
        --machine-type=g1-small \
        --scopes userinfo-email,cloud-platform \
        --metadata app-location=$DEPLOY_LOCATION \
        --metadata-from-file startup-script=gce/startup-script.sh \
        --zone us-central1-f \
        --tags http-server
    

    Windows

    gcloud compute instances create my-app-instance ^
        --image-family=debian-9 ^
        --image-project=debian-cloud ^
        --machine-type=g1-small ^
        --scopes userinfo-email,cloud-platform ^
        --metadata-from-file startup-script=gce/startup-script.sh ^
        --zone us-central1-f ^
        --tags http-server
    

    Ersetzen Sie die Zone durch eine Entwicklungszone, z. B. us-central1-a. Weitere Informationen zu Regionen und Zonen finden Sie unter Geografie und Regionen.

    Hierdurch wird eine neue Instanz erstellt, deren Zugriff auf Google Cloud-Dienste ermöglicht und das Startskript ausgeführt. Der Instanzname lautet my-app-instance.

  2. Prüfen Sie den Fortschritt der Instanzerstellung:

    gcloud compute instances get-serial-port-output my-app-instance --zone YOUR_ZONE
    

    Ersetzen Sie YOUR_ZONE durch die Zone, in der Sie die Instanz bereitgestellt haben.

    Wenn das Startskript abgeschlossen ist, sehen Sie folgende Meldung:

    startup-script: INFO Finished running startup scripts.
    
  3. Erstellen Sie eine Firewallregel, die Traffic zur Instanz zulässt:

    gcloud compute firewall-rules create default-allow-http-80 \
        --allow tcp:80 \
        --source-ranges 0.0.0.0/0 \
        --target-tags http-server \
        --description "Allow port 80 access to http-server"
    

  4. Rufen Sie die externe IP-Adresse der Instanz ab:

    gcloud compute instances list
    
  5. Geben Sie die folgende URL in Ihren Browser ein, wenn Sie Ihre ausgeführte Anwendung sehen möchten:

    http://YOUR_INSTANCE_IP
    

    Ersetzen Sie YOUR_INSTANCE_IP durch die externe IP-Adresse Ihrer Instanz.

Instanzen verwalten und beobachten

Mit der Cloud Console können Sie Ihre Instanz im Blick behalten und verwalten.

  1. Öffnen Sie in der Cloud Console die Seite VM-Instanzen.

    Zur Seite "VM-Instanzen"

  2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der Instanz, zu der Sie eine Verbindung herstellen möchten, auf SSH.
  3. Wenn Sie alle von Ihren Compute Engine-Ressourcen generierten Logs anzeigen lassen möchten, rufen Sie die Seite Loganzeige auf. Loganzeige aufrufen

    Cloud Logging wird automatisch so konfiguriert, dass Logs aus verschiedenen gängigen Diensten erfasst werden, einschließlich syslog.

Bereinigen

So vermeiden Sie, dass Ihr Google Cloud Platform-Konto für die in dieser Anleitung genutzten Ressourcen unnötig mit Gebühren belastet wird:

Projekt löschen

  1. Wechseln Sie in der Cloud Console zur Seite Ressourcen verwalten.

    Zur Seite "Ressourcen verwalten"

  2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen .
  3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Beenden, um das Projekt zu löschen.

Einzelne Ressourcen löschen

gcloud compute instances delete my-app-instance --zone=YOUR_ZONE --delete-disks=all
gcloud compute firewall-rules delete default-allow-http-80

Weitere Informationen