Installation

Guides for installing Armory, an enterprise continuous delivery platform built on top of SpinnakerTM, in your air-gapped, local, or cloud environment.

Installation methods

There are several methods to install Armory:

Method Environment Description Benefits
Armory Operator Kubernetes Kubernetes operator that turns Armory’s configuration declarative GitOps friendly and ready for production use
Armory Halyard Kubernetes Versatile command line interface to configure and deploy Armory Quick Setup
Minnaker MacOS, Linux, Windows Spin up a whole environment on top of Rancher K3s to deploy Armory This is ideal if you do not have a Kubernetes cluster available and want to try out Armory

All the methods above share similar configurations, and you can migrate between them if your needs change.

Armory does not generate default hardcoded usernames and passwords for user accounts for any service. Manage these by configuring authentication and authorization for the Armory Platform.

Guides

Based on your environment, use one of the following guides to help you install Armory:

Guide Environment Description
Air Gapped Air-gapped environments that use Halyard or Operator Learn how to host your own Bill of Materials to install Armory in air-gapped environments.
AWS Marketplace AWS One-click install on the AWS marketplace.
Install on Kubernetes Halyard, Operator General workflow for installing Armory on Kubernetes
Install on AWS AWS, Halyard Installation steps for AWS, including IAM configuration
Install on AWS EC2 with Operator AWS EC2, Operator Installation steps for using Armory Operator to install Armory in a Lightweight Kubernetes (K3s) instance for POCs
Install on AKS AKS, Halyard Installation steps for Azure Kubernetes Service
Install on GKE GKE, Halyard Installation steps for GoogLe Kubernetes Engine
Install on GKE with Operator GKE, Operator Installation steps for Google Kubernetes Engine using Operator
Configuring Halyard Halyard Description of Armory-extended Halyard configurations

Armory Operator

The Armory Operator is a Kubernetes Operator that makes it easy to install, deploy, and upgrade any version of Armory or Spinnaker.

Armory Halyard

Armory-extended Halyard is a versatile command line interface (CLI) to configure and deploy Armory in Kubernetes or any cloud environment.

Minnaker

Minnaker is an all-in-one, open source command line tool to install Armory or SpinnakerTM in a lightweight Kubernetes environment.

Guides

This section details installing Armory in Kubernetes, OpenShift, Azure, Google Kubernetes Engine (GKE), and Amazon Web Sevices (AWS), including from the AWS Marketplace. Instructions cover using Halyard and the Armory Operator in local, cloud, and air-gapped environments.

Armory Operator Reference

The Armory Operator is a Kubernetes Operator that makes it easier to install, deploy, and upgrade any version of Armory. This section describes the fields in the SpinnakerService custom resource definition (CRD) and example manifests.