Menggunakan fungsi Lambda di AWS SAM dan Komposer Infrastruktur

Dalam tutorial ini, Anda dapat mulai menggunakan IaC dengan Lambda dengan membuat AWS SAM template dari fungsi Lambda yang ada dan kemudian membangun aplikasi tanpa server di Infrastructure Composer dengan menambahkan sumber daya lainnya. AWS

Saat Anda melaksanakan tutorial ini, Anda akan mempelajari beberapa konsep dasar, seperti bagaimana AWS sumber daya ditentukan di AWS SAM. Anda juga akan belajar cara menggunakan Infrastructure Composer untuk membangun aplikasi tanpa server yang dapat Anda terapkan menggunakan AWS SAM atau CloudFormation.

Untuk menyelesaikan tutorial ini, Anda akan melakukan langkah-langkah berikut:

Prasyarat

Dalam tutorial ini, Anda menggunakan fitur sinkronisasi lokal Infrastructure Composer untuk menyimpan template dan file kode Anda ke mesin build lokal Anda. Untuk menggunakan fitur ini, Anda memerlukan browser yang mendukung File System Access API, yang memungkinkan aplikasi web membaca, menulis, dan menyimpan file di sistem file lokal Anda. Sebaiknya gunakan Google Chrome atau Microsoft Edge. Untuk informasi selengkapnya tentang API Akses Sistem File, lihat Apa itu API Akses Sistem File?

Buat fungsi Lambda

Pada langkah pertama ini, Anda membuat fungsi Lambda yang dapat Anda gunakan untuk menyelesaikan sisa tutorial. Agar semuanya tetap sederhana, Anda menggunakan konsol Lambda untuk membuat fungsi dasar 'Hello world' menggunakan runtime Python 3.11.

Lihat AWS SAM template untuk fungsi Anda

Sebelum Anda mengekspor konfigurasi fungsi Anda ke Infrastructure Composer, gunakan konsol Lambda untuk melihat konfigurasi fungsi Anda saat ini sebagai AWS SAM templat. Dengan mengikuti langkah-langkah di bagian ini, Anda akan belajar tentang anatomi AWS SAM template dan cara mendefinisikan sumber daya seperti fungsi Lambda untuk mulai menentukan aplikasi tanpa server.

Mari kita luangkan waktu sejenak untuk melihat template YAML untuk fungsi Anda dan memahami beberapa konsep kunci.

Template dimulai dengan deklarasiTransform: AWS::Serverless-2016-10-31. Deklarasi ini diperlukan karena di balik layar, AWS SAM template digunakan melalui CloudFormation. Menggunakan Transform pernyataan mengidentifikasi template sebagai file AWS SAM template.

Setelah Transform deklarasi muncul Resources bagian. Di sinilah AWS sumber daya yang ingin Anda terapkan dengan AWS SAM template Anda ditentukan. AWS SAM template dapat berisi kombinasi AWS SAM sumber daya dan CloudFormation sumber daya. Ini karena selama penerapan, AWS SAM template diperluas ke CloudFormation templat, sehingga CloudFormation sintaks yang valid dapat ditambahkan ke AWS SAM template.

Saat ini, hanya ada satu sumber daya yang ditentukan di Resources bagian template, fungsi LambdaIaCDemo Lambda Anda. Untuk menambahkan fungsi Lambda ke AWS SAM template, Anda menggunakan jenis AWS::Serverless::Function sumber daya. Sumber Properties daya fungsi Lambda menentukan runtime fungsi, pengendali fungsi, dan opsi konfigurasi lainnya. Jalur ke kode sumber fungsi Anda yang AWS SAM harus digunakan untuk menerapkan fungsi juga didefinisikan di sini. Untuk mempelajari lebih lanjut tentang sumber daya fungsi Lambda di AWS SAM, lihat AWS::Serverless: :Function di Panduan Peng AWS SAM embang.

Selain properti fungsi dan konfigurasi, template juga menentukan kebijakan AWS Identity and Access Management (IAM) untuk fungsi Anda. Kebijakan ini memberikan izin fungsi Anda untuk menulis log ke Amazon CloudWatch Logs. Saat Anda membuat fungsi di konsol Lambda, Lambda secara otomatis melampirkan kebijakan ini ke fungsi Anda. Untuk mempelajari selengkapnya tentang menentukan kebijakan IAM untuk fungsi dalam AWS SAM template, lihat policies properti di halaman AWS::Serverless: :Function pada Panduan Peng AWS SAM embang.

Untuk mempelajari lebih lanjut tentang struktur AWS SAM templat, lihat anatomi AWS SAM template.

Gunakan AWS Infrastructure Composer untuk merancang aplikasi tanpa server

Untuk mulai membangun aplikasi tanpa server sederhana menggunakan AWS SAM template fungsi Anda sebagai titik awal, Anda mengekspor konfigurasi fungsi Anda ke Infrastructure Composer dan mengaktifkan mode sinkronisasi lokal Infrastructure Composer. Sinkronisasi lokal secara otomatis menyimpan kode fungsi dan AWS SAM template Anda ke mesin build lokal Anda dan menjaga template yang disimpan Anda tetap disinkronkan saat Anda menambahkan AWS sumber daya lain di Infrastructure Composer.

Untuk mengekspor fungsi Anda ke Infrastructure Composer, Anda memerlukan izin untuk menggunakan tindakan API tertentu. Jika Anda tidak dapat mengekspor fungsi Anda, lihat Izin yang diperlukan dan pastikan Anda memiliki izin yang Anda butuhkan.

