View a markdown version of this page

AWS::Serverless::MicrovmImage - AWS Serverless Application Model
SintassiPropertiesValori restituitiEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS::Serverless::MicrovmImage

Crea un'immagine AWS Lambda MicroVM da un elemento di codice archiviato in Amazon S3. Un'immagine MicroVM è un'Firecrackeristantanea creata a partire da un codice applicativo, che consente l'avvio in meno di un secondo per Dockerfile le istanze MicroVM.

Nota

Quando esegui la distribuzione su, trasforma le tue risorse in risorse. AWS CloudFormation AWS SAM AWS SAM CloudFormation Per ulteriori informazioni, consulta Generato CloudFormation risorse per AWS SAM.

Sintassi

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

Properties

AdditionalOsCapabilities

Funzionalità del sistema operativo aggiuntive da concedere all'ambiente di runtime MicroVM. Se non si specifica un valore, il servizio non concede funzionalità aggiuntive del sistema operativo.

Valori validi: ALL

Tipo: elenco

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla AdditionalOsCapabilities proprietà di una AWS::Lambda::MicrovmImage risorsa.

BaseImageArn

L'ARN dell'immagine MicroVM di base da cui creare.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla BaseImageArn proprietà di una risorsa. AWS::Lambda::MicrovmImage

BaseImageVersion

La versione dell'immagine MicroVM di base da utilizzare.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla BaseImageVersion proprietà di una AWS::Lambda::MicrovmImage risorsa.

BuildRoleArn

L'ARN del ruolo IAM che il servizio di compilazione MicroVM assume per scaricare l'elemento di codice da Amazon S3 e scrivere i log di build.

▬Tipo: stringa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà è simile alla proprietà di una risorsa. BuildRoleArn AWS::Lambda::MicrovmImage È obbligatorio in CloudFormation ma non in AWS SAM. Se non specifichi un ruolo, ne AWS SAM crea uno con un ID logico di<resource-logical-id>BuildRole. Se l'elemento del codice è crittografato con una chiave gestita dal cliente AWS KMS, è necessario fornire al proprio ruolo l'autorizzazione appropriatakms:Decrypt.

CodeUri

L'URI Amazon S3 dell'elemento zip contenente il codice e dell'Dockerfileapplicazione.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene trasformata nella CodeArtifact proprietà di una risorsa. AWS::Lambda::MicrovmImage AWS SAM avvolge l'URI nella struttura. CodeArtifact.Uri

CpuConfigurations

Un elenco di CpuConfigurationoggetti che specificano le architetture CPU supportate per la microVM. Se non si specifica un valore, il servizio utilizza l'architettura CPU predefinita.

Tipo: elenco

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla CpuConfigurations proprietà di una AWS::Lambda::MicrovmImage risorsa.

Description

Una descrizione dell'immagine MicroVM.

▬Tipo: stringa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Description proprietà di una AWS::Lambda::MicrovmImage risorsa.

EgressNetworkConnectors

L'elenco degli ARN dei connettori di rete in uscita disponibili per la microVM in fase di esecuzione.

Tipo: elenco

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla EgressNetworkConnectors proprietà di una risorsa. AWS::Lambda::MicrovmImage

EnvironmentVariables

Variabili di ambiente impostate nell'ambiente di runtime MicroVM.

Tipo: Mappa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà è simile alla EnvironmentVariables proprietà di una AWS::Lambda::MicrovmImage risorsa. In AWS SAM, specificare come mappa (ad esempio,KEY: value). AWS SAM converte nel formato CloudFormation [{Key: KEY, Value: value}] array.

Hooks

configurazione Lifecycle Hook per immagini MicroVMS e MicroVM.

Tipo: ganci

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Hooks proprietà di una AWS::Lambda::MicrovmImage risorsa.

Logging

Configurazione per l'output di registrazione MicroVM. Specificane esattamente uno: CloudWatch per abilitare CloudWatch la registrazione o Disabled per disattivarla.

Type: Logging

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Logging proprietà di una AWS::Lambda::MicrovmImage risorsa.

Name

Il nome dell'immagine MicroVM.

▬Tipo: stringa

Obbligatorio: sì

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Name proprietà di una AWS::Lambda::MicrovmImage risorsa.

PropagateTags

Speciifica se passare i tag dalla Tags proprietà alle risorse generate, ad esempio il ruolo di compilazione generato automaticamente.

Tipo: Booleano

Obbligatorio: no

Default: False

CloudFormation compatibilità: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

Resources

Un elenco di oggetti Resources che specificano i requisiti di risorse per la MicroVM.

Tipo: elenco

Obbligatorio: no

CloudFormation compatibilità: questa proprietà viene passata direttamente alla Resources proprietà di una AWS::Lambda::MicrovmImage risorsa.

Tags

Una mappa di coppie chiave-valore che specifica i tag aggiunti a questa immagine MicroVM.

Tipo: Mappa

Obbligatorio: no

CloudFormation compatibilità: questa proprietà è simile alla Tags proprietà di una AWS::Lambda::MicrovmImage risorsa. La Tags proprietà in AWS SAM è costituita da coppie chiave-valore (mentre in CloudFormation questa proprietà è costituita da un elenco di Tag oggetti). Inoltre, aggiunge AWS SAM automaticamente un lambda:createdBy:SAM tag a questa immagine MicroVM e ai ruoli predefiniti generati per essa.

Valori restituiti

Ref

Quando l'ID logico di questa risorsa viene fornito alla funzione Ref intrinseca, restituisce l'ARN dell'immagine MicroVM.

Per ulteriori informazioni sull'uso della Ref funzione, vedere Refla Guida per l'utente.AWS CloudFormation

Fn: GetAtt

Fn::GetAtt restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio.

Per ulteriori informazioni sull'utilizzoFn::GetAtt, consulta Fn::GetAttla Guida per l'AWS CloudFormation utente.

CreatedAt

Il timestamp in cui è stata creata la versione dell'immagine MicroVM.

ImageArn

L'ARN dell'immagine MicroVM.

LatestActiveImageVersion

L'ultima versione attiva dell'immagine MicroVM.

LatestFailedImageVersion

L'ultima versione non riuscita dell'immagine MicroVM, se presente.

State

Lo stato attuale dell'immagine MicroVM.

UpdatedAt

Il timestamp dell'ultimo aggiornamento della versione dell'immagine MicroVM.

Esempi

Immagine microVM minima

L'esempio seguente crea un'immagine MicroVM con solo le proprietà richieste. AWS SAM genera automaticamente un ruolo di compilazione.

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"

Configurazione completa dell'immagine MicroVM

L'esempio seguente crea un'immagine MicroVM con tutte le proprietà disponibili configurate.

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