To create a custom AWS AppConfig extension, complete the following tasks. Each task is described in more detail in later topics.
Note
You can view samples of custom AWS AppConfig extensions on GitHub:
- 1. Create an AWS Lambda function
-
For most use cases, to create a custom extension, you must create an AWS Lambda function to perform any computation and processing defined in the extension. An exception to this rule is if you create custom versions of the AWS authored notification extensions to add or remove action points. For more details about this exception, see Step 3: Create a custom AWS AppConfig extension.
- 2. Configure permissions for your custom extension
-
To configure permissions for your custom extension, you can do one of the following:
-
Create an AWS Identity and Access Management (IAM) service role that includes
InvokeFunctionpermissions. -
Create a resource policy by using the Lambda AddPermission API action.
This walkthrough describes how to create the IAM service role.
-
- 3. Create an extension
-
You can create an extension by using the AWS AppConfig console or by calling the CreateExtension API action from the AWS CLI, AWS Tools for PowerShell, or the SDK. The walkthrough uses the console.
- 4. Create an extension association
-
You can create an extension association by using the AWS AppConfig console or by calling the CreateExtensionAssociation API action from the AWS CLI, AWS Tools for PowerShell, or the SDK. The walkthrough uses the console.
- 5. Perform an action that invokes the extension
-
After you create the association, AWS AppConfig invokes the extension when the action points defined by the extension occur for that resource. For example, if you associate an extension that contains a
PRE_CREATE_HOSTED_CONFIGURATION_VERSIONaction, the extension is invoked every time you create a new hosted configuration version.
The topics in this section describe each task involved in creating a custom AWS AppConfig
extension. Each task is described in the context of a use case where a customer wants to
create an extension that automatically backs up a configuration to an Amazon Simple Storage Service (Amazon S3) bucket.
The extension runs whenever a hosted configuration is created
(PRE_CREATE_HOSTED_CONFIGURATION_VERSION) or deployed
(PRE_START_DEPLOYMENT).
Topics
