A log of all ksonnet release changes

v0.12.0 (2018-8-2)

Full Changelog

ksonnet 0.12.0 introduces the following changes:


  • Added Helm Registry support where charts operate as ksonnet parts #583
  • Added docker-image target to Makefile for building an image with ks #588
  • Added --installed flag to ks pkg list to show installed packages #600
  • Changed location of cached registry manifests #604
  • Added --server to change Kubernetes server address in an environment #612
  • Added --api-spec to change Kubernetes API version in an environment #618
  • Added ks registry set <name> --uri <uri> command to update a registry URI #622
  • Changed GitHub-based registries to automatically follow remote branches #622
  • Removed versioning for ksonnet registries #632
  • Added retries up to five times for ks apply #639
  • Added lib/ to jsonnet path #647
  • Changed vendored packages to be qualified with their versions and allow side-by-side installation #669
  • Updated ks pkg list to show canonical versions for packages #673
  • Added package version to ks pkg list #673
  • Added package versioning support where fully-qualified package identifiers can be specified by <registry>/<pkg>@<version> #683
  • Added --output=json to print tabular output as JSON #695
  • Added support for packages to be installed in an environment with ks pkg install --env <env> <registry/package> #697
  • Added environment scope for packages with ks pkg list #727
  • Added a force option to allow re-installing an existing version of a package with ks pkg install --force #744
  • Updated ks upgrade to change environment target separators from / to . #792
  • Change ks component list to aggregate components from all modules #797
  • Updated go-jsonnet version from dfddf2b to v0.11.2 #800

Bug Fixes:

  • Allowed component selection for ks diff #592
  • Ensured registry paths exist prior to adding #601
  • Picked up proper kubernetes version when running on OpenShift #640
  • Re-added docker image resolver for setting parameters #645
  • Fixed case where ks apply --dry-run modified the cluster #699
  • Reworked failing end-to-end tests #706
  • Fixed error message when passing verbose flag to ks generate #772
  • Update resource version on retry due to conflict #787
  • Fixed case where params are required to render multiple components #790
  • Allow removing component in a module with dot notation #796
  • Fixed sorting of objects for consistent ks diff behavior #808
  • Fixed ks diff to return all object types #811
  • Updated ks diff to use environment rather than current context #811

v0.11.0 (2018-6-1)

Full Changelog

ksonnet 0.11 introduces the following changes:

  • ks apply will now use merge patching when it can, so Service NodePorts will not be reassigned
  • ks diff now provides more concise output
  • ksonnet built-in prototypes have been reworked to not use ksonnet-lib
  • Allow parameters with underscores in the name
  • Jsonnet printer now produces jsonnet formatter compliant output
  • ks show output in JSON format will use a Kubernetes list object
  • Components can now return lists and ksonnet will wrap them in a Kubernetes list object
  • App override configuration now has a kind/apiVersion
  • Fixed various panics due to ksonnet not being run in an application or receiving unknown input

v0.10.2 (2018-5-11)

Full Changelog

ksonnet 0.10.2 is a bug fix release

  • gracefully recover when setting parameters from the command line
  • add module paths to jsonnet path when evaluating components
  • support all Jsonnet language functions
  • adds option to reduce verbosity of debug logging
  • re-enable native functions for Jsonnet vm
  • list components in alphabetical order
  • disable ksonnet-lib import in environments unless explicitly required
  • omit library gitVersion if it is null

v0.10.1 (2018-04-27)

Full Changelog

ksonnet 0.10.1 fixes issues with evaluating components

v0.10.0 (2018-04-26)

Full Changelog

ksonnet 0.10.0 introduces the following new features:

  • support for YAML/JSON components
  • global environment parameters
  • use Jsonnet AST for all Jsonnet transformations
  • filesystem based registries
  • upgrade jsonnet to 0.10
  • registry and environment overrides
  • many bug fixes and usability improvements

Closed issues:

  • Iteration plan for release 0.10 #360
  • Public Git Repository Setup #352
  • Generate registry scaffolding #234
  • ks disk-based registry can’t generate prototype #480
  • param::import is broken in alpha version #475
  • ks apply –component not working on 0.10.0-alpha.2 or 0.10.0-alpha.3 #472
  • ks param set does not seem to work for yaml components #468
  • ks import doesn’t take namespace into account #467
  • X.509 certificate issue when executing ks init #436
  • Move main.go to cmd/ks #112

Merged pull requests:

v0.10.0-alpha.3 (2018-04-20)

Full Changelog

Fixed bugs:

  • Support GitHub registries with contents in the root path. #459

