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 yarn.
git clone https://github.com/kubev2v/forklift-console-plugin.git
cd forklift-console-plugin
yarn installWith 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:
# yarn console:stop
# Setting the console image and forklift service URLs as environment variables:
#
# Note: default values works with the local development cluster, you can create using the CI.
# set this variables if you use a different cluster.
export INVENTORY_SERVER_HOST=https://virt-konveyor-forklift.apps.<your cluster address>
export SERVICES_API_SERVER_HOST=https://virt-konveyor-forklift.apps.<your cluster address>
export CONSOLE_IMAGE=quay.io/openshift/origin-console:4.15
# Run the web console locally (uses the enviorment variables we defined above)
yarn console
# If this is the first time running, yarn build will build the required dependencies
yarn build
# Start the plugin in development mode
yarn startForklift 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.
# Setup a kind cluster with Forklift operator and an OKD web console
yarn cluster:up
# Example: setup a local KinD cluster with ovirt mock provider
# [ options: --with-all-providers --with-ovirt-provider, --with-vmware-provider, --with-openstack-provider]
#
# Note I: mock providers requires forkliftci, clone on the ci directory
# Note II: mock providers requires NFS server running, look at forkliftci documentation for more details.
# See: forkliftci/cluster/providers/utils/install_nfs.sh
git clone [email protected]:kubev2v/forkliftci.git ./ci/forkliftci
yarn cluster:up -- --with-ovirt-provider
# run cleanup to stop and delete the cluster.
yarn cluster:deleteMore 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 virtualization. |
| Forklift CI | Collection of scripts and tools used in forklift development. |
| Patternfly | Open source design system used for Openshift user interfaces development. |