hmgauthami / spinnaker_cf Goto Github PK

Spinnaker is a Netflix open source, multi-cloud continuous delivery platform for releasing software changes with high velocity and confidence. It provides two core sets of features: cluster management and deployment management. For more information please refer to Spinnaker main website.

If you are interested in using Spinnaker on AWS, you can follow the instructions below to launch Spinnaker using CloudFormation or follow the official Spinnaker Getting Started guide.

AWS CloudFormation allows developers and systems administrators to create a collection of AWS resources as code in a template that can be provision repeatedly in an orderly and predictable fashion.

In order to launch Spinnaker on AWS, you would need to create a an instance running Spinnaker in a VPC's private subnet, instance role, base role for instances that Spinnaker will launch, and policies and permissions. This CloudFormation template takes care of the creation of most of that except for the base role and SSH key. The base role (BaseIAMRole) is a static string name that Spinnaker uses to assign role to instances it creates (aka IAM:PassRole permission). This cannot be created by CloudFormation because in order to prevent IAM resources name collision, CloudFormation does not allow you to control the IAM resource name therefore a role/user/group/policy created using CloudFormation will have a random name.

##Instruction - Using CloudFormation to Launch Spinnaker

Instructions to run Spinnaker using this Cloudformation:

1. Create an EC2 role - BaseIAMRole. EC2 instances launched with Spinnaker will be associated with this role.

2. Goto Console > AWS Identity & Access Management > Roles.

3. Click Create New Role.

4. Set Role Name to BaseIAMRole. Click Next Step.

5. On Select Role Type screen, hit Select for Amazon EC2.

6. Click Next Step.

7. On Review screen, click Create Role.

8. Create an EC2 Key Pair for connecting to your instances.

9. Goto Console > EC2 > Key Pairs.

10. Click Create Key Pair.

11. Name the key pair my-aws-account-keypair

12. AWS will download file my-aws-account-keypair.pem to your computer. chmod 400 the file.

13. Copy the config file file and place it in this folder ~/.ssh/ and replace <> with your instance info ---See sample in the repository

14. Copy the spinnaker-tunnel.sh file with the following content, and give it execute permissions

15. Run Spinnaker on AWS using Cloudformation

16. On AWS Console go to Cloudformation > Create new Stack

17. Select the template file > Click Next

18. Select the key and optionally change VPC and subnet info if needed

19. Accept IAM warning and click Submit

20. Once the status has changed to CREATE_COMPLETE. Click on the Output tab and copy the SpinnakerPublicHostName

21. Execute the script to start your Spinnaker tunnel

    ./spinnaker-tunnel.sh start

    Open browser to http://localhost:9000 to access Spinnaker

22. To stop your Spinnaker tunnel

    ./spinnaker-tunnel.sh stop