View a markdown version of this page

Membuat layanan App Runner - AWS App Runner
PrasyaratBuat layanan

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.

Membuat layanan App Runner

AWS App Runner mengotomatiskan transisi dari image kontainer atau repositori kode sumber ke layanan web yang sedang berjalan yang menskalakan secara otomatis. Anda mengarahkan App Runner ke gambar atau kode sumber Anda, hanya menentukan sejumlah kecil pengaturan yang diperlukan. App Runner membangun aplikasi Anda jika diperlukan, menyediakan sumber daya komputasi, dan menyebarkan aplikasi Anda untuk menjalankannya.

Saat Anda membuat layanan, App Runner membuat sumber daya layanan. Dalam beberapa kasus, Anda mungkin perlu menyediakan sumber daya koneksi. Jika Anda menggunakan konsol App Runner, konsol secara implisit membuat sumber daya koneksi. Untuk informasi selengkapnya tentang jenis sumber daya App Runner, lihatSumber daya Pelari Aplikasi. Jenis sumber daya ini memiliki kuota yang terkait dengan akun Anda di masing-masing Wilayah AWS. Untuk informasi selengkapnya, lihat Kuota sumber daya App Runner.

Ada perbedaan halus dalam prosedur untuk membuat layanan tergantung pada jenis sumber dan penyedia. Topik ini mencakup prosedur yang berbeda untuk membuat jenis sumber ini sehingga Anda dapat mengikuti mana pun yang cocok untuk situasi Anda. Untuk memulai prosedur dasar dengan contoh kode, lihatMemulai dengan App Runner.

Prasyarat

Sebelum membuat layanan App Runner, pastikan untuk menyelesaikan tindakan berikut:

Buat layanan

Bagian ini membahas proses pembuatan untuk dua jenis layanan App Runner: berdasarkan kode sumber, dan berdasarkan gambar kontainer.

catatan

Jika Anda membuat konektor VPC lalu lintas keluar untuk 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 di bagian Jaringan dengan App Runner dari panduan ini.

Bagian berikut menunjukkan cara membuat layanan App Runner ketika sumber Anda adalah repositori kode di GitHub atau Bitbucket. Saat Anda menggunakan repositori kode, App Runner harus terhubung ke organisasi atau akun penyedia. Karena itu, Anda perlu membantu membangun koneksi ini. Untuk informasi selengkapnya tentang koneksi App Runner, lihatMengelola koneksi App Runner.

Saat Anda membuat layanan, App Runner membangun image Docker yang berisi kode aplikasi dan dependensi Anda. Kemudian meluncurkan layanan yang menjalankan instance container dari gambar ini.

Membuat layanan dari kode menggunakan konsol App Runner

