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.
# Memulai dengan App Runner
AWS App Runner adalah AWS layanan yang menyediakan cara cepat, sederhana, dan hemat biaya untuk mengubah gambar kontainer atau kode sumber yang ada langsung menjadi layanan web yang berjalan di situs web. AWS Cloud
Tutorial ini mencakup bagaimana Anda dapat menggunakan AWS App Runner untuk menyebarkan aplikasi Anda ke layanan App Runner. Ini berjalan melalui konfigurasi kode sumber dan penerapan, build layanan, dan runtime layanan. Ini juga menunjukkan cara menerapkan versi kode, membuat perubahan konfigurasi, dan melihat log. Terakhir, tutorial menunjukkan cara membersihkan sumber daya yang Anda buat saat mengikuti prosedur tutorial.
**Topics**
+ [Prasyarat](#getting-started.prereq)
+ [Langkah 1: Buat layanan App Runner](#getting-started.create)
+ [Langkah 2: Ubah kode layanan Anda](#getting-started.deploy)
+ [Langkah 3: Buat perubahan konfigurasi](#getting-started.config)
+ [Langkah 4: Lihat log untuk layanan Anda](#getting-started.logs)
+ [Langkah 5: Bersihkan](#getting-started.cleanup)
+ [Apa selanjutnya](#getting-started.next)
## Prasyarat
Sebelum Anda memulai tutorial, pastikan untuk mengambil tindakan berikut:
1. Selesaikan langkah-langkah pengaturan di[Menyiapkan untuk App Runner](setting-up.md).
1.
Putuskan apakah Anda ingin bekerja dengan repositori atau GitHub repositori Bitbucket.
+ Untuk bekerja dengan Bitbucket, pertama-tama buat akun [Bitbucket](https://bitbucket.org/), jika Anda belum memilikinya. Jika Anda baru mengenal Bitbucket, lihat [Memulai Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/get-started-with-bitbucket-cloud/) di Dokumentasi Cloud *Bitbucket*.
+ Untuk bekerja dengan GitHub, buat [GitHub](https://github.com/)akun, jika Anda belum memilikinya. Jika Anda baru mengenal GitHub, lihat [Memulai GitHub](https://docs.github.com/en/github/getting-started-with-github) di *GitHubDokumen.*
**catatan**
Anda dapat membuat koneksi ke beberapa penyedia repositori dari akun Anda. Jadi, jika Anda ingin berjalan melalui penerapan dari repositori GitHub dan Bitbucket, Anda dapat mengulangi prosedur ini. Lain kali melalui membuat layanan App Runner baru dan membuat koneksi akun baru untuk penyedia repositori lainnya.
1. Buat repositori di akun penyedia repositori Anda. Tutorial ini menggunakan nama repositori. `python-hello` Buat file di direktori root repositori, dengan nama dan konten yang ditentukan dalam contoh berikut.
### File untuk `python-hello` repositori contoh
**Example requirements.txt**
```
pyramid==2.0
```
**Example server.py**
```
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response
import os
def hello_world(request):
name = os.environ.get('NAME')
if name == None or len(name) == 0:
name = "world"
message = "Hello, " + name + "!\n"
return Response(message)
if __name__ == '__main__':
port = int(os.environ.get("PORT"))
with Configurator() as config:
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', port, app)
server.serve_forever()
```
## Langkah 1: Buat layanan App Runner
Pada langkah ini, Anda membuat layanan App Runner berdasarkan contoh repositori kode sumber yang Anda buat GitHub atau Bitbucket sebagai bagian dari. [Prasyarat](#getting-started.prereq) Contohnya berisi situs web Python sederhana. Ini adalah langkah-langkah utama yang Anda ambil untuk membuat layanan:
1. Konfigurasikan kode sumber Anda.
1. Konfigurasikan penyebaran sumber.
1. Konfigurasikan pembuatan aplikasi.
1. Konfigurasikan layanan Anda.
1. Tinjau dan konfirmasi.
Diagram berikut menguraikan langkah-langkah untuk membuat layanan App Runner:
![\[Diagram alur kerja pembuatan layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-service-workflow.png)
**Untuk membuat layanan App Runner berdasarkan repositori kode sumber**
1. Konfigurasikan kode sumber Anda.
1. Buka [konsol App Runner](https://console.aws.amazon.com/apprunner), dan di daftar **Wilayah**, pilih konsol Anda Wilayah AWS.
1. Jika Akun AWS belum memiliki layanan App Runner, halaman beranda konsol akan ditampilkan. Pilih **Buat layanan App Runner**.
![\[Halaman beranda konsol App Runner yang menampilkan tombol buat layanan\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-home.png)
Jika Akun AWS memiliki layanan yang ada, halaman **Layanan** dengan daftar layanan Anda akan ditampilkan. Pilih **Buat layanan**.
![\[Halaman layanan konsol App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-services.png)
1. Pada halaman **Sumber dan penyebaran**, di bagian **Sumber**, untuk **jenis Repositori, pilih repositori** kode **sumber**.
1. Pilih **Jenis Penyedia**. Pilih salah satu **GitHub**atau **Bitbucket**.
1. Selanjutnya pilih **Tambah baru**. Jika diminta, berikan kredensi Anda GitHub atau Bitbucket.
1. Pilih rangkaian langkah berikutnya berdasarkan **jenis Penyedia** yang Anda pilih sebelumnya.
**catatan**
Langkah-langkah berikut untuk menginstal konektor AWS GitHub ke GitHub akun Anda adalah langkah satu kali. Anda dapat menggunakan kembali koneksi untuk membuat beberapa layanan App Runner berdasarkan repositori di akun ini. Ketika Anda memiliki koneksi yang ada, pilih dan lewati ke pemilihan repositori.
Hal yang sama berlaku untuk konektor AWS untuk akun Bitbucket Anda. Jika Anda menggunakan keduanya GitHub dan Bitbucket sebagai repositori kode sumber untuk layanan App Runner, Anda harus menginstal satu AWS Connector untuk setiap penyedia. Anda kemudian dapat menggunakan kembali setiap konektor untuk membuat lebih banyak layanan App Runner.
+ Untuk **GitHub**, ikuti langkah-langkah ini.
1. Pada layar berikutnya, masukkan **Nama Koneksi**.
1. Jika ini pertama kali Anda gunakan GitHub dengan App Runner, pilih **Instal yang lain**.
1. Di kotak GitHub dialog **AWS Connector for**, jika diminta, pilih nama GitHub akun Anda.
1. Jika diminta untuk mengotorisasi AWS Konektor GitHub, pilih **Otorisasi Koneksi AWS**.
1. Dalam **Instal AWS Konektor untuk** kotak GitHub dialog, Pilih **Instal**.
Nama akun Anda muncul sebagai **GitHub akun/organisasi** yang dipilih. Anda sekarang dapat memilih repositori di akun Anda.
1. Untuk **Repositori**, pilih contoh repositori yang Anda buat,. `python-hello` Untuk **Branch**, pilih nama cabang default repositori Anda (misalnya, **main**).
1. Tinggalkan **direktori Source** dengan nilai default. Direktori default ke root repositori. Anda menyimpan kode sumber Anda di direktori root repositori di langkah-langkah *Prasyarat* sebelumnya.
+ Untuk **Bitbucket**, ikuti langkah-langkah ini.
1. Pada layar berikutnya, masukkan **Nama Koneksi**.
1. Jika ini pertama kalinya Anda menggunakan Bitbucket dengan App Runner, pilih **Install** another.
1. Di kotak dialog **AWS CodeStar request access**, Anda dapat memilih ruang kerja dan memberikan akses ke integrasi AWS CodeStar Bitbucket. Pilih ruang kerja Anda, lalu pilih **Grant access**.
1. Selanjutnya Anda akan diarahkan ke AWS konsol. **Verifikasi bahwa aplikasi Bitbucket diatur ke ruang kerja Bitbucket yang benar dan pilih Berikutnya.**
1. Untuk **Repositori**, pilih contoh repositori yang Anda buat,. `python-hello` Untuk **Branch**, pilih nama cabang default repositori Anda (misalnya, **main**).
1. Tinggalkan **direktori Source** dengan nilai default. Direktori default ke root repositori. Anda menyimpan kode sumber Anda di direktori root repositori di langkah-langkah *Prasyarat* sebelumnya.
1. **Konfigurasikan penerapan Anda: Di bagian **Pengaturan Deployment**, pilih **Otomatis**, lalu pilih Berikutnya.**
**catatan**
Dengan penerapan otomatis, setiap komit baru ke direktori sumber repositori Anda secara otomatis menerapkan versi baru layanan Anda.
![\[Pengaturan sumber dan penerapan saat membuat layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-source-depl.png)
1. Konfigurasikan pembuatan aplikasi.
1. Pada halaman **Konfigurasi build**, untuk **file Konfigurasi**, pilih **Konfigurasi semua pengaturan di sini**.
1. Berikan setelan build berikut:
+ **Runtime** - Pilih **Python 3**.
+ **Membangun perintah** — Enter**pip install -r requirements.txt**.
+ **Mulai perintah** — Enter**python server.py**.
+ **Pelabuhan** — Masuk**8080**.
1. Pilih **Berikutnya**.
**catatan**
Runtime Python 3 membangun image Docker menggunakan gambar dasar Python 3 dan contoh kode Python Anda. Kemudian meluncurkan layanan yang menjalankan instance kontainer dari gambar ini.
![\[Membangun setelan saat membuat layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-build.png)
1. Konfigurasikan layanan Anda.
1. Pada halaman **Konfigurasi Layanan**, di bagian **Pengaturan layanan**, masukkan nama layanan.
1. Di bawah **Variabel lingkungan**, pilih **Tambahkan variabel lingkungan**. Berikan nilai-nilai berikut untuk variabel lingkungan.
+ **Sumber** - Pilih **Teks biasa**
+ **Nama variabel lingkungan** - **NAME**
+ **Nilai variabel lingkungan** - nama apa pun (misalnya, nama depan Anda).
**catatan**
Contoh aplikasi membaca nama yang Anda tetapkan dalam variabel lingkungan ini dan menampilkan nama di halaman webnya.
1. Pilih **Berikutnya**.
![\[Pengaturan layanan saat membuat layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-service.png)
1. Pada halaman **Tinjau dan buat**, verifikasi semua detail yang Anda masukkan, lalu pilih **Buat dan terapkan**.
Jika layanan berhasil dibuat, konsol menampilkan dasbor layanan, dengan **ikhtisar Layanan** dari layanan baru.
![\[Halaman dasbor layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-dashboard.png)
1. Verifikasi bahwa layanan Anda sedang berjalan.
1. Pada halaman dasbor layanan, tunggu hingga **Status** layanan **Berjalan**.
1. Pilih nilai **domain default** — ini adalah URL ke situs web layanan Anda.
**catatan**
[Untuk meningkatkan keamanan aplikasi App Runner Anda, *domain\$1.awsapprunner.com* terdaftar di Daftar Akhiran Publik (PSL).](https://publicsuffix.org/) 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](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) di Jaringan Pengembang Mozilla.
Sebuah halaman web menampilkan: **Halo,\$1 *your name***
![\[Halaman web aplikasi dari layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-create-webpage.png)
## Langkah 2: Ubah kode layanan Anda
Pada langkah ini, Anda membuat perubahan pada kode Anda di direktori sumber repositori. CI/CD Kemampuan App Runner secara otomatis membangun dan menyebarkan perubahan ke layanan Anda.
**Untuk membuat perubahan pada kode layanan Anda**
1. Arahkan ke repositori contoh Anda.
1. Edit file bernama`server.py`.
1. Dalam ekspresi yang ditugaskan ke variabel`message`, ubah teks `Hello` menjadi`Good morning`.
1. Simpan dan komit perubahan Anda ke repositori.
1. Langkah-langkah berikut menggambarkan mengubah kode layanan dalam GitHub repositori.
1. Arahkan ke GitHub repositori contoh Anda.
1. Pilih nama file `server.py` untuk menavigasi ke file itu.
1. Pilih **Edit file ini** (ikon pensil).
1. Dalam ekspresi yang ditugaskan ke variabel`message`, ubah teks `Hello` menjadi`Good morning`.
![\[GitHub halaman file dengan ikon edit dan pesan disorot\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/getting-started-deploy-edit.png)
1. Pilih **Perubahan commit**.
1. Komit baru mulai diterapkan untuk layanan App Runner Anda. Pada halaman dasbor layanan, **Status** layanan berubah menjadi **Operasi yang sedang berlangsung**.
Tunggu hingga penerapan berakhir. Pada halaman dasbor layanan, **Status** layanan harus berubah kembali ke **Running**.
1. Verifikasi bahwa penerapan berhasil: segarkan tab browser tempat halaman web layanan Anda ditampilkan.
Halaman sekarang menampilkan pesan yang dimodifikasi: **Selamat pagi,*your name*\$1**
## Langkah 3: Buat perubahan konfigurasi
Pada langkah ini, Anda membuat perubahan pada nilai variabel **NAME** lingkungan, untuk menunjukkan perubahan konfigurasi layanan.
**Untuk mengubah nilai variabel lingkungan**
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**.
Konsol menampilkan pengaturan konfigurasi layanan Anda di beberapa bagian.
1. Di bagian **Konfigurasi layanan**, pilih **Edit**.
![\[Bagian konfigurasi Layanan pada tab Konfigurasi pada halaman dasbor layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/service-dashboad-config-service.png)
1. Untuk variabel lingkungan dengan kunci**NAME**, ubah nilai ke nama yang berbeda.
1. Pilih **Terapkan perubahan**.
App Runner memulai proses pembaruan. Pada halaman dasbor layanan, **Status** layanan berubah menjadi **Operasi yang sedang berlangsung**.
1. Tunggu hingga pembaruan berakhir. Pada halaman dasbor layanan, **Status** layanan harus berubah kembali ke **Running**.
1. Verifikasi bahwa pembaruan berhasil: segarkan tab browser tempat halaman web layanan Anda ditampilkan.
Halaman sekarang menampilkan nama yang dimodifikasi: **Selamat pagi,*new name*\$1**
## Langkah 4: Lihat log untuk layanan Anda
Pada langkah ini, Anda menggunakan konsol App Runner untuk melihat log untuk layanan App Runner Anda. App Runner mengalirkan log ke Amazon CloudWatch Logs (CloudWatch Log) dan menampilkannya di dasbor layanan Anda. Untuk informasi tentang log Pelari Aplikasi, lihat[Melihat log App Runner dialirkan ke Log CloudWatch](monitor-cwl.md).
**Untuk melihat log untuk 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 **Log**.
Konsol menampilkan beberapa jenis log di beberapa bagian:
+ **Log peristiwa** — Aktivitas dalam siklus hidup layanan App Runner Anda. Konsol menampilkan acara terbaru.
+ **Log penerapan** — Penerapan repositori sumber ke layanan App Runner Anda. Konsol menampilkan aliran log terpisah untuk setiap penerapan.
+ **Log aplikasi** — Output dari aplikasi web yang diterapkan ke layanan App Runner Anda. Konsol menggabungkan output dari semua instance yang berjalan ke dalam satu aliran log.
![\[Tab Log di halaman dasbor layanan App Runner\]](http://docs.aws.amazon.com/id_id/apprunner/latest/dg/images/service-dashboad-logs.png)
1. Untuk menemukan penerapan tertentu, cakupkan daftar log penerapan dengan memasukkan istilah penelusuran. Anda dapat mencari nilai apa pun yang muncul di tabel.
1. Untuk melihat konten log, pilih **Lihat log lengkap (log** peristiwa) atau nama aliran log (penerapan dan log aplikasi).
1. Pilih **Unduh** untuk mengunduh log. Untuk aliran log penerapan, pilih aliran log terlebih dahulu.
1. Pilih **Lihat CloudWatch** untuk membuka CloudWatch konsol dan gunakan kemampuan penuhnya untuk menjelajahi log layanan App Runner Anda. Untuk aliran log penerapan, pilih aliran log terlebih dahulu.
**catatan**
CloudWatch Konsol ini sangat berguna jika Anda ingin melihat log aplikasi dari instance tertentu alih-alih log aplikasi gabungan.
## Langkah 5: Bersihkan
Anda sekarang telah mempelajari cara membuat layanan App Runner, melihat log, dan membuat beberapa perubahan. Pada langkah ini, Anda menghapus layanan untuk menghapus sumber daya yang tidak Anda butuhkan lagi.
**Untuk menghapus layanan Anda**
1. Pada halaman dasbor layanan, pilih **Tindakan**, lalu pilih **Hapus layanan**.
1. Dalam dialog konfirmasi, masukkan teks yang diminta, lalu pilih **Hapus**.
Hasil: Konsol menavigasi ke halaman **Layanan**. Layanan yang baru saja Anda hapus menunjukkan status **MENGHAPUS.** Beberapa saat kemudian menghilang dari daftar.
Pertimbangkan juga menghapus koneksi GitHub dan Bitbucket yang Anda buat sebagai bagian dari tutorial ini. Untuk informasi selengkapnya, lihat [Mengelola koneksi App Runner](manage-connections.md).
## Apa selanjutnya
Setelah menerapkan layanan App Runner pertama Anda, pelajari lebih lanjut dalam topik berikut:
+ [Arsitektur dan konsep App Runner](architecture.md)Arsitektur, konsep utama, dan AWS sumber daya yang terkait dengan App Runner.
+ [Layanan berbasis gambar](service-source-image.md)dan [Layanan berbasis kode](service-source-code.md) — Dua jenis sumber aplikasi yang dapat diterapkan oleh App Runner.
+ [Mengembangkan kode aplikasi untuk App Runner](develop.md)— Hal-hal yang harus Anda ketahui saat mengembangkan atau memigrasi kode aplikasi untuk penerapan ke App Runner.
+ [Menggunakan konsol App Runner](console.md)— Kelola dan pantau layanan Anda menggunakan konsol App Runner.
+ [Mengelola layanan App Runner](manage.md)— Kelola siklus hidup layanan App Runner Anda.
+ [Observabilitas untuk layanan App Runner](monitor.md)— Dapatkan visibilitas ke dalam operasi layanan App Runner Anda dengan memantau metrik, membaca log, menangani peristiwa, melacak panggilan tindakan layanan, dan melacak peristiwa aplikasi seperti panggilan HTTP.
+ [File konfigurasi App Runner](config-file.md)— Cara berbasis konfigurasi untuk menentukan opsi untuk perilaku build dan runtime layanan App Runner Anda.
+ [API Pelari Aplikasi](api.md)— Gunakan antarmuka pemrograman aplikasi (API) App Runner untuk membuat, membaca, memperbarui, dan menghapus sumber daya App Runner.
+ [Keamanan di App Runner](security.md)— Berbagai cara itu AWS dan Anda memastikan keamanan cloud saat Anda menggunakan App Runner dan layanan lainnya.