Menerapkan versi aplikasi baru ke App Runner

Saat Anda membuat layanan di AWS App Runner, Anda mengonfigurasi sumber aplikasi—gambar kontainer atau repositori sumber. App Runner menyediakan sumber daya untuk menjalankan layanan Anda dan menyebarkan aplikasi Anda ke sana.

Topik ini menjelaskan cara untuk menerapkan kembali sumber aplikasi ke layanan App Runner Anda 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 cara penerapan aplikasi dimulai.

Penyebaran otomatis

Gunakan penerapan otomatis saat Anda menginginkan perilaku integrasi dan penerapan berkelanjutan (CI/CD) untuk layanan Anda. App Runner memantau repositori gambar atau 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 menerapkannya 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 dalam direktori sumber yang memicu penerapan otomatis, penting untuk memahami bagaimana lokasi direktori sumber memengaruhi cakupan penerapan otomatis.

• Direktori tingkat atas (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 komit 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 menyebarkan perubahan yang Anda dorong di luar direktori sumber.

catatan

App Runner tidak mendukung penerapan otomatis untuk gambar ECR Publik Amazon, dan untuk gambar di ECR repositori Amazon milik yang berbeda AWS akun daripada yang ada di layanan Anda.

Penyebaran manual

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

catatan

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

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

• Konsol — Untuk layanan baru yang Anda buat atau untuk layanan yang sudah ada, di bagian Pengaturan Deployment pada halaman konfigurasi Sumber dan penerapan, pilih Manual atau Otomatis.

  

• APIatau AWS CLI— Dalam panggilan ke UpdateServicetindakan CreateServiceatau, atur AutoDeploymentsEnabled anggota SourceConfigurationparameter False untuk penerapan manual atau True untuk penerapan otomatis.

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 App RunnerAPI. Penyebaran manualBagian berikut menyediakan prosedur untuk ini.

• Penerapan otomatis dipicu oleh perubahan dalam isi direktori sumber.

Penyebaran manual

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

catatan

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

Menerapkan 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 Wilayah AWS.

2. Di panel navigasi, pilih Layanan, lalu pilih layanan Pelari Aplikasi Anda.

   Konsol menampilkan dasbor layanan dengan ikhtisar Layanan.

   

3. Pilih Deploy.

   Hasil: Penerapan versi baru dimulai. Pada halaman dasbor layanan, Status layanan berubah menjadi Operasi yang 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—itu adalah URL untuk 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 Daftar Akhiran Publik (). PSL Untuk keamanan lebih lanjut, kami menyarankan Anda menggunakan cookie dengan __Host- awalan jika Anda perlu mengatur 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 selengkapnya, lihat halaman Set-Cookie di Jaringan Pengembang Mozilla.

App Runner API or AWS CLI

Untuk menerapkan menggunakan App Runner API atau AWS CLI, sebut StartDeploymentAPItindakan. Satu-satunya parameter untuk lulus adalah layanan AndaARN. Anda sudah mengonfigurasi lokasi sumber aplikasi saat membuat layanan, dan App Runner dapat menemukan versi baru. Penerapan Anda dimulai jika panggilan mengembalikan respons yang berhasil.