.NET-Anwendung in der flexiblen App Engine-Umgebung erstellen
Regions-ID
REGION_ID
ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r
in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.
In dieser Kurzanleitung wird gezeigt, wie Sie eine Anwendung erstellen und bereitstellen, die eine kurze Nachricht anzeigt.
Sie können die Beispielanwendung in dieser Kurzanleitung für jede unterstützte .NET-Version verwenden. Geben Sie dazu die Laufzeitversion und das Betriebssystem in der Datei app.yaml
an.
Wenn Sie in der Datei app.yaml
keine Laufzeitversion angeben, verwendet App Engine standardmäßig die neueste verfügbare LTS .NET-Version.
Vorbereitung
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Cloud Build API.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
Zusätzliche Voraussetzungen
Initialisieren Sie die App Engine-Anwendung mit Ihrem Projekt und wählen Sie die Region aus:
gcloud app create --project=[YOUR_PROJECT_ID]
Wählen Sie bei entsprechender Aufforderung die Region aus, in der sich die App Engine-Anwendung befinden soll.
Installieren Sie Folgendes auf Ihrem lokalen Computer:
Installieren Sie die LTS-Version des .NET Core SDK.
Wenn Sie mit Visual Studio arbeiten, brauchen Sie Version 2015 oder höher. Images sind für ASP.NET-Core-Anwendungen verfügbar, die für .NET Core 1.0, 1.1, 2.0 oder 2.1 geschrieben wurden.
Tools for Visual Studio installieren, um direkt von Visual Studio aus in App Engine bereitstellen zu können.
App Engine-Standorte
App Engine ist regional, was bedeutet, dass sich die Infrastruktur, in der Ihre Anwendungen ausgeführt werden, in einer bestimmten Region befindet und Google sie so verwaltet, dass sie redundant in allen Zonen innerhalb dieser Region verfügbar ist.
Die Erfüllung der Latenz-, Verfügbarkeits- oder Langlebigkeitsanforderungen ist der wichtigste Gesichtspunkt bei der Auswahl der Region, in der Ihre Anwendungen ausgeführt werden sollen. Sie können im Allgemeinen die Region auswählen, die den Nutzern Ihrer Anwendung am nächsten ist. Sie sollten jedoch die Standorte berücksichtigen, an denen App Engine verfügbar ist, sowie die Standorte der anderen Google Cloud-Produkte und -Dienste, die Ihre Anwendung nutzt. Eine Nutzung von Diensten über mehrere Standorte kann die Latenz der Anwendung sowie die Preise beeinflussen.
Sie können die Region einer Anwendung nicht mehr ändern, nachdem Sie sie festgelegt haben.
Wenn Sie bereits eine App Engine-Anwendung erstellt haben, können Sie die Region mit einer der folgenden Methoden aufrufen:
Führen Sie den Befehl
gcloud app describe
aus:Öffnen Sie das App Engine-Dashboard in der Google Cloud Console. Die Region wird oben auf der Seite angezeigt.
Hello-World-Anwendung herunterladen
Wir haben eine einfache Hello-World-Anwendung für App Engine entwickelt, damit Sie schnell ein Gefühl für die Bereitstellung einer Anwendung in der Google Cloud entwickeln können.
Die Hello World-Beispielanwendung ähnelt der Anwendung, die von Visual Studio als leere ASP.NET Core-Anwendung erstellt wird. In der Beispielanwendung kommt eine app.yaml
-Datei hinzu. Die app.yaml
-Datei ist eine App Engine-Konfigurationsdatei, in der die Laufzeit und andere App Engine-spezifische Einstellungen angegeben werden.
Klonen Sie das Repository der Hello-World-Beispielanwendung auf dem lokalen Computer:
git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples
Sie können das Beispiel auch als ZIP-Datei herunterladen und extrahieren.
Wechseln Sie zu dem Verzeichnis, das den Beispielcode enthält:
cd dotnet-docs-samples/appengine/flexible/HelloWorld
Hello-World-Anwendung auf lokalem Computer ausführen
Führen Sie die folgenden Befehle im Verzeichnis
dotnet-docs-samples/appengine/flexible/HelloWorld/HelloWorld.Sample
aus:dotnet restore dotnet run
Rufen Sie in Ihrem Webbrowser http://localhost:5000 auf. Auf der Seite wird die Nachricht "Hello World" aus der Beispielanwendung angezeigt. Drücken Sie im Terminalfenster Strg+C, um den Webserver zu beenden.
Hello World in App Engine bereitstellen und ausführen
- Führen Sie
gcloud app deploy
über die Befehlszeile aus. - Starten Sie den Browser und rufen Sie die Anwendung unter
https://PROJECT_ID.REGION_ID.r.appspot.com
gcloud app browse
auf
Dieses Mal wird die Seite mit der Nachricht „Hello World” von einem Webserver bereitgestellt, der auf einer App Engine-Instanz ausgeführt wird.
Das wars! Sie haben Ihre erste App Engine-Anwendung in der flexiblen App Engine-Umgebung bereitgestellt!
Wenn beim Bereitstellen Ihrer Anwendung Fehler aufgetreten sind, lesen Sie die Tipps zur Fehlerbehebung.In den folgenden Abschnitten finden Sie Informationen zur Bereinigung sowie Links für mögliche weitere Schritte.
Bereinigen
Zur Vermeidung von Gebühren können Sie Ihr Google Cloud-Projekt löschen und so die Abrechnung für alle in diesem Projekt verwendeten Ressourcen beenden.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.
Nächste Schritte
Informationen zur Plattform
Sie wissen jetzt, wie Sie Anwendungen in App Engine entwickeln und bereitstellen. Nun können Sie sich mit den weiteren Bereichen von Google Cloud vertraut machen. Sie haben bereits die Google Cloud CLI installiert, mit der Sie die Tools zur Interaktion mit Produkten wie z. B. Cloud SQL, Cloud Storage, Firestore nutzen können.
Informationen zur flexiblen App Engine-Umgebung
Im Folgenden finden Sie weitere Themen zu App Engine:
Hello World-Code prüfen
Die Hello-World-Anwendung ist die einfachste realisierbare App Engine-Anwendung, da sie nur einen Dienst enthält, nur eine Version hat und sich der gesamte Code im Stammverzeichnis der Anwendung befindet. Dieser Abschnitt beschreibt alle Dateien der Anwendung im Detail.
Program.cs
Die "Hello World"-Anwendung ist eine einfache ASP.NET-Anwendung:
app.yaml
In der app.yaml
-Datei wird die folgende Konfiguration für Ihre Anwendung beschrieben:
- Legt
env: flex
fest. Dies gibt an, dass Ihre Anwendung die flexible App Engine-Umgebung verwendet. Gibt die von der App verwendete Laufzeit an.
Weitere Informationen zur Funktionsweise der .NET-Laufzeit finden Sie unter .NET-Laufzeit.
Weitere Informationen zum Entwickeln der Anwendung unter Nutzung der Vorteile von Versionen und Diensten finden Sie unter Überblick über App Engine.
Weitere Informationen zu den Konfigurationseinstellungen für App Engine finden Sie unter Anwendung mit app.yaml konfigurieren