Client tool to deploy Senza definitions using a Lizzy Agent (REST API)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Travis CI build status Coveralls status

Lizzy Client

Script to deploy Senza definitions using a Lizzy server.

Create a new stack

Use the create subcommand to create stacks. The syntax is lizzy create [OPTIONS] DEFINITION STACK_VERSION IMAGE_VERSION:

$ lizzy create senza.yaml 42 1.0

For see more options use lizzy create --help.

List stacks

Use the list subcommand to list stacks:

$ lizzy list

For see more options use lizzy list --help.

Change stack traffic

Use the traffic subcommand to change the stacks traffic:

$ lizzy traffic my_app 1.0 95

For see more options use lizzy traffic --help.

Change stack scale

Use the scale subcommand to re-scale a stack:

$ lizzy scale my_app 1.0 0

Note: Unlike senza, it doesn't require the --force argument to update multiple stacks.

For see more options use lizzy scale --help.

Deleting stacks

Use the delete subcommand to delete stacks:

$ lizzy delete my_app 1.0

For see more options use lizzy delete --help.


Lizzy Client can be configured with environmental variables:

  • LIZZY_URL — URL of Lizzy Agent (
  • LIZZY_SCOPES — should be uid
  • OAUTH2_ACCESS_TOKEN_URL — Oauth2 Access Token Url
  • CREDENTIALS_DIR — berry credentials folder, using the Zalando Stups' infrastructure, and by default /meta/credentials

The agent URL can also be set with the --remote flag


Lizzy client works with Berry out of the box. To run it locally for testing purposes see python-token's documentation.


Copyright 2015 Zalando SE

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.