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.

Prasyarat

Sebelum Anda memulai tutorial, pastikan untuk mengambil tindakan berikut:

1. Selesaikan langkah-langkah pengaturan diMenyiapkan untuk App Runner.

2. Putuskan apakah Anda ingin bekerja dengan repositori atau GitHub repositori Bitbucket.

   • Untuk bekerja dengan Bitbucket, pertama-tama buat akun Bitbucket, jika Anda belum memilikinya. Jika Anda baru mengenal Bitbucket, lihat Memulai Bitbucket di Dokumentasi Cloud Bitbucket.

   • Untuk bekerja dengan GitHub, buat GitHubakun, jika Anda belum memilikinya. Jika Anda baru mengenal GitHub, lihat Memulai 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.

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

contoh requirements.txt

pyramid==2.0

contoh 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 Contohnya berisi situs web Python sederhana. Ini adalah langkah-langkah utama yang Anda ambil untuk membuat layanan:

1. Konfigurasikan kode sumber Anda.

2. Konfigurasikan penyebaran sumber.

3. Konfigurasikan pembuatan aplikasi.

4. Konfigurasikan layanan Anda.

5. Tinjau dan konfirmasi.

Diagram berikut menguraikan langkah-langkah untuk membuat layanan App Runner:

Untuk membuat layanan App Runner berdasarkan repositori kode sumber

1. Konfigurasikan kode sumber Anda.

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

   2. Jika Akun AWS belum memiliki layanan App Runner, halaman beranda konsol akan ditampilkan. Pilih Buat layanan App Runner.

      

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

      

   3. Pada halaman Sumber dan penyebaran, di bagian Sumber, untuk jenis Repositori, pilih repositori kode sumber.

   4. Pilih Jenis Penyedia. Pilih salah satu GitHubatau Bitbucket.

   5. Selanjutnya pilih Tambah baru. Jika diminta, berikan kredensi Anda GitHub atau Bitbucket.

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

        2. Jika ini pertama kali Anda gunakan GitHub dengan App Runner, pilih Instal yang lain.

        3. Di kotak GitHub dialog AWS Konektor untuk, jika diminta, pilih nama GitHub akun Anda.

        4. Jika diminta untuk mengotorisasi AWS Konektor GitHub, pilih Otorisasi Koneksi AWS.

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

        6. Untuk Repositori, pilih contoh repositori yang Anda buat,. python-hello Untuk Branch, pilih nama cabang default repositori Anda (misalnya, main).

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

        2. Jika ini pertama kalinya Anda menggunakan Bitbucket dengan App Runner, pilih Install another.

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

        4. Selanjutnya Anda akan diarahkan ke AWS konsol. Verifikasi bahwa aplikasi Bitbucket diatur ke ruang kerja Bitbucket yang benar dan pilih Berikutnya.

        5. Untuk Repositori, pilih contoh repositori yang Anda buat,. python-hello Untuk Branch, pilih nama cabang default repositori Anda (misalnya, main).

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

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

   

3. Konfigurasikan pembuatan aplikasi.

   1. Pada halaman Konfigurasi build, untuk file Konfigurasi, pilih Konfigurasi semua pengaturan di sini.

   2. Berikan setelan build berikut:

      • Runtime - Pilih Python 3.

      • Membangun perintah — Enterpip install -r requirements.txt.

      • Mulai perintah — Enterpython server.py.

      • Pelabuhan — Masuk8080.

   3. Pilih Selanjutnya.

   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.

   

4. Konfigurasikan layanan Anda.

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

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

   3. Pilih Selanjutnya.

   

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

   

6. Verifikasi bahwa layanan Anda sedang berjalan.

   1. Pada halaman dasbor layanan, tunggu hingga Status layanan Berjalan.

   2. Pilih nilai domain default — ini adalah URL ke situs web layanan 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.

      Sebuah halaman web menampilkan: Halo, nama Anda!

   

Langkah 2: Ubah kode layanan Anda

Pada langkah ini, Anda membuat perubahan pada kode Anda di direktori sumber repositori. Kemampuan CI/CD App Runner secara otomatis membangun dan menyebarkan perubahan ke layanan Anda.

Untuk membuat perubahan pada kode layanan Anda