Closed issues:

  • ksonnet version 0.10.0-alpha.2 unable to import libsonnet files #464
  • Cannot use importstr: ERROR find objects: output: unknown node type: (*ast.ImportStr) #461
  • update ksonnet libs #454
  • ks param set command is not able to set array or map. #448
  • ks param list command shows error if components/params.libsonnet has null or array. #447
  • ks import -f some-component.yaml does not set component index in components/params.libsonnet #437
  • Regression from 0.9.1: Getting “ERROR Unauthorized” when using –token parameter in 0.9.2 #430

Merged pull requests:

  • Reorganize layout #466 (bryanl)
  • Supply proper codes for building env jsonnet #465 (bryanl)
  • Updating ksonnet-lib printer to handle importstr #463 (bryanl)
  • When importing YAML, extract objects into separate component files #462 (bryanl)
  • Generate proper vendor paths for gh registry with in root #460 (bryanl)
  • evaluator is missing ksonnet vendor path #458 (bryanl)
  • Fixed year 2017 -> 2018 #456 (uthark)
  • Add env update command #455 (bryanl)
  • Handle null as a value #453 (bryanl)

v0.10.0-alpha.2 (2018-04-17)

Full Changelog

Fixed bugs:

  • Drop-in YAML components with parameters #426

Closed issues:

  • ksonnet 1.10 no longer uses environments/env/main.jsonnet #446
  • ks diff local:prod local:dev: RUNTIME ERROR: max stack frames exceeded #445
  • ks generate panics “runtime error: index out of range” instead of printing usage #441
  • ks param list: ERROR retrieve values for mixin.spec.template.spec.hostNetwork: can’t handle type bool #438
  • ks generate prototype --help should be a thing #120

Merged pull requests:

  • Set maps in arrays from cli #452 (bryanl)
  • Convert diff to use pipline #451 (bryanl)
  • Ensure param diff works with all component types #450 (bryanl)
  • Use main.jsonnet for rendering components #449 (bryanl)
  • Support bool for object values in YAML #444 (bryanl)
  • Don’t panic when runing ks generate with no args #443 (bryanl)
  • Merge in new YAML params #442 (bryanl)
  • Fixing broken link in docs and also typos #439 (Maerville)
  • Add help when generating or previewing prototypes #435 (bryanl)
  • FS registry can handle relative paths #434 (bryanl)

v0.10.0-alpha.1 (2018-04-10)

Full Changelog

Implemented enhancements:

  • Generated environment parameters can’t assume component parameters path #354
  • Upgrade to client-go version 6 #297
  • Support local folders for registries #232
  • Load test data as fixtures #168
  • Document or provide better error messages for breaking ks changes #155
  • Consider naming the default environment after the initialized context #82
  • Move constructBaseObj out of root.go #72
  • Autogenerate .gitignore file (e.g. for libs or hidden files) #55

Fixed bugs:

  • Misleading kubeconfig log message #287
  • Consolidate type checking between params and prototypes #44

Closed issues:

  • In-cluster API access #431
  • inception server not working #429
  • Question: import not available kubeflow/core/all.libsonnet and other problems with master #420
  • ks pkg install does not install the correct branch set in the registry #398
  • 1.9 & 1.10 support? #394
  • ks -v should print an equivalent jsonnet command line string #378
  • Proposal: Create ks param unset command for “unsetting” params #325
  • use /swagger.json from apiserver for api-spec #264
  • Update VSCode extension to work better with the new ks-generated files #224
  • Implement ks install #217
  • Increase test coverage #216
  • Should be able to be used offline #204
  • Add bash completion #124
  • Consolidate expandEnvObjs and expandEnvCmdObjs into one function #70
  • Move core logic of new commands (dep and registry) to pkg kubecfg #65

Merged pull requests:

v0.9.1 (2018-03-08)

This patch focuses on fixes around usability bugs.

Closed issues:

  • version 0.9 - ks show not picking up env param overrides #346
  • ks delete default fails #342

Merged pull requests:

v0.9.0 (2018-03-05)

Iteration Plan

Full Changelog

To update older ksonnet applications, run ks upgrade --help.


This release focuses on two major areas:

  1. Changes to the underlying ksonnet-lib dependency and utilizing them in ks. The changes involve a major uplift to how the ksonnet language APIs are generated, so that support for future Kubernetes versions are easier.

  2. Improvements to the support for environments and components. Environments are now able to specify targets, to apply a subset of components as opposed to all components. We’ve introduced the concept of component namespaces to add division and hierarchy to components. We’ve also added commands to support removing and listing of components.

