AWS App Runner tidak akan lagi terbuka untuk pelanggan baru mulai 30 April 2026. Jika Anda ingin menggunakan App Runner, daftar sebelum tanggal tersebut. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [perubahan AWS App Runner ketersediaan](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengonfigurasi layanan App Runner
Saat Anda [membuat AWS App Runner layanan](manage-create.md), Anda menetapkan berbagai nilai konfigurasi. Anda dapat mengubah beberapa pengaturan konfigurasi ini setelah Anda membuat layanan. Pengaturan lain hanya dapat diterapkan saat membuat layanan dan tidak dapat diubah setelahnya. Topik ini membahas konfigurasi layanan Anda menggunakan App Runner API, konsol App Runner, dan file konfigurasi App Runner.
**Topics**
+ [Konfigurasikan layanan Anda menggunakan App Runner API atau AWS CLI](#manage-configure.api)
+ [Konfigurasikan layanan Anda menggunakan konsol App Runner](#manage-configure.console)
+ [Konfigurasikan layanan Anda menggunakan file konfigurasi App Runner](#manage-configure.file)
+ [Mengkonfigurasi observabilitas untuk layanan Anda](manage-configure-observability.md)
+ [Mengkonfigurasi pengaturan layanan menggunakan sumber daya yang dapat dibagikan](manage-configure-resources.md)
+ [Mengkonfigurasi pemeriksaan kesehatan untuk layanan Anda](manage-configure-healthcheck.md)
## Konfigurasikan layanan Anda menggunakan App Runner API atau AWS CLI
API menentukan pengaturan mana yang dapat diubah setelah pembuatan layanan. Daftar berikut membahas tindakan, jenis, dan batasan yang relevan.
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)tindakan - Dapat dipanggil setelah pembuatan untuk memperbarui beberapa pengaturan konfigurasi.
+ *Dapat diperbarui* - Anda dapat memperbarui pengaturan di`SourceConfiguration`,`InstanceConfiguration`, dan `HealthCheckConfiguration` parameter. Namun, di`SourceConfiguration`, Anda tidak dapat mengalihkan jenis sumber Anda dari kode ke gambar atau sebaliknya. Anda harus menyediakan repositoryparameter yang sama seperti yang Anda berikan ketika Anda membuat layanan. Ini salah satu `CodeRepository` atau`ImageRepository`.
Anda juga dapat memperbarui sumber daya konfigurasi terpisah berikut ARNs yang terkait dengan layanan:
+ `AutoScalingConfigurationArn`
+ `VpcConnectorArn`
+ *Tidak dapat diperbarui* — Anda tidak dapat mengubah `ServiceName` dan `EncryptionConfiguration` parameter yang tersedia dalam [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)tindakan. Mereka tidak dapat diubah setelah dibuat. [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)Tindakan tidak termasuk parameter ini.
+ *API vs. File* - Anda dapat mengatur `ConfigurationSource` parameter [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)tipe (digunakan untuk repositori kode sumber sebagai bagian dari`SourceConfiguration`) ke. `Repository` Dalam hal ini, App Runner mengabaikan pengaturan konfigurasi di`CodeConfigurationValues`, dan membaca pengaturan ini dari [file konfigurasi](config-file.md) di repositori Anda. Jika Anda menyetel `ConfigurationSource` ke`API`, App Runner mendapatkan semua pengaturan konfigurasi dari panggilan API dan mengabaikan file konfigurasi, meskipun ada.
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)tindakan - Dapat dipanggil setelah layanan Anda dibuat untuk menambahkan tag ke layanan atau memperbarui nilai tag yang ada.
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)tindakan - Dapat dipanggil setelah layanan Anda dibuat untuk menghapus tag dari layanan.
**catatan**
Jika Anda membuat konektor VPC lalu lintas keluar untuk suatu layanan, proses startup layanan berikut akan mengalami latensi satu kali. Anda dapat mengatur konfigurasi ini untuk layanan baru saat Anda membuatnya, atau sesudahnya, dengan pembaruan layanan. Untuk informasi selengkapnya, lihat [Latensi satu kali](network-vpc.md#network-vpc.VPC-connector.latency) di bagian *Networking with App Runner* dari panduan ini.
## Konfigurasikan layanan Anda menggunakan konsol App Runner
Konsol menggunakan App Runner API untuk menerapkan pembaruan konfigurasi. Aturan pembaruan yang diberlakukan API, seperti yang didefinisikan di bagian sebelumnya, menentukan apa yang dapat Anda konfigurasikan menggunakan konsol. Beberapa pengaturan yang tersedia selama pembuatan layanan tidak tersedia untuk modifikasi nanti. Selain itu, jika Anda memutuskan untuk menggunakan [file konfigurasi](config-file.md), pengaturan tambahan disembunyikan di konsol, dan App Runner membacanya dari file.
**Untuk mengonfigurasi layanan Anda**
1. Buka [konsol App Runner](https://console.aws.amazon.com/apprunner), dan di daftar **Wilayah**, pilih konsol Anda Wilayah AWS.
1. Di panel navigasi, pilih **Layanan, lalu pilih layanan** App Runner Anda.
Konsol menampilkan dasbor layanan dengan **ikhtisar Layanan**.
![\[Halaman dasbor layanan App Runner yang menampilkan daftar Aktivitas\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/console-dashboard.png)
1. Pada halaman dasbor layanan, pilih tab **Konfigurasi**.
Hasil: Konsol menampilkan pengaturan konfigurasi layanan Anda saat ini di beberapa bagian: **Sumber dan penerapan**, **Konfigurasi build**, dan **Konfigurasi layanan**.
1. Untuk memperbarui pengaturan dalam kategori apa pun, pilih **Edit**.
1. Pada halaman edit konfigurasi, buat perubahan yang diinginkan, lalu pilih **Simpan perubahan**.
**catatan**
Jika Anda membuat konektor VPC lalu lintas keluar untuk suatu layanan, proses startup layanan berikut akan mengalami latensi satu kali. Anda dapat mengatur konfigurasi ini untuk layanan baru saat Anda membuatnya, atau sesudahnya, dengan pembaruan layanan. Untuk informasi selengkapnya, lihat [Latensi satu kali](network-vpc.md#network-vpc.VPC-connector.latency) di bagian *Networking with App Runner* dari panduan ini.
## Konfigurasikan layanan Anda menggunakan file konfigurasi App Runner
Saat membuat atau memperbarui layanan App Runner, Anda dapat menginstruksikan App Runner untuk membaca beberapa setelan konfigurasi dari file konfigurasi yang Anda berikan sebagai bagian dari repositori sumber. Dengan melakukan ini, Anda dapat mengelola pengaturan yang terkait dengan kode sumber Anda di bawah kendali sumber, bersama dengan kode itu sendiri. File konfigurasi juga menyediakan pengaturan lanjutan tertentu yang tidak dapat Anda atur menggunakan konsol atau API. Untuk informasi selengkapnya, lihat [Menyetel opsi layanan App Runner menggunakan file konfigurasi](config-file.md).
**catatan**
Jika Anda membuat konektor VPC lalu lintas keluar untuk suatu layanan, proses startup layanan berikut akan mengalami latensi satu kali. Anda dapat mengatur konfigurasi ini untuk layanan baru saat Anda membuatnya, atau sesudahnya, dengan pembaruan layanan. Untuk informasi selengkapnya, lihat [Latensi satu kali](network-vpc.md#network-vpc.VPC-connector.latency) di bagian *Networking with App Runner* dari panduan ini.
# Mengkonfigurasi observabilitas untuk layanan Anda
AWS App Runner terintegrasi dengan beberapa AWS layanan untuk memberi Anda rangkaian alat observabilitas ekstensif untuk layanan App Runner Anda. Untuk informasi selengkapnya, lihat [Observabilitas untuk layanan App Runner](monitor.md).
App Runner mendukung mengaktifkan beberapa fitur observabilitas dan mengonfigurasi perilakunya dengan menggunakan sumber daya yang dapat dibagikan yang disebut. *ObservabilityConfiguration* Anda dapat menyediakan sumber daya konfigurasi observabilitas saat membuat atau memperbarui layanan. Konsol App Runner membuatnya untuk Anda saat Anda membuat layanan App Runner baru. Menyediakan konfigurasi observabilitas adalah opsional. Jika Anda tidak menyediakannya, App Runner menyediakan konfigurasi observabilitas default.
Anda dapat membagikan konfigurasi observabilitas tunggal di beberapa layanan App Runner untuk memastikan mereka memiliki perilaku observabilitas yang sama. Untuk informasi selengkapnya, lihat [Mengkonfigurasi pengaturan layanan menggunakan sumber daya yang dapat dibagikan](manage-configure-resources.md).
Anda dapat mengonfigurasi fitur observabilitas berikut menggunakan konfigurasi observabilitas:
+ *Konfigurasi pelacakan* — Pengaturan untuk melacak permintaan yang disajikan aplikasi Anda dan panggilan hilir yang dibuatnya. Untuk informasi lebih lanjut tentang penelusuran, lihat[Menelusuri aplikasi App Runner Anda dengan X-Ray](monitor-xray.md).
## Kelola observabilitas
Mengelola observabilitas untuk layanan App Runner Anda menggunakan salah satu metode berikut:
------
#### [ App Runner console ]
Saat [membuat layanan](manage-create.md) menggunakan konsol App Runner, atau saat [memperbarui konfigurasinya nanti](manage-configure.md), Anda dapat mengonfigurasi fitur observabilitas untuk layanan Anda. Cari bagian konfigurasi **Observabilitas** di halaman konsol.
![\[Halaman konfigurasi konsol App Runner yang menampilkan opsi observabilitas\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/manage-configure-observability.png)
------
#### [ App Runner API or AWS CLI ]
Saat memanggil tindakan [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)atau [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)App Runner API, Anda dapat menggunakan objek `ObservabilityConfiguration` parameter untuk mengaktifkan fitur observabilitas dan menentukan sumber daya konfigurasi observabilitas untuk layanan Anda.
Gunakan tindakan App Runner API berikut untuk mengelola sumber daya konfigurasi observabilitas Anda.
+ [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— Membuat konfigurasi observabilitas baru atau revisi ke yang sudah ada.
+ [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— Mengembalikan daftar konfigurasi observabilitas yang terkait dengan Anda Akun AWS, dengan informasi ringkasan.
+ [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— Mengembalikan deskripsi lengkap dari konfigurasi observabilitas.
+ [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— Menghapus konfigurasi observabilitas. Anda dapat menghapus revisi tertentu atau revisi aktif terbaru. Anda mungkin perlu menghapus konfigurasi observabilitas yang tidak perlu jika Anda mencapai kuota konfigurasi observabilitas untuk Anda. Akun AWS
------
# Mengkonfigurasi pengaturan layanan menggunakan sumber daya yang dapat dibagikan
Untuk beberapa fitur, masuk akal untuk berbagi konfigurasi di seluruh AWS App Runner layanan. Misalnya, Anda mungkin ingin satu set layanan memiliki perilaku penskalaan otomatis yang sama. Atau Anda mungkin menginginkan pengaturan observabilitas yang identik untuk semua layanan Anda. App Runner memungkinkan Anda berbagi setelan dengan menggunakan sumber daya yang dapat dibagikan terpisah. Anda membuat sumber daya yang mendefinisikan setelan konfigurasi untuk fitur, lalu Anda memberikan Nama Sumber Daya Amazon (ARN) sumber daya konfigurasi ini ke satu atau beberapa layanan App Runner.
App Runner mengimplementasikan sumber daya konfigurasi yang dapat dibagikan untuk fitur berikut:
+ [Penskalaan otomatis](manage-autoscaling.md)
+ [Observabilitas](manage-configure-observability.md)
+ [Akses VPC](network-vpc.md)
Halaman dokumen untuk masing-masing fitur ini memberikan informasi tentang pengaturan yang tersedia dan prosedur manajemen.
Fitur yang menggunakan sumber daya konfigurasi terpisah berbagi beberapa ciri dan pertimbangan desain.
+ **Revisi** — Beberapa sumber konfigurasi dapat memiliki revisi. Penskalaan otomatis dan observabilitas adalah contoh dari dua sumber daya konfigurasi yang menggunakan revisi. Dalam kasus ini, setiap konfigurasi memiliki *nama* dan *revisi* numerik. Beberapa revisi konfigurasi memiliki nama yang sama dan nomor revisi yang berbeda. Anda dapat menggunakan nama konfigurasi yang berbeda untuk skenario yang berbeda. Untuk setiap nama, Anda dapat menambahkan beberapa revisi untuk menyempurnakan pengaturan untuk skenario tertentu.
Konfigurasi pertama yang Anda buat dengan nama mendapatkan nomor revisi 1. Konfigurasi selanjutnya dengan nama yang sama mendapatkan nomor revisi berturut-turut (dimulai dengan 2). Anda dapat mengaitkan layanan App Runner dengan revisi konfigurasi tertentu atau dengan revisi konfigurasi terbaru.
+ **Dibagikan** - Anda dapat berbagi sumber daya konfigurasi tunggal di beberapa layanan App Runner. Ini berguna jika Anda ingin mempertahankan konfigurasi yang identik di seluruh layanan ini. Khususnya, jika sumber daya Anda mendukung revisi, Anda dapat mengonfigurasi beberapa layanan untuk menggunakan revisi konfigurasi terbaru. Anda dapat melakukannya dengan menentukan hanya nama konfigurasi, tetapi bukan revisi. Layanan apa pun yang Anda konfigurasikan dengan cara ini menerima pembaruan konfigurasi saat Anda memperbarui layanan. Untuk informasi selengkapnya tentang perubahan konfigurasi, lihat[Mengonfigurasi layanan App Runner](manage-configure.md).
+ **Manajemen sumber daya** — Anda dapat menggunakan App Runner untuk membuat dan menghapus konfigurasi. Anda tidak dapat memperbarui konfigurasi secara langsung. Sebagai gantinya, untuk sumber daya yang mendukung revisi, Anda dapat membuat revisi baru ke nama konfigurasi yang ada untuk memperbarui konfigurasi secara efektif.
**catatan**
Untuk penskalaan otomatis, Anda dapat membuat konfigurasi dan *beberapa* revisi dengan konsol App Runner dan App Runner API. Baik konsol App Runner maupun App Runner API juga dapat menghapus konfigurasi dan revisi. Untuk detail selengkapnya, lihat [Mengelola penskalaan otomatis App Runner](manage-autoscaling.md).
Untuk jenis konfigurasi lainnya, seperti konfigurasi observabilitas, Anda hanya dapat membuat konfigurasi dengan *satu revisi dengan konsol* App Runner. Untuk membuat lebih banyak revisi, dan menghapus konfigurasi, Anda harus menggunakan App Runner API.
+ **Kuota sumber daya** — Ada kuota yang ditetapkan untuk jumlah nama konfigurasi unik dan revisi yang dapat Anda miliki untuk sumber daya konfigurasi Anda di masing-masing. Wilayah AWS Jika Anda mencapai kuota ini, Anda harus menghapus nama konfigurasi atau setidaknya beberapa revisinya sebelum Anda dapat membuat lebih banyak. Untuk revisi konfigurasi penskalaan otomatis, Anda dapat menggunakan konsol App Runner atau App Runner API untuk menghapusnya. Untuk detail selengkapnya, lihat [Mengelola penskalaan otomatis App Runner](manage-autoscaling.md). Anda harus menggunakan App Runner API untuk menghapus sumber daya lainnya. Untuk informasi lebih lanjut tentang kuota, lihat[Kuota sumber daya App Runner](architecture.md#architecture.quotas).
+ **Tidak ada biaya sumber daya** - Anda tidak dikenakan biaya tambahan untuk membuat sumber daya konfigurasi. Anda mungkin dikenakan biaya untuk fitur itu sendiri (misalnya, Anda dikenakan AWS X-Ray biaya normal saat mengaktifkan penelusuran X-Ray), tetapi tidak untuk sumber daya konfigurasi App Runner yang mengonfigurasi fitur untuk layanan Pelari Aplikasi Anda.
# Mengkonfigurasi pemeriksaan kesehatan untuk layanan Anda
AWS App Runner memantau kesehatan layanan Anda dengan melakukan pemeriksaan kesehatan. Protokol pemeriksaan kesehatan default adalah TCP. App Runner melakukan ping ke domain yang ditetapkan ke layanan Anda. Anda dapat mengatur protokol pemeriksaan kesehatan ke HTTP. App Runner mengirimkan permintaan HTTP pemeriksaan kesehatan ke aplikasi web Anda.
Anda dapat mengonfigurasi beberapa pengaturan yang terkait dengan pemeriksaan kesehatan. Tabel berikut menjelaskan pengaturan pemeriksaan kesehatan dan nilai defaultnya.
| **Pengaturan** | **Deskripsi** | **Default** |
| --- | --- | --- |
| Protokol | Protokol IP yang digunakan App Runner untuk melakukan pemeriksaan kesehatan untuk layanan Anda. Jika Anda menyetel protokol`TCP`, App Runner melakukan ping domain default yang ditetapkan ke layanan Anda di port yang didengarkan aplikasi Anda. Jika Anda menyetel protokol`HTTP`, App Runner akan mengirimkan permintaan pemeriksaan kesehatan ke jalur yang dikonfigurasi. | `TCP` |
| Jalan | URL tempat App Runner mengirimkan permintaan pemeriksaan kesehatan HTTP. Hanya berlaku untuk pemeriksaan HTTP. | `/` |
| Interval | Interval waktu, dalam hitungan detik, antara pemeriksaan kesehatan. | `5` |
| Waktu habis | Waktu, dalam hitungan detik, untuk menunggu respons pemeriksaan kesehatan sebelum memutuskan gagal. | `2` |
| Ambang batas yang sehat | Jumlah permiksaan berturut-turut yang harus berhasil sebelum App Runner memutuskan bahwa layanan sehat. | `1` |
| Ambang batas yang tidak sehat | Jumlah permiksaan berturut-turut yang harus gagal sebelum App Runner memutuskan bahwa layanan tidak sehat. | `5` |
## Konfigurasi pemeriksaan kondisi
Konfigurasikan pemeriksaan kesehatan untuk layanan App Runner Anda menggunakan salah satu metode berikut:
------
#### [ App Runner console ]
Saat membuat layanan App Runner menggunakan konsol App Runner, atau saat memperbarui konfigurasinya nanti, Anda dapat mengonfigurasi pengaturan pemeriksaan kesehatan. Untuk prosedur konsol lengkap, lihat [Membuat layanan App Runner](manage-create.md) dan[Mengonfigurasi layanan App Runner](manage-configure.md). Dalam kedua kasus, cari bagian Konfigurasi **pemeriksaan Kesehatan** di halaman konsol.
![\[Halaman konfigurasi konsol App Runner yang menampilkan opsi pemeriksaan kesehatan\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/console-health-check.png)
------
#### [ App Runner API or AWS CLI ]
Saat Anda memanggil tindakan [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)atau [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API, Anda dapat menggunakan `HealthCheckConfiguration` parameter untuk menentukan pengaturan pemeriksaan kesehatan.
Untuk informasi tentang struktur parameter, lihat [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)di *Referensi AWS App Runner API*.
------