Procedura dettagliata: cerca AMI IDs con una risorsa personalizzata supportata da Lambda

Questa procedura dettagliata mostra come utilizzare Lambda e una risorsa personalizzata per cercare dinamicamente Amazon Machine Image AMI () IDs nel tuo modello. CloudFormation Questo può aiutarti a semplificare il modo in cui aggiorni i tuoi modelli. AMI IDs CloudFormation

Quando crei un CloudFormation modello per avviare un'EC2istanza Amazon, devi specificare un AMI ID, che è come un modello per il sistema operativo e il software che verranno installati sull'istanza. L'AMIID corretto dipende dal tipo di istanza e dal tipo di istanza in cui Regione AWS stai avviando l'istanza. Questi IDs possono cambiare regolarmente, ad esempio quando un AMI viene aggiornato con aggiornamenti software.

In genere si specifica l'AMIID in una Mappings sezione che corrisponde AMI IDs a tipi di istanza e regioni specifici. Ciò significa che per aggiornare iIDs, è necessario modificarli manualmente in ciascuno dei modelli. Tuttavia, utilizzando risorse personalizzate e Lambda, puoi creare una funzione che ottenga le ultime novità AMIs per il tipo IDs di istanza e la regione che stai utilizzando. In questo modo, non è necessario mantenere manualmente le mappature tra AMI IDs i tipi di istanza e le regioni nei modelli di stack.

Questa procedura dettagliata mostra come creare una risorsa personalizzata e associarvi una funzione Lambda per eseguire la ricerca. AMI IDs Si presuppone che tu abbia dimestichezza con le risorse personalizzate e le funzioni Lambda. Per un'introduzione alle risorse personalizzate e al loro funzionamento, consulta. Crea una logica di provisioning personalizzata con risorse personalizzate Per informazioni su Lambda, consulta la AWS Lambda Developer Guide.

Panoramica

I passaggi seguenti forniscono una panoramica di questa implementazione.

Spiegazione passo per passo del modello

Per visualizzare l'intero modello di esempio, consulta:

I seguenti frammenti spiegano le parti rilevanti del modello di esempio per aiutarti a capire come associare una funzione Lambda a una risorsa personalizzata e come utilizzare la risposta della funzione.

AWS: :Lambda: :Risorsa funzionale AMIInfoFunction

La AWS::Lambda::Function risorsa specifica il codice sorgente della funzione, il nome del gestore, l'ambiente di runtime e il ruolo di esecuzione Amazon Resource Name ()ARN.

"AMIInfoFunction": {
  "Type": "AWS::Lambda::Function",
  "Properties": {
    "Code": {
      "S3Bucket": { "Ref": "S3Bucket" },
      "S3Key": { "Ref": "S3Key" }
    },
    "Handler": { "Fn::Join" : [ "", [{ "Ref": "ModuleName" },".handler"] ] },
    "Runtime": "nodejs18.x",
    "Timeout": "30",
    "Role": { "Fn::GetAtt" : ["LambdaExecutionRole", "Arn"] }
  }
}

AMIInfoFunction:
  Type: AWS::Lambda::Function
  Properties:
    Code:
      S3Bucket: !Ref S3Bucket
      S3Key: !Ref S3Key
    Handler: !Sub "${ModuleName}.handler"
    Runtime: nodejs18.x
    Timeout: 30
    Role: !GetAtt LambdaExecutionRole.Arn

AWS::IAM: Risorsa di ruolo LambdaExecutionRole

Il ruolo di esecuzione concede alla funzione Lambda il permesso di inviare log AWS a e chiamare. EC2 DescribeImages API