Untuk membuat layanan App Runner menggunakan konsol

  1. Konfigurasikan kode sumber Anda.

    1. Buka konsol App Runner, dan di daftar Wilayah, pilih Anda Wilayah AWS.

    2. 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

      Jika Akun AWS memiliki layanan yang sudah ada, halaman Layanan dengan daftar layanan Anda ditampilkan. Pilih Buat layanan.

      Halaman layanan konsol App Runner

    3. Pada halaman Sumber dan penerapan, di bagian Sumber, untuk Jenis Repositori, pilih Repositori kode sumber.

    4. Pilih Jenis Penyedia. Pilih salah satu GitHub atau Bitbucket.

    5. Selanjutnya pilih akun atau organisasi untuk Penyedia yang telah Anda gunakan sebelumnya, atau pilih Tambahkan baru. Kemudian, lakukan proses menyediakan kredenSIAL repositori kode Anda dan memilih akun atau organisasi untuk terhubung.

    6. Untuk Repositori, pilih repositori yang berisi kode aplikasi Anda.

    7. Untuk Cab ang, pilih cabang yang ingin Anda terapkan.

    8. Untuk direktori Sumber, masukkan direktori di repositori sumber yang menyimpan kode aplikasi dan file konfigurasi Anda.

      catatan

      Perintah build dan start dijalankan dari direktori sumber yang Anda tentukan. App Runner menangani jalur sebagai absolut dari root. Jika Anda tidak menentukan nilai di sini, direktori default ke root repositori.

  2. Konfigurasikan penerapan Anda.

    1. Di bagian Peng aturan penerapan, pilih Manual atau Otomatis.

      Untuk informasi selengkapnya tentang metode penerapan, lihatMetode deployment.

    2. Pilih Berikutnya.

    Pengaturan sumber dan penerapan saat membuat layanan App Runner

  3. Konfigurasikan build aplikasi.

    1. Pada halaman Konfigurasi build, untuk File konfigurasi, pilih Konfigurasikan semua pengaturan di sini jika repositori Anda tidak berisi file konfigurasi App Runner, atau Gunakan file konfigurasi jika ada.

      catatan

      File konfigurasi App Runner adalah cara untuk mempertahankan konfigurasi build Anda sebagai bagian dari sumber aplikasi Anda. Saat Anda menyediakannya, App Runner membaca beberapa nilai dari file dan tidak mengizinkan Anda mengaturnya di konsol.

    2. Berikan pengaturan build berikut:

      • Runtime — Pilih runtime terkelola tertentu untuk aplikasi Anda.

      • Membangun perintah — Masukkan perintah yang membangun aplikasi Anda dari kode sumbernya. Ini mungkin alat khusus bahasa atau skrip yang disediakan dengan kode Anda.

      • Perintah Mulai — Masukkan perintah yang memulai layanan web Anda.

      • Port — Masukkan port IP yang didengarkan layanan web Anda.

    3. Pilih Berikutnya.

    Membangun pengaturan saat membuat layanan App Runner

  4. Konfigurasikan layanan Anda.

    1. Pada halaman Konfigurasi layanan, di bagian Pengaturan layanan, masukkan nama layanan.

      catatan

      Semua pengaturan layanan lainnya bersifat opsional atau memiliki default yang disediakan konsol.

    2. Secara opsional, ubah atau tambahkan pengaturan lain untuk memenuhi persyaratan aplikasi Anda.

    3. Pilih Berikutnya.

    Pengaturan layanan saat membuat layanan App Runner

  5. Pada halaman Tinjau dan buat, verifikasi semua detail yang Anda masukkan, lalu pilih Buat dan terapkan.

    Hasil: Jika layanan berhasil dibuat, konsol menampilkan dasbor layanan dengan ikhtisar Layanan dari layanan baru.

    Halaman dasbor layanan App Runner

  6. Pastikan layanan Anda sedang berjalan.

    1. Pada halaman dasbor layanan, tunggu hingga Status layanan Ber jalan.

    2. Pilih nilai domain default. Ini adalah URL ke situs web layanan Anda.

    3. Gunakan situs web Anda dan verifikasi bahwa itu berjalan dengan benar.

Membuat layanan dari kode menggunakan App Runner API atau AWS CLI

Untuk membuat layanan menggunakan API App Runner atau AWS CLI, panggil tindakan CreateService API. Untuk informasi lebih lanjut dan contoh, lihat CreateService. Jika ini adalah pertama kalinya Anda membuat layanan menggunakan organisasi atau akun tertentu untuk repositori kode sumber (GitHub atau Bitbucket), mulailah dengan memanggil CreateConnection. Ini membuat koneksi antara App Runner dan organisasi atau akun penyedia repositori. Untuk informasi selengkapnya tentang koneksi App Runner, lihatMengelola koneksi App Runner.

Jika panggilan mengembalikan respons yang berhasil dengan objek Layanan ditampilkan"Status": "CREATING", layanan Anda mulai dibuat.

Untuk contoh panggilan, lihat Membuat layanan repositori kode sumber di Refer AWS App Runner ensi API

Bagian berikut menunjukkan cara membuat layanan App Runner ketika sumber Anda adalah gambar kontainer yang disimpan di Amazon ECR. Amazon ECR adalah Layanan AWS. Oleh karena itu, untuk membuat layanan berdasarkan gambar Amazon ECR, Anda memberi App Runner peran akses yang berisi izin tindakan Amazon ECR yang diperlukan.

catatan

