Menggunakan platform.NET - AWS App Runner
Konfigurasi runtime .NETContoh runtime .NET

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan platform.NET

AWS App Runner Platform.NET menyediakan runtime terkelola. Setiap runtime memudahkan untuk membangun dan menjalankan container dengan aplikasi web berdasarkan versi.NET. Saat Anda menggunakan runtime.NET, App Runner dimulai dengan image runtime.NET yang dikelola. Gambar ini didasarkan pada image Amazon Linux Docker dan berisi paket runtime untuk versi.NET dan beberapa alat dan paket ketergantungan populer. App Runner menggunakan image runtime terkelola ini sebagai image dasar, dan menambahkan kode aplikasi Anda untuk membuat image Docker. Kemudian menyebarkan gambar ini untuk menjalankan layanan web Anda dalam sebuah wadah.

Anda menentukan runtime untuk layanan App Runner saat membuat layanan menggunakan konsol App Runner atau operasi API. CreateService Anda juga dapat menentukan runtime sebagai bagian dari kode sumber Anda. Gunakan runtime kata kunci dalam file konfigurasi App Runner yang Anda sertakan dalam repositori kode Anda. Konvensi penamaan runtime terkelola adalah. <language-name><major-version>

Untuk nama dan versi runtime .NET yang valid, lihat. NETinformasi rilis runtime.

App Runner memperbarui runtime untuk layanan Anda ke versi terbaru pada setiap penerapan atau pembaruan layanan. Jika aplikasi Anda memerlukan versi tertentu dari runtime terkelola, Anda dapat menentukannya menggunakan runtime-version kata kunci dalam file konfigurasi App Runner. Anda dapat mengunci ke tingkat versi apa pun, termasuk versi mayor atau minor. App Runner hanya membuat pembaruan tingkat rendah untuk runtime layanan Anda.

Sintaks versi untuk runtime.NET: major[.minor[.patch]]

Misalnya: 6.0.9

Contoh berikut menunjukkan penguncian versi:

  • 6.0— Kunci versi mayor dan minor. App Runner hanya memperbarui versi tambalan.

  • 6.0.9— Kunci ke versi patch tertentu. App Runner tidak memperbarui versi runtime Anda.

Topik

Konfigurasi runtime .NET

Saat memilih runtime terkelola, Anda juga harus mengonfigurasi, seminimal mungkin, membangun dan menjalankan perintah. Anda mengonfigurasinya saat membuat atau memperbarui layanan App Runner. Anda dapat melakukan ini menggunakan salah satu metode berikut:

  • Menggunakan konsol App Runner — Tentukan perintah di bagian Configure build pada tab proses pembuatan atau konfigurasi.

  • Menggunakan App Runner API — Panggil operasi CreateServiceatau UpdateServiceAPI. Tentukan perintah menggunakan BuildCommand dan StartCommand anggota tipe CodeConfigurationValuesdata.

  • Menggunakan file konfigurasi — Tentukan satu atau beberapa perintah build hingga tiga fase build, dan satu perintah run yang berfungsi untuk memulai aplikasi Anda. Ada pengaturan konfigurasi opsional tambahan.

Menyediakan file konfigurasi adalah opsional. Saat membuat layanan App Runner menggunakan konsol atau API, Anda menentukan apakah App Runner mendapatkan setelan konfigurasi secara langsung saat dibuat atau dari file konfigurasi.

Contoh runtime .NET

Contoh berikut menunjukkan file konfigurasi App Runner untuk membangun dan menjalankan layanan.NET. Contoh terakhir adalah kode sumber untuk aplikasi.NET lengkap yang dapat Anda gunakan ke layanan runtime .NET.

catatan

Versi runtime yang digunakan dalam contoh ini adalah 6.0.9. Anda dapat menggantinya dengan versi yang ingin Anda gunakan. Untuk versi runtime.NET terbaru yang didukung, lihat. NETinformasi rilis runtime.

Contoh ini menunjukkan file konfigurasi minimal yang dapat Anda gunakan dengan runtime yang dikelola .NET. Untuk asumsi yang dibuat oleh App Runner dengan file konfigurasi minimal, lihat. Contoh file konfigurasi

contoh apprunner.yaml
version: 1.0
runtime: dotnet6
build:
  commands:    
    build:
      - dotnet publish -c Release -o out
run:                              
  command: dotnet out/HelloWorldDotNetApp.dll

Contoh ini menunjukkan penggunaan semua kunci konfigurasi dengan runtime yang dikelola .NET.

catatan

Versi runtime yang digunakan dalam contoh ini adalah 6.0.9. Anda dapat menggantinya dengan versi yang ingin Anda gunakan. Untuk versi runtime.NET terbaru yang didukung, lihat. NETinformasi rilis runtime.

contoh apprunner.yaml
version: 1.0
runtime: dotnet6
build:
  commands:
    pre-build:
      - scripts/prebuild.sh
    build:
      - dotnet publish -c Release -o out
    post-build:
      - scripts/postbuild.sh
  env:
    - name: MY_VAR_EXAMPLE
      value: "example"    
run:
  runtime-version: 6.0.9
  command: dotnet out/HelloWorldDotNetApp.dll
  network:
    port: 5000
    env: APP_PORT
  env:
    - name: ASPNETCORE_URLS
      value: "http://*:5000"

Contoh ini menunjukkan kode sumber untuk aplikasi.NET lengkap yang dapat Anda gunakan ke layanan runtime .NET.

catatan

  • Jalankan perintah berikut untuk membuat aplikasi web.NET 6 sederhana: dotnet new web --name HelloWorldDotNetApp -f net6.0

  • Tambahkan apprunner.yaml ke aplikasi web.NET 6 yang dibuat.

contoh HelloWorldDotNetApp
version: 1.0
runtime: dotnet6
build:
  commands:
    build:
      - dotnet publish -c Release -o out
run:
  command: dotnet out/HelloWorldDotNetApp.dll
  network:
    port: 5000
    env: APP_PORT
  env:
    - name: ASPNETCORE_URLS
      value: "http://*:5000"