Kyma 1.4 Kyoto

Malgorzata Swieca, Technical Writer @Kyma on August 8, 2019

Straight from Indonesian Jakarta, we sail to Japan. Let's stop in one of its beautiful temples and ponder over what the 1.4 Kyoto Release has to offer. Being hard-working as the Japanese, Kyma busy bees introduced many improvements in their components, including the Application Connector, Console, Kiali, and Headless CMS. Read on to find out what has changed in Kyma since 1.3.

The highlights of Kyma 1.4 Kyoto include:

See the overview of all changes in this release:

  • Backup - Simplified Valero installation, a new implementation of the backup and restore functionalities, backup available on Azure, and backup tests fixed
  • Core and Supporting - Relative links disabled in Markdown specs
  • JSON schema - Guidelines for creating JSON schemas for Kyma components
  • Knative - Knative Eventing and Serving update
  • Kyma CLI - Kyma CLI enriched with the test command and inline documentation
  • Service Management - New GCP Service Broker addon and Helm Broker support for addons exposed by Git

Read about known issues for Valero.

CAUTION: Before you upgrade to Kyma 1.4, read the Migration Guide which describes necessary manual actions required by the Google Cloud Platform (GCP) Service Broker addon.

Making friends in the open-source world is natural. Collaboration with our friend, ORY, in the 1.4 release bore fruit, and Kyma got its very own OAuth2 server. Our new component consists of three elements from ORY: Hydra OAuth2 server, Oathkeeper proxy, and Oathkeeper Maester controller. By default, the solution is now installed with every Kyma deployment. We worked closely with ORY developers to make their solution Kubernetes-native. We achieved that by creating the Maester controller and contributing it to the ORY stack. This controller allows for convenient management of Access Rules through custom resources. Check out and test the Kyma-ORY integration and follow its development closely as we're still in the development phase. Read this blog post to see where we're heading. Also, read the Security documentation to get more details on the current state of the integration.

As you already know, the Application Connector uses Istio to ensure a high level of security. From now on, the Application Registry benefits from features introduced in Istio 1.2 to control access to the Application Gateway.

The backup component, Velero, is now upgraded to its latest stable version 1.0.0.

We improved and simplified the installation and setup process for Velero. Read the documentation and see how easy it is now to set up Valero either before or after installing Kyma.

We implemented the backup functionality from scratch to guarantee that all resources in a cluster are properly backed-up. The documentation was updated to reflect the changes we made.

Also, we have a brand-new restore functionality. It guarantees that a backed-up cluster can be fully recovered. The documentation was updated to reflect the changes we made.

All backup and restore integration tests are fixed and pass.

The backup functionality was successfully introduced on Azure (AKS). Follow the steps from the installation guide to set up Valero on Azure.

We deleted all Velero plugins as they are not needed anymore.

Valero returns an error during restoring CRDs. The temporary workaround is to divide the restore process into 2 steps:

  1. Restore only CRDs.
  2. Restore the remaining part of the cluster.

It may also happen that the restore process fails to complete. It is caused by a bug in Velero. In such a case, retry to restore your cluster.

So far, once you entered a Kubernetes cluster you could probably see quite a bunch of Namespaces. These were both built-in Namespaces and those that came with modules you installed. They were not the ones a Kyma user wanted to work with. To have a better user experience, system Namespaces are now hidden by default. As a result, you can easily find the Namespaces that you work with. To see the system Namespaces, go to the General Settings view and toggle the Show System Namespaces option under Namespace settings.

Namespace settings

The Kyma project puts a lot of effort into documentation and processes around it, not only with respect to kyma-project.io. As you know, you can also access Kyma documentation from the Console UI. In Kyma, we offer features that you can use to document your own services - that does not only relate to static docs provided with Markdown specs but also other formats, such as OpenAPI, AsyncAPI, and OData.

It basically means that at the moment we have 4 different views that render documentation, and you can expect more of them to come in the future releases. We decided that it was about time to consolidate our experience in this area into one component.

  • Documentation component project

As mentioned in the previous release notes, we have one single project in which we maintain the Documentation component and just reuse it in different applications. We already introduced it in the Console UI Documentation view in the last release. In the 1.4 release, it was integrated into the Console UI Catalog and Instances views. In a few days, you will see this component being used on kyma-project.io.

  • Improved look and feel

While working on the Documentation component, we took a closer look at the styling of different specs and decided to improve and unify them. The style is now unified in Markdown, OpenAPI, and OData. In the next release, we would like to do the same with AsyncAPI.

