Skip to content

ec2_ami_fast_launch_info: new module to gather Fast Launch enabled AMIs - #2449

Open
ewaldbervoets wants to merge 2 commits into
ansible-collections:mainfrom
ewaldbervoets:ec2_ami_fast_launch_info
Open

ec2_ami_fast_launch_info: new module to gather Fast Launch enabled AMIs#2449
ewaldbervoets wants to merge 2 commits into
ansible-collections:mainfrom
ewaldbervoets:ec2_ami_fast_launch_info

Conversation

@ewaldbervoets

@ewaldbervoets ewaldbervoets commented May 22, 2026

Copy link
Copy Markdown
SUMMARY

New read-only module wrapping the EC2 DescribeFastLaunchImages API. AMI Fast Launch state is not currently inspectable from Ansible.

ISSUE TYPE
  • New Module/Plugin Pull Request
COMPONENT NAME

ec2_ami_fast_launch_info

ADDITIONAL INFORMATION
  • Mirrors patterns from ec2_carrier_gateway_info (argument spec, retry decorator, snake_case transformation, error handling).
  • Registered in meta/runtime.yml action_groups: aws and .github/BOTMETA.yml.
  • Integration test scaffold included; tests are deliberately light because Fast Launch requires a Windows (or eligible Linux) AMI in the CI account, so the assertions cover response shape and graceful empty-result handling rather than enabling Fast Launch end-to-end. Happy to extend if the CI account has a suitable AMI.
  • Draft so maintainers can comment on naming/scope and test depth before I add the state-changing companion.

@github-actions

Copy link
Copy Markdown

Docs Build 📝

Thank you for contribution!✨

The docsite for this PR is available for download as an artifact from this run:
https://github.com/ansible-collections/community.aws/actions/runs/26290440210

You can compare to the docs for the main branch here:
https://ansible-collections.github.io/community.aws/branch/main

File changes:

  • A collections/community/aws/ec2_ami_fast_launch_info_module.html
  • M collections/community/aws/ec2_ami_copy_module.html
  • M collections/community/aws/ec2_carrier_gateway_module.html
  • M collections/community/aws/index.html
  • M collections/index_module.html
Click to see the diff comparison.

NOTE: only file modifications are shown here. New and deleted files are excluded.
See the file list and check the published docs to see those files.

diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/ec2_ami_copy_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/ec2_ami_copy_module.html
index 42ec656..675a735 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/ec2_ami_copy_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/ec2_ami_copy_module.html
@@ -22,7 +22,7 @@
       <script src="../../../_static/sphinx_highlight.js?v=6ffebe34"></script>
     <script src="../../../_static/js/theme.js"></script>
     <link rel="search" title="Search" href="../../../search.html" />
-    <link rel="next" title="community.aws.ec2_carrier_gateway module – Manage an AWS VPC Carrier gateway" href="ec2_carrier_gateway_module.html" />
+    <link rel="next" title="community.aws.ec2_ami_fast_launch_info module – Gather information about EC2 Fast Launch enabled AMIs" href="ec2_ami_fast_launch_info_module.html" />
     <link rel="prev" title="community.aws.dynamodb_ttl module – Set TTL for a given DynamoDB table" href="dynamodb_ttl_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
 
 
@@ -497,7 +497,7 @@ see <a class="reference internal" href="#ansible-collections-community-aws-ec2-a
 
 <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
         <a href="dynamodb_ttl_module.html" class="btn btn-neutral float-left" title="community.aws.dynamodb_ttl module – Set TTL for a given DynamoDB table" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
-        <a href="ec2_carrier_gateway_module.html" class="btn btn-neutral float-right" title="community.aws.ec2_carrier_gateway module – Manage an AWS VPC Carrier gateway" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+        <a href="ec2_ami_fast_launch_info_module.html" class="btn btn-neutral float-right" title="community.aws.ec2_ami_fast_launch_info module – Gather information about EC2 Fast Launch enabled AMIs" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
   <hr/>
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/ec2_carrier_gateway_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/ec2_carrier_gateway_module.html
index e991b13..1745e9d 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/ec2_carrier_gateway_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/ec2_carrier_gateway_module.html
@@ -23,7 +23,7 @@
     <script src="../../../_static/js/theme.js"></script>
     <link rel="search" title="Search" href="../../../search.html" />
     <link rel="next" title="community.aws.ec2_carrier_gateway_info module – Gather information about carrier gateways in AWS" href="ec2_carrier_gateway_info_module.html" />
-    <link rel="prev" title="community.aws.ec2_ami_copy module – copies AMI between AWS regions, return new image id" href="ec2_ami_copy_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
+    <link rel="prev" title="community.aws.ec2_ami_fast_launch_info module – Gather information about EC2 Fast Launch enabled AMIs" href="ec2_ami_fast_launch_info_module.html" /><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
 
 
 
@@ -457,7 +457,7 @@ see <a class="reference internal" href="#ansible-collections-community-aws-ec2-c
           
 
 <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
