Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menggunakan AWS App Runner dengan AWS Toolkit for Visual Studio Code
[AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/what-is-apprunner.html)menyediakan cara yang cepat, sederhana, dan hemat biaya untuk menyebarkan dari kode sumber atau gambar kontainer langsung ke aplikasi web yang dapat diskalakan dan aman di Cloud. AWS Dengan menggunakannya, Anda tidak perlu mempelajari teknologi baru, memutuskan layanan komputasi mana yang akan digunakan, atau mengetahui cara menyediakan dan mengonfigurasi AWS sumber daya.
Anda dapat menggunakan AWS App Runner untuk membuat dan mengelola layanan berdasarkan *gambar sumber* atau *kode sumber*. Jika Anda menggunakan gambar sumber, Anda dapat memilih gambar kontainer publik atau pribadi yang disimpan dalam repositori gambar. App Runner mendukung penyedia repositori gambar berikut:
+ Amazon Elastic Container Registry (Amazon ECR): Menyimpan gambar pribadi di akun Anda. AWS
+ Amazon Elastic Container Registry Public (Amazon ECR Public): Menyimpan gambar yang dapat dibaca publik.
Jika Anda memilih opsi kode sumber, Anda dapat menerapkan dari repositori kode sumber yang dikelola oleh penyedia repositori yang didukung. Saat ini, App Runner mendukung [GitHub](https://github.com/)sebagai penyedia repositori kode sumber.
## Prasyarat
Untuk berinteraksi dengan App Runner menggunakan hal AWS Toolkit for Visual Studio Code berikut ini:
+ AWS Akun
+ Versi dari fitur AWS Toolkit for Visual Studio Code itu AWS App Runner
Selain persyaratan inti tersebut, pastikan bahwa semua pengguna IAM yang relevan memiliki izin untuk berinteraksi dengan layanan App Runner. Anda juga perlu mendapatkan informasi spesifik tentang sumber layanan Anda seperti URI gambar kontainer atau koneksi ke GitHub repositori. Anda memerlukan informasi ini saat membuat layanan App Runner.
### Mengkonfigurasi izin IAM untuk App Runner
Cara termudah untuk memberikan izin yang diperlukan untuk App Runner adalah dengan melampirkan kebijakan AWS terkelola yang ada ke entitas yang relevan AWS Identity and Access Management (IAM), khususnya pengguna atau grup. App Runner menyediakan dua kebijakan terkelola yang dapat Anda lampirkan ke pengguna IAM Anda:
+ `AWSAppRunnerFullAccess`: Memungkinkan pengguna untuk melakukan semua tindakan App Runner.
+ `AWSAppRunnerReadOnlyAccess`: Izinkan pengguna untuk membuat daftar dan melihat detail tentang sumber daya Pelari Aplikasi.
Selain itu, jika Anda memilih repositori pribadi dari Amazon Elastic Container Registry (Amazon ECR) sebagai sumber layanan, Anda harus membuat peran akses berikut untuk layanan App Runner Anda:
+ `AWSAppRunnerServicePolicyForECRAccess`: Memungkinkan App Runner mengakses gambar Amazon Elastic Container Registry (Amazon ECR) di akun Anda.
Anda dapat membuat peran ini secara otomatis saat mengonfigurasi instance layanan Anda dengan **Palet Perintah** VS Code.
**catatan**
Peran **AWSServiceRoleForAppRunner**terkait layanan memungkinkan AWS App Runner untuk menyelesaikan tugas-tugas berikut:
Dorong log ke grup CloudWatch log Amazon Logs.
Buat aturan Amazon CloudWatch Events untuk berlangganan push image Amazon Elastic Container Registry (Amazon ECR).
Anda tidak perlu membuat peran tertaut layanan secara manual. Saat Anda membuat AWS App Runner di dalam Konsol Manajemen AWS atau dengan menggunakan operasi API yang dipanggil oleh AWS Toolkit for Visual Studio Code, AWS App Runner buat peran terkait layanan ini untuk Anda.
Untuk informasi selengkapnya, lihat [Identitas dan manajemen akses untuk Pelari Aplikasi](https://docs.aws.amazon.com/apprunner/latest/dg/security-iam.html) di *Panduan AWS App Runner Pengembang*.
### Memperoleh sumber layanan untuk App Runner
Anda dapat menggunakan AWS App Runner untuk menyebarkan layanan dari gambar sumber atau kode sumber.
------
#### [ Source image ]
Jika Anda menerapkan dari gambar sumber, Anda dapat memperoleh tautan ke repositori untuk gambar itu dari registri gambar pribadi atau publik AWS .
+ [Registri pribadi Amazon ECR: Salin URI untuk repositori pribadi yang menggunakan konsol Amazon ECR di repositori. https://console.aws.amazon.com/ecr/](https://console.aws.amazon.com/ecr/repositories)
+ [Registri publik Amazon ECR: Salin URI untuk repositori publik yang menggunakan Galeri Publik Amazon ECR di https://gallery.ecr.aws/.](https://gallery.ecr.aws)
**catatan**
Anda juga dapat memperoleh URI untuk repositori Amazon ECR pribadi langsung dari **AWS Explorer** di Toolkit for VS Code:
Buka **AWS Explorer** dan perluas node **ECR** untuk melihat daftar repositori untuk Wilayah itu. AWS
Klik kanan repositori dan pilih **Salin Repositori URI untuk menyalin tautan ke clipboard** Anda.
**Anda menentukan URI untuk repositori gambar saat mengonfigurasi instance layanan Anda dengan Palet Perintah VS Code**
Untuk informasi selengkapnya, lihat [Layanan Pelari Aplikasi berdasarkan gambar sumber](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-image.html) di *Panduan AWS App Runner Pengembang*.
------
#### [ Source code ]
Agar kode sumber Anda dapat diterapkan ke AWS App Runner layanan, kode tersebut harus disimpan dalam repositori Git yang dikelola oleh penyedia repositori yang didukung. App Runner mendukung satu penyedia repositori kode sumber:. [GitHub](https://github.com/)
Untuk informasi tentang menyiapkan GitHub repositori, lihat [dokumentasi Memulai](https://docs.github.com/en/github/getting-started-with-github). GitHub
Untuk menerapkan kode sumber Anda ke layanan App Runner dari GitHub repositori, App Runner membuat sambungan ke. GitHub Jika repositori Anda bersifat pribadi (artinya, repositori tidak dapat diakses publik GitHub), Anda harus memberikan detail koneksi kepada App Runner.
**penting**
Untuk membuat GitHub koneksi, Anda harus menggunakan konsol App Runner ([https://console.aws.amazon.com/apprunner](https://console.aws.amazon.com/apprunner)) untuk membuat koneksi yang ditautkan. GitHub AWS Anda dapat memilih koneksi yang tersedia di halaman **GitHubkoneksi** saat mengonfigurasi instance layanan Anda dengan **Palet Perintah** VS Code.
Untuk informasi selengkapnya, lihat [Mengelola koneksi App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/manage-connections.html) di *Panduan AWS App Runner Pengembang*.
Instans layanan App Runner menyediakan runtime terkelola yang memungkinkan kode Anda dibuat dan dijalankan. AWS App Runner saat ini mendukung runtime berikut:
+ Runtime terkelola Python
+ Node.js mengelola runtime
Sebagai bagian dari konfigurasi layanan, Anda memberikan informasi tentang cara layanan App Runner membangun dan memulai layanan Anda. Anda dapat memasukkan informasi ini menggunakan **Command Palette** atau menentukan file konfigurasi [App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/config-file.html) yang diformat YAML. Nilai dalam file ini menginstruksikan App Runner cara membuat dan memulai layanan Anda, serta menyediakan konteks runtime. Ini termasuk pengaturan jaringan yang relevan dan variabel lingkungan. File konfigurasi diberi nama`apprunner.yaml`. Ini secara otomatis ditambahkan ke direktori root repositori aplikasi Anda.
------
## Harga
Anda dikenakan biaya untuk sumber daya komputasi dan memori yang digunakan aplikasi Anda. Selain itu, jika Anda mengotomatiskan penerapan, Anda juga membayar biaya bulanan yang ditetapkan untuk setiap aplikasi yang mencakup semua penerapan otomatis untuk bulan itu. Jika Anda memilih untuk menerapkan dari kode sumber, Anda juga membayar biaya pembuatan untuk jumlah waktu yang diperlukan App Runner untuk membuat container dari kode sumber Anda.
Untuk informasi selengkapnya, silakan lihat [Harga AWS App Runner](https://aws.amazon.com/apprunner/pricing/).
**Topics**
+ [Prasyarat](#apprunner-prereqs)
+ [Harga](#app-runner-pricing)
+ [Membuat layanan App Runner](creating-service-apprunner.md)
+ [Mengelola layanan App Runner](managing-service-apprunner.md)
# Membuat layanan App Runner
**Anda dapat membuat layanan App Runner di Toolkit for VS Code dengan menggunakan Palet **AWS Perintah** Explorer dan VS Code.** Setelah Anda memilih untuk membuat layanan di AWS Wilayah tertentu, langkah-langkah bernomor yang disediakan oleh **Command Palette** memandu Anda melalui proses mengonfigurasi instance layanan tempat aplikasi Anda berjalan.
Sebelum membuat layanan App Runner, pastikan Anda telah menyelesaikan [prasyarat](using-apprunner.md#apprunner-prereqs). Ini termasuk memberikan izin IAM yang relevan dan mengonfirmasi repositori sumber tertentu yang ingin Anda terapkan.
# Untuk membuat layanan App Runner
1. Buka AWS Explorer, jika belum terbuka.
1. Klik kanan node **App Runner** dan pilih **Create** Service.
**Palet Perintah** ditampilkan.
1. Untuk **Pilih jenis lokasi kode sumber**, pilih **ECR** atau **Repositori**.
Jika Anda memilih **ECR**, Anda menentukan gambar kontainer dalam repositori yang dikelola oleh Amazon Elastic Container Registry. Jika Anda memilih **Repositori**, Anda menentukan repositori kode sumber yang dikelola oleh penyedia repositori yang didukung. Saat ini, App Runner mendukung [GitHub](https://github.com/)sebagai penyedia repositori kode sumber.
## Menerapkan dari ECR
1. Untuk **Pilih atau masukkan repositori gambar**, pilih atau masukkan URL repositori gambar yang dikelola oleh registri pribadi Amazon ECR Anda atau Galeri Publik Amazon ECR.
**catatan**
Jika Anda menentukan repositori dari Galeri Publik Amazon ECR, pastikan penerapan otomatis dimatikan karena App Runner tidak mendukung penerapan otomatis untuk gambar di repositori Publik ECR.
Penerapan otomatis dimatikan secara default, dan ini ditunjukkan ketika ikon pada header **Command Palette** menampilkan garis diagonal melaluinya. Jika Anda memilih untuk mengaktifkan penerapan otomatis, sebuah pesan memberi tahu Anda bahwa opsi ini dapat menimbulkan biaya tambahan.
1. Jika langkah **Command Palette** melaporkan bahwa **Tidak ada tag yang ditemukan**, Anda harus kembali ke langkah untuk memilih repositori yang berisi gambar kontainer yang ditandai.
1. **Jika Anda menggunakan registri pribadi Amazon ECR, Anda memerlukan peran akses ECR, Peran, AppRunner ECRAccess yang memungkinkan App Runner mengakses gambar Amazon Elastic Container Registry (Amazon ECR) di akun Anda.** Pilih ikon “\$1” pada header **Command Palette** untuk membuat peran ini secara otomatis. (Peran akses tidak diperlukan jika gambar Anda disimpan di Amazon ECR Public, tempat gambar tersedia untuk umum.)
1. Untuk **Port**, masukkan port IP yang digunakan oleh layanan (Port`8000`, misalnya).
1. Untuk **Konfigurasi variabel lingkungan**, Anda dapat menentukan file yang berisi variabel lingkungan yang digunakan untuk menyesuaikan perilaku dalam instance layanan Anda. Atau Anda dapat melewati langkah ini.
1. Untuk **Nama layanan Anda**, masukkan nama unik tanpa spasi dan tekan **Enter**.
1. Untuk **konfigurasi instans Pilih**, pilih kombinasi unit CPU dan memori dalam GB untuk instance layanan Anda.
Ketika layanan Anda sedang dibuat, statusnya berubah dari **Creating** to **Running**.
1. Setelah layanan Anda mulai berjalan, klik kanan dan pilih **Salin URL Layanan**.
1. Untuk mengakses aplikasi yang Anda gunakan, rekatkan URL yang disalin ke bilah alamat browser web Anda.
## Menerapkan dari repositori jarak jauh
1. Untuk **Pilih koneksi**, pilih koneksi yang terhubung GitHub ke AWS. Koneksi yang tersedia untuk dipilih tercantum di halaman **GitHub koneksi** di konsol App Runner.
1. Untuk **Pilih GitHub repositori jarak jauh**, pilih atau masukkan URL untuk repositori jarak jauh.
Repositori jarak jauh yang sudah dikonfigurasi dengan manajemen kontrol sumber (SCM) Visual Studio Code tersedia untuk dipilih. Anda juga dapat menempelkan tautan ke repositori jika tidak terdaftar.
1. Untuk **Pilih cabang**, pilih cabang Git mana dari kode sumber Anda yang ingin Anda gunakan.
1. Untuk **Pilih sumber konfigurasi**, tentukan bagaimana Anda ingin menentukan konfigurasi runtime Anda.
Jika Anda memilih **Gunakan file konfigurasi**, instance layanan Anda dikonfigurasi oleh pengaturan yang ditentukan oleh file `apprunner.yaml` konfigurasi. File ini ada di direktori root repositori aplikasi Anda.
Jika Anda memilih **Konfigurasikan semua pengaturan di sini**, gunakan **palet Command** untuk menentukan hal berikut:
+ **Runtime**: Pilih **Python** 3 **atau** Nodejs 12.
+ **Perintah build**: Masukkan perintah untuk membangun aplikasi Anda di lingkungan runtime instance layanan Anda.
+ **Mulai perintah**: Masukkan perintah untuk memulai aplikasi Anda di lingkungan runtime instance layanan Anda.
1. Untuk **Port**, masukkan port IP yang digunakan oleh layanan (Port`8000`, misalnya).
1. Untuk **Konfigurasi variabel lingkungan**, Anda dapat menentukan file yang berisi variabel lingkungan yang digunakan untuk menyesuaikan perilaku dalam instance layanan Anda. Atau Anda dapat melewati langkah ini.
1. Untuk **Nama layanan Anda**, masukkan nama unik tanpa spasi dan tekan **Enter**.
1. Untuk **konfigurasi instans Pilih**, pilih kombinasi unit CPU dan memori dalam GB untuk instance layanan Anda.
Ketika layanan Anda sedang dibuat, statusnya berubah dari **Creating** to **Running**.
1. Setelah layanan Anda mulai berjalan, klik kanan dan pilih **Salin URL Layanan**.
1. Untuk mengakses aplikasi yang Anda gunakan, rekatkan URL yang disalin ke bilah alamat browser web Anda.
**catatan**
Jika upaya Anda untuk membuat layanan App Runner gagal, layanan akan menampilkan status **Buat gagal** di **AWS Explorer**. Untuk tips pemecahan masalah, lihat [Saat pembuatan layanan gagal](https://docs.aws.amazon.com/apprunner/latest/dg/manage-create.html#manage-create.failure) di Panduan Pengembang *App Runner*.
# Mengelola layanan App Runner
Setelah membuat layanan App Runner, Anda dapat mengelolanya dengan menggunakan panel AWS Explorer untuk melakukan aktivitas berikut:
+ [Menjeda dan melanjutkan layanan App Runner](#pause-resume-apprunner)
+ [Menyebarkan layanan App Runner](#deploying-apprunner)
+ [Melihat aliran log untuk App Runner](#viewing-logs-apprunner)
+ [Menghapus layanan App Runner](#deleting-apprunner)
## Menjeda dan melanjutkan layanan App Runner
Jika Anda perlu menonaktifkan aplikasi web untuk sementara dan menghentikan kode agar tidak berjalan, Anda dapat menjeda layanan AWS App Runner. App Runner mengurangi kapasitas komputasi untuk layanan menjadi nol. Ketika Anda siap untuk menjalankan aplikasi Anda lagi, lanjutkan layanan App Runner Anda. App Runner menyediakan kapasitas komputasi baru, menyebarkan aplikasi Anda ke dalamnya, dan menjalankan aplikasi.
**penting**
Anda ditagih untuk App Runner hanya saat sedang berjalan. Oleh karena itu, Anda dapat menjeda dan melanjutkan aplikasi Anda sesuai kebutuhan untuk mengelola biaya. Ini sangat membantu dalam skenario pengembangan dan pengujian.
## Untuk menjeda layanan App Runner
1. Buka AWS Explorer, jika belum terbuka.
1. Perluas **App Runner** untuk melihat daftar layanan.
1. Klik kanan layanan Anda dan pilih **Jeda**.
1. Di kotak dialog yang ditampilkan, pilih **Konfirmasi**.
**Saat layanan berhenti, status layanan berubah dari **Running** ke **Pusing dan kemudian ke Pause**.**
## Untuk melanjutkan layanan App Runner
1. Buka AWS Explorer, jika belum terbuka.
1. Perluas **App Runner** untuk melihat daftar layanan.
1. Klik kanan layanan Anda dan pilih **Lanjutkan**.
**Saat layanan dilanjutkan, status layanan berubah dari **Melanjutkan** ke Berjalan.**
## Menyebarkan layanan App Runner
Jika Anda memilih opsi penerapan manual untuk layanan Anda, Anda perlu secara eksplisit memulai setiap penerapan ke layanan Anda.
1. Buka AWS Explorer, jika belum terbuka.
1. Perluas **App Runner** untuk melihat daftar layanan.
1. Klik kanan layanan Anda dan pilih **Mulai Deployment**.
1. **Saat aplikasi Anda sedang di-deploy, status layanan berubah dari **Deploying** ke Running.**
1. Untuk mengonfirmasi bahwa aplikasi Anda berhasil digunakan, klik kanan layanan yang sama dan pilih **Salin URL Layanan**.
1. Untuk mengakses aplikasi web yang Anda gunakan, tempel URL yang disalin ke bilah alamat browser web Anda.
## Melihat aliran log untuk App Runner
Gunakan CloudWatch Log untuk memantau, menyimpan, dan mengakses aliran log Anda untuk layanan seperti App Runner. Pengaliran log adalah urutan log acara yang berbagi sumber yang sama.
1. Perluas **App Runner** untuk melihat daftar instance layanan.
1. Perluas instance layanan tertentu untuk melihat daftar grup log. (Grup log adalah grup aliran log yang berbagi pengaturan retensi, pemantauan, dan kontrol akses yang sama.)
1. Klik kanan grup log dan pilih **Lihat Aliran Log**.
1. Dari **Command Palette**, pilih aliran log dari grup.
Editor VS Code menampilkan daftar peristiwa log yang membentuk aliran. Anda dapat memilih untuk memuat acara lama atau yang lebih baru ke dalam editor.
## Menghapus layanan App Runner
**penting**
Jika Anda menghapus layanan App Runner, layanan tersebut akan dihapus secara permanen dan data yang disimpan akan dihapus. Jika Anda perlu membuat ulang layanan, App Runner perlu mengambil sumber Anda lagi dan membangunnya jika itu adalah repositori kode. Aplikasi web Anda mendapatkan domain App Runner baru.
1. Buka AWS Explorer, jika belum terbuka.
1. Perluas **App Runner** untuk melihat daftar layanan.
1. Klik kanan layanan dan pilih **Hapus Layanan**.
1. Di **Palet Perintah**, masukkan *hapus* dan kemudian tekan **Enter** untuk mengonfirmasi.
Layanan yang dihapus menampilkan status **Menghapus**, dan kemudian layanan menghilang dari daftar.