forklift-console-plugin is an open source project providing Openshift web console plugin for Migration Toolkit for Virtualization. The plugin adds a web based user interface for Migration Toolkit for Virtualization inside Openshift web console.
Migration Toolkit for Virtualization (Forklift) is a suite of migration tools that facilitate the import of virtualization workloads from oVirt, VMware and OpenStack to OpenShift Virtualization.
Forklift console plugin is managed by Migration Toolkit for Virtualization operator, when installing the operator on Openshift cluster, the plugin will be installed automatically, and the Migration menu item will be added to the Openshift web console.
To get started, clone the repo to your development workstation and install the required dependencies locally with NPM.
git clone --recurse-submodules https://github.com/kubev2v/forklift-console-plugin.git
cd forklift-console-plugin
npm install
With a user logged in to existing Kubernetes or Openshift environment with Forklift operator available, one can start a locally served forklift-console-plugin instance ( running on http://localhost:9000 ) with:
# Start a local Openshift console server on the background.
# - The console will be available in http://localhost:9000
# - The inventory URL can be set using an enviorment variable,
# ( default value for INVENTORY_SERVER_HOST is https://localhost:30444 )
# for example:
# export INVENTORY_SERVER_HOST=https://virt-konveyor-forklift.apps.example.com
# - To close the console server run:
# npm run console:stop
export INVENTORY_SERVER_HOST=https://virt-konveyor-forklift.apps.<your caluster address>
npm run console:background
# If this is the first time running, npm run build will build the required dependencies
npm run build
# Start the plugin in development mode
npm run start
Forklift console plugin requires the user to be logged into an openshift or kubernetes cluster, if you do not have access to one, you can setup your own using Openshift local or use the CI script to build a local KinD cluster.
# Example: setup a local KinD cluster with ovirt mock provider
# [ options: --with-all-providers --with-ovirt-provider, --with-vmware-provider, --with-openstack-provider]
#
# Note: openstack-provider requires NFS server running, look at forkliftci documentation for more details.
npm run cluster:up -- --with-ovirt-provider
# run cleanup to stop and delete the cluster.
npm run cluster:delete
More documentation is available in the docs directory.
Reference | |
---|---|
Forklift | Migration toolkit for virtualization |
Openshift web console | Openshift web console is a web based user interface for Openshift. |
OpenShift Dynamic Plugin SDK | Dynamic plugin SDK for Openshift user interfaces. |
Forklift documentation | Usage documentation for the migration toolkit for viertualization. |
Forklict CI | Collection of scripts and tools used in forklict development. |
Patternfly | Open source design system used for Openshift user interfaces development. |