Skip to content

Commit

Permalink
docs(aws): Adding link titles for pages, fixing formatting (#108)
Browse files Browse the repository at this point in the history
Co-authored-by: brian-armory <53799971+brian-armory@users.noreply.github.com>
  • Loading branch information
pdk27 and 317brian committed Jul 6, 2021
1 parent 32f29d5 commit 1338387
Show file tree
Hide file tree
Showing 7 changed files with 22 additions and 22 deletions.
2 changes: 1 addition & 1 deletion content/en/docs/setup/other_config/features/_index.md
Expand Up @@ -2,5 +2,5 @@
title: "Additional Features"
linkTitle: "Additional Features"
weight: 40
description:
description: Configure additional features like notifications, user data, Slack support.
---
Expand Up @@ -2,5 +2,5 @@
title: "Server Group Launch Settings"
linkTitle: "Server Group Launch Settings"
weight: 40
description:
description: Configure instance configuration for your server groups.
---
Expand Up @@ -2,33 +2,33 @@
title: "AWS EC2 Server Group Launch Settings"
linkTitle: "AWS EC2 Server Group Launch Settings"
weight: 1
description: An AWS EC2 Server Group offers a number of launch setting configurations that can enhance your experience with Spinnaker.
description: An AWS EC2 Server Group offers a number of launch setting configurations. Learn how you can enhance your experience with Spinnaker using the recommended EC2 Launch Templates.
---


### Launch Settings
An AWS Server Group can be set up with either a launch template or a launch configuration. However, <b>you must enable launch templates support for all of your applications if you want to use the latest AWS features.
AWS strongly recommends using _launch templates_ over _launch configurations_ because launch configurations do NOT provide full functionality for Amazon EC2 Auto Scaling or Amazon EC2.</b>

1. (Older) [launch configuration](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html) is an instance configuration template that an AWS Auto Scaling group uses to launch EC2 instances.
2. (Newer) [launch template](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html) is similar to a launch configuration, in that it specifies instance configuration information.
* (Newer) [launch template](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html) is similar to a launch configuration, in that it specifies instance configuration information.
However, defining a launch template instead of a launch configuration, you can:
- create and maintain multiple versions of a launch template
- access the launch-template-only AWS features like diversification of instances of a server group across instance type, purchase options (On-Demand / Spot), allocation strategies.

To learn more about launch templates features, see [AWS EC2 Launch Templates.](/features/server-group-launch-settings/aws-ec2/launch-templates.md)
- access the launch-template-only AWS features like diversification of instances of a server group across instance type, purchase options (On-Demand / Spot), allocation strategies.
To enable launch templates support, follow guidelines in <b>[AWS EC2 Launch Templates Setup](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates-setup)</b>
To learn more about launch templates features, see <b>[AWS EC2 Launch Templates](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates)</b>
* (Older) [launch configuration](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchConfiguration.html) is an instance configuration template that an AWS Auto Scaling group uses to launch EC2 instances.

### Enhance your EC2 Spot experience
[Amazon EC2 Spot Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html#spot-features)
let you take advantage of unused EC2 capacity in the AWS Cloud. Spot Instances are available at up to a 90% discount compared to On-Demand prices.

Spot Instances are tightly integrated with AWS services, like Amazon EC2 Auto Scaling. Auto Scaling groups let you tweak a number of configuration parameters that decide how to launch and maintain your applications running on Spot Instances.

Here are some configuration parameters to consider:
* Use MixedInstancesPolicy features detailed [here](/features/server-group-launch-settings/aws-ec2/launch-templates.md).
* Use MixedInstancesPolicy features detailed [here](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates)(requires Launch Template support to be enabled).
For example,
* Launch your Spot capacity from optimal instance pools using `spotAllocationStrategy` <b>caapcity-optimized</b>
* Launch your Spot capacity from optimal instance pools using `spotAllocationStrategy` <b>capacity-optimized</b>
* Specify a flexible set of instance types for your server group using `launch template overrides`.
* Enable `capacityRebalance` to allow EC2 Auto Scaling to monitor and automatically respond to changes that affect availability of your Spot Instances. This feature works best with the `capacity-optimized` spotAllocationStrategy.
For more information about capacity rebalancing, see [Amazon EC2 Auto Scaling Capacity Rebalancing.](https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html)
For more information about capacity rebalancing, see [Amazon EC2 Auto Scaling Capacity Rebalancing](https://docs.aws.amazon.com/autoscaling/ec2/userguide/capacity-rebalance.html)

Learn more about [AWS recommended best practices](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-best-practices.html).
@@ -1,8 +1,9 @@
---
title: "AWS EC2 Launch Templates Setup"
linkTitle: "AWS EC2 Launch Templates Setup"
description: "Setup and Rollout Guidelines for AWS EC2 Launch Templates"
---


> Please note that you should only proceed with this if you have [AWS EC2](/setup/install/providers/aws/aws-ec2) configured as a cloud provider. These features require 1.24 (although some features were launched in previous releases leading up to 1.24).
AWS uses [launch templates](https://docs.aws.amazon.com/autoscaling/ec2/userguide/LaunchTemplates.html) to specify instance configuration information. Launch templates are the successor of launch configurations. This means that any new instance configuration feature from AWS will only be supported by launch templates.
Expand All @@ -20,7 +21,7 @@ If you are new to Spinnaker or even just new to AWS in Spinnaker, we recommend i
aws.features.launch-templates.enabled: true
aws.features.launch-templates.all-applications.enabled: true
```
1. Read through the available launch template supported [features](#feature-configuration) to determine which features make sense for your users.
1. Read through the available launch template supported [features](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates) to determine which features make sense for your users.
1. Update AWS settings in Deck to enable launch templates and the features you identified. Ensure that `enableLaunchTemplates` is `true`.
```js
providers: {
Expand All @@ -46,7 +47,7 @@ If you already use AWS as a cloud provider in Spinnaker, we recommend migrating
aws.features.launch-templates.excluded-applications: "dangerousapp"
```
Review the [rollout configurations](#rollout-configuration) and determine which of these you can *temporarily* utilize for your rollout. If you do not need to rollout, stop here and follow the [new AWS users](#new-to-aws) steps instead.
1. Read through the available launch template supported [features](#feature-configuration) to determine which features make sense for your users.
1. Read through the available launch template supported [features](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates) to determine which features make sense for your users.
1. Update AWS settings in Deck to enable launch templates and the features you identified. Ensure that `enableLaunchTemplates` is `true`.
```js
// enable launch templates for AWS
Expand Down Expand Up @@ -116,4 +117,4 @@ If you would prefer to **skip a rollout**, use the configuration in [New to AWS]
</table>
## Feature Configuration
Learn more about the feature set along with sample API requests [here](/features/server-group-launch-settings/aws-ec2/launch-templates.md#Launch-Template-Feature-Configuration).
Learn more about the feature set along with sample API requests [here](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates).
@@ -1,14 +1,14 @@
---

title: "AWS EC2 Launch Templates"
linkTitle: "AWS EC2 Launch Templates"
description: "AWS EC2 Launch Template Features, Use Cases and Sample API Requests"
---


## Enable launch template feature set in Spinnaker
Follow guidelines [here](/features/server-group-launch-settings/aws-ec2/launch-templates-setup.md)
Follow guidelines [here](/docs/setup/other_config/server-group-launch-settings/aws-ec2/launch-templates-setup)

Note: The features supported in Deck come with helpful tool tips that aid in learning about them quickly.
Consider trying them out in Deck before using them in API, especially if you are new to them.
Consider trying them out in Deck, especially if they are new to you.

## Launch Template Feature Configuration
Once launch templates support is enabled in Clouddriver, a new set of features are unlocked.
Expand Down Expand Up @@ -186,9 +186,8 @@ Note that a number of these parameters complement each other. So, combining them
</tbody>
</table>

## Use Cases & Sample Requests
## Use Cases & Sample API Requests

## Sample API request
### Create Server Group with launch template
After enabling the launch template feature set is Clouddriver and/or Deck, set `setLaunchTemplate` to true in order to indicate Spinnaker to create your Server Group with an EC2 launch template.
```bash
Expand Down

0 comments on commit 1338387

Please sign in to comment.