Membuat aplikasi .NET di lingkungan fleksibel App Engine

Membuat aplikasi .NET di lingkungan fleksibel App Engine

ID region

REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.

Pelajari ID region lebih lanjut.

Oke

Catatan: Jika Anda men-deploy layanan web .NET baru ke Google Cloud, sebaiknya mulai menggunakan Cloud Run.

Panduan memulai ini menunjukkan cara membuat dan men-deploy aplikasi yang menampilkan pesan singkat. Anda dapat menggunakan aplikasi contoh dalam panduan memulai ini untuk versi .NET yang didukung, dengan menentukan versi runtime dan sistem operasi dalam file app.yaml. Secara default, App Engine menggunakan versi .NET LTS terbaru yang tersedia jika Anda tidak menentukan versi runtime dalam file app.yaml.

Sebelum memulai

Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Instal Google Cloud CLI.

Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

Untuk melakukan inisialisasi gcloud CLI, jalankan perintah berikut:

gcloud init

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menyelesaikan panduan memulai ini, minta administrator untuk memberi Anda peran IAM berikut:

• App Engine Admin (roles/appengine.appAdmin) di project
• Cloud Build Editor (roles/cloudbuild.builds.editor) di project
• Storage Object Admin (roles/storage.objectAdmin) di project
• Logs Viewer (roles/logging.viewer) di project
• Pengguna Akun Layanan (roles/iam.serviceAccountUser) di akun layanan
• Minta administrator Anda untuk memberikan peran berikut untuk akun layanan default App Engine:
  • Pembaca Artifact Registry (roles/artifactregistry.reader) di project
  • Akun Layanan Cloud Build (roles/cloudbuild.builds.builder) di project
  • Storage Object Viewer (roles/storage.objectViewer) di project

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Prasyarat tambahan

1. Lakukan inisialisasi aplikasi App Engine dengan project Anda, lalu pilih region:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Saat diminta, pilih region tempat Anda ingin menemukan aplikasi App Engine.

   Perhatian: Anda tidak dapat mengubah region aplikasi setelah ditetapkan.

2. Instal komponen berikut di komputer lokal Anda:

• Instal .NET Core SDK, versi LTS.

• Jika menggunakan Visual Studio, Anda harus menggunakan versi 2015 atau yang lebih baru. Gambar tersedia untuk aplikasi ASP.NET Core yang ditulis untuk .NET Core 1.0, 1.1, 2.0, dan 2.1.

Lokasi App Engine

App Engine bersifat regional. Artinya, infrastruktur yang menjalankan aplikasi Anda terletak di region tertentu, dan Google mengelolanya sehingga aplikasi Anda tersedia secara redundan di semua zona dalam region tersebut.

Memenuhi persyaratan latensi, ketersediaan, atau ketahanan adalah faktor utama untuk memilih region tempat aplikasi dijalankan. Umumnya, Anda dapat memilih region yang paling dekat dengan pengguna aplikasi Anda, tetapi Anda harus mempertimbangkan lokasi tempat App Engine tersedia serta lokasi dari produk dan layanan Google Cloud lainnya yang digunakan aplikasi Anda.Google Cloud Penggunaan layanan di beberapa lokasi dapat memengaruhi latensi dan harga aplikasi.

Anda tidak dapat mengubah region aplikasi setelah menyetelnya.

Catatan: Dua lokasi, yang disebut europe-west dan us-central dalam perintah App Engine dan di konsol Google Cloud , masing-masing disebut europe-west1 dan us-central1, di bagian lain dalam dokumentasi Google.

Jika sudah membuat aplikasi App Engine, Anda dapat melihat region-nya dengan melakukan salah satu tindakan berikut:

• Jalankan perintah gcloud app describe.

• Buka Dasbor App Engine di Google Cloud konsol. Region muncul di dekat bagian atas halaman.

Oke

Panduan memulai ini mengasumsikan bahwa Anda sudah memahami cara membuat aplikasi web dengan C#.

Mendownload aplikasi Halo Dunia

Kami telah membuat aplikasi Hello World untuk App Engine agar Anda dapat dengan cepat memahami cara men-deploy aplikasi ke Google Cloud. Aplikasi Hello World mirip dengan aplikasi yang dibuat oleh Visual Studio saat aplikasi inti ASP.NET kosong dibuat. Aplikasi contoh menambahkan file app.yaml. File app.yaml adalah file konfigurasi App Engine yang menentukan runtime Anda dan setelan App Engine lainnya.

1. Buat clone repositori aplikasi contoh Halo Dunia ke komputer lokal Anda.

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples
   

   Atau, Anda dapat mendownload sampel sebagai file ZIP dan mengekstraknya.

