Before you follow the development tutorials for creating a Zowe™ CLI plug-in, follow these steps to set up your environment.
To create your development space, you will clone and build zowe-cli-sample-plugin from source.
Before you clone the repository, create a local development folder named
zowe-tutorial. You will clone and build all projects in this folder.
There are two branches in the repository that correspond to different Zowe CLI versions. You can develop two branches of your plug-in so that users can install your plug-in into either
@lts-incremental CLI. Developing for both versions will let you take advantage of new core features quickly and expose your plug-in to a wider range of users.
lts-incremental branch of Sample Plug-in is compatible with the
@lts-incremental version of core CLI (Zowe Stable release). The
master branch of Sample Plug-in is compatible with
@latest version of core CLI (Zowe Active Development release).
For more information about the versioning scheme, see Maintaner Versioning in the Zowe CLI repository.
Clone the repository into your development folder to match the following structure:
Follow these steps:
git clone https://github.com/zowe/zowe-cli-sample-plugin
git checkout lts-incremental
npm run build
We recommend running automated tests on all code changes. Follow these steps:
- Edit the properties within
custom_properties.yamlto contain valid system information for your site.
npm run test
After you complete your setup, follow the Installing the sample plug-in tutorial to install this sample plug-in to Zowe CLI.