software.amazon.awscdk.services.ec2

Class CloudFormationInit

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.ec2.CloudFormationInit

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-14T16:25:28.546Z")
public class CloudFormationInit
extends software.amazon.jsii.JsiiObject

A CloudFormation-init configuration.

Example:

 Bucket myBucket;
 InitServiceRestartHandle handle = new InitServiceRestartHandle();
 CloudFormationInit.fromElements(InitFile.fromString("/etc/nginx/nginx.conf", "...", InitFileOptions.builder().serviceRestartHandles(List.of(handle)).build()), InitSource.fromS3Object("/var/www/html", myBucket, "html.zip", InitSourceOptions.builder().serviceRestartHandles(List.of(handle)).build()), InitService.enable("nginx", InitServiceOptions.builder()
         .serviceRestartHandle(handle)
         .build()));
 

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CloudFormationInit(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CloudFormationInit(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
void	addConfig(java.lang.String configName, InitConfig config) Add a config with the given name to this CloudFormationInit object.
void	addConfigSet(java.lang.String configSetName) Add a config set with the given name to this CloudFormationInit object.
void	addConfigSet(java.lang.String configSetName, java.util.List<java.lang.String> configNames) Add a config set with the given name to this CloudFormationInit object.
void	attach(CfnResource attachedResource, AttachInitOptions attachOptions) Attach the CloudFormation Init config to the given resource.
static CloudFormationInit	fromConfig(InitConfig config) Use an existing InitConfig object as the default and only config.
static CloudFormationInit	fromConfigSets(ConfigSetProps props) Build a CloudFormationInit from config sets.
static CloudFormationInit	fromElements(InitElement... elements) Build a new config from a set of Init Elements.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CloudFormationInit

protected CloudFormationInit(software.amazon.jsii.JsiiObjectRef objRef)

CloudFormationInit

protected CloudFormationInit(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Method Detail

fromConfig

public static CloudFormationInit fromConfig(InitConfig config)

Use an existing InitConfig object as the default and only config.

Parameters:

config - This parameter is required.

fromConfigSets

public static CloudFormationInit fromConfigSets(ConfigSetProps props)

Build a CloudFormationInit from config sets.

Parameters:

props - This parameter is required.

fromElements

public static CloudFormationInit fromElements(InitElement... elements)

Build a new config from a set of Init Elements.

Parameters:

elements - This parameter is required.

addConfig

public void addConfig(java.lang.String configName,
                      InitConfig config)

Add a config with the given name to this CloudFormationInit object.

Parameters:

configName - This parameter is required.

config - This parameter is required.

addConfigSet

public void addConfigSet(java.lang.String configSetName,
                         java.util.List<java.lang.String> configNames)

Add a config set with the given name to this CloudFormationInit object.

The new configset will reference the given configs in the given order.

Parameters:

configSetName - This parameter is required.

configNames -

addConfigSet

public void addConfigSet(java.lang.String configSetName)

Add a config set with the given name to this CloudFormationInit object.

The new configset will reference the given configs in the given order.

Parameters:

configSetName - This parameter is required.

attach

public void attach(CfnResource attachedResource,
                   AttachInitOptions attachOptions)

Attach the CloudFormation Init config to the given resource.

As an app builder, use instance.applyCloudFormationInit() or autoScalingGroup.applyCloudFormationInit() to trigger this method.

This method does the following:

• Renders the AWS::CloudFormation::Init object to the given resource's metadata, potentially adding a AWS::CloudFormation::Authentication object next to it if required.
• Updates the instance role policy to be able to call the APIs required for cfn-init and cfn-signal to work, and potentially add permissions to download referenced asset and bucket resources.
• Updates the given UserData with commands to execute the cfn-init script.

Parameters:

attachedResource - This parameter is required.

attachOptions - This parameter is required.