Gunakan kembali kode dan sumber daya menggunakan aplikasi bersarang di AWS SAM

Sebuah aplikasi nirserver dapat mencakup satu aplikasi nest atau lebih. Aplikasi bersarang adalah bagian dari aplikasi yang lebih besar dan dapat dikemas dan digunakan baik sebagai artefak yang berdiri sendiri atau sebagai komponen dari aplikasi yang lebih besar. Aplikasi bersarang memungkinkan Anda mengubah kode yang sering digunakan dan menjadi aplikasinya sendiri yang kemudian dapat digunakan kembali di aplikasi tanpa server yang lebih besar atau beberapa aplikasi tanpa server.

Seiring berkembangnya arsitektur tanpa server Anda, pola umum biasanya muncul di mana komponen yang sama didefinisikan dalam beberapa templat aplikasi. Aplikasi bersarang memungkinkan Anda untuk menggunakan kembali kode umum, fungsionalitas, sumber daya, dan konfigurasi secara terpisah AWS SAM template, memungkinkan Anda untuk hanya mempertahankan kode dari satu sumber. Ini mengurangi kode dan konfigurasi duplikat. Selain itu, pendekatan modular ini merampingkan pengembangan, meningkatkan organisasi kode, dan memfasilitasi konsistensi di seluruh aplikasi tanpa server. Dengan aplikasi nest, Anda tetap dapat lebih fokus pada logika bisnis yang unik untuk aplikasi Anda.

Untuk menentukan aplikasi nest di aplikasi nirserver Anda, gunakan tipe sumber daya AWS::Serverless::Application.

Anda dapat menentukan aplikasi nest dari dua sumber berikut:

• Sebuah AWS Serverless Application Repository aplikasi — Anda dapat menentukan aplikasi bersarang dengan menggunakan aplikasi yang tersedia untuk akun Anda di AWS Serverless Application Repository. Ini dapat berupa aplikasi pribadi di akun Anda, aplikasi yang dibagikan secara pribadi dengan akun Anda, atau aplikasi yang dibagikan secara publik di AWS Serverless Application Repository. Untuk informasi selengkapnya tentang tingkat izin penerapan yang berbeda, lihat Izin Penerapan Aplikasi dan Penerbitan Aplikasi di AWS Serverless Application Repository Panduan Pengembang.

• Aplikasi lokal – Anda dapat menentukan aplikasi nest dengan menggunakan aplikasi yang disimpan di sistem file lokal Anda.

Lihat bagian berikut untuk detail tentang cara menggunakan AWS SAM untuk menentukan kedua jenis aplikasi bersarang ini dalam aplikasi tanpa server Anda.

catatan

Jumlah maksimum aplikasi yang dapat di-nest dalam aplikasi nirserver adalah 200.

Jumlah maksimum parameter yang dapat dimiliki aplikasi nest adalah 60.

Mendefinisikan aplikasi bersarang dari AWS Serverless Application Repository

Anda dapat menentukan aplikasi bersarang dengan menggunakan aplikasi yang tersedia di AWS Serverless Application Repository Anda juga dapat menyimpan dan mendistribusikan aplikasi yang berisi aplikasi nest menggunakan . AWS Serverless Application Repository. Untuk meninjau detail aplikasi bersarang di AWS Serverless Application Repository, Anda dapat menggunakan AWS SDK, AWS CLI, atau konsol Lambda.

Untuk menentukan aplikasi yang di-host di AWS Serverless Application Repository di aplikasi tanpa server Anda AWS SAM template, gunakan tombol Copy as SAM Resource pada halaman detail setiap AWS Serverless Application Repository aplikasi. Untuk melakukannya, ikuti langkah-langkah berikut:

1. Pastikan Anda masuk ke AWS Management Console.

2. Temukan aplikasi yang ingin Anda sarang di AWS Serverless Application Repository dengan menggunakan langkah-langkah di bagian Browsing, Searching, dan Deploying Applications dari AWS Serverless Application Repository Panduan Pengembang.

3. Pilih tombol Salin sebagai SAM Sumber Daya. Bagian SAM template untuk aplikasi yang Anda lihat sekarang ada di clipboard Anda.

4. Tempelkan bagian SAM templat ke Resources: bagian file SAM templat untuk aplikasi yang ingin Anda sarang di aplikasi ini.

Berikut ini adalah bagian contoh SAM template untuk aplikasi bersarang yang di-host di AWS Serverless Application Repository:

Transform: AWS::Serverless-2016-10-31

Resources:
  applicationaliasname:
    Type: AWS::Serverless::Application
    Properties:
      Location:
        ApplicationId: arn:aws:serverlessrepo:us-east-1:123456789012:applications/application-alias-name
        SemanticVersion: 1.0.0
      Parameters:
        # Optional parameter that can have default value overridden
        # ParameterName1: 15 # Uncomment to override default value
        # Required parameter that needs value to be provided
        ParameterName2: YOUR_VALUE

Jika tidak ada pengaturan parameter yang diperlukan, Anda dapat menghilangkan bagian Parameters: pada templat.

penting

Aplikasi yang berisi aplikasi bersarang yang dihosting di AWS Serverless Application Repository mewarisi batasan berbagi aplikasi bersarang.

Misalnya, aplikasi dibagikan secara publik, tetapi berisi aplikasi bersarang yang hanya dibagikan secara pribadi dengan AWS akun yang membuat aplikasi induk. Dalam hal ini, jika Anda AWS akun tidak memiliki izin untuk menyebarkan aplikasi bersarang, Anda tidak dapat menerapkan aplikasi induk. Untuk informasi selengkapnya tentang izin untuk menerapkan aplikasi, lihat Izin Penerapan Aplikasi dan Penerbitan Aplikasi di AWS Serverless Application Repository Panduan Pengembang.

Mendefinisikan aplikasi nest dari sistem file lokal

Anda dapat menentukan aplikasi nest dengan menggunakan aplikasi yang disimpan di sistem file lokal Anda. Anda melakukan ini dengan menentukan jalur ke AWS SAM file template yang disimpan di sistem file lokal Anda.

Berikut ini adalah contoh bagian SAM template untuk aplikasi lokal bersarang:

Transform: AWS::Serverless-2016-10-31

Resources:
  applicationaliasname:
    Type: AWS::Serverless::Application
    Properties:
      Location: ../my-other-app/template.yaml
      Parameters:
        # Optional parameter that can have default value overridden
        # ParameterName1: 15 # Uncomment to override default value
        # Required parameter that needs value to be provided
        ParameterName2: YOUR_VALUE

Jika tidak ada pengaturan parameter, Anda dapat menghilangkan bagian Parameters: pada templat.

Men-deploy aplikasi nest

Anda dapat menerapkan aplikasi bersarang dengan menggunakan AWS SAM CLI perintahsam deploy. Untuk detail selengkapnya, lihat Menyebarkan aplikasi dan sumber daya Anda dengan AWS SAM.

catatan

Saat Anda menyebarkan aplikasi yang berisi aplikasi bersarang, Anda harus mengakuinya berisi aplikasi bersarang. Anda melakukan ini dengan meneruskan CAPABILITY_AUTO_EXPAND ke CreateCloudFormationChangeSet API, atau menggunakan aws serverlessrepo create-cloud-formation-change-set AWS CLI perintah.

Untuk informasi selengkapnya tentang mengakui aplikasi bersarang, lihat Mengakui IAM Peran, Kebijakan Sumber Daya, dan Aplikasi Bersarang saat Menerapkan Aplikasi di AWS Serverless Application Repository Panduan Pengembang.