Skip to content
This repository was archived by the owner on Jul 10, 2021. It is now read-only.

Commit 07fa46c

Browse files
docs(aws): AWS Launch Template only applicable for 1.23 and above (#2098)
Co-authored-by: Kevin Woo <[email protected]>
1 parent 738e17f commit 07fa46c

File tree

1 file changed

+15
-16
lines changed
  • setup/features/aws-launch-templates

1 file changed

+15
-16
lines changed

setup/features/aws-launch-templates/index.md

Lines changed: 15 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -7,12 +7,13 @@ sidebar:
77

88
{% include toc %}
99

10-
> 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.
10+
> 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. This features requires version 1.23.
1111
1212
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.
1313

1414
Spinnaker still supports launch configurations for backwards compatbility, but recommends enabling launch templates to access any new features that AWS adds.
1515

16+
<!-- The New to AWS section is valid in version 2.24 and later
1617
## Setup Steps
1718
This section summarizes the steps required to set up launch templates if you are new to using AWS in Spinnaker or if you have already been using AWS as one of your cloud providers.
1819
@@ -41,40 +42,39 @@ If you are new to Spinnaker or even just new to AWS in Spinnaker, we recommend i
4142
### Current AWS User
4243
If you already use AWS as a cloud provider in Spinnaker, we recommend migrating to launch templates. Since there may be pre-existing dependencies on launch configurations, we have created some rollout configurations you can utilize for testing and/or migration.
4344
45+
4446
1. Update your clouddriver configuration file, usually `clouddriver.yml`, to enable launch template support.
4547
```yml
4648
aws.features.launch-templates.enabled: true
4749
```
4850
1. 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.
49-
1. Update `coulddriver.yml`. This step can be repeated as needed throughout your rollout. This is an example config where launch templates is rolled out to two applications in production and all of the test account. It also excludes one application completely:
51+
-->
52+
1. Update `clouddriver.yml`. This step can be repeated as needed throughout your rollout. This is an example config where launch templates is rolled out to two applications in production and all of the test account. It also excludes one application completely:
5053
```yml
5154
aws.features.launch-templates.enabled: true
5255
aws.features.launch-templates.allowed-applications: "myapp:prod:us-east-1,anotherapp:prod:us-east-1"
5356
aws.features.launch-templates.allowed-accounts: "test"
5457
aws.features.launch-templates.excluded-applications: "dangerousapp"
55-
aws.features.launch-templates.all-applicaitons.enabled: false
58+
aws.features.launch-templates.all-applications.enabled: false
5659
```
5760
1. Read through the available [features](#feature-configuration) to determine which make sense for your use cases.
58-
1. Update AWS settings in deck to include the features you identified. Ensure that `enableLaunchTemplates` is `true`.
61+
1. Update AWS settings to enable launch templates to include the features you identified. Ensure that `enableLaunchTemplates` is `true`.
5962
```js
60-
providers: {
61-
aws: {
62-
serverGroups: {
63-
enableLaunchTemplates: true,
64-
enableIPv6: true,
65-
enableIMDSv2: true,
66-
}
67-
}
68-
}
63+
// enable launch templates for AWS
64+
window.spinnakerSettings.providers.aws.serverGroups.enableLaunchTemplates = true;
65+
window.spinnakerSettings.providers.aws.serverGroups.enableIPv6 = true;
66+
window.spinnakerSettings.providers.aws.serverGroups.enableIMDSv2 = true;
6967
```
68+
<!-- The New to AWS section is valid in version 2.24 and later
7069
1. When you are ready for a complete rollout, enable launch templates for all applications and clean up rollout config in `clouddriver.yml`.
7170
```yml
7271
aws.features.launch-templates.enabled: true
7372
aws.features.launch-templates.all-applications.enabled: true
7473
```
75-
74+
-->
7675
## Rollout Configuration
77-
If you already use AWS, then your applications may have some dependencies on launch configurations that prevent simple feature enabling. The configuration options beflow were created to aid with testing or a rollout period. Feel free to use whatever combination is best for you. If you would prefer to **skip a rollout**, use the configuration in [New to AWS](#new-to-aws).
76+
If you already use AWS, then your applications may have some dependencies on launch configurations that prevent simple feature enabling. The configuration options beflow were created to aid with testing or a rollout period. Feel free to use whatever combination is best for you.
77+
<!--If you would prefer to **skip a rollout**, use the configuration in [New to AWS](#new-to-aws).-->
7878

7979
<table>
8080
<thead>
@@ -149,4 +149,3 @@ Once launch templates are enabled in clouddriver, a new set of features are unlo
149149
</tr>
150150
</tbody>
151151
</table>
152-

0 commit comments

Comments
 (0)