View a markdown version of this page

Buat aplikasi Anda di AWS SAM - AWS Serverless Application Model

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat aplikasi Anda di AWS SAM

Setelah selesai Memulai dan membaca Cara menggunakan AWS Serverless Application Model (AWS SAM), Anda akan siap untuk membuat AWS SAM proyek di lingkungan pengembang Anda. Anda AWS SAM proyek akan berfungsi sebagai titik awal untuk menulis aplikasi tanpa server Anda. Untuk daftar AWS SAM CLI sam init opsi perintah, lihat init sam.

The AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam init perintah menyediakan opsi untuk menginisialisasi aplikasi tanpa server baru yang terdiri dari:

  • Sebuah AWS SAM template untuk menentukan kode infrastruktur Anda.

  • Struktur folder yang mengatur aplikasi Anda.

  • Konfigurasi untuk Anda AWS Lambda Fungsi Acara.

Untuk membuat AWS SAM proyek, lihat topik di bagian ini.

penting

Template kustom dapat menyertakan kait yang menjalankan kode pada mesin Anda saat sam init menciptakan proyek. Dapatkan template khusus hanya dari penulis yang Anda percayai.

catatan

sam init termasuk template proyek untuk fungsi tahan lama dalam runtime yang didukung (TypeScript, Python, Jawa). Template ini menyediakan kode awal dan konfigurasi untuk membangun aplikasi tanpa server yang berstatus.

Menginisialisasi aplikasi tanpa server baru

Untuk menginisialisasi aplikasi tanpa server baru menggunakan AWS SAM CLI
  1. cd ke direktori awal.

  2. Jalankan yang berikut ini di baris perintah:

    $ sam init
  3. The AWS SAM CLI akan memandu Anda melalui aliran interaktif untuk membuat aplikasi tanpa server baru.

    catatan

    Seperti yang dirinci dalam Tutorial: Menyebarkan aplikasi Hello World dengan AWS SAM, perintah ini menginisialisasi aplikasi tanpa server Anda, membuat direktori proyek Anda. Direktori ini akan berisi beberapa file dan folder. File yang paling penting adalah template.yaml. Ini adalah milikmu AWS SAM templat. Versi python Anda harus sesuai dengan versi python yang tercantum di template.yaml arsipkan bahwa sam init perintah dibuat.

Pilih template awal

SEBUAH templat terdiri dari yang berikut:

  1. Sebuah AWS SAM template untuk kode infrastruktur Anda.

  2. Direktori proyek awal yang mengatur file proyek Anda. Misalnya, ini mungkin termasuk:

    1. Struktur untuk kode fungsi Lambda Anda dan dependensinya.

    2. Sebuah events folder yang berisi acara pengujian untuk pengujian lokal.

    3. SEBUAH tests folder untuk mendukung pengujian unit.

    4. SEBUAH samconfig.toml file untuk mengkonfigurasi pengaturan proyek.

    5. SEBUAH ReadMe file dan file proyek awal dasar lainnya.

    Berikut ini adalah contoh direktori proyek awal:

    sam-app
    ├── README.md
    ├── __init__.py
    ├── events
    │   └── event.json
    ├── hello_world
    │   ├── __init__.py
    │   ├── app.py
    │   └── requirements.txt
    ├── samconfig.toml
    ├── template.yaml
    └── tests
        ├── __init__.py
        ├── integration
        │   ├── __init__.py
        │   └── test_api_gateway.py
        ├── requirements.txt
        └── unit
            ├── __init__.py
            └── test_handler.py

Anda dapat memilih dari daftar yang tersedia AWS Templat Mulai Cepat atau berikan milik Anda sendiri Lokasi Template Kustom.

Untuk memilih AWS Templat Mulai Cepat
  1. Saat diminta, pilih AWS Templat Mulai Cepat.

  2. Pilih AWS Template Mulai Cepat untuk memulai. Berikut ini adalah contohnya:

    Which template source would you like to use?
        1 - AWS Quick Start Templates
        2 - Custom Template Location
    Choice: 1
    
    Choose an AWS Quick Start application template
        1 - Hello World Example
        2 - Multi-step workflow
        3 - Serverless API
        4 - Scheduled task
        5 - Standalone function
        6 - Data processing
        7 - Hello World Example With Powertools
        8 - Infrastructure event management
        9 - Serverless Connector Hello World Example
        10 - Multi-step workflow with Connectors
        11 - Lambda EFS example
        12 - DynamoDB Example
        13 - Machine Learning
    Template: 4
