Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spinnaker/kayenta
Automated Canary Service
https://github.com/spinnaker/kayenta
hacktoberfest
Last synced: 24 days ago
JSON representation
Automated Canary Service
- Host: GitHub
- URL: https://github.com/spinnaker/kayenta
- Owner: spinnaker
- License: apache-2.0
- Created: 2017-01-27T17:30:07.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-09-25T17:49:23.000Z (about 1 month ago)
- Last Synced: 2024-10-02T01:42:07.719Z (about 1 month ago)
- Topics: hacktoberfest
- Language: Java
- Homepage:
- Size: 11.4 MB
- Stars: 1,287
- Watchers: 81
- Forks: 631
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-cloud-native - kenyata - Automated Canary Service. (Application Delivery)
README
Kayenta
====
[](https://travis-ci.org/spinnaker/kayenta)
Kayenta is a platform for Automated Canary Analysis (ACA). It is used by Spinnaker to enable automated canary deployments. Please see the comprehensive [canary documentation](https://www.spinnaker.io/guides/user/canary/stage/) for more details.
### Canary Release
A canary release is a technique to reduce the risk from deploying a new version of software into production. A new version of software, referred to as the canary, is deployed to a small subset of users alongside the stable running version. Traffic is split between these two versions such that a portion of incoming requests are diverted to the canary. This approach can quickly uncover any problems with the new version without impacting the majority of users.
The quality of the canary version is assessed by comparing key metrics that describe the behavior of the old and new versions. If there is significant degradation in these metrics, the canary is aborted and all of the traffic is routed to the stable version in an effort to minimize the impact of unexpected behavior.
Canaries are usually run against deployments containing changes to code, but they
can also be used for operational changes, including changes to configuration.
### Frequently Asked Questions
See the [FAQ](docs/faq.md).
### Creating Canary Config
See the [Canary Config Object model](docs/canary-config.md) for how a canary config is defined in [Markdown Syntax for Object Notation (MSON)](https://github.com/apiaryio/mson).
### Debugging
To start the JVM in debug mode, set the Java system property `DEBUG=true`:
```
./gradlew -DDEBUG=true
```
The JVM will then listen for a debugger to be attached on port 8191. The JVM will _not_ wait for the debugger
to be attached before starting Kayenta; the relevant JVM arguments can be seen and modified as needed in `build.gradle`.
### Running Standalone Kayenta Locally
You can run a standalone kayenta instance locally with `docker-compose`.
```
# Copy and edit example config accordingly
cp kayenta-web/config/kayenta.yml ~/.spinnaker/kayenta.yml
# Build/Start Kayenta
docker-compose up
```
You should then be able to access your local kayenta instance at http://localhost:8090/swagger-ui/index.html.