"LambdaExecutionRole": {
  "Type": "AWS::IAM::Role",
  "Properties": {
    "AssumeRolePolicyDocument": {
      "Version": "2012-10-17",
      "Statement": [{
        "Effect": "Allow",
        "Principal": {"Service": ["lambda.amazonaws.com"]},
        "Action": ["sts:AssumeRole"]
      }]
    },
    "Path": "/",
    "Policies": [{
      "PolicyName": "root",
      "PolicyDocument": {
        "Version": "2012-10-17",
        "Statement": [{
          "Effect": "Allow",
          "Action": ["logs:CreateLogGroup","logs:CreateLogStream","logs:PutLogEvents"],
          "Resource": "arn:aws:logs:*:*:*"
        },
        {
          "Effect": "Allow",
          "Action": ["ec2:DescribeImages"],
          "Resource": "*"
        }]
      }
    }]
  }
}

LambdaExecutionRole:
  Type: AWS::IAM::Role
  Properties:
    AssumeRolePolicyDocument:
      Version: '2012-10-17'
      Statement:
      - Effect: Allow
        Principal:
          Service:
          - lambda.amazonaws.com
        Action:
        - sts:AssumeRole
    Path: "/"
    Policies:
    - PolicyName: root
      PolicyDocument:
        Version: '2012-10-17'
        Statement:
        - Effect: Allow
          Action:
          - logs:CreateLogGroup
          - logs:CreateLogStream
          - logs:PutLogEvents
          Resource: arn:aws:logs:*:*:*
        - Effect: Allow
          Action:
          - ec2:DescribeImages
          Resource: "*"

Risorsa personalizzata: AMIInfo AMIInfo

Per entrambi i modelli Linux e Windows, la risorsa personalizzata richiama la funzione Lambda ad essa associata. Per associare una funzione a una risorsa personalizzata, si specifica la funzione ARN relativa alla ServiceToken proprietà, utilizzando la Fn::GetAtt funzione intrinseca. CloudFormation invia le proprietà aggiuntive incluse nella dichiarazione personalizzata delle risorse, come Region eArchitecture, alla funzione Lambda come input. La funzione Lambda determina i nomi e i valori corretti per queste proprietà di input.

"AMIInfo": {
  "Type": "Custom::AMIInfo",
  "Properties": {
    "ServiceToken": { "Fn::GetAtt" : ["AMIInfoFunction", "Arn"] },
    "Region": { "Ref": "AWS::Region" },
    "Architecture": { "Fn::FindInMap" : [ "AWSInstanceType2Arch", { "Ref" : "InstanceType" }, "Arch" ] }
  }
}

AMIInfo:
  Type: Custom::AMIInfo
  Properties:
    ServiceToken: !GetAtt AMIInfoFunction.Arn
    Region: !Ref "AWS::Region"
    Architecture:
      Fn::FindInMap:
      - AWSInstanceType2Arch
      - !Ref InstanceType
      - Arch

Per Windows, la risorsa personalizzata fornisce la versione di Windows alla funzione Lambda invece dell'architettura dell'istanza.

"AMIInfo": {
  "Type": "Custom::AMIInfo",
  "Properties": {
    "ServiceToken": { "Fn::GetAtt": ["AMIInfoFunction", "Arn"] },
    "Region": { "Ref": "AWS::Region" },
    "OSName": { "Ref": "WindowsVersion" }
  }
}

AMIInfo:
  Type: Custom::AMIInfo
  Properties:
    ServiceToken: !GetAtt AMIInfoFunction.Arn
    Region: !Ref "AWS::Region"
    OSName: !Ref "WindowsVersion"

Quando CloudFormation richiama la funzione Lambda, la funzione chiama EC2 DescribeImagesAPI, utilizzando l'architettura Regione AWS and instance o il nome del sistema operativo per filtrare l'elenco di immagini. Quindi la funzione ordina l'elenco delle immagini per data e restituisce l'ID dell'ultima. AMI

Quando restituisce l'ID più recenteAMI, la funzione invia l'ID a un elemento prefirmato URL nella Data proprietà dell'oggetto di risposta. I dati sono strutturati come una coppia nome-valore, come nell'esempio seguente:

"Data": { 
  "Id": "ami-02354e95b3example"
}

AWS::EC2: Risorsa di istanza SampleInstance

