Running Kai consists of:
- Installing the Kai VSCode extension
- Configuring Kai for your desired use case
- Running analysis and accepting/rejecting generated code fixes
See the installation guide for details on installing the IDE extension.
Once the VSCode extension is installed, you are presented with the "Set up Konveyor" page. This page is where you as a user can configure Kai to suit your needs. This page can also be accessed by clicking "Help"->"Welcome" and finding "Set up Konveyor" in the "Walkthroughs" section.
All of the following settings can be configured via the setup page or via
modifying settings.json. For more details; see configuration for a full list of
available settings.
Override Analyzer Binary This allows you as a user to configure custom analyzer and Kai binaries as opposed to the default packaged ones. This shouldn't be necessary for most users.
Configure Custom Rules This allows you as a user to configure custom rules for the Konveyor analyzer to use when running static code analysis. This can be done by selecting a directory where these rules exist.
Configure Analysis Arguments This allows you as a user to define the sources and targets for static code analysis. Additionally, you as a user can define a specific label selector to use when querying the rulesets.
Configure Get Solution Parameters This allows you as a user to configure the codeplan solution parameters. These are advanced options and should only be set by an experienced user. For more information about what these values do; see here
Click "Start Analyzer" to launch the RPC server. You can then click "Mark Done" to close the setup page.
Now that Kai is installed and started, using the extension consists of running static code analysis and generating code fixes. Once analysis is performed, you are presented with a list of violations and their associated incidents. Kai currently allows the user to generate code fixes based on incidents.
To start, the analysis view allows you to run a full analysis of the codebase based on the prior configured analysis arguments. After analysis completes, you will see violations and incidents generated as a result. On the left side of the extension, you will see a tree view of these incidents and the files where those incidents are present.
Now that you have violations from analysis, you will want to begin generating code fixes based on these incidents. This is done in the main analysis view by expanding the incident you want to fix and clicking the lightbulb icon. This will begin the process of asking Kai to generate a code fix for the given incident.
Once the fix is generated, you will be presented with a list of files that would be changed, and you are given the option to view, accept, or reject those changes. You can view this from an in-view diff editor via the analysis view, or from the Konveyor Resolutions pane on the left side of the extension. When these changes are accepted, the changes will be reflected in the source code directly. Anytime a change is accepted, Kai will automatically rerun a partial analysis of the codebase that has changed to update whether an incident was resolved. Whenever you want to evaluate the current state of the migration, it is best to rerun a full analysis.
Now that you understand how to get started with Kai, we suggest running through a guided scenario to get a better idea of how Kai can assist with the migration of an application.