2. Ubah ke direktori yang berisi kode contoh.

      cd dotnet-docs-samples/appengine/flexible/HelloWorld
   

Jalankan Halo Dunia di komputer lokal

1. Jalankan perintah berikut dari direktori dotnet-docs-samples/appengine/flexible/HelloWorld/HelloWorld.Sample:

   dotnet restore
   dotnet run
   

2. Di browser web, buka http://localhost:5000. Anda dapat melihat pesan "Halo Dunia" dari aplikasi contoh yang ditampilkan di halaman. Di jendela terminal, tekan Ctrl+C untuk keluar dari server web.

Deploy dan jalankan Halo Dunia di App Engine

1. Jalankan gcloud app deploy dari command line.
2. Luncurkan browser Anda dan lihat aplikasi di https://PROJECT_ID.REGION_ID.r.appspot.com gcloud app browse

Kali ini, halaman yang menampilkan pesan Halo Dunia dikirim oleh server web yang berjalan di instance App Engine.

Selamat! Anda telah men-deploy aplikasi App Engine pertama Anda ke lingkungan fleksibel App Engine.

Jika Anda mengalami error saat men-deploy aplikasi, lihat tips pemecahan masalah.

Lihat bagian berikut untuk mengetahui informasi tentang pembersihan serta link ke kemungkinan langkah berikutnya yang dapat Anda lakukan.

Pembersihan

Agar tidak menimbulkan biaya, Anda dapat menghapus project Google Cloud untuk menghentikan penagihan semua resource yang digunakan dalam project tersebut.

Perhatian: Penghapusan project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk mengerjakan tugas di dokumen ini, saat Anda menghapusnya, pekerjaan lain dalam project tersebut juga akan dihapus.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin juga membuat project ID kustom yang masih ingin digunakan pada masa mendatang. Agar tidak kehilangan URL yang menggunakan project ID tersebut, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.
1. Di Konsol Google Cloud , buka halaman Manage resources.

   Buka Kelola resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah berikutnya

Mempelajari seluruh platform

Setelah mengetahui cara mengembangkan dan men-deploy aplikasi App Engine, Anda dapat menjelajahi bagian Google Cloudlainnya. Anda telah menginstal Google Cloud CLI yang menyediakan alat untuk berinteraksi dengan produk seperti Cloud SQL, Cloud Storage, Firestore, dan lainnya.

Mempelajari lingkungan fleksibel App Engine

Berikut beberapa topik yang dapat membantu Anda melanjutkan pembelajaran tentang App Engine:

• Ringkasan App Engine
• Meminta pemilihan rute
• Meminta penanganan
• Mengelola instance

Ulasan kode Halo Dunia

Halo Dunia adalah aplikasi App Engine paling sederhana, karena hanya berisi satu layanan, hanya memiliki satu versi, dan semua kode berada dalam direktori utama aplikasi. Bagian ini menjelaskan setiap file aplikasi secara mendetail.

Program.cs

Aplikasi Halo Dunia adalah aplikasi ASP.NET sederhana.

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => builder.Configuration["My:Greeting"]);

app.Run();

app.yaml

File app.yaml mendeskripsikan konfigurasi berikut untuk aplikasi Anda:

• Menetapkan env: flex, yang menunjukkan bahwa aplikasi Anda menggunakan lingkungan fleksibel App Engine.

• Menentukan runtime yang digunakan oleh aplikasi.

  runtime: aspnetcore
  env: flex
  
  runtime_config:
    operating_system: ubuntu22
  
  # This sample incurs costs to run on the App Engine flexible environment. 
  # The settings below are to reduce costs during testing and are not appropriate
  # for production use. For more information, see:
  # https://cloud.google.com/appengine/docs/flexible/dotnet/configuring-your-app-with-app-yaml
  manual_scaling:
    instances: 1
  resources:
    cpu: 1
    memory_gb: 0.5
    disk_size_gb: 10
  
  env_variables:
    # The __ in My__Greeting will be translated to a : by ASP.NET.
    My__Greeting: Hello AppEngine!
  

  • Untuk informasi selengkapnya tentang cara kerja runtime .NET, lihat Runtime .NET.

  • Untuk mengetahui detail selengkapnya tentang cara mendesain aplikasi yang memanfaatkan versi dan layanan, lihat Ringkasan App Engine.

  • Untuk mengetahui detail selengkapnya tentang setelan konfigurasi untuk App Engine, lihat Mengonfigurasi aplikasi dengan app.yaml.