Unzip the ZIP file you downloaded in a directory of your choice. The following commands assume you have unpacked it in your home directory, %USERPROFILE%\cdk (C:\Users\<username>\cdk).

At this point, review the included README files to familiarize yourself with Red Hat Container Tools.

Install additional Vagrant plugins for using the Container Development Kit Vagrant boxes.

All of the remaining steps can be performed using the Windows command-line shell, cmd.exe, PowerShell, or other command-line shell.

To install additional Vagrant plugins to support several features, use the vagrant plugin install command. The plugins in the form of .gem files are included in the ZIP file.

The installation of the first plugin may take several minutes, and Vagrant may install some additional gem files as needed.

C:> cd %USERPROFILE%\cdk\plugins
C:> dir *.gem
C:> vagrant plugin install vagrant-registration-*.gem
C:> vagrant plugin install vagrant-service-manager-*.gem
C:> vagrant plugin install vagrant-sshfs-*.gem

Verify the plugins are installed by running the following command:

C:> vagrant plugin list

Add the Container Development Environment box to Vagrant. For example:

C:> cd %USERPROFILE%\Downloads\
C:> vagrant box add --name cdkv2 rhel-cdk-kubernetes-7.3-*.x86_64.vagrant-virtualbox.box

Verify that the box is installed:

C:> vagrant box list

The box image files will be stored in your home directory under %USERPROFILE%\.vagrant.d. You will need adequate space there, approximately 2 GB.

Initialize the Container Development Kit Vagrant box:

Enter the username and password you use with the Red Hat Customer Portal to register the Red Hat Enterprise Linux system running in the Vagrant box:

==> default: Registering box with vagrant-registration…
    default: Would you like to register the system now (default: yes)? [y|n] y
    default: Subscriber username: <username>
    default: Subscriber password:

Check whether your Vagrant box is running using the vagrant status command. Note that you must be in the same directory where your Vagrantfile is located. For example:

$ cd %USERPROFILE%\cdk\components\rhel\rhel-ose\
$ vagrant status

Download the Container Development Kit software components from the Red Hat Product Downloads web site. You must log in to get access to this page. If you are on the right page, you should see "Product Variant: Red Hat Container Development Kit". You need to download the following items:

Unzip the ZIP file you downloaded. This should create the ~/cdk subdirectory:

$ cd
$ unzip ~/Downloads/cdk-2.4.0.zip

Install the vagrant-registration, vagrant-service-manager, and vagrant-sshfs plugins (the plugins in the form of .gem files are included in the ZIP file).

The installation of the first plugin may take several minutes, and Vagrant may install some additional gem files as needed.

$ cd ~/cdk/plugins
$ ls -1 *.gem
$ vagrant plugin install \
  ./vagrant-registration-*.gem \
  ./vagrant-service-manager-*.gem \
  ./vagrant-sshfs-*.gem

Verify the plugins are installed by running the following command:

$ vagrant plugin list

Add the Container Development Kit box to Vagrant. This is the configured virtual machine image that you downloaded in one of the previous steps.

$ vagrant box add --name cdkv2 ~/Downloads/rhel-cdk-kubernetes-7.2*.x86_64.vagrant-virtualbox.box

Verify that the box is installed:

$ vagrant box list
cdkv2 (virtualbox, 0)

The box image file will be stored in your home directory under ~/.vagrant.d. You need adequate space there, approximately 2 GB.

Initialize the Container Development Kit Vagrant box:

Enter the username and password you use with the Red Hat Customer Portal to register the Red Hat Enterprise Linux system running in the Vagrant box:

==> default: Registering box with vagrant-registration…
    default: Would you like to register the system now (default: yes)? [y|n] y
    default: Subscriber username: <username>
    default: Subscriber password:

Check whether your Vagrant box is running using the vagrant status command. Note that you must be in the same directory where your Vagrantfile is located. For example:

$ cd ~/cdk/components/rhel/rhel-ose/
$ vagrant status

Verify you are a member of the vagrant group (you may need to log in again to have the new group appear).

$ grep vagrant /etc/group
vagrant:x:978:joe
$ id
uid=1001(joe) gid=1001(joe) groups=1001(joe),978(vagrant)
context=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023

Enable the Vagrant Software Collection:

$ scl enable sclo-vagrant1 bash

Verify that the system is set up to run Vagrant as a regular, non-root user:

$ vagrant global-status
id       name   provider state  directory
--------------------------------------------------------------------
There are no active Vagrant environments on this computer! Or,
you haven't destroyed and recreated Vagrant environments that were
started with an older version of Vagrant.

Download the Container Development Kit software components from the Red Hat Product Downloads web site. You must log in to get access to this page. If you are on the right page, you should see Product Variant: Red Hat Container Development Kit. You need to download the following items:

Unzip the downloaded ZIP file:

~/Downloads]$ unzip ~/Downloads/cdk-2.4.0.zip

At this point, review the included README files to familiarize yourself with Red Hat Container Tools.

Install the plugins contained in the unpacked cdk/plugins/ directory. Each plugin is in the form of a .gem file:

~/Downloads]$ cd ~/cdk/plugins/
~/cdk/plugins]$ ls -1 *.gem
~/cdk/plugins]$ vagrant plugin install \
  ./vagrant-registration-*.gem \
  ./vagrant-service-manager-*.gem \
  ./vagrant-sshfs-*.gem

Verify that the vagrant-libvirt, vagrant-registration, vagrant-service-manager, and vagrant-sshfs plugins are properly installed by running the following command:

$ vagrant plugin list

Add the Container Development Kit Vagrant box to Vagrant:

$ vagrant box add --name cdkv2 \
  ~/Downloads/rhel-cdk-kubernetes-7.*.x86_64.vagrant-libvirt.box

Verify that the box is installed:

$ vagrant box list
cdkv2 (libvirt, 0)

The box image file will be stored in your home directory under ~/.vagrant.d. You need adequate space there, approximately 3 GB.

Initialize the Container Development Kit Vagrant box:

Enter the username and password you use with the Red Hat Customer Portal to register the Red Hat Enterprise Linux system running in the Vagrant box:

==> default: Registering box with vagrant-registration…
    default: Would you like to register the system now (default: yes)? [y|n] y
    default: Subscriber username: <username>
    default: Subscriber password:

Check whether your Vagrant box is running using the vagrant status command. Note that you must be in the same directory where your Vagrantfile is located. For example:

$ cd ~/cdk/components/rhel/rhel-ose/
$ vagrant status

Check for existing Vagrant virtual machines.

Use the global-status command to display all virtual machines administered by Vagrant for your account:

$ vagrant global-status
id       name    provider state   directory
-----------------------------------------------------------------------
e781364  default libvirt running /home/test/cdk/components/rhel/rhel-ose

The above shows information about all known Vagrant environments
on this machine. This data is cached and may not be completely
up-to-date. To interact with any of the machines, you can go to
that directory and run Vagrant, or you can use the ID directly
with Vagrant commands from any directory. For example:
"vagrant destroy 1a2b3c4d"

Destroy existing Container Development Environment virtual machines.

Destroy the virtual machine identified in the previous step. Specify the -f or --force option to destroy the machine without an interactive confirmation:

$ vagrant destroy -f e781364

List installed Vagrant boxes:

$ vagrant box list
cdkv2 (virtualbox, 0)

Remove the Container Development Environment Vagrant box.

Remove the Container Development Environment Vagrant box (named cdkv2 by default):

$ vagrant box remove cdkv2
Removing box 'cdkv2' (v0) with provider 'libvirt'...
Vagrant-libvirt plugin removed box only from you LOCAL ~/.vagrant/boxes directory
From libvirt storage pool you have to delete image manually (virsh, virt-manager or by any other tool)

Remove the Red Hat Container Tools ZIP file (cdk-2.4.0.zip) and the cdk/ directory. This example assumes that the Red Hat Container Tools ZIP file was downloaded to the Downloads/ directory and unpacked directly to the home directory:

Uninstall the Vagrant plugins supplied with Container Development Kit:

$ vagrant plugin uninstall vagrant-registration vagrant-service-manager vagrant-sshfs
Uninstalling the 'vagrant-registration' plugin...
Uninstalling the 'vagrant-service-manager' plugin...
Uninstalling the 'vagrant-sshfs' plugin...

List all storage images to identify the one you need to delete:

# virsh vol-list default
 Name                 Path
----------------------------------------------------------------------
 rhel-ose_default.img /var/lib/libvirt/images/rhel-ose_default.img

Change the ownership of the image file:

# chown root:root /var/lib/libvirt/images/rhel-ose_default.img

Output volume information:

# virsh vol-dumpxml rhel-ose_default.img --pool default

Delete the image:

This can be done in two alternative ways. Use the second one if the first one does not work.

Restart the libvirtd daemon:

# systemctl restart libvirtd