Installation

Installing Armory Spinnaker

The installer is a script that is responsible for asking the user for customer specific inputs like AWS keys, VPC, subnets and S3 buckets. These inputs are kept locally on your system and then passed to Terraform. You can also install Armory Spinnaker directly from the Debian or RPM package if you don’t need the additional resources (S3/ElastiCache/IAM roles) created for you. Before getting started you’ll want to review the architecture guide, it’ll give you an overview of Armory Spinnaker.

Installing Armory Spinnaker Installer Scripts

Armory Spinnaker comes with an installer that walks you through deploying Spinnaker in your AWS account. It should only take 15 minutes to have an instance of Armory Spinnaker up and running. To get started, open up a terminal and execute the following:

bash -c "$(curl -sS http://get.armory.io)"

You will need a AWS user/profile with permission to create the following resources:

  • Autoscaling group and launch configuration
  • Elastic Load Balancer
  • Security group for the ELB
  • Security group for the Spinnaker stack
  • Elastic Cache (Redis)
  • IAM Role for Spinnaker instances
  • IAM Role for Spinnaker managed account
  • IAM Policy Spinnaker S3 Access
  • IAM Policy Spinnaker assume role permissions
  • IAM Policy Spinnaker ECR read access

If you want to learn more about what is happening behind the scenes, you can go through the components below.

Continuing From A Previous Install

previous

Terraform Templates

The installation of Armory Spinnaker relies on Terraform templates to create the infrastructure described above. The tfstate file is created and backed by S3 for record keeping. Note: You do not have to have Terraform installed for this as the dependency is managed with Docker. All you need is Docker installed to deploy Spinnaker for the first time.

Once you have Spinnaker deployed, you can then use Spinnaker to deploy itself.

Spinnaker-Terraform

Configuration(s) to set Spinnaker up for the first time.

ha - Configuration for a highly available setup.

stand-alone - Configuration for a development setup.

modules - Common configuration shared by both setups.

The installer will download the latest stable version of the Terraform files and place them in ~/armory/. - If you want to customize how the bootstrapped version of Spinnaker is installed, make changes to the template files in ~/armory/ and run the installer again.

Validating Your Spinnaker Install

hello