Construindo camadas Lambda em AWS SAM

Você pode usar AWS SAM para criar camadas Lambda personalizadas. As camadas do Lambda permitem que você extraia código de uma função do Lambda que pode ser reutilizado em várias funções do Lambda. Criar somente camadas Lambda (em vez de criar todo o aplicativo) pode beneficiar você de algumas maneiras. Ele pode ajudá-lo a reduzir o tamanho de seus pacotes de implantação, separar a lógica da função principal das dependências e permitir que você compartilhe dependências entre várias funções. Para obter informações sobre camadas, consulte Camadas do AWS Lambda no Guia do desenvolvedor do AWS Lambda .

Como criar uma camada Lambda no AWS SAM

nota

Antes de criar uma camada Lambda, você deve primeiro escrever uma camada Lambda no seu modelo. AWS SAM Para obter informações e exemplos sobre como fazer isso, consulteAumente a eficiência usando camadas Lambda com AWS SAM.

Para criar uma camada personalizada, declare-a em seu arquivo de modelo AWS Serverless Application Model (AWS SAM) e inclua uma seção de atributo de Metadata recurso com uma BuildMethod entrada. Os valores válidos para BuildMethod são identificadores de um AWS Lambda tempo de execução, ou makefile. Inclua uma entrada BuildArchitecture para especificar as arquiteturas do conjunto de instruções que sua camada suporta. Os valores válidos para BuildArchitecture são arquiteturas dos conjuntos de instruções Lambda.

Se você especificar makefile, forneça o makefile personalizado, onde você declara um destino de construção do formulário build-layer-logical-id que contém os comandos de construção para sua camada. Seu makefile é responsável por compilar a camada, se necessário, e copiar os artefatos de construção no local adequado para as etapas subsequentes do seu fluxo de trabalho. A localização do makefile é especificada pela propriedade ContentUri do recurso de camada e deve ser nomeada Makefile.

nota

Quando você cria uma camada personalizada, AWS Lambda depende das variáveis de ambiente para encontrar seu código de camada. Os tempos de execução do Lambda incluem caminhos no diretório /opt em que seu código de camada é copiado. A estrutura de pastas de artefatos de construção do seu projeto deve corresponder à estrutura de pastas esperada do tempo de execução para que seu código de camada personalizado possa ser encontrado.

Por exemplo, para Python, você pode colocar seu código no subdiretório python/. Para NodeJS, você pode colocar seu código no subdiretório nodejs/node_modules/.

Para obter mais informações, consulte Incluindo dependências de biblioteca em uma camada no AWS Lambda Guia do desenvolvedor.

Veja a seguir um exemplo de seção de atributo de recurso Metadata.

    Metadata:
      BuildMethod: python3.8
      BuildArchitecture: arm64

nota

Se você não incluir a seção do atributo do Metadata recurso, AWS SAM não cria a camada. Em vez disso, ele copia os artefatos de construção do local especificado na propriedade CodeUri do recurso de camada. Para obter mais informações, consulte a ContentUripropriedade do tipo de AWS::Serverless::LayerVersion recurso.

Ao incluir a seção do atributo do Metadata recurso, você pode usar o sam build comando para criar a camada, tanto como um objeto independente quanto como uma dependência de uma AWS Lambda função.

• Como um objeto independente. Talvez você queira criar apenas o objeto de camada, por exemplo, quando estiver testando localmente uma alteração de código na camada e não precisar criar todo o aplicativo. Para criar a camada de forma independente, especifique o recurso da camada com o comando sam build layer-logical-id.

• Como uma dependência de uma função do Lambda. Quando você inclui o ID lógico de uma camada na propriedade Layers de uma função do Lambda no mesmo arquivo de modelo AWS SAM , a camada é uma dependência dessa função do Lambda. Quando essa camada também inclui uma seção de atributo de recurso Metadata com uma entrada BuildMethod, você cria a camada criando o aplicativo inteiro com o comando sam build ou especificando o recurso da função com o comando sam build function-logical-id.

Exemplos

Exemplo de modelo 1: Criar uma camada com o ambiente de tempo de execução Python 3.9

O AWS SAM modelo de exemplo a seguir cria uma camada em relação ao ambiente de execução do Python 3.9.

Resources:
  MyLayer:
    Type: AWS::Serverless::LayerVersion
    Properties:
      ContentUri: my_layer
      CompatibleRuntimes:
        - python3.9
    Metadata:
      BuildMethod: python3.9   # Required to have AWS SAM build this layer

Exemplo de modelo 2: Crie uma camada usando um makefile personalizado

O AWS SAM modelo de exemplo a seguir usa um personalizado makefile para criar a camada.

Resources:
  MyLayer:
    Type: AWS::Serverless::LayerVersion
    Properties:
      ContentUri: my_layer
      CompatibleRuntimes:
        - python3.8
    Metadata:
      BuildMethod: makefile

O seguinte makefile contém o destino da compilação e os comandos que serão executados. Observe que a propriedade ContentUri está definida como my_layer, portanto, o makefile deve estar localizado na raiz do subdiretório my_layer e o nome do arquivo deve ser Makefile. Observe também que os artefatos de construção são copiados para o python/ subdiretório para que AWS Lambda você possa encontrar o código da camada.

build-MyLayer:
  mkdir -p "$(ARTIFACTS_DIR)/python"
  cp *.py "$(ARTIFACTS_DIR)/python"
  python -m pip install -r requirements.txt -t "$(ARTIFACTS_DIR)/python"

Exemplo de comandos sam build

Os comandos sam build a seguir criam camadas que incluem as seções de atributos do recurso Metadata.

# Build the 'layer-logical-id' resource independently
$ sam build layer-logical-id
            
# Build the 'function-logical-id' resource and layers that this function depends on
$ sam build function-logical-id

# Build the entire application, including the layers that any function depends on
$ sam build