View a markdown version of this page

AWS::Serverless::MicrovmImage - AWS Serverless Application Model
SintaxePropriedadesValores de retornoExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS::Serverless::MicrovmImage

Cria uma imagem de AWS Lambda microVM a partir de um artefato de código armazenado no Amazon S3. Uma imagem de microVM é um Firecracker instantâneo criado a partir de um código de aplicativo, permitindo a inicialização em menos de um Dockerfile segundo para instâncias de microVM.

nota

Quando você implanta AWS CloudFormation, AWS SAM transforma seus AWS SAM recursos em CloudFormation recursos. Para obter mais informações, consulte Gerado CloudFormation recursos para AWS SAM.

Sintaxe

Para declarar essa entidade em seu modelo AWS Serverless Application Model (AWS SAM), use a sintaxe a seguir.

YAML

Type: AWS::Serverless::MicrovmImage
Properties:
  AdditionalOsCapabilities: List
  BaseImageArn: String
  BaseImageVersion: String
  BuildRoleArn: String
  CodeUri: String
  CpuConfigurations: List
  Description: String
  EgressNetworkConnectors: List
  EnvironmentVariables: Map
  Hooks: Hooks
  Logging: Logging
  Name: String
  PropagateTags: Boolean
  Resources: List
  Tags: Map

Propriedades

AdditionalOsCapabilities

Recursos adicionais do sistema operacional para conceder ao ambiente de tempo de execução do microVM. Se você não especificar um valor, o serviço não concederá recursos adicionais do sistema operacional.

Valores válidos: ALL

Tipo: lista

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a AdditionalOsCapabilities propriedade de um AWS::Lambda::MicrovmImage recurso.

BaseImageArn

O ARN da imagem base da microVM a partir da qual criar.

Tipo: string

Obrigatório: Sim

CloudFormation compatibilidade: essa propriedade é passada diretamente para a BaseImageArn propriedade de um AWS::Lambda::MicrovmImage recurso.

BaseImageVersion

A versão da imagem base do microVM a ser usada.

Tipo: string

Obrigatório: Sim

CloudFormation compatibilidade: essa propriedade é passada diretamente para a BaseImageVersion propriedade de um AWS::Lambda::MicrovmImage recurso.

BuildRoleArn

O ARN da função do IAM que o serviço de compilação MicroVM assume para baixar seu artefato de código do Amazon S3 e gravar registros de construção.

Tipo: string

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é semelhante à BuildRoleArn propriedade de um AWS::Lambda::MicrovmImage recurso. Isso é necessário no CloudFormation , mas não no AWS SAM. Se você não especificar uma função, AWS SAM cria uma com uma ID lógica de<resource-logical-id>BuildRole. Se seu artefato de código estiver criptografado com uma chave gerenciada pelo cliente AWS KMS, você deverá fornecer sua própria função com a kms:Decrypt permissão apropriada.

CodeUri

O URI do Amazon S3 do artefato zip contendo o código do aplicativo Dockerfile e.

Tipo: string

Obrigatório: Sim

CloudFormation compatibilidade: essa propriedade é transformada na CodeArtifact propriedade de um AWS::Lambda::MicrovmImage recurso. AWS SAM envolve o URI na CodeArtifact.Uri estrutura.

CpuConfigurations

Uma lista de CpuConfigurationobjetos que especificam as arquiteturas de CPU suportadas pela microVM. Se você não especificar um valor, o serviço usará a arquitetura de CPU padrão.

Tipo: lista

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a CpuConfigurations propriedade de um AWS::Lambda::MicrovmImage recurso.

Description

Uma descrição da imagem do microVM.

Tipo: string

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Description propriedade de um AWS::Lambda::MicrovmImage recurso.

EgressNetworkConnectors

A lista de ARNs de conectores de rede de saída disponíveis para a microVM em tempo de execução.

Tipo: lista

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a EgressNetworkConnectors propriedade de um AWS::Lambda::MicrovmImage recurso.

EnvironmentVariables

Variáveis de ambiente definidas no ambiente de execução do microVM.

Tipo: mapa

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é semelhante à EnvironmentVariables propriedade de um AWS::Lambda::MicrovmImage recurso. Em AWS SAM, especifique como um mapa (por exemplo,KEY: value). AWS SAM converte para o formato CloudFormation [{Key: KEY, Value: value}] de matriz.

Hooks

Configuração de gancho de ciclo de vida para imagens de microVMS e microVM.