Untuk memilih lokasi template kustom Anda sendiri
  1. Saat diminta, pilih Lokasi Template Kustom.

    Which template source would you like to use?
        1 - AWS Quick Start Templates
        2 - Custom Template Location
    Choice: 2
  2. The AWS SAM CLI akan meminta Anda untuk memberikan lokasi template.

    Template location (git, mercurial, http(s), zip, path):

    Berikan salah satu lokasi berikut ke arsip file .zip template Anda:

    • GitHub repositori — Jalur ke file.zip di GitHub repositori. File harus berada di root repositori Anda.

    • Mercurial repositori — Jalur ke file.zip di Mercurial repositori. File harus berada di root repositori Anda.

    • Jalur.zip — HTTPS atau jalur lokal ke file.zip Anda.

  3. The AWS SAM CLI akan menginisialisasi aplikasi tanpa server Anda menggunakan template kustom Anda.

Pilih runtime

Ketika Anda memilih AWS Templat Mulai Cepat, AWS SAM CLI meminta Anda untuk memilih runtime untuk fungsi Lambda Anda. Daftar opsi yang ditampilkan oleh AWS SAM CLI adalah runtime yang didukung secara asli oleh Lambda.

  • Runtime menyediakan lingkungan khusus bahasa yang berjalan di lingkungan eksekusi.

  • Ketika dikerahkan ke AWS Cloud, layanan Lambda memanggil fungsi Anda dalam lingkungan eksekusi.

Anda dapat menggunakan bahasa pemrograman lain dengan runtime khusus. Untuk melakukan ini, Anda perlu membuat struktur aplikasi awal secara manual. Anda kemudian dapat menggunakan sam init untuk menginisialisasi aplikasi Anda dengan cepat dengan mengonfigurasi lokasi template khusus.

Dari pilihan Anda, AWS SAM CLI membuat direktori awal untuk kode fungsi Lambda dan dependensi Anda.

Jika Lambda mendukung beberapa manajer ketergantungan untuk runtime Anda, Anda akan diminta untuk memilih manajer ketergantungan pilihan Anda.

Pilih jenis paket

Ketika Anda memilih AWS Templat Mulai Cepat dan a runtime, AWS SAM CLI meminta Anda untuk memilih jenis paket. Jenis paket menentukan bagaimana fungsi Lambda digunakan untuk digunakan dengan layanan Lambda. Dua jenis paket yang didukung adalah:

  1. Gambar kontainer - Berisi sistem operasi dasar, runtime, ekstensi Lambda, kode aplikasi Anda, dan dependensinya.

  2. arsip file.zip — Berisi kode aplikasi Anda dan dependensinya.

Untuk mempelajari lebih lanjut tentang jenis paket penerapan, lihat Paket penerapan Lambda di AWS Lambda Panduan Pengembang.

Berikut ini adalah contoh struktur direktori aplikasi dengan fungsi Lambda yang dikemas sebagai image container. The AWS SAM CLI mengunduh gambar dan membuat Dockerfile di direktori fungsi untuk menentukan gambar.

sam-app
├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── Dockerfile
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
    ├── __init__.py
    └── unit
        ├── __init__.py
        └── test_handler.py

Berikut ini adalah contoh struktur direktori aplikasi dengan fungsi yang dikemas sebagai arsip file.zip.

sam-app
├── README.md
├── __init__.py
├── events
│   └── event.json
├── hello_world
│   ├── __init__.py
│   ├── app.py
│   └── requirements.txt
├── samconfig.toml
├── template.yaml
└── tests
    ├── __init__.py
    ├── integration
    │   ├── __init__.py
    │   └── test_api_gateway.py
    ├── requirements.txt
    └── unit
        ├── __init__.py
        └── test_handler.py

