Deploy Spinnaker and Connect to the UI

After you finish configuring Spinnaker, deploy it and connect to the Deck, the Spinnaker UI.

Now that we’ve enabled one or more Cloud Providers , picked a Deployment Environment , and configured Persistent Storage , we’re ready to pick a version of Spinnaker, deploy it, and connect to it.

Pick a version

  1. List the available versions:

    1. hal version list

    You can follow the links to the versions’ respective changelogs to see what features each adds.

  2. Set the version you want to use:

    1. hal config version edit --version $VERSION

Deploy Spinnaker

  1. hal deploy apply

Note: If you’re deploying to your local machine, you might need sudo hal deploy apply.

Connect to the Spinnaker UI

  1. Run the following command:

    1. hal deploy connect

    If necessary, set up an SSH tunnel to the host running Halyard.

    This command automatically forwards ports 9000 (Deck UI) and 8084 (Gate API service).

  2. Navigate to localhost:9000 .

Note: Even if the hal deploy apply command returns successfully, the installation may not be complete yet. This is especially the case with kubernetes distributed installs. If you see errors such as Connection refused it may be that all of the containers are not yet available. You can either wait, or check the status of all of the containers using the commands for your cloud provider (such as kubectl get pods --namespace spinnaker).

Troubleshooting

If this command fails, and it’s the first time you’ve run this command please reach out to us on Slack . If you’ve had a successful deployment, you can run hal deploy diff to see what changes you’ve made that may be causing problems. At any point you can rerun hal deploy apply with any changes you’ve made to retry the deployment.

Upgrade Spinnaker

If you want to change Spinnaker versions using Halyard, you can read about supported versions like so:

  1. hal version list

And pick a new version like so:

  1. hal config version edit --version $VERSION
  2. # this will update Spinnaker
  3. hal deploy apply

Next steps

Now that Spinnaker is deployed and capable managing your cloud provider, you can…

You might also want to back up your configuration .

Last modified May 7, 2021: docs(migration): fix imgs and links (9a18ce6)