Changes to Environment Metadata

spec.json > app.yaml

In 0.8.0, each ks application contained a spec.json file per environment. This file contained the environment specification details; corresponding to a Kubernetes cluster server address and namespace.


  "server": "",
  "namespace": "default"

With 0.9.0, we will be consolidating majority of the application specification details into a top-level app.yaml file. As opposed to opening multiple files, this approach will make it easier for users to configure changes in a single place. Similar to spec.json, this metadata will be auto-generated when a environment is created or modified from the command line. However, it is also meant to be user-modifiable.


apiVersion: 0.0.1
      namespace: default
    k8sVersion: v1.7.0
    path: default
name: new
      commitSha: 422d521c05aa905df949868143b26445f5e4eda5
      refSpec: master
    protocol: github
version: 0.0.1

You will notice a couple new fields under the environments field.

  1. destination is identical to the contents of the previous spec.json, containing the server address and namespace that this environment points to.

  2. k8sVersion is the Kubernetes version of the server pointed to at the destination field.

  3. path is the relative path in the environments directory that contains other metadata associated with this environment. By default, path is the environment name.

Consolidation of lib files

In 0.8.0, each environment’s .metadata directory stored 3 files related to the generated ksonnet-lib. It was unecessary and also costly as the number of environments grow. We didn’t need to store multiple copies of the same API version on disk.

With 0.9.0, the Kubernetes API version that each environment uses will be recorded in the environment specification (as seen in the previous section). The metadata files are cached once locally per k8s API version in lib.

These files also no longer need to be checked into source control, as ks will auto-generate lib files that aren’t found.

Targets & Component Namespaces

In 0.8.0, there was no simple way for users to declare that a environment should only operate on a subset of components.

With 0.9.0, environments can now choose the set of components that they wish to operate (i.e., apply, delete, etc.) on. These targets can be specified in the app.yaml file, mentioned in an earlier section.

For example, if the components directory is structured as follows:

├── components
│   ├── auth
│   │   ├── ca-secret.jsonnet
│   │   ├── params.libsonnet
│   │   └── tls-certificate.jsonnet
│   ├── dev
│   │   ├── memcached.jsonnet
│   │   └── params.libsonnet
│   ├── params.libsonnet
│   └── prod
│   ...

An environment configuration in app.yaml may appear as follows:

    k8sVersion: 1.7.0
      namespace: default
      - auth
      - dev

In the above example, the dev environment would only operate on the components within the auth and dev component namespaces.

Note: Component files do not need to be namespaced. Top-level components and individual component files can also be referenced by targets.

Command Changes

ks component list

ks component list is a new command. See docs here.

ks component rm

ks component rm is a new command. See docs here.

ksonnet-lib Changes

  • Create Jsonnet AST printer
  • Convert ksonnet-lib generation process to Asonnet AST


Closed issues:

  • tutorial document as linked from Google seems semi-broken? #322
  • Incorrect imports in ks generated files #321
  • delete component ERROR strconv.Atoi: parsing “8+”: invalid syntax #316
  • ks param set when used with boolean does not create string value #311
  • Move custom constructors k8s.libsonnet to k.libsonnet #304
  • ERROR user: Current not implemented on linux/amd64 #298
  • Difficulty handling components unique to environments #292
  • ks delete ERROR strconv.Atoi #272
  • Create darwin binaries and make the available via brew #270
  • Unable to install packages with the same name under different registries #269
  • prototypes can’t rely on a registry name, but they do #262
  • Confirm that ksonnet-lib generation works for Kubernetes 1.9#260
  • ks can’t recognise the registry ‘kubeflow’#258
  • website is not available#256
  • ks init fails when using $KUBECONFIG env var#251
  • Badly formatted client-go version string#250
  • Remove components#243
  • List components#242

Merged pull requests:

v0.8.0 (2017-12-20)

Full Changelog

Implemented enhancements:

  • Package list/install is awkward #195
  • Rework demos/examples in light of #169 #194

Fixed bugs:

  • param set incorrectly supporting hyphenated param names #214
  • Makefile hardcodes version #198
  • Accurately read/write non-ASCII param identifiers #219 (jessicayuen)

Closed issues:

  • Packages should be able to depend on other packages #238
  • YAML components are currently disabled; docs say they aren’t #208
  • Confusing info in ks version #199
  • Support/document using github token to increase rate limits #196
  • Issue with redis-stateless prototype #193
  • ks version missing/incorrect data #170
  • Create binary releases #131
  • Check apiVersion numbers #75
  • Add links to #20

Merged pull requests: