Overview of the Kyndryl Cloud Uplift Vagrant Provider

Vagrant is a powerful tool for software development. With simple commands, Vagrant can quickly provision, run, and control virtual machines. With the Kyndryl Cloud Uplift provider for Vagrant, you can remove local storage and processing constraints of running VMs locally by using Vagrant commands to create, run, and control virtual machines in Kyndryl Cloud Uplift.

Watch Demo of the Kyndryl Cloud Uplift Provider for Vagrant

Process overview

The Kyndryl Cloud Uplift provider creates new virtual machines in Kyndryl Cloud Uplift based on any existing Kyndryl Cloud Uplift environment or template. It can even combine VMs from multiple Kyndryl Cloud Uplift templates into a single environment.

To use the Kyndryl Cloud Uplift provider, you:

Install Vagrant and the Vagrant provider on either your local machine or a VM within Kyndryl Cloud Uplift.
Prepare one or more Kyndryl Cloud Uplift VMs to use as “base boxes” with Vagrant; you can use any VM in your Kyndryl Cloud Uplift account. The VMs should be:
- Powered off in Kyndryl Cloud Uplift.
- In the same Kyndryl Cloud Uplift region as the other VMs you plan to include in the Vagrant-created environment.
- Configured for SSH or WinRM access. For Linux VMs: We recommend that you store the SSH credentials in the VM using VM Credentials. Use the “user name / password” format. Optionally, you can use Vagrant’s instructions to store other SSH configuration information in the Vagrantfile.
Build or download a Vagrantfile that includes URLs for the Kyndryl Cloud Uplift VMs you prepared, as well as information about how the VMs should be configured (network, file, and hardware settings).
Use vagrant up to create a new environment in Kyndryl Cloud Uplift based on the Vagrantfile. Vagrant makes a copy of each Kyndryl Cloud Uplift VM to include in the new environment.
Use other supported Vagrant commands to control the environment, sync files to it, share it, or delete it.

How it works

The Kyndryl Cloud Uplift provider securely communicates with Kyndryl Cloud Uplift; it translates native Vagrant commands into Kyndryl Cloud Uplift REST API calls.

When the Kyndryl Cloud Uplift provider is installed on your local machine, it connects to Kyndryl Cloud Uplift via a Kyndryl Cloud Uplift VPN connection.
Alternately, you can install the Kyndryl Cloud Uplift provider on a Kyndryl Cloud Uplift VM; in this case, the provider connects to VMs through secure cross-environment network connections (ICNR).

What you can do with the Kyndryl Cloud Uplift provider for Vagrant

The Kyndryl Cloud Uplift provider exposes unique Kyndryl Cloud Uplift functionality through Vagrant. The Kyndryl Cloud Uplift provider can:

Create single VMs or multiple-VM environments
Access, start, stop, and delete entire Kyndryl Cloud Uplift environments or subsets of VMs within those environments.
Customize the VM hardware settings.
SSH into VMs created with Vagrant.
Sync folders between your local machine and Kyndryl Cloud Uplift VMs using NFS mounts.
Use port forwarding to send network traffic on a local port to a Kyndryl Cloud Uplift VM.
Publish and control access to an environment with the Kyndryl Cloud Uplift web interface.

Getting started

To get started, see the articles below: