Exemplarische Vorgehensweise: Suchen Sie AMI IDs mit einer von Lambda unterstützten benutzerdefinierten Ressource nach

Diese exemplarische Vorgehensweise zeigt Ihnen, wie Sie Lambda und eine benutzerdefinierte Ressource verwenden, um Amazon Machine Image (AMI) IDs in Ihrer CloudFormation Vorlage dynamisch nachzuschlagen. Dies kann Ihnen helfen, die Aktualisierung der AMI IDs in Ihren Vorlagen zu optimieren. CloudFormation

Wenn Sie eine CloudFormation Vorlage zum Starten einer EC2 Amazon-Instance erstellen, müssen Sie eine AMI ID angeben, die einer Vorlage für das Betriebssystem und die Software entspricht, die auf der Instance installiert werden. Die richtige AMI ID hängt vom Instance-Typ ab und in dem AWS-Region Sie Ihre Instance starten. Diese IDs können sich regelmäßig ändern, z. B. wenn eine mit Softwareupdates aktualisiert AMI wird.

In der Regel geben Sie die AMI ID in einem Mappings Abschnitt AMI IDs an, der bestimmten Instance-Typen und Regionen zugeordnet ist. Das bedeutet, dass Sie sie in jeder Ihrer Vorlagen manuell ändern müssenIDs, um sie zu aktualisieren. Mithilfe von benutzerdefinierten Ressourcen und Lambda können Sie jedoch eine Funktion erstellen, die die neuesten Informationen AMIs für den IDs Instance-Typ und die Region, die Sie verwenden, abruft. Auf diese Weise müssen Sie die Zuordnungen zwischen Instance-Typen und Regionen in Ihren AMI IDs Stack-Vorlagen nicht manuell verwalten.

In dieser exemplarischen Vorgehensweise wird gezeigt, wie Sie eine benutzerdefinierte Ressource erstellen und ihr eine Lambda-Funktion zuordnen, um sie nachzuschlagen. AMI IDs Es wird davon ausgegangen, dass Sie mit benutzerdefinierten Ressourcen und Lambda-Funktionen vertraut sind. Eine Einführung in benutzerdefinierte Ressourcen und deren Funktionsweise finden Sie unterErstellen Sie eine benutzerdefinierte Bereitstellungslogik mit benutzerdefinierten Ressourcen. Informationen zu Lambda finden Sie im AWS Lambda Developer Guide.

Übersicht

Die folgenden Schritte bieten einen Überblick über diese Implementierung.

Walkthrough zu Vorlagen

Sehen Sie sich folgendes an, um die gesamte Beispielvorlage anzuzeigen:

In den folgenden Codeausschnitten werden relevante Teile der Beispielvorlage erläutert, anhand der Sie sehen können, wie eine Lambda-Funktion mit einer benutzerdefinierten Ressource verknüpft und wie die Antwort der Funktion verwendet wird.

AWS: :Lambda: :Funktionsressource AMIInfoFunction

Die AWS::Lambda::Function Ressource gibt den Quellcode, den Handlernamen, die Laufzeitumgebung und die Ausführungsrolle Amazon Resource Name (ARN) der Funktion an.

"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: :Rollenressource LambdaExecutionRole

Die Ausführungsrolle erteilt der Lambda-Funktion die Berechtigung, Protokolle an zu senden AWS und EC2 DescribeImages API aufzurufen.

"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: "*"

Benutzerdefiniert: Ressource AMIInfo AMIInfo

Sowohl für die Linux- als auch für die Windows-Vorlage ruft die benutzerdefinierte Ressource die ihr zugeordnete Lambda-Funktion auf. Um eine Funktion mit einer benutzerdefinierten Ressource zu verknüpfen, geben Sie mithilfe ARN der Fn::GetAtt systemeigenen Funktion die Funktion für die ServiceToken Eigenschaft an. CloudFormation sendet die zusätzlichen Eigenschaften, die in der benutzerdefinierten Ressourcendeklaration enthalten sind, wie z. B. Region undArchitecture, als Eingaben an die Lambda-Funktion. Die Lambda-Funktion bestimmt die korrekten Namen und Werte für diese Eingabeeigenschaften.

"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

Bei Windows stellt die benutzerdefinierte Ressource der Lambda-Funktion die Windows-Version anstelle der Architektur der Instance bereit.

"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"

Wenn die Lambda-Funktion aufgerufen wird, CloudFormation ruft die Funktion die auf AWS-Region und verwendet EC2 DescribeImages API dabei die Instanzarchitektur oder den Betriebssystemnamen, um die Liste der Bilder zu filtern. Anschließend sortiert die Funktion die Liste der Bilder nach Datum und gibt die ID der letzten Bilder zurück. AMI