Sekarang setelah Anda menambahkan sumber daya tambahan ini, mari kita lihat AWS SAM template terbaru yang telah dibuat oleh Infrastructure Composer.

AWS SAM Template Anda sekarang harus berisi sumber daya dan properti tambahan berikut:

AWS SAM Template akhir lengkap akan terlihat seperti berikut ini.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
Description: An AWS Serverless Specification template describing your function.
Resources:
  LambdaIaCDemo:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: .
      Description: ''
      MemorySize: 128
      Timeout: 3
      Handler: lambda_function.lambda_handler
      Runtime: python3.11
      Architectures:
        - x86_64
      EventInvokeConfig:
        MaximumEventAgeInSeconds: 21600
        MaximumRetryAttempts: 2
      EphemeralStorage:
        Size: 512
      RuntimeManagementConfig:
        UpdateRuntimeOn: Auto
      SnapStart:
        ApplyOn: None
      PackageType: Zip
      Policies:
        - Statement:
            - Effect: Allow
              Action:
                - logs:CreateLogGroup
              Resource: arn:aws:logs:us-east-1:594035263019:*
            - Effect: Allow
              Action:
                - logs:CreateLogStream
                - logs:PutLogEvents
              Resource:
                - arn:aws:logs:us-east-1:594035263019:log-group:/aws/lambda/LambdaIaCDemo:*
        - DynamoDBCrudPolicy:
            TableName: !Ref LambdaIaCTable
      Events:
        LambdaIaCQueue:
          Type: SQS
          Properties:
            Queue: !GetAtt LambdaIaCQueue.Arn
            BatchSize: 1
      Environment:
        Variables:
          LAMBDAIACTABLE_TABLE_NAME: !Ref LambdaIaCTable
          LAMBDAIACTABLE_TABLE_ARN: !GetAtt LambdaIaCTable.Arn
  LambdaIaCQueue:
    Type: AWS::SQS::Queue
    Properties:
      MessageRetentionPeriod: 345600
  LambdaIaCTable:
    Type: AWS::DynamoDB::Table
    Properties:
      AttributeDefinitions:
        - AttributeName: id
          AttributeType: S
      BillingMode: PAY_PER_REQUEST
      KeySchema:
        - AttributeName: id
          KeyType: HASH
      StreamSpecification:
        StreamViewType: NEW_AND_OLD_IMAGES

Menyebarkan aplikasi tanpa server Anda menggunakan AWS SAM (opsional)

Jika Anda ingin menggunakan AWS SAM untuk menyebarkan aplikasi tanpa server menggunakan template yang baru saja Anda buat di Infrastructure Composer, Anda harus terlebih dahulu menginstal. AWS SAM CLI Untuk melakukan ini, ikuti instruksi di Memasang AWS SAM CLI.

Sebelum menerapkan aplikasi Anda, Anda juga perlu memperbarui kode fungsi yang disimpan oleh Infrastructure Composer bersama dengan template Anda. Saat ini, lambda_function.py file yang disimpan Infrastructure Composer hanya berisi kode dasar 'Halo dunia' yang disediakan Lambda saat Anda membuat fungsi.

Untuk memperbarui kode fungsi Anda, salin kode berikut dan tempel ke lambda_function.py file Infrastructure Composer yang disimpan ke mesin build lokal Anda. Anda menentukan direktori untuk Infrastructure Composer untuk menyimpan file ini ketika Anda mengaktifkan mode Sinkronisasi Lokal.

Kode ini menerima pasangan nilai kunci dalam pesan dari antrian Amazon SQS yang Anda buat di Infrastructure Composer. Jika kunci dan nilai adalah string, kode kemudian menggunakannya untuk menulis item ke tabel DynamoDB yang ditentukan dalam template Anda.

import boto3
import os
import json

# define the DynamoDB table that Lambda will connect to
tablename = os.environ['LAMBDAIACTABLE_TABLE_NAME']

# create the DynamoDB resource
dynamo = boto3.client('dynamodb')

def lambda_handler(event, context):
    # get the message out of the SQS event
    message = event['Records'][0]['body']
    data = json.loads(message)
    # write event data to DDB table
    if check_message_format(data):
        key = next(iter(data))
        value = data[key]
        dynamo.put_item(
            TableName=tablename,
            Item={
                'id': {'S': key},
                'Value': {'S': value}
            }
        )
    else:
        raise ValueError("Input data not in the correct format")

# check that the event object contains a single key value  
# pair that can be written to the database
def check_message_format(message):
    if len(message) != 1:
        return False
        
    key, value = next(iter(message.items()))
    
    if not (isinstance(key, str) and isinstance(value, str)):
        return False

    else:
        return True

Selama proses penerapan, AWS SAM buat sumber daya berikut di Akun AWS:

AWS SAM juga membuat peran dan kebijakan IAM yang diperlukan agar fungsi Lambda Anda dapat membaca pesan dari antrian Amazon SQS dan melakukan operasi CRUD pada tabel DynamoDB.

Menguji aplikasi yang Anda gunakan (opsional)

Untuk mengonfirmasi bahwa aplikasi tanpa server digunakan dengan benar, kirim pesan ke antrian Amazon SQS berisi pasangan nilai kunci dan periksa apakah Lambda menulis item ke tabel DynamoDB menggunakan nilai-nilai ini.