Tipo: Ganchos

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Hooks propriedade de um AWS::Lambda::MicrovmImage recurso.

Logging

Configuração para saída de registro de microVM. Especifique exatamente um: CloudWatch ativar o CloudWatch registro ou Disabled desativar o registro.

Type: Logging

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Logging propriedade de um AWS::Lambda::MicrovmImage recurso.

Name

O nome da imagem do microVM.

Tipo: string

Obrigatório: Sim

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Name propriedade de um AWS::Lambda::MicrovmImage recurso.

PropagateTags

Especifica se as tags da Tags propriedade devem ser passadas para os recursos gerados, como a função de criação gerada automaticamente.

Tipo: booliano

Obrigatório: não

Padrão: False

CloudFormation compatibilidade: essa propriedade é exclusiva AWS SAM e não tem CloudFormation equivalente.

Resources

Uma lista de objetos de recursos que especificam os requisitos de recursos para a microVM.

Tipo: lista

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Resources propriedade de um AWS::Lambda::MicrovmImage recurso.

Tags

Um mapa de pares de valores-chave que especifica as tags adicionadas a essa imagem de microVM.

Tipo: mapa

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é semelhante à Tags propriedade de um AWS::Lambda::MicrovmImage recurso. A Tags propriedade in AWS SAM consiste em pares de valores-chave (enquanto CloudFormation nessa propriedade consiste em uma lista de Tag objetos). Além disso, adiciona AWS SAM automaticamente uma lambda:createdBy:SAM tag a essa imagem de microVM e às funções padrão que são geradas para ela.

Valores de retorno

Ref.

Quando a ID lógica desse recurso é fornecida à função Ref intrínseca, ela retorna o ARN da imagem da microVM.

Para obter mais informações sobre como usar a função Ref, consulte Ref no Guia do usuário do AWS CloudFormation .

Fã:: GetAtt

Fn::GetAtt retorna um valor para um atributo especificado deste tipo. Estes são os atributos disponíveis e os valores de retorno de amostra.

Para obter mais informações sobre o uso do Fn::GetAtt, consulte Fn::GetAtt o AWS CloudFormation Guia do usuário.

CreatedAt

O carimbo de data e hora em que a versão da imagem microVM foi criada.

ImageArn

O ARN da imagem microVM.

LatestActiveImageVersion

A versão ativa mais recente da imagem microVM.

LatestFailedImageVersion

A última versão com falha da imagem do microVM, se houver.

State

O estado atual da imagem do microVM.

UpdatedAt

O carimbo de data e hora em que a versão da imagem do microVM foi atualizada pela última vez.

Exemplos

Imagem mínima de microVM

O exemplo a seguir cria uma imagem de microVM com somente as propriedades necessárias. AWS SAM gera automaticamente uma função de construção.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyMicroVM:
    Type: AWS::Serverless::MicrovmImage
    Properties:
      Name: my-app
      CodeUri: s3://my-bucket/app.zip
      BaseImageArn: arn:aws:lambda:us-east-2:aws:microvm-image:al2023-1
      BaseImageVersion: "0"

Configuração completa da imagem microVM

O exemplo a seguir cria uma imagem de microVM com todas as propriedades disponíveis configuradas.

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyMicroVM:
    Type: AWS::Serverless::MicrovmImage
    Properties:
      Name: my-app
      CodeUri: s3://my-bucket/app.zip
      BaseImageArn: arn:aws:lambda:us-east-2:aws:microvm-image:al2023-1
      BaseImageVersion: "0"
      Description: "Production MicroVM application"
      CpuConfigurations:
        - Architecture: ARM_64
      Resources:
        - MinimumMemoryInMiB: 1024
      AdditionalOsCapabilities:
        - ALL
      EgressNetworkConnectors:
        - arn:aws:lambda:us-east-2:aws:network-connector:aws-network-connector:INTERNET_EGRESS
      Hooks:
        Port: 9000
        MicrovmHooks:
          Run: ENABLED
          RunTimeoutInSeconds: 30
          Suspend: ENABLED
          Resume: ENABLED
        MicrovmImageHooks:
          Ready: ENABLED
          ReadyTimeoutInSeconds: 60
      EnvironmentVariables:
        LOG_LEVEL: info
        APP_ENV: production
      Logging:
        CloudWatch:
          LogGroup: /aws/lambda-microvms/my-app
      Tags:
        Environment: Production
        Team: Platform