This is the new Fiori 3-like design for the OpenAPI spec:

OpenAPI spec

This is the new Fiori 3-like design for the Markdown spec with the new and much better approach to navigation with the right-hand side navigation:

Markdown spec

This is the new Fiori 3-like design for the OData spec:

OData spec

Ever since we introduced Kyma and its Application Connector component, we have been getting reports that you could easily register an application with the AsyncAPI spec but the spec did not render successfully in the UI. The reason was each and every time the same: the spec was not valid. It wasn't rendered because the validation only worked in the UI.

We decided to finally solve the problem and introduce a service that validates the AsyncAPI spec before it is accepted by the Headless CMS. Because integrating the service with Kyma will take some time, we decided to introduce the validation already for the latest version of the AsyncAPI specification. As a result, the service we introduced not only handles validation of the spec but also automatically converts the spec into the latest AsyncAPI version. For example, if you register the spec in version 1.0, 1.1, or 1.2, the service converts it to version 2.0.0-rc1.

This functionality is disabled by default, and the service is not provisioned or configured because we do not have the UI support for AsyncAPI 2.0 yet. To enable the validation service and play with it, override the following value:

Click to copy
apiVersion: v1
kind: ConfigMap
metadata:
name: cms-asyncapi-overrides
namespace: kyma-installer
labels:
installer: overrides
component: cms
kyma-project.io/installation: ""
data:
global.cmsAsyncAPIService.enabled: "true"

After you override the value, you can create a DocsTopic resource using this example. The example contains a reference to the official Slack AsyncAPI spec provided in version 1.2. After you go through the steps for the happy path, create a new DocsTopic using an invalid spec. You can use the invalid AsyncAPI spec we used for testing.

In the previous release, we introduced a new field in the DocsTopic CR that allows you to provide custom parameters that can modify the rendering options when supported by the presentation layer. After getting your feedback, we renamed the field from metadata to parameters and enabled its support in the Console UI.

From now on, once you provide the spec.sources.parameters.disableRelativeLinks parameter for a Markdown source, the UI disables relative links and informs about it in a tooltip. This applies to a use case in which you render Markdown documentation that you do not own and that has some broken relative links. This is the only use case we support so far, but if you see other applications, please let us know. You can contact us on Slack or submit a GitHub issue.

We encourage you to read brand-new documentation defining standards for creating JSON schemas for Kyma components.

We also added a governance CI Job that checks if all components have a JSON schema file with the mandatory properties.

By default, Kiali is now enabled together with monitoring.

Kiali was upgraded to version 1.1.0.

From now on, you can access Kiali from the Kyma Console. If you click the Service Mesh section on the left navigation menu, the link redirects you to the Kiali page.

Kiali in the Console UI

We added an integrated authentication strategy to the Kiali dashboard to enable Single-Sign-On based on the Dex configuration.

Kiali is now documented in the Kyma Docs.

Knative Eventing chart, which is the foundational layer for Kyma Event Bus, was updated to version 0.6. Read more about the update here.

Knative Serving chart, which by default is installed with Kyma, was also updated but to version 0.6.1. Learn more about the update details here.

From this release, the Octopus test suites can be managed fully using the Kyma CLI. You can easily run, list, check, delete, and watch both test suites and test definitions on your cluster.

We improved the documentation output of the Kyma CLI. The usage, help and flag documentation, and error messages are more user-friendly now.

Starting from the 1.4 release, all bundles are renamed to addons to better reflect the functionality they provide. This applies to all occurrences, including the names of repositories. See this issue for more information.

As the Google Cloud Platform (GCP) Service Broker is being deprecated by Google, we have removed this addon from our offering. Instead, we added the preview mode of a new GCP Service Broker which you can already integrate with Kyma. See this issue for more information. To learn how to switch to the new addon when upgrading Kyma, read the migration guide.

Starting from this release, you can expose your addons not only through HTTPS serves but also using Git. To do so, simply place your addons directly in a Git directory and follow the necessary addon repository structure. Read this document to learn more.

With great power comes great... resource consumption? Not anymore! Starting with this release the components of the Service Mesh and Security areas, including the API Controller, the API Server Proxy, Dex, the IAM Kubeconfig Service, Istio sidecars, and Istio Management Plane deployments consume significantly fewer resources, helping you to stay within the limits of your license's resource quotas. See this issue for more details.

  • Tags:
  • #release-notes