-        <a href="ec2_ami_copy_module.html" class="btn btn-neutral float-left" title="community.aws.ec2_ami_copy module – copies AMI between AWS regions, return new image id" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+        <a href="ec2_ami_fast_launch_info_module.html" class="btn btn-neutral float-left" title="community.aws.ec2_ami_fast_launch_info module – Gather information about EC2 Fast Launch enabled AMIs" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
         <a href="ec2_carrier_gateway_info_module.html" class="btn btn-neutral float-right" title="community.aws.ec2_carrier_gateway_info module – Gather information about carrier gateways in AWS" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
     </div>
 
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/index.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/index.html
index 4ec2fe4..bbf5f4e 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/community/aws/index.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/community/aws/index.html
@@ -222,6 +222,7 @@
 <li><p><a class="reference internal" href="dynamodb_table_info_module.html#ansible-collections-community-aws-dynamodb-table-info-module"><span class="std std-ref">dynamodb_table_info module</span></a> – Returns information about a Dynamo DB table</p></li>
 <li><p><a class="reference internal" href="dynamodb_ttl_module.html#ansible-collections-community-aws-dynamodb-ttl-module"><span class="std std-ref">dynamodb_ttl module</span></a> – Set TTL for a given DynamoDB table</p></li>
 <li><p><a class="reference internal" href="ec2_ami_copy_module.html#ansible-collections-community-aws-ec2-ami-copy-module"><span class="std std-ref">ec2_ami_copy module</span></a> – copies AMI between AWS regions, return new image id</p></li>
+<li><p><a class="reference internal" href="ec2_ami_fast_launch_info_module.html#ansible-collections-community-aws-ec2-ami-fast-launch-info-module"><span class="std std-ref">ec2_ami_fast_launch_info module</span></a> – Gather information about EC2 Fast Launch enabled AMIs</p></li>
 <li><p><a class="reference internal" href="ec2_carrier_gateway_module.html#ansible-collections-community-aws-ec2-carrier-gateway-module"><span class="std std-ref">ec2_carrier_gateway module</span></a> – Manage an AWS VPC Carrier gateway</p></li>
 <li><p><a class="reference internal" href="ec2_carrier_gateway_info_module.html#ansible-collections-community-aws-ec2-carrier-gateway-info-module"><span class="std std-ref">ec2_carrier_gateway_info module</span></a> – Gather information about carrier gateways in AWS</p></li>
 <li><p><a class="reference internal" href="ec2_customer_gateway_module.html#ansible-collections-community-aws-ec2-customer-gateway-module"><span class="std std-ref">ec2_customer_gateway module</span></a> – Manage an AWS customer gateway</p></li>
diff --git a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/index_module.html b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/index_module.html
index e29b360..075ba8c 100644
--- a/home/runner/work/community.aws/community.aws/docsbuild/base/collections/index_module.html
+++ b/home/runner/work/community.aws/community.aws/docsbuild/head/collections/index_module.html
@@ -165,6 +165,7 @@
 <li><p><a class="reference internal" href="community/aws/dynamodb_table_info_module.html#ansible-collections-community-aws-dynamodb-table-info-module"><span class="std std-ref">community.aws.dynamodb_table_info</span></a> – Returns information about a Dynamo DB table</p></li>
 <li><p><a class="reference internal" href="community/aws/dynamodb_ttl_module.html#ansible-collections-community-aws-dynamodb-ttl-module"><span class="std std-ref">community.aws.dynamodb_ttl</span></a> – Set TTL for a given DynamoDB table</p></li>
 <li><p><a class="reference internal" href="community/aws/ec2_ami_copy_module.html#ansible-collections-community-aws-ec2-ami-copy-module"><span class="std std-ref">community.aws.ec2_ami_copy</span></a> – copies AMI between AWS regions, return new image id</p></li>
+<li><p><a class="reference internal" href="community/aws/ec2_ami_fast_launch_info_module.html#ansible-collections-community-aws-ec2-ami-fast-launch-info-module"><span class="std std-ref">community.aws.ec2_ami_fast_launch_info</span></a> – Gather information about EC2 Fast Launch enabled AMIs</p></li>
 <li><p><a class="reference internal" href="community/aws/ec2_carrier_gateway_module.html#ansible-collections-community-aws-ec2-carrier-gateway-module"><span class="std std-ref">community.aws.ec2_carrier_gateway</span></a> – Manage an AWS VPC Carrier gateway</p></li>
 <li><p><a class="reference internal" href="community/aws/ec2_carrier_gateway_info_module.html#ansible-collections-community-aws-ec2-carrier-gateway-info-module"><span class="std std-ref">community.aws.ec2_carrier_gateway_info</span></a> – Gather information about carrier gateways in AWS</p></li>
 <li><p><a class="reference internal" href="community/aws/ec2_customer_gateway_module.html#ansible-collections-community-aws-ec2-customer-gateway-module"><span class="std std-ref">community.aws.ec2_customer_gateway</span></a> – Manage an AWS customer gateway</p></li>

@centosinfra-prod-github-app

Copy link
Copy Markdown
Contributor

Build succeeded.
https://gateway-cloud-softwarefactory.apps.ocp.cloud.ci.centos.org/zuul/t/ansible/buildset/714ecf8bf1a34ab1a1df91348f47cc38

✔️ ansible-galaxy-importer SUCCESS in 4m 32s (non-voting)
✔️ build-ansible-collection SUCCESS in 6m 47s
✔️ ansible-test-splitter SUCCESS in 2m 43s
✔️ integration-community.aws-1 SUCCESS in 2m 40s
Skipped 21 jobs

@ewaldbervoets
ewaldbervoets marked this pull request as ready for review May 22, 2026 13:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant