View a markdown version of this page

Menyebarkan versi aplikasi baru ke App Runner - AWS App Runner

AWS App Runner Tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat perubahan AWS App Runner ketersediaan.

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

Menyebarkan versi aplikasi baru ke App Runner

Saat Anda membuat layanan di AWS App Runner, Anda mengonfigurasi sumber aplikasi—image wadah atau repositori sumber. App Runner menyediakan sumber daya untuk menjalankan layanan Anda dan menyebarkan aplikasi Anda ke mereka.

Topik ini menjelaskan cara untuk menyebarkan kembali sumber aplikasi Anda ke layanan App Runner saat versi baru tersedia. Ini bisa berupa versi gambar baru di repositori gambar atau komit baru di repositori kode. App Runner menyediakan dua metode untuk menerapkan ke layanan: otomatis dan manual.

Metode deployment

App Runner menyediakan metode berikut bagi Anda untuk mengontrol bagaimana penerapan aplikasi dimulai.

Penyebaran otomatis

Gunakan penerapan otomatis saat Anda menginginkan integrasi berkelanjutan dan perilaku pener CI/CD apan () untuk layanan Anda. App Runner memantau gambar atau repositori kode Anda untuk perubahan.

Repositori gambar - Setiap kali Anda mendorong versi gambar baru ke repositori gambar Anda, atau komit baru ke repositori kode Anda, App Runner secara otomatis menyebarkannya ke layanan Anda tanpa tindakan lebih lanjut di pihak Anda.

Repositori kode - Setiap kali Anda mendorong komit baru ke repositori kode Anda yang membuat perubahan di direktori sumber, App Runner menyebarkan seluruh repositori Anda. Karena hanya perubahan pada direktori sumber yang memicu penerapan otomatis, penting untuk memahami bagaimana lokasi direktori sumber mempengaruhi ruang lingkup penerapan otomatis.

  • Top-level direktori (root repositori) - Ini adalah nilai default yang ditetapkan untuk direktori sumber saat Anda membuat layanan. Jika direktori sumber Anda diatur ke nilai ini, ini berarti seluruh repositori berada di dalam direktori sumber. Jadi semua commit yang Anda dorong ke repositori sumber akan memicu penerapan dalam kasus ini.

  • Jalur direktori apa pun yang bukan root repositori (non-default) - Karena hanya perubahan yang didorong dalam direktori sumber yang akan memicu penerapan otomatis, setiap perubahan yang didorong ke repositori Anda yang tidak ada di direktori sumber tidak akan memicu penerapan otomatis. Oleh karena itu, Anda harus menggunakan penerapan manual untuk menerapkan perubahan yang Anda dorong di luar direktori sumber.

catatan

App Runner tidak mendukung penerapan otomatis untuk gambar Amazon ECR Public, dan untuk gambar di repositori Amazon ECR yang milik AWS akun berbeda dari akun tempat layanan Anda berada.

Penerapan manual

Gunakan penerapan manual saat Anda ingin secara eksplisit memulai setiap penerapan ke layanan Anda. Anda memulai penerapan jika repositori yang Anda konfigurasi untuk layanan Anda memiliki versi baru yang ingin Anda terapkan. Untuk informasi selengkapnya, lihat Penerapan manual.

catatan

Saat Anda menjalankan penerapan manual, App Runner menerapkan sumber dari repositori lengkap.

Anda dapat mengonfigurasi metode penerapan untuk layanan Anda dengan cara berikut:

  • Konsol — Untuk layanan baru yang Anda buat atau untuk layanan yang sudah ada, di bagian Peng aturan penerapan pada halaman Konfigur asi Sumber dan penerapan, pilih Manual atau Otomatis.

    Konfigurasi metode penerapan App Runner
Membandingkan penerapan otomatis dan manual

Penerapan otomatis dan manual menghasilkan hasil yang sama: kedua metode menerapkan repositori penuh.

Perbedaan antara kedua metode ini adalah mekanisme pemicunya:

  • Penerapan manual dipicu oleh penerapan dari konsol, panggilan ke AWS CLI, atau panggilan ke API App Runner. Penerapan manualBagian berikut menyediakan prosedur untuk ini.

  • Penerapan otomatis dipicu oleh perubahan dalam isi direktori sumber.

Penerapan manual

Dengan penerapan manual, Anda perlu secara eksplisit memulai setiap penerapan ke layanan Anda. Saat Anda memiliki versi baru gambar aplikasi atau kode yang siap digunakan, Anda dapat merujuk ke bagian berikut untuk mempelajari cara melakukan penerapan menggunakan konsol dan API.

catatan

Saat Anda menjalankan penerapan manual, App Runner menerapkan sumber dari repositori lengkap.

Menyebarkan versi aplikasi Anda menggunakan salah satu metode berikut:

App Runner console
Untuk menerapkan menggunakan konsol App Runner
  1. Buka konsol App Runner, dan di daftar Wilayah, pilih Anda Wilayah AWS.

  2. Di panel navigasi, pilih Layanan, lalu pilih layanan App Runner Anda.

    Konsol menampilkan dasbor layanan dengan ikhtis ar Layanan.

    Halaman dasbor layanan App Runner menampilkan daftar Aktivitas
  3. Pilih Deploy.

    Hasil: Penerapan versi baru dimulai. Pada halaman dasbor layanan, Status layanan berubah menjadi Operasi sedang berlangsung.

  4. Tunggu hingga penerapan berakhir. Pada halaman dasbor layanan, Status layanan harus berubah kembali ke Running.

  5. Untuk memverifikasi bahwa penerapan berhasil, pada halaman dasbor layanan, pilih nilai domain default —ini adalah URL ke situs web layanan Anda. Periksa atau berinteraksi dengan aplikasi web Anda dan verifikasi perubahan versi Anda.

    catatan

    Untuk meningkatkan keamanan aplikasi App Runner Anda, domain *.awsapprunner.com terdaftar di Public Suffix List (PSL). Untuk keamanan lebih lanjut, kami menyarankan Anda menggunakan cookie dengan __Host- awalan jika Anda perlu menyetel cookie sensitif di nama domain default untuk aplikasi App Runner Anda. Praktik ini akan membantu mempertahankan domain Anda dari upaya pemalsuan permintaan lintas situs (CSRF). Untuk informasi lebih lanjut, lihat Set-Cookie halaman di Mozilla Developer Network.

App Runner API or AWS CLI

Untuk menerapkan menggunakan API App Runner atau AWS CLI, panggil tindakan StartDeployment API. Satu-satunya parameter yang harus dilewati adalah layanan ARN Anda. Anda sudah mengonfigurasi lokasi sumber aplikasi Anda saat membuat layanan, dan App Runner dapat menemukan versi baru. Penerapan Anda dimulai jika panggilan mengembalikan respons yang berhasil.