Bei der Rückgabe der neuesten AMI ID sendet die Funktion die ID an ein URL in der Data Eigenschaft des Antwortobjekts vorsigniertes Objekt. Die Daten sind als Name-Wert-Paar strukturiert, wie im folgenden Beispiel dargestellt:

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

AWS::EC2: :Instanzressource SampleInstance

Der folgende Codeausschnitt zeigt, wie die Daten von der Lambda-Funktion abgerufen werden. Sie verwendet die intrinsische Fn::GetAtt-Funktion, die den Namen der benutzerdefinierten Ressource und den Attributnamen des Werts bereitstellen, den Sie abrufen möchten. In dieser Anleitung lautet der benutzerdefinierte Ressourcenname AMIInfo und der Attributname 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

Voraussetzungen

Bevor Sie die Schritte zum Erstellen des Stacks abschließen können, müssen Sie bereits über einen Amazon S3 S3-Bucket verfügen. Wenn Sie einen Stack mit einer Lambda-Funktion erstellen, müssen Sie den Speicherort des Amazon S3-Buckets angeben, der den Quellcode der Funktion enthält. Der Bucket muss sich in demselben befinden, in dem AWS-Region Sie Ihren Stack erstellen. Weitere Informationen zum Erstellen eines Buckets finden Sie unter Erstellen von Buckets im Benutzerhandbuch für Amazon Simple Storage Service.

Sie müssen außerdem über IAM Berechtigungen verfügen, um alle entsprechenden Dienste wie LambdaEC2, Amazon und CloudFormation zu nutzen.

Schritt 1: Speichern Sie das Lambda-Beispielpaket in Amazon S3

In diesem Schritt laden Sie das Lambda-Beispielpaket (eine .zip Datei) in Ihren Amazon S3 S3-Bucket hoch.

Dieses Paket enthält den Quellcode für die Lambda-Funktion und die erforderlichen Bibliotheken. In dieser Anleitung sind für die Funktion keine zusätzlichen Bibliotheken erforderlich.

Schritt 2: Starten Sie den Stack

In diesem Schritt starten Sie einen Stack aus einer Beispielvorlage. Der Stack umfasst eine Lambda-Funktion, eine IAM Rolle (Ausführungsrolle), eine benutzerdefinierte Ressource, die die Funktion aufruft, und eine EC2 Instanz, die die Ergebnisse der Funktion verwendet.

Während der Stack-Erstellung ruft die benutzerdefinierte Ressource die Lambda-Funktion auf und wartet, bis die Funktion eine Antwort an das vorsignierte Amazon S3 sendet. URL In der Antwort gibt die Funktion die neueste ID zurück, die dem EC2 Instance-Typ entsprichtAMI, in dem AWS-Region Sie die Instance erstellen. Die Daten aus der Antwort der Funktion werden als Attribut der benutzerdefinierten Ressource gespeichert, das zur Angabe der AMI ID der EC2 Instanz verwendet wird.

Es kann mehrere Minuten dauern CloudFormation , bis Ihr Stack erstellt ist. Betrachten Sie die Stack-Ereignisse, um den Fortschritt zu überwachen. Weitere Informationen finden Sie unter Stack-Informationen von der CloudFormation Konsole aus anzeigen.

Wenn die Stack-Erstellung erfolgreich ist, wurden alle Ressourcen im Stack, z. B. die Lambda-Funktion, die benutzerdefinierte Ressource und die EC2 Instanz, erstellt. Sie haben erfolgreich eine Lambda-Funktion und eine benutzerdefinierte Ressource verwendet, um die AMI ID einer EC2 Instanz anzugeben. Sie müssen in dieser Vorlage kein Mapping von AMI IDs erstellen und verwalten.

Um zu sehen, welche AMI ID zum Erstellen der EC2 Instanz CloudFormation verwendet wurde, sehen Sie sich die Stack-Ausgaben an.

Wenn die Lambda-Funktion einen Fehler zurückgibt, sehen Sie sich die Protokolle der Funktion in der CloudWatch Logs-Konsole an. Der Name des Protokollstreams ist die physische ID der benutzerdefinierten Ressource, die Sie durch Anzeigen der Ressourcen des Stacks finden können. Weitere Informationen finden Sie unter Protokolldaten anzeigen im CloudWatch Amazon-Benutzerhandbuch.

Schritt 3: Bereinigen von Ressourcen

Löschen Sie den Stack, um alle Stack-Ressourcen zu bereinigen, die Sie erstellt haben, damit Ihnen keine unnötigen Ressourcen in Rechnung gestellt werden.

Alle erstellten Ressourcen werden gelöscht.

Nachdem Sie nun verstanden haben, wie Lambda-Funktionen erstellt und verwendet werden CloudFormation, können Sie die Beispielvorlage und den Code aus dieser exemplarischen Vorgehensweise verwenden, um weitere Stacks und Funktionen zu erstellen.

Ähnliche Informationen