Spinnaker is an open source, multi-cloud continuous delivery platform for releasing software changes with high velocity and confidence.
Перейти к файлу
Greg BOUGEARD 2534d40037 Specific S3 as front50 backend stackdriver hints 2016-10-27 18:48:56 +02:00
.github https://github.com/spinnaker/spinnaker/issues/909: Fix link to troubleshooting documentation. 2016-05-31 14:36:17 -07:00
cassandra Remove references to deprecated rush service. (#942) 2016-06-17 11:01:41 -04:00
config Specific S3 as front50 backend stackdriver hints 2016-10-27 18:48:56 +02:00
consul (consul) No need for hello-consul deb 2016-10-06 12:30:25 -04:00
dev Disable deck tests when CHROME_BIN isnt set (#1247) 2016-10-18 09:44:57 -04:00
etc Configuration to support stackdriver. (#1200) 2016-10-05 11:54:23 -04:00
experimental Remove services.default.primaryAccountName from configuration. (#1238) 2016-10-14 09:21:56 -04:00
google merge conflict 2016-10-26 20:06:39 +00:00
gradle travis config 2015-11-20 12:14:34 -08:00
install adds confdef/confold flags to dist-upgrade 2016-10-26 21:32:52 +00:00
packer Update deck to resolve bake details url (aka the logs) via gate instead of directly via rosco. (#1232) 2016-10-13 16:29:17 -04:00
pkg_scripts Add fiat 2016-09-03 03:38:47 +00:00
pylib Add fiat 2016-09-03 03:38:47 +00:00
runtime Allow InstallSpinnaker.sh to ommit cassandra (#1026) 2016-07-28 14:20:59 -04:00
testing/citest L7 test deletes security group and updated health check. (#1262) 2016-10-25 16:56:03 -04:00
unittest Fixed yaml_util writing captalized booleans to config. (#959) 2016-06-27 14:01:09 -04:00
.gitignore (consul) added sample consul service (#1203) 2016-10-05 12:45:19 -04:00
.travis.yml travis config 2015-11-20 12:14:34 -08:00
AUTHORS Create AUTHORS 2015-11-15 10:16:46 -08:00
InstallSpinnaker.sh use mktemp to create tmp dir in install script (#1168) 2016-10-14 10:11:12 -04:00
LICENSE.txt Update LICENSE.txt 2016-03-14 03:22:31 -07:00
README.adoc Fixed a typo in README.adoc (#1169) 2016-09-25 15:13:13 -04:00
build.gradle publish InstallSpinnaker.sh during release process 2016-10-11 10:38:16 -07:00
gradlew newer gradle plugin 2015-11-15 10:04:29 -08:00
gradlew.bat Adding config files. Adding Install Scripts 2015-11-14 17:32:49 -05:00
settings.gradle Adding config files. Adding Install Scripts 2015-11-14 17:32:49 -05:00

README.adoc

:doctype: book

image:http://join.spinnaker.io/badge.svg[Slack Status,link=http://join.spinnaker.io]

= Using Spinnaker

If you are only interested in using Spinnaker, please refer to the main
Spinnaker site and http://www.spinnaker.io/docs/target-deployment-setup[Installation] guide.

If you want more information on how Spinnaker is designed, see the http://www.spinnaker.io/docs/overview[Documentation Overview].

= Setting Up Spinnaker For Development

These instructions cover pulling Spinnaker from source and setting up to run locally against Amazon Web Services and/or Google Cloud Platform accounts. 

Please ensure you have set up your target environment correctly by following step 1 of the http://www.spinnaker.io/docs/target-deployment-setup[Getting Started Documentation].

If you do not wish to build from source, please follow the http://www.spinnaker.io/docs/creating-a-spinnaker-instance#section-localhost[Localhost] section of the Creating a Spinnaker Instance guide.

If you would prefer to try a container based solution, see https://github.com/spinnaker/spinnaker/tree/master/experimental/docker-compose[docker-compose installation].

These scripts are tested on:

* Ubuntu 14.04 LTS
* Mac OS X 10.11

== Get the bootstrap / configuration repo

[source,bash]
----
#export SPINNAKER_HOME=/path/to/your/Spinnaker/workspace
mkdir -p $SPINNAKER_HOME
cd $SPINNAKER_HOME
git clone git@github.com:spinnaker/spinnaker.git
----

== Configure your environment

The Spinnaker platform has a few prerequisites, which are installed as a part of this configuration process. They are: 

* https://www.oracle.com/java/index.html[JDK8]
* http://redis.io/[Redis]
* http://cassandra.apache.org/[Cassandra]
* https://www.packer.io/[Packer]

=== Mac OS X

You need to have http://brew.sh/[homebrew] installed and ensure your version of git is above 2.0.  Cassandra must be 2.1.x where x >= 11 or you must enable thrift.

[source,bash]
----
brew tap caskroom/cask
brew install brew-cask
brew install redis homebrew/versions/cassandra21 packer
brew cask install java
cd $SPINNAKER_HOME
mkdir build
cd build
../spinnaker/dev/refresh_source.sh --pull_origin --use_ssh --github_user default
----

=== Ubuntu Linux

[source,bash]
----
cd $SPINNAKER_HOME
spinnaker/dev/install_development.sh
spinnaker/dev/bootstrap_dev.sh
----

The `bootstrap_dev.sh` script will ask to install additional components. `gcloud`
is only needed to write releases to Google Cloud Storage, but is convenient
to have if you plan on using or accessing Google Cloud Platform resources
from your development environment. These could be installed at a system level
rather than user level, but the default install requires updating your path
so is performed here.

== Configure Spinnaker

We will create a directory for Spinnaker configuration overrides, copy the
default configuration template there, and edit to select the appropriate cloud
provider(s).

[source,bash]
----
cd $SPINNAKER_HOME
mkdir -p $HOME/.spinnaker
cp spinnaker/config/default-spinnaker-local.yml $HOME/.spinnaker/spinnaker-local.yml
chmod 600 $HOME/.spinnaker/spinnaker-local.yml
----

If you are deployed onto a supported cloud provider (e.g., AWS or Google) and
you only wish to deploy on that platform then you do not need to perform
additional configuration. Otherwise, edit `$HOME/.spinnaker/spinnaker-local.yml`
and set the enabled option for the cloud provider(s) of your choice and
configure the attributes for that provider.

== Start Spinnaker Services

If you're running on Mac OS X, please make sure that your Redis and Cassandra
servers are up and running. Make sure that `cqlsh` is accessible in your path
and you can connect to Cassandra by calling `cqlsh` in your terminal.

[source,bash]
----
cd $SPINNAKER_HOME/build
../spinnaker/dev/run_dev.sh [service]
----

If a service is provided, then just that one service will be started.
If no service is provided, then all the services will be started
(including Redis and Cassandra unless they are specified with a remote host).
If a service is already running (even if not yet available) then it will
not be restarted.

*Note* `run_dev.sh` might get stuck waiting on a service to start. Hitting
CTRL-C just stops the waiting on service, it doesn't terminate the services. If
it seems stuck, stop and restart `run_dev.sh`.

== Stop Spinnaker Services

[source,bash]
----
cd $SPINNAKER_HOME/build
../spinnaker/dev/stop_dev.sh [service]
----

If a service is provided, then just that one service will be stopped.
If no service is provided then all the spinnaker services will be stopped.
Cassandra and Redis are not affected by `stop_dev.sh`.