Skip to content

migtools/mta-kantra

 
 

Repository files navigation

Test

Kantra

Kantra is a CLI for Konveyor analysis and transformation.


Prerequisites

Analysis Containerless mode — prerequisites and layout are documented in docs/containerless.md

Analysis Hybrid mode (external language providers run in containers; the analyzer runs on the host.) and Transform

  • Podman 4+ or Docker (Engine 24+ / Desktop 4+). Kantra defaults to podman; override with export CONTAINER_TOOL=/path/to/docker.

Install

  1. Releases: GitHub releases — unzip and add kantra to your PATH.

Quick start: analyze

Containerless (default) — Java + builtin on the host:

kantra analyze --input=/path/to/app --output=/path/to/out --overwrite --target cloud-readiness

Hybrid — language providers in containers, engine on the host (needed for Go, Python, Node.js, C#, or Java in a container):

kantra analyze --input=/path/to/app --output=/path/to/out --run-local=false --overwrite
  • --modefull (default, source + deps where supported) or source-only.
  • Filtering--target, --source, --label-selector; list labels with --list-targets / --list-sources.

Deeper detail: docs/containerless.md, docs/hybrid.md.

Quick start: transform

Run OpenRewrite recipes on Java source (runs in a container; requires Podman/Docker):

kantra transform openrewrite --list-targets
kantra transform openrewrite --input=/path/to/app --target=<recipe-name>

Other commands

Command Purpose
kantra config Login / sync / list Konveyor Hub profiles (kantra config --help)
kantra test Run YAML rule tests
kantra discover / kantra generate Asset-generation workflows; see docs/examples.md

Use kantra <command> --help for flags.


Documentation

Topic Doc
Examples docs/examples.md
Hybrid / containerless analysis docs/hybrid.md, docs/containerless.md
Rule YAML tests docs/testrunner.md
Writing rules docs/rules-quickstart.md
Provider options docs/usage.md
Hack scripts / asset generation hack/README.md

Code of conduct

Konveyor community Code of Conduct.

About

A CLI that unifies analysis and transformation capabilities of Konveyor

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Go 94.6%
  • Dockerfile 1.9%
  • Java 1.6%
  • Shell 1.5%
  • Makefile 0.2%
  • TypeScript 0.1%
  • Python 0.1%