Memulai dengan App Runner - AWS App Runner
PrasyaratLangkah 1: Buat layanan App RunnerLangkah 2: Ubah kode layanan AndaLangkah 3: Buat perubahan konfigurasiLangkah 4: Lihat log untuk layanan AndaLangkah 5: BersihkanApa selanjutnya

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.

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.

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:

Diagram alur kerja pembuatan 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.

      Halaman beranda konsol App Runner yang menampilkan tombol buat layanan

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

      Halaman layanan konsol App Runner

    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.

    Pengaturan sumber dan penerapan saat membuat layanan App Runner

  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.

    Membangun setelan saat membuat layanan App Runner

  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.

    Pengaturan layanan saat membuat layanan App Runner

  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.

    Halaman dasbor layanan App Runner

  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!

    Halaman web aplikasi dari layanan App Runner

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.

      GitHub halaman file dengan ikon edit dan pesan disorot

    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.

    Halaman dasbor layanan App Runner yang menampilkan daftar Aktivitas

  3. Pada halaman dasbor layanan, pilih tab Konfigurasi.

    Konsol menampilkan pengaturan konfigurasi layanan Anda di beberapa bagian.

  4. Di bagian Konfigurasi layanan, pilih Edit.

    Bagian konfigurasi Layanan pada tab Konfigurasi pada halaman dasbor layanan App Runner

  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.

    Halaman dasbor layanan App Runner yang menampilkan daftar Aktivitas

  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.

    Tab Log di halaman dasbor layanan App Runner

  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: