ContextQMD
Back to Aws Doc Sdk Examples

Amazon EC2 Auto Scaling code examples for the SDK for Kotlin

kotlin/services/autoscale/README.md

latest4.1 KB
Original Source

Amazon EC2 Auto Scaling code examples for the SDK for Kotlin

Overview

This README discusses how to run and test the AWS SDK for Kotlin examples for Amazon EC2 Auto Scaling.

With Amazon EC2 Auto Scaling, you can maintain application availability and automatically add or remove EC2 instances according to conditions.

⚠️ Important

  • The SDK for Kotlin examples perform AWS operations for the account and AWS Region for which you've specified credentials. Running these examples might incur charges on your account. For details about the charges you can expect for a given service and API operation, see AWS Pricing.
  • Running the tests might result in charges to your AWS account.
  • We recommend that you grant your code least privilege. At most, grant only the minimum permissions required to perform the task. For more information, see Grant least privilege.
  • This code is not tested in every AWS Region. For more information, see AWS Regional Services.

Code examples

The credential provider used in all code examples is ProfileCredentialsProvider. For more information, see Using credentials.

Scenario

Running the Amazon EC2 Auto Scaling operations Kotlin files

Some of these examples perform destructive operations on AWS resources, such as deleting an Auto Scaling group. Be very careful when running an operation that deletes or modifies AWS resources in your account. We recommend creating separate test-only resources when experimenting with these examples.

To run these examples, set up your development environment. For more information, see Get started with the SDK for Java.

Testing the Amazon EC2 Auto Scaling Java files

You can test the Java code examples for Amazon EC2 Auto Scaling by running a test file named AutoScaleTest. This file uses JUnit 5 to run the JUnit tests and is located in the src/test/java folder. For more information, see https://junit.org/junit5/.

You can run the JUnit tests from an IDE, such as IntelliJ, or from the command line. As each test runs, you can view messages that inform you if the various tests succeed or fail. For example, the following message informs you that Test 3 passed.

Test 3 passed

WARNING: Running these JUnit tests manipulates real Amazon resources and might incur charges on your account.

Properties file

Before running the AWS Elastic Beanstalk JUnit tests, you must define values in the config.properties file located in the resources folder. This file contains values that are required to run the JUnit tests. For example, you define a crawler name used in the tests. If you do not define all values, the JUnit tests fail.

To successfully run the JUnit tests, define the following values:

  • groupName - The name of the Auto Scaling group.
  • groupNameSc - The name of the Auto Scaling group used in the scenario.
  • launchTemplateName - The name of the launch template.
  • serviceLinkedRoleARN - The Amazon Resource Name (ARN) of the service-linked role that the Auto Scaling group uses.
  • vpcZoneId - A subnet Id for a virtual private cloud (VPC) where instances in the Auto Scaling group can be created.

Additional resources

Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. SPDX-License-Identifier: Apache-2.0