Il frammento seguente mostra come ottenere i dati da una funzione Lambda. Utilizza la funzione intrinseca Fn::GetAtt, fornendo il nome della risorsa personalizzata e il nome attributo del valore che desideri ottenere. In questa procedura guidata, il nome della risorsa personalizzata è AMIInfo e il nome attributo è Id.

"SampleInstance": {  
  "Type": "AWS::EC2::Instance",
  "Properties": {
    "InstanceType" : { "Ref": "InstanceType" },
    "ImageId": { "Fn::GetAtt": [ "AMIInfo", "Id" ] }
  }
}

SampleInstance:
  Type: AWS::EC2::Instance
  Properties:
    InstanceType: !Ref InstanceType
    ImageId: !GetAtt AMIInfo.Id

Prerequisiti

Prima di completare i passaggi per creare lo stack, devi già disporre di un bucket Amazon S3. Quando crei uno stack con una funzione Lambda, devi specificare la posizione del bucket Amazon S3 contenente il codice sorgente della funzione. Il bucket deve trovarsi nello stesso in cui Regione AWS hai creato lo stack. Per ulteriori informazioni sulla creazione di un bucket, consulta Creazione di un bucket nella Guida per l'utente di Amazon Simple Storage Service.

È inoltre necessario disporre IAM delle autorizzazioni per utilizzare tutti i servizi corrispondenti, come Lambda, EC2 Amazon e. CloudFormation

Fase 1: salvare il pacchetto Lambda di esempio in Amazon S3

In questo passaggio, carichi il pacchetto Lambda di esempio (un .zip file) nel tuo bucket Amazon S3.

Questo pacchetto contiene il codice sorgente per la funzione Lambda e le librerie richieste. Per questa procedura guidata, la funzione non richiede librerie aggiuntive.

Passaggio 2: avvia lo stack

In questo passaggio, si avvia uno stack a partire da un modello di esempio. Lo stack include una funzione Lambda, IAM un ruolo (ruolo di esecuzione), una risorsa personalizzata che richiama la funzione e EC2 un'istanza che utilizza i risultati della funzione.

Durante la creazione dello stack, la risorsa personalizzata richiama la funzione Lambda e attende che la funzione invii una risposta all'Amazon S3 prefirmato. URL Nella risposta, la funzione restituisce l'ID dell'ultima versione corrispondente al tipo di istanza in AMI cui si sta creando l'EC2istanza. Regione AWS I dati della risposta della funzione vengono archiviati come attributo della risorsa personalizzata, utilizzata per specificare l'AMIID dell'EC2istanza.

La creazione dello stack potrebbe richiedere alcuni minuti. CloudFormation È possibile controllare l'avanzamento negli eventi per lo stack. Per ulteriori informazioni, consulta Visualizza le informazioni sullo stack dalla console CloudFormation .

Se la creazione dello stack ha esito positivo, vengono create tutte le risorse dello stack, ad esempio la funzione Lambda, la risorsa personalizzata e EC2 l'istanza. Hai utilizzato correttamente una funzione Lambda e una risorsa personalizzata per specificare l'AMIID di un'EC2istanza. Non è necessario creare e mantenere una mappatura di AMI IDs in questo modello.

Per vedere quale AMI ID è stato CloudFormation utilizzato per creare l'EC2istanza, visualizza gli output dello stack.

Se la funzione Lambda restituisce un errore, visualizza i log della funzione nella CloudWatch console Logs. Il nome del flusso di log è l'ID fisico della risorsa personalizzata, che puoi trovare visualizzando le risorse dello stack. Per ulteriori informazioni, consulta Visualizza i dati di log nella Amazon CloudWatch User Guide.

Fase 3: Eliminazione delle risorse

Elimina lo stack per cancellare tutte le risorse dello stack create in modo da non pagare per le risorse superflue.

Tutte le risorse create vengono eliminate.

Ora che hai capito come creare e usare le funzioni Lambda CloudFormation, puoi usare il modello e il codice di esempio di questa procedura dettagliata per creare altri stack e funzioni.

Informazioni correlate