Konfigurasi AWS X-Ray melacak

Anda dapat memilih untuk mengaktifkan AWS X-Ray menelusuri. Untuk mempelajari lebih lanjut, lihat Apa itu AWS X-Ray? di AWS X-Ray Panduan Pengembang.

Jika Anda mengaktifkan, AWS SAM CLI mengkonfigurasi Anda AWS SAM templat. Berikut ini adalah contohnya:

Globals: Function: ... Tracing: Active Api: TracingEnabled: True

Konfigurasikan pemantauan dengan Amazon CloudWatch Wawasan Aplikasi

Anda dapat memilih untuk mengaktifkan pemantauan menggunakan Amazon CloudWatch Wawasan Aplikasi. Untuk mempelajari lebih lanjut, lihat Amazon CloudWatch Wawasan Aplikasi di Amazon CloudWatch Panduan Pengguna.

Jika Anda mengaktifkan, AWS SAM CLI mengkonfigurasi Anda AWS SAM templat. Berikut ini adalah contohnya:

Resources: ApplicationResourceGroup: Type: AWS::ResourceGroups::Group Properties: Name: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName ResourceQuery: Type: CLOUDFORMATION_STACK_1_0 ApplicationInsightsMonitoring: Type: AWS::ApplicationInsights::Application Properties: ResourceGroupName: Fn::Join: - '' - - ApplicationInsights-SAM- - Ref: AWS::StackName AutoConfigurationEnabled: 'true' DependsOn: ApplicationResourceGroup

Beri nama aplikasi Anda

Berikan nama untuk aplikasi Anda. The AWS SAM CLI membuat folder tingkat atas untuk aplikasi Anda menggunakan nama ini.

Pilihan untuk sam init

Berikut ini adalah beberapa opsi utama yang dapat Anda gunakan dengan sam init perintah. Untuk daftar semua opsi, lihat init sam.

Menginisialisasi aplikasi menggunakan lokasi template kustom

Gunakan --location opsi dan menyediakan lokasi template kustom yang didukung. Berikut ini adalah contohnya:

$ sam init --location https://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip

Menginisialisasi aplikasi tanpa aliran interaktif

Gunakan --no-interactive opsi dan berikan pilihan konfigurasi Anda di baris perintah untuk melewati alur interaktif. Berikut ini adalah contohnya:

$ sam init --no-interactive --runtime go1.x --name go-demo --dependency-manager mod --app-template hello-world

Pemecahan Masalah

Untuk memecahkan masalah AWS SAM CLI, lihat AWS SAM CLI penyelesaian masalah.

Contoh

Inisialisasi aplikasi tanpa server baru menggunakan Hello World AWS Templat Pemula

Untuk contoh ini, lihat Langkah 1: Inisialisasi contoh aplikasi Hello World di Tutorial: Menyebarkan aplikasi Hello World.

Menginisialisasi aplikasi tanpa server baru dengan lokasi template khusus

Berikut ini adalah contoh penyediaan a GitHub lokasi ke template kustom Anda:

$ sam init --location gh:aws-samples/cookiecutter-aws-sam-python $ sam init --location git+sh://git@github.com/aws-samples/cookiecutter-aws-sam-python.git $ sam init --location hg+ssh://hg@bitbucket.org/repo/template-name

Berikut ini adalah contoh jalur file lokal:

$ sam init --location /path/to/template.zip

Berikut ini adalah contoh jalur yang dapat dijangkau oleh HTTPS:

$ sam init --location https://github.com/aws-samples/sessions-with-aws-sam/raw/master/starter-templates/web-app.zip

Pelajari selengkapnya

Untuk mempelajari lebih lanjut tentang menggunakan sam init perintah, lihat yang berikut ini:

Langkah berikutnya

Sekarang kamu telah menciptakan AWS SAM proyek, Anda siap untuk mulai menulis aplikasi Anda. Lihat Tentukan infrastruktur Anda dengan AWS SAM untuk instruksi terperinci tentang tugas yang perlu Anda selesaikan untuk melakukan ini.