Skip to content

A tool for configuring, installing, and updating Spinnaker

License

Notifications You must be signed in to change notification settings

spinnaker/halyard

Folders and files

NameName
Last commit message
Last commit date
Feb 13, 2025
Sep 27, 2024
Jun 13, 2023
Sep 26, 2024
Nov 20, 2024
Sep 27, 2024
Sep 26, 2024
Nov 20, 2024
Jun 12, 2024
Aug 18, 2022
Sep 25, 2024
Aug 25, 2022
Aug 25, 2022
Apr 19, 2017
Aug 25, 2022
Mar 22, 2017
Jan 8, 2019
Apr 9, 2020
Oct 29, 2018
Apr 27, 2022
May 30, 2019
Jul 6, 2020
Nov 19, 2024
Nov 19, 2024
Nov 19, 2024
May 4, 2017
Sep 26, 2016
Oct 5, 2023
Oct 17, 2023
Jun 10, 2017
Mar 21, 2025
Jun 13, 2023
Jun 13, 2023
Jan 8, 2019
Apr 9, 2024
Oct 5, 2023

Halyard

Logo

A tool for configuring, installing, and updating Spinnaker.

Halyard Docs are available on spinnaker.io

Installation

NOTICE: This tool is in Beta - some behavior may still change. Please report any bugs/problems/questions on the issue tracker or in slack.

$ curl -O https://raw.githubusercontent.com/spinnaker/halyard/master/install/debian/InstallHalyard.sh
$ sudo bash InstallHalyard.sh

Overview

There are three parts to Halyard, the halconfig, the daemon, and hal. In short, hal is a Command Line Interface (CLI) that sends commands to the daemon to update the halconfig, which is ultimately the source of all configuration for your Spinnaker deployment.

halconfig

The halconfig is a file that is central to how Halyard configures your Spinnaker deployment. Its goal is to centralize all configuration for your Spinnaker deployment (how to authenticate against your cloud providers, which CI system is in use, Spinnaker monitoring, etc...).

For a detailed description, please read the design doc

daemon

The daemon validates and generates Spinnaker config using your halconfig. It must run on a machine that has any credentials needed by Spinnaker in order to validate your configuration.

debugging

To run a daemon locally for JVM debugging, set the java system property DEBUG=true. For example:

./gradlew halyard-web:run -DDEBUG=true

It listens for the debugger on port 9099, and does not wait for the debugger before running halyard. To change these, check out the relevant bits in halyard-web/halyard-web.gradle

hal

hal is a CLI for making changes to your halconfig via the daemon.

Read the command reference here.