Erste Schritte mit Ruby in Compute Engine

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

Lernziele

  • Laden Sie mit Cloud Shell eine "Hello World"-Beispielanwendung herunter und stellen Sie sie bereit
  • "Hello World"-Beispielanwendung in einer einzelnen Compute Engine-Instanz bereitstellen

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

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.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

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

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Compute Engine API aktivieren.

    Aktivieren Sie die API

    5.

  5. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  6. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  7. Compute Engine API aktivieren.

    Aktivieren Sie die API

    8.

  8. Öffnen Sie in der Google Cloud Console die App in Cloud Shell.

    Zu Cloud Shell

    Cloud Shell bietet Ihnen direkt über den Browser Befehlszeilenzugriff auf Ihre Cloud-Ressourcen.

  9. Wenn Sie damit einverstanden sind, das Repository zu klonen, klicken Sie auf Bestätigen, um den Beispielcode herunterzuladen und in das Anwendungsverzeichnis zu wechseln.

  10. Konfigurieren Sie in Cloud Shell die gcloud CLI für die Verwendung Ihres neuen Google Cloud-Projekts: 
    # Configure gcloud for your project
gcloud config set project YOUR_PROJECT_ID

Anwendung in Cloud Shell ausführen

  1. Installieren Sie in Cloud Shell die Abhängigkeiten Ihrer Anwendung mit bundle:

    bundle install

  2. Führen Sie die Sinatra-App aus:

    bundle exec ruby app.rb -p 8080

  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.

  4. 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 App 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.

getting-started/gce/startup-script.sh 
# Install Stackdriver logging agent
curl -sSO https://dl.google.com/cloudagents/add-logging-agent-repo.sh
bash add-logging-agent-repo.sh --also-install

# Install dependencies
apt-get update && apt-get -y upgrade && apt-get install -y autoconf bison \
    build-essential git libssl-dev libyaml-dev libreadline6-dev zlib1g-dev \
    libncurses5-dev libffi-dev libgdbm3 libgdbm-dev nginx supervisor

# Account to own server process
useradd -m -d /home/rubyapp rubyapp

# Install Ruby and Bundler
mkdir /home/rubyapp/.ruby
git clone https://github.com/rbenv/ruby-build.git /home/rubyapp/.ruby-build
/home/rubyapp/.ruby-build/bin/ruby-build 2.6.5 /home/rubyapp/.ruby

chown -R rubyapp:rubyapp /home/rubyapp

cat >/home/rubyapp/.profile << EOF
export PATH="/home/rubyapp/.ruby/bin:$PATH"
EOF

su -l rubyapp -c "gem install bundler"

# Fetch source code
git clone https://github.com/GoogleCloudPlatform/getting-started-ruby.git /opt/app

# Set ownership to newly created account
chown -R rubyapp:rubyapp /opt/app

# Install ruby dependencies
su -l rubyapp -c "cd /opt/app/gce && bundle install"

# Disable the default NGINX configuration
rm /etc/nginx/sites-enabled/default

# Enable our NGINX configuration
cp /opt/app/gce/rubyapp.conf /etc/nginx/sites-available/rubyapp.conf
ln -s /etc/nginx/sites-available/rubyapp.conf /etc/nginx/sites-enabled/rubyapp.conf

# Start NGINX
systemctl restart nginx.service

# Configure supervisor to run the ruby app
cat >/etc/supervisor/conf.d/rubyapp.conf << EOF
[program:rubyapp]
directory=/opt/app/gce
command=bash -lc "bundle exec ruby app.rb"
autostart=true
autorestart=true
user=rubyapp
environment=HOME="/home/rubyapp",USER="rubyapp"
stdout_logfile=syslog
stderr_logfile=syslog
EOF

supervisorctl reread
supervisorctl update

# Application should now be running under supervisor

Das Startskript führt folgende Aufgaben durch:

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

  • Installiert Ruby 2.6.5, Bundler und deren Systemabhängigkeiten.

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

  • Installieren und konfigurieren Sie Nginx.

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

  • 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

    getting-started/gce/deploy.sh 
    MY_INSTANCE_NAME="my-app-instance"
ZONE=us-central1-a

gcloud compute instances create $MY_INSTANCE_NAME \
    --image-family=debian-9 \
    --image-project=debian-cloud \
    --machine-type=g1-small \
    --scopes userinfo-email,cloud-platform \
    --metadata-from-file startup-script=startup-script.sh \
    --zone $ZONE \
    --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-a ^
    --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 überwachen

Mit der Google Cloud Console können Sie Ihre Instanz überwachen und verwalten.

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zu 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. Rufen Sie die Seite Log-Explorer auf, um alle von Ihren Compute Engine-Ressourcen generierten Logs anzusehen. Zum Log-Explorer

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

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.

Projekt löschen

  1. Wechseln Sie in der Google 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 Shut down (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