creating-ec2-image-builder-pipeline
Creates a complete EC2 Image Builder pipeline that builds a custom AMI with pre-installed software, distributes it to target regions, executes the pipeline, and creates a launch template. Use when setting up automated AMI creation with IAM roles, build components, image recipes, and infrastructure configuration.
Security Assessment
About creating-ec2-image-builder-pipeline
creating-ec2-image-builder-pipeline provides domain expertise for creating and managing EC2 Image Builder pipelines that automate custom AMI creation. It solves the problem of building a custom AMI with pre-installed software, distributing it to target regions, executing the pipeline, and creating a launch template, all as a repeatable end-to-end procedure. It is intended for use when setting up automated AMI creation involving IAM roles, build components, image recipes, and infrastructure configuration.
The skill covers the full pipeline lifecycle: IAM role setup, build component definition, image recipe creation, infrastructure and distribution configuration, pipeline execution, and launch template creation. The complete step-by-step procedure lives in references/ec2-image-builder-pipeline.md, which the skill instructs users to follow exactly. It also includes targeted troubleshooting guidance: InvalidParameterValueException on pipeline operations is resolved by using the exact ARN returned by API calls rather than constructing ARNs manually (pipeline ARNs follow arn:<partition>:imagebuilder:<region>:<account>:image-pipeline/<name>); InstanceProfileNotFoundException is handled by waiting 10–15 seconds after creating the instance profile because IAM changes are eventually consistent; ResourceAlreadyExistsException is resolved by deleting the existing resource or using a different name/version.
Target users are AWS engineers and DevOps practitioners automating golden-image creation and cross-region AMI distribution. The skill emphasizes correctness of IAM configuration and resource references. For a build instance that fails to launch, it advises verifying that the instance profile exists, all three IAM policies are attached, and the instance type is available in the region. The detailed procedure and exact commands are contained in the referenced procedure document.
FAQ
What does this pipeline do end to end?
It builds a custom AMI with pre-installed software, distributes it to target regions, executes the pipeline, and creates a launch template. Along the way it covers IAM role setup, build component definition, image recipe creation, and infrastructure and distribution configuration.
Where is the actual step-by-step procedure?
The complete procedure is in references/ec2-image-builder-pipeline.md, and the skill instructs you to follow it exactly to create the full pipeline.
How do I fix an InvalidParameterValueException on pipeline operations?
Use the exact ARN returned by API calls instead of constructing ARNs manually. Pipeline ARNs must follow the format arn:<partition>:imagebuilder:<region>:<account>:image-pipeline/<name>.
Why do I get InstanceProfileNotFoundException right after creating the profile?
IAM changes are eventually consistent. Wait 10–15 seconds after creating the instance profile before using it.
My build instance fails to launch — what should I check?
Verify the instance profile exists, all three IAM policies are attached, and the instance type is available in the region.
Install creating-ec2-image-builder-pipeline
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
aws/agent-toolkit-for-aws