September 3, 2019 By Chris Rosen
John Starich
3 min read

Big changes are coming to the IBM Cloud Kubernetes Service CLI plugin to change your experience for the better.

Today, we’re announcing big enhancements in the user experience with the CLI plugin for IBM Cloud Kubernetes Service. Changes to the kubernetes-service will be rolled out in two phases—a backward-compatible release (0.4) today and an upcoming major release (1.0). Version 1.0 will be released on March 16th, 2020.

Version 1.0 contains breaking changes from previous releases, so we’ve included extra tools in 0.4 to make the transition smoother.

These new releases are the result of a backend overhaul and months of user testing to bring our UX up to speed. For more on the engineering challenges and our user experience journey, see this blog post.

New features and compatibility

These releases of the Kubernetes Service plugin enable you to more easily do the following:

  • Discover new commands
  • Integrate with community tools
  • Intuitively understand commands, flags, and arguments based on names and usage text

User testing has shown that this release is a significant step forward for our user experience, and we’d love to share it with you. In fact, we’re so excited to deliver a better experience that we’re releasing most of these UX improvements today as a backward-compatible release (0.4).

The 1.0 release will contain breaking changes from previous releases:

  • Replaces flat commands with structured commands, from ibmcloud ks cluster-get to ibmcloud ks cluster get
  • Drops support for positional arguments in favor of using flags, from ibmcloud ks cluster get mycluster to ibmcloud ks cluster get --cluster mycluster
  • Switches from --camelCase flags to --dash-name flags
  • Drops support for comma-delimited values in favor of repeated flags that have shorthand aliases, from ibmcloud ks logging config create --app-containers cont1,cont2,cont3 to create -c cont1 -c cont2 -c cont3
  • The ibmcloud ks cluster config command now appends the kubeconfig file to your existing kubeconfig in ~/.kube/config (or the first file in the KUBECONFIG environment variable). After running the command, you can interact with your cluster immediately.
    • Run kubectl config use-context CTX_NAME to switch between clusters
    • If you installed kubectl with auto-completion, then you can tab-complete the context names too

For a full list of changes, see the CLI changelog.

Upgrade the IBM Cloud Kubernetes Service plugin

To get started, all you need to do is upgrade the Kubernetes Service plugin to the latest version with this command: ibmcloud plugin update kubernetes-service

If you update to 0.4, you’ll still get lots of awesome improvements without breaking backward compatibility. If you want to try out 1.0 or need to test your scripts with the new CLI behavior, you can opt-in to 1.0 in its full glory. Just set the IKS_BETA_VERSION environment variable to 1. In bash, this looks like export IKS_BETA_VERSION=1.

Structured commands

The biggest change is the new command structure and help output. Instead of a long list of all possible commands, only a small subset is shown. As soon as you decide on a command, you can drill one step further into the subcommands.

For example, I want to update a worker but I don’t know which command that is. I’ll start by getting help output for the plugin: ibmcloud ks

➜ ~ ibmcloud ks
        ibmcloud ks - Manage IBM Cloud Kubernetes Service clusters.
        ibmcloud ks command [arguments...] [command options]


Cluster Management Commands:
    cluster       View and modify cluster and cluster service settings.
    worker        View and modify worker nodes for a cluster.
    worker-pool   View and modify worker pools for a cluster.
    zone          View and modify the zones attached to a worker pool.


The new structured help output breaks down the commands into categories and only one layer at a time, so my next step is to run ibmcloud ks worker followed by ibmcloud ks worker update. At each step, run an additional subcommand to narrow down the choices to the intended command.

Since more commands are uncovered with each step, you can intuit the desired command without being completely overwhelmed with choices.

Upgrade tools

We’ve included some additional tools to help ease the transition to 1.0.

The first thing you may notice is warnings are printed when you run deprecated commands:

➜ ~ ibmcloud ks cluster-config
WARNING: This legacy command is deprecated and will soon be unsupported. Use the 'ibmcloud ks cluster config' command instead.

We also created a special command to help upgrade your automated scripts that use our CLI.

Run ibmcloud ks script update ./ ./ to show a diff of which things should change in the given script files. If you agree with the changes, run it again with the --in-place flag to save those changes.

We recommend you set IKS_BETA_VERSION=1 and run your scripts to verify they work as expected.

Wait, I’m not ready! How do I go back?

If you need time to update your automated scripts that use the Kubernetes Service plugin and the ibmcloud ks script update command is insufficient for your needs, you can always install an older version of the plugin: ibmcloud plugin install kubernetes-service -v 0.4.

Note: New features will not be back-ported to old releases of the CLI. You will need to update automation scripts as soon as possible to gain access to new feature releases.

More details

For more information, including a list of changes between each version of the CLI plug-in, see the IBM Cloud Kubernetes Service documentation.

Contact us

If you have questions, engage our team via Slack by registering here and join the discussion in the #general channel on our public IBM Cloud Kubernetes Service Slack.

More from Announcements

IBM named a Leader in Gartner Magic Quadrant for SIEM, for the 14th consecutive time

3 min read - Security operations is getting more complex and inefficient with too many tools, too much data and simply too much to do. According to a study done by IBM, SOC team members are only able to handle half of the alerts that they should be reviewing in a typical workday. This potentially leads to missing the important alerts that are critical to an organization's security. Thus, choosing the right SIEM solution can be transformative for security teams, helping them manage alerts…

IBM and MuleSoft expand global relationship to accelerate modernization on IBM Power 

2 min read - As companies undergo digital transformation, they rely on APIs as the backbone for providing new services and customer experiences. While APIs can simplify application development and deliver integrated solutions, IT shops must have a robust solution to effectively manage and govern them to ensure that response times and costs are kept low for all applications. Many customers use Salesforce’s MuleSoft, named a leader by Gartner® in full lifecycle API management for seven consecutive times, to manage and secure APIs across…

IBM Consulting augments expertise with AWS Competencies: A win-win for clients 

3 min read - In today's dynamic economic landscape, businesses demand continuous innovation and speed of execution. At IBM Consulting®, our unwavering focus on partnerships and shared commitment to delivering enterprise-level solutions to mutual clients have been core to our success.   We are thrilled to announce that IBM® has recently gained five competencies from Amazon Web Services (AWS) in vital domains including Cloud Operations, Internet of Things (IoT), Life Sciences, Mainframe Modernization, and Telecommunications. With these credentials, IBM further establishes its position as a…

IBM Newsletters

Get our newsletters and topic updates that deliver the latest thought leadership and insights on emerging trends.
Subscribe now More newsletters