Gambar yang disimpan di Amazon ECR Public tersedia untuk umum. Jadi, jika gambar Anda disimpan di Amazon ECR Public, peran akses tidak diperlukan.

Saat layanan Anda sedang dibuat, App Runner meluncurkan layanan yang menjalankan instance container dari gambar yang Anda berikan. Tidak ada fase pembangunan dalam kasus ini.

Untuk informasi selengkapnya, lihat Layanan App Runner berdasarkan gambar sumber.

Membuat layanan dari gambar menggunakan konsol App Runner

Untuk membuat layanan App Runner menggunakan konsol

  1. Konfigurasikan kode sumber Anda.

    1. Buka konsol App Runner, dan di daftar Wilayah, pilih Anda Wilayah AWS.

    2. 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

      Jika Akun AWS memiliki layanan yang sudah ada, halaman Layanan dengan daftar layanan Anda ditampilkan. Pilih Buat layanan.

      Halaman layanan konsol App Runner

    3. Pada halaman Sumber dan penerapan, di bagian Sumber, untuk Jenis Repositori, pilih registri kontainer.

    4. Untuk Penye dia, pilih penyedia tempat gambar Anda disimpan:

      • Amazon ECR — Gambar pribadi yang disimpan di Amazon ECR.

      • Amazon ECR Public — Gambar yang dapat dibaca publik yang disimpan di Amazon ECR Public.

    5. Untuk URI gambar kontainer, pilih Browse.

    6. Di kotak dialog Pilih gambar wadah Amazon ECR, untuk Repositori gambar, pilih repositori yang berisi gambar Anda.

    7. Untuk Tag gambar, pilih tag gambar tertentu yang ingin Anda terapkan (misalnya, terbaru), lalu pilih L anjutkan.

    Memilih gambar Amazon ECR saat membuat layanan App Runner

  2. Konfigurasikan penerapan Anda.

    1. Di bagian Peng aturan penerapan, pilih Manual atau Otomatis.

      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.

      Untuk informasi selengkapnya tentang metode penerapan, lihatMetode deployment.

    2. [Penyedia Amazon ECR] Untuk peran akses ECR, pilih peran layanan yang ada di akun Anda atau pilih untuk membuat peran baru. Jika Anda menggunakan penerapan manual, Anda juga dapat memilih untuk menggunakan peran pengguna IAM pada saat penerapan.

    3. Pilih Berikutnya.

    Pengaturan sumber dan penerapan saat membuat layanan App Runner

  3. Konfigurasikan layanan Anda.

    1. Pada halaman Konfigurasi layanan, di bagian Pengaturan layanan, masukkan nama layanan dan port IP yang didengarkan situs web layanan Anda.

      catatan

      Semua pengaturan layanan lainnya bersifat opsional atau memiliki default yang disediakan konsol.

    2. (Opsional) Ubah atau tambahkan pengaturan lain agar sesuai dengan kebutuhan aplikasi Anda.

    3. Pilih Berikutnya.

    Pengaturan layanan saat membuat layanan App Runner

  4. Pada halaman Tinjau dan buat, verifikasi semua detail yang Anda masukkan, lalu pilih Buat dan terapkan.

    Hasil: Jika layanan berhasil dibuat, konsol menampilkan dasbor layanan, dengan ikhtisar Layanan dari layanan baru.

    Halaman dasbor layanan App Runner

  5. Pastikan layanan Anda sedang berjalan.

    1. Pada halaman dasbor layanan, tunggu hingga Status layanan Ber jalan.

    2. Pilih nilai domain default. Ini adalah URL ke situs web layanan Anda.

    3. Gunakan situs web Anda dan verifikasi bahwa itu berjalan dengan benar.

Membuat layanan dari gambar menggunakan App Runner API atau AWS CLI

Untuk membuat layanan menggunakan API App Runner atau AWS CLI, panggil tindakan CreateService API.

Pembuatan layanan Anda dimulai jika panggilan mengembalikan respons yang berhasil dengan objek Layanan ditampilkan"Status": "CREATING".

Untuk contoh panggilan, lihat Membuat layanan repositori gambar sumber di Refer AWS App Runner ensi API