1. Arahkan ke repositori contoh Anda.

2. Edit file bernamaserver.py.

3. Dalam ekspresi yang ditugaskan ke variabelmessage, ubah teks Hello menjadiGood morning.

4. Simpan dan komit perubahan Anda ke repositori.

5. Langkah-langkah berikut menggambarkan mengubah kode layanan dalam GitHub repositori.

   1. Arahkan ke GitHub repositori contoh Anda.

   2. Pilih nama file server.py untuk menavigasi ke file itu.

   3. Pilih Edit file ini (ikon pensil).

   4. Dalam ekspresi yang ditugaskan ke variabelmessage, ubah teks Hello menjadiGood morning.

      

   5. Pilih Perubahan commit.

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

7. Verifikasi bahwa penerapan berhasil: segarkan tab browser tempat halaman web layanan Anda ditampilkan.

   Halaman sekarang menampilkan pesan yang dimodifikasi: Selamat pagi, nama Anda!

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, dan di daftar Wilayah, pilih Wilayah AWS.

2. Di panel navigasi, pilih Layanan, lalu pilih layanan App Runner Anda.

   Konsol menampilkan dasbor layanan dengan ikhtisar Layanan.

   

3. Pada halaman dasbor layanan, pilih tab Konfigurasi.

   Konsol menampilkan pengaturan konfigurasi layanan Anda di beberapa bagian.

4. Di bagian Konfigurasi layanan, pilih Edit.

   

5. Untuk variabel lingkungan dengan kunciNAME, ubah nilai ke nama yang berbeda.

6. Pilih Terapkan perubahan.

   App Runner memulai proses pembaruan. Pada halaman dasbor layanan, Status layanan berubah menjadi Operasi yang sedang berlangsung.

7. Tunggu pembaruan berakhir. Pada halaman dasbor layanan, Status layanan harus berubah kembali ke Running.

8. Verifikasi bahwa pembaruan berhasil: segarkan tab browser tempat halaman web layanan Anda ditampilkan.

   Halaman sekarang menampilkan nama yang dimodifikasi: Selamat pagi, nama baru!

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, lihatMelihat log App Runner dialirkan ke Log CloudWatch .

Untuk melihat log untuk layanan Anda

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

2. Di panel navigasi, pilih Layanan, lalu pilih layanan App Runner Anda.

   Konsol menampilkan dasbor layanan dengan ikhtisar Layanan.

   

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

   

4. Untuk menemukan penerapan tertentu, cakupkan daftar log penerapan dengan memasukkan istilah penelusuran. Anda dapat mencari nilai apa pun yang muncul di tabel.

5. Untuk melihat konten log, pilih Lihat log lengkap (log peristiwa) atau nama aliran log (penerapan dan log aplikasi).

6. Pilih Unduh untuk mengunduh log. Untuk aliran log penerapan, pilih aliran log terlebih dahulu.

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

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

Apa selanjutnya

Setelah menerapkan layanan App Runner pertama Anda, pelajari lebih lanjut dalam topik berikut:

• Arsitektur dan konsep App RunnerArsitektur, konsep utama, dan AWS sumber daya yang terkait dengan App Runner.

• Layanan berbasis gambardan Layanan berbasis kode — Dua jenis sumber aplikasi yang dapat diterapkan oleh App Runner.

• Mengembangkan kode aplikasi untuk App Runner— Hal-hal yang harus Anda ketahui saat mengembangkan atau memigrasi kode aplikasi untuk penerapan ke App Runner.

• Menggunakan konsol App Runner— Kelola dan pantau layanan Anda menggunakan konsol App Runner.

• Mengelola layanan App Runner— Kelola siklus hidup layanan App Runner Anda.

• Observabilitas untuk layanan App Runner— 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— Cara berbasis konfigurasi untuk menentukan opsi untuk perilaku build dan runtime layanan App Runner Anda.

• API Pelari Aplikasi— Gunakan antarmuka pemrograman aplikasi (API) App Runner untuk membuat, membaca, memperbarui, dan menghapus sumber daya App Runner.

• Keamanan di App Runner— Berbagai cara itu AWS dan Anda memastikan keamanan cloud saat Anda menggunakan App Runner dan layanan lainnya.