spinnaker

:doctype: book

image:http://join.spinnaker.io/badge.svg[Slack Status,link=http://join.spinnaker.io]
image:https://travis-ci.org/spinnaker/spinnaker.svg?branch=master["Build Status", link="https://travis-ci.org/spinnaker/spinnaker"]

= Welcome to the Spinnaker Project

Spinnaker is an open-source continuous delivery platform for releasing software changes with high velocity and confidence.  Spinnaker provides a single platform that allows you to safely deploy and manage your application in multiple cloud environments (AWS, GCP, Kubernetes and more!).  With automated canary analysis and multiple ways to initiate deployments, you can safely promote your code from a git commit into a dev environment all the way through multiple production environments with confidence in the results.  Spinnaker is the most mature and widely productionalized continuous delivery platform built upon the work of Netflix, Google, Microsoft, Amazon and numerous other companies to allow fast, safe deploys. Used by numerous organizations including Target, Salesforce, Airbnb, Cerner, Adobe, JPMorgan Chase and more!  

= Project status and updates

Note that this repo is only used for issue tracking across the various services at this time.  Releases are not managed here nor are updates regularly made to this repository.  Please see the following for more information about spinnaker and it's state:

- https://spinnaker.io/docs/releases/versions/[Current available versions]
- https://join.slack.com/t/spinnakerteam/shared_invite/zt-7juwxmx0-nQ4Ud4pJcbuPykX3SXwQrg[The spinnaker slack for help and discussions around spinnaker]
- https://github.com/spinnaker/spinnaker/issues[Issues page for bug reports, enhancements and similar]
- https://github.com/spinnaker/governance/[Governance for the project as a whole]
There is a lot of activity and we'd welcome participation! 

= More about spinnaker


Manage your SDLC in Spinnaker using the GUI (graphical user interface), or config-as-code. View, manage, and construct https://www.spinnaker.io/docs/concepts/#application[application] workflows involving one or all of these resources:

- https://www.spinnaker.io/reference/pipeline/stages/#bake[Virtual machine (VM) deployments to a public cloud provider], "baked" as immutable infrastructure
- https://www.spinnaker.io/reference/providers/[Container deployments to a cloud]
- https://www.spinnaker.io/guides/user/kubernetes-v2/deploy-manifest/[Container deployments to Kubernetes]
- https://www.spinnaker.io/docs/concepts/#load-balancer[Load balancers]
- Security groups
- https://www.spinnaker.io/docs/concepts/#server-group[Server groups]
- https://www.spinnaker.io/docs/concepts/#cluster[Clusters]
- https://www.spinnaker.io/docs/concepts/#firewall[Firewalls]
- Functions

Facilitate GitOps, and grant developers control of provisioning infrastructure for apps. Use Spinnaker’s Clouddriver to deploy to all of the major public cloud providers and Kubernetes. You may even orchestrate configuration and firmware changes as part of Spinnaker delivery https://www.spinnaker.io/docs/concepts/#pipeline[pipelines].

= Why Do I Need Spinnaker?

Use Spinnaker to create a “paved road” for application delivery, with guardrails that ensure only valid infrastructure and configuration reach production.

Free development teams from burdensome ops provisioning while automating reinforcement of business and regulatory requirements. Delivery automation strategies such as canary deployments provide the safety necessary to capture value from quick innovation, while protecting against business and end-user impact.
 
= Tech Specs

Spinnaker consists of a number of https://www.spinnaker.io/reference/architecture/[independent microservices], with the https://github.com/spinnaker/halyard[Halyard CLI tool] or the https://www.armory.io/spinnaker-community/spinnaker-operator/[Kubernetes Operator] (Beta)
managing the lifecycle of the other services. A https://www.spinnaker.io/docs/setup/other_config/[variety of SDLC tools] integrate with Spinnaker, and its plugin framework makes Spinnaker more easily customizable to your needs. Plugins allow us to add system integrations without updating Spinnaker, broadening its potential
to easily leverage the entire software delivery toolchain. With this in place, Spinnaker is evolving towards a smaller threat surface,
enabling performance and operational advantages. Meanwhile, managed delivery, a newer Spinnaker featureset, provides declarative definitions of common
infrastructure and other requirements; users can declare requirements using those
prebuilt definitions and move changes through environments via a visual interface.

'''

This repository centralizes issue tracking across Spinnaker for each microservice. 
The core code making up Spinnaker’s microservices is found in the other https://github.com/spinnaker[Spinnaker repositories].

= Using Spinnaker

Spinnaker users should refer to the main
https://www.spinnaker.io/[Spinnaker site] and https://www.spinnaker.io/docs/setup/[Installation] guide.

For more information on how Spinnaker is designed, see the https://www.spinnaker.io/docs/concepts/[Concepts] topic in the documentation Overview.

If you're interested in a detailed walkthrough of the Spinnaker systems, check the https://spinnaker.io/guides/[Spinnaker How-to guides, videos, and codelabs].

= Setting Up Spinnaker For Development

To pull Spinnaker from source and set it up to run locally against any of the https://www.spinnaker.io/setup/install/providers/#supported-providers[Cloud Providers], follow the https://spinnaker.io/docs/community/contributing/code/developer-guides/dev-env/getting-set-up/[Developer Setup Guide]