Reutilizar código e recursos usando aplicações aninhadas no AWS SAM

Um aplicativo sem servidor pode incluir um ou mais aplicativos aninhados. Uma aplicação aninhada faz parte de um aplicação maior e pode ser empacotada e implantada como um artefato independente ou como um componente de uma aplicação maior. As aplicações aninhadas permitem que você transforme códigos usados com frequência em sua própria aplicação, que pode ser reutilizado em uma aplicação sem servidor maior ou em várias aplicações sem servidor.

À medida que as arquiteturas sem servidor crescem, normalmente surgem padrões comuns nos quais os mesmos componentes são definidos em vários modelos de aplicação. As aplicações aninhadas permitem que você reutilize códigos, funcionalidades, recursos e configurações comuns em modelos separados do AWS SAM, permitindo que você mantenha apenas o código de uma única origem. Isso reduz código e configurações duplicadas. Além disso, essa abordagem modular simplifica o desenvolvimento, aprimora a organização do código e facilita a consistência em aplicações sem servidor. Com aplicativos aninhados, você pode se concentrar mais na lógica de negócios exclusiva do seu aplicativo.

Para definir um aplicativo aninhado em seu aplicativo sem servidor, use o tipo de recurso AWS::Serverless::Application.

Você pode definir aplicativos aninhados a partir das duas fontes a seguir:

Consulte as seções a seguir para obter detalhes sobre como usar AWS SAM para definir esses dois tipos de aplicativos aninhados em seu aplicativo sem servidor.

Definindo um aplicativo aninhado a partir do AWS Serverless Application Repository

Você pode definir aplicativos aninhados usando aplicativos que estão disponíveis no AWS Serverless Application Repository. Você também pode armazenar e distribuir aplicativos que contêm aplicativos aninhados usando AWS Serverless Application Repository. Para revisar os detalhes de um aplicativo aninhado no AWS Serverless Application Repository, você pode usar o AWS SDK, o AWS CLI, o ou console Lambda.

Para definir um aplicativo hospedado no AWS Serverless Application Repository em seu modelo AWS SAM do seu aplicativo sem servidor, use o botão Copiar como recurso do SAM na página de detalhes de cada aplicativo AWS Serverless Application Repository. Para isso, siga estas etapas:

Veja a seguir um exemplo de seção de modelo de SAM para um aplicativo aninhado hospedado no 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

Se não houver configurações de parâmetros obrigatórias, você poderá omitir a seção Parameters: do modelo.

Definindo um aplicativo aninhado a partir do sistema de arquivos local

Você pode definir aplicativos aninhados usando aplicativos armazenados no sistema de arquivos local. Você faz isso especificando o caminho para o arquivo de modelo AWS SAM que está armazenado em seu sistema de arquivos local.

Veja a seguir um exemplo de seção de modelo de SAM para um aplicativo local aninhado:

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

Se não houver configurações de parâmetros, você poderá omitir a seção Parameters: do modelo.

Implantar aplicativos aninhados

Você pode implantar seu aplicativo aninhado usando o comando sam deploy do AWS SAM CLI. Consulte mais detalhes em Implantar a aplicação e os recursos com o AWS SAM.