Mulai Cepat: Penerbitan Aplikasi

Untuk menginisialisasi aplikasi

1. Jalankan perintah berikut pada prompt perintah CLI AWS SAM.

   sam init --runtime python3.6 

2. Tinjau isi direktori yang dibuat oleh perintah (sam-app/):

   • template.yaml— Mendefinisikan duaAWS sumber daya yang dibutuhkan aplikasi Hello World: fungsi Lambda dan titik akhir API Gateway yang mendukung operasi GET. Templat juga menentukan pemetaan antara dua sumber daya.

   • Konten yang terkait dengan kode aplikasi Hello World:

     • hello_world/direktori - Berisi kode aplikasi, yang kembalihello world ketika Anda menjalankannya.

   catatan

   Untuk latihan ini, kode aplikasi ditulis dengan Python, dan Anda menentukan runtime dalaminit perintah. AWS Lambdamendukung bahasa tambahan untuk membuat kode aplikasi. Jika Anda menentukan runtime lain yang didukung,init perintah tersebut menyediakan kode Hello World dalam bahasa yang ditentukan, danREADME.md file yang dapat Anda ikuti untuk bahasa tersebut. Untuk informasi tentang runtime yang didukung, lihat Lingkungan Eksekusi Lambda dan Pustaka yang Tersedia.

Untuk menguji aplikasi secara lokal

1. Mulai endpoint API Gateway secara lokal. Anda harus menjalankan perintah berikut dari direktori yang berisitemplate.yaml file tersebut.

   sam-app> sam local start-api --region us-east-1

   Perintah mengembalikan endpoint API Gateway, yang dapat Anda kirimkan permintaan untuk pengujian lokal.

2. Uji aplikasi. Salin URL endpoint API Gateway, tempelkan di browser, dan pilih Enter. Contoh URL endpoint API Gateway adalahhttp://127.0.0.1:3000/hello.

   API Gateway secara lokal memanggil fungsi Lambda tempat endpoint dipetakan. Fungsi Lambda dijalankan dalam kontainer Docker lokal dan kembalihello world. API Gateway mengembalikan respons ke browser yang berisi teks.

1. Edit/hello_world/app.py file untuk mengubah string pesan dari'hello world' ke'Hello World!'.

2. Muat ulang URL pengujian di browser Anda dan amati string baru.

Untuk membuat paket deployment Lambda

1. TambahkanMetadata bagian ke fileAWS SAM template Anda yang menyediakan informasi aplikasi yang diperlukan. Untuk informasi selengkapnya tentangMetadata bagianAWS SAM template, lihat Properti Bagian MetdataAWS SAM Template di PanduanAWS Serverless Application Model Pengembang.

   Berikut adalahMetadata bagian contoh:

   Metadata:
     AWS::ServerlessRepo::Application:
       Name: my-app
       Description: hello world
       Author: user1
       SpdxLicenseId: Apache-2.0
       LicenseUrl: LICENSE.txt
       ReadmeUrl: README.md
       Labels: ['tests']
       HomePageUrl: https://github.com/user1/my-app-project
       SemanticVersion: 0.0.1
       SourceCodeUrl: https://github.com/user1/my-app-project

   ReadmeUrlPropertiLicenseUrl dan properti dapat berupa referensi ke file lokal (seperti pada contoh di atas), atau dapat berupa tautan ke bucket Amazon S3 yang sudah menampung artefak ini.

2. Buat bucket S3 di lokasi tempat Anda ingin menyimpan kode yang dipaketkan. Jika Anda ingin menggunakan bucket S3 yang sudah ada, lewati langkah ini.

   sam-app> aws s3 mb s3://bucketname

3. Buat paket deployment fungsi Lambda dengan menjalankan perintahpackageAWS SAM CLI berikut ini.

   sam-app> sam package \
       --template-file template.yaml \
       --output-template-file packaged.yaml \
       --s3-bucket bucketname

   Perintah ini melakukan hal berikut:

   • Menitsleting kontenaws-sam/hello_world/ direktori dan mengunggahnya ke Amazon S3.

   • Mengunggah paket penerapan, file README, dan file LICENSE ke bucket Amazon S3 yang ditentukan oleh--s3-bucket opsi.

   • Menampilkan file templat baru, yang disebutpackaged.yaml, yang Anda gunakan di langkah berikutnya untuk memublikasikan aplikasi tersebutAWS Serverless Application Repository. Filepackaged.yaml templat mirip dengan file templat asli (template.yaml), tetapi memiliki perbedaan kunci—ReadmeUrl properti intiCodeUri,LicenseUrl, dan menunjuk pada bucket Amazon S3 dan objek yang mencakup artefaknya masing-masing. Sinppet berikut dari contoh file templat packaged.yaml menunjukkan properti CodeUri:

     HelloWorldFunction:
         Type: AWS::Serverless::Function # For more information about function resources, see https://github.com/awslabs/serverless-application-model/blob/master/versions/2016-10-31.md#awsserverlessfunction
         Properties:
           CodeUri: s3://bucketname/fbd77a3647a4f47a352fcObjectGUID
     
     ...

Untuk memublikasikan aplikasi tanpa server keAWS Serverless Application Repository

• Jalankan perintah berikut untuk mempublikasikan aplikasi baruAWS Serverless Application Repository dengan versi pertama yang dibuat sebagai 0.0.1.

  sam-app> sam publish \
      --template packaged.yaml \
      --region us-east-1