software.amazon.awscdk.services.ec2

Class InitUser

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.ec2.InitElement

software.amazon.awscdk.services.ec2.InitUser

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:38.451Z")
 @Stability(value=Stable)
public class InitUser
extends InitElement

Create Linux/UNIX users and to assign user IDs.

Users are created as non-interactive system users with a shell of /sbin/nologin. This is by design and cannot be modified.

Not supported for Windows systems.

Example:

 // Example automatically generated from non-compiling source. May contain errors.
 Vpc vpc;
 InstanceType instanceType;
 IMachineImage machineImage;
 Instance.Builder.create(this, "Instance")
         .vpc(vpc)
         .instanceType(instanceType)
         .machineImage(machineImage)
         // Showing the most complex setup, if you have simpler requirements
         // you can use `CloudFormationInit.fromElements()`.
         .init(CloudFormationInit.fromConfigSets(ConfigSetProps.builder()
                 .configSets(Map.of(
                         // Applies the configs below in this order
                         "default", List.of("yumPreinstall", "config")))
                 .configs(Map.of(
                         "yumPreinstall", new InitConfig(List.of(InitPackage.yum("git"))),
                         "config", new InitConfig(List.of(InitFile.fromObject("/etc/stack.json", Map.of(
                                 "stackId", Stack.of(this).getStackId(),
                                 "stackName", Stack.of(this).getStackName(),
                                 "region", Stack.of(this).getRegion())), InitGroup.fromName("my-group"), InitUser.fromName("my-user"), InitPackage.rpm("http://mirrors.ukfast.co.uk/sites/dl.fedoraproject.org/pub/epel/8/Everything/x86_64/Packages/r/rubygem-git-1.5.0-2.el8.noarch.rpm")))))
                 .build()))
         .initOptions(ApplyCloudFormationInitOptions.builder()
                 // Optional, which configsets to activate (['default'] by default)
                 .configSets(List.of("default"))
                 // Optional, how long the installation is expected to take (5 minutes by default)
                 .timeout(Duration.minutes(30))
                 // Optional, whether to include the --url argument when running cfn-init and cfn-signal commands (false by default)
                 .includeUrl(true)
                 // Optional, whether to include the --role argument when running cfn-init and cfn-signal commands (false by default)
                 .includeRole(true)
                 .build())
         .build();
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InitUser(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	InitUser(software.amazon.jsii.JsiiObjectRef objRef)
protected	InitUser(String userName, InitUserOptions userOptions)

Method Summary

Modifier and Type	Method and Description
static InitUser	fromName(String userName) Create a user from user name.
static InitUser	fromName(String userName, InitUserOptions options) Create a user from user name.
String	getElementType() Returns the init element type for this element.

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

InitUser

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

InitUser

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

InitUser

@Stability(value=Stable)
protected InitUser(@NotNull
                                            String userName,
                                            @NotNull
                                            InitUserOptions userOptions)

Parameters:

userName - This parameter is required.

userOptions - This parameter is required.

Method Detail

fromName

@Stability(value=Stable)
 @NotNull
public static InitUser fromName(@NotNull
                                                                   String userName,
                                                                   @Nullable
                                                                   InitUserOptions options)

Create a user from user name.

Parameters:

userName - This parameter is required.

options -

fromName

@Stability(value=Stable)
 @NotNull
public static InitUser fromName(@NotNull
                                                                   String userName)

Create a user from user name.

Parameters:

userName - This parameter is required.

getElementType

@Stability(value=Stable)
 @NotNull
public String getElementType()

Returns the init element type for this element.

Specified by:

getElementType in class InitElement