AWS imagebuilder: Add parent instance option and troubleshooting/SNS config details
Summary
Documents a new 'parent instance' build option using an EC2 Auto Scaling group, adds terminateInstanceOnCompletion troubleshooting setting, clarifies SNS topic naming rules, and fixes a Region wording typo.
Security assessment
The change adds a functional build option (parent instance from an Auto Scaling group) and clarifies configuration settings; it does not address a vulnerability or document a security control.
Evidence
* **A parent instance** – an instance that's already running, which Image Builder uses as the build instance instead of launching a new one. Image Builder takes it from an Amazon EC2 Auto Scaling group that you specify. For more information, see [Build on an instance from an Auto Scaling group](./infra-config-parent-instance.html).
Diff
diff --git a/imagebuilder/latest/userguide/manage-infra-config.md b/imagebuilder/latest/userguide/manage-infra-config.md index 85262bf..ebc6b1d 100644 --- a//imagebuilder/latest/userguide/manage-infra-config.md +++ b//imagebuilder/latest/userguide/manage-infra-config.md @@ -19 +19 @@ Use an infrastructure configuration to specify the following settings for your b - * **Instance types** for your build and test instances. We recommend that you specify more than one instance type because this allows Image Builder to launch an instance from a pool with sufficient capacity. This can reduce your transient build failures. If you specify more than one type, Image Builder launches an instance from the first type that has available capacity. If none of your instance types are available in the , the build fails. + * **Instance types** for your build and test instances. We recommend that you specify more than one instance type because this allows Image Builder to launch an instance from a pool with sufficient capacity. This can reduce your transient build failures. If you specify more than one type, Image Builder launches an instance from the first type that has available capacity. If none of your instance types are available in the AWS Region, the build fails. @@ -26,0 +27,2 @@ For Mac images, choose instance types that natively support macOS. For more info + * **A parent instance** – an instance that's already running, which Image Builder uses as the build instance instead of launching a new one. Image Builder takes it from an Amazon EC2 Auto Scaling group that you specify. For more information, see [Build on an instance from an Auto Scaling group](./infra-config-parent-instance.html). + @@ -31 +33 @@ For Mac images, choose instance types that natively support macOS. For more info - * **Troubleshooting settings** – an Amazon EC2 key pair and the `terminateInstanceOnFailure` setting. With these settings, you can keep a failed build instance running and connect to it to investigate. + * **Troubleshooting settings** – an Amazon EC2 key pair, and the `terminateInstanceOnFailure` setting. With these settings, you can keep a failed build instance running and connect to it to investigate. To keep the instance running after a build that completes successfully, use `terminateInstanceOnCompletion`. @@ -35 +37 @@ For Mac images, choose instance types that natively support macOS. For more info - * **An SNS topic** where Image Builder publishes messages about your image build status, such as when an image becomes available or a build fails. For more information, see [Amazon SNS integration in Image Builder](./integ-sns.html). + * **An SNS topic** where Image Builder publishes messages about your image build status, such as when an image becomes available or a build fails. The topic name can contain only letters, numbers, hyphens, and underscores. For more information, see [Amazon SNS integration in Image Builder](./integ-sns.html). @@ -47,0 +50,2 @@ If your SNS topic is encrypted, the key that encrypts this topic must reside in + * [Build on an instance from an Auto Scaling group](./infra-config-parent-instance.html) +