This document describes how to install ADB and required dependencies.
Two virtualization providers have been tested with ADB; VirtualBox and Libvirt.
The following virtualization providers are suggested for the respective operating systems:
The suggested virtualization provider for Microsoft Windows and Mac OS X is VirtualBox. Installation instructions are available online. While the latest stable shipping release should work, the majority of testing has been done with version 5.0.0 on Mac OS X and 5.0.8 on Microsoft Windows.
Two different virtualization providers are supported on Linux; VirtualBox and libvirt. The choice as to which to use should be driven by your preferences and environmental concerns and is outside of the scope of this document. Both will work equally well in their default configuration. You may wish to read the section on file synchronization in the Using ADB documentation when making this decision.
-
VirtualBox installation instructions are available online at the VirtualBox website. Testing has been done with versions 4.3.34 and 5.0.0.
A summary of the installation is listed below:
$ sudo dnf -y install dkms $ curl -O http://download.virtualbox.org/virtualbox/rpm/fedora/virtualbox.repo $ sudo mv virtualbox.repo /etc/yum.repos.d/ $ sudo dnf -y install VirtualBox-4.3 $ sudo /etc/init.d/vboxdrv setup
While the latest stable release should work, the majority of testing has been done with version 4.3.30.
-
Installing libvirt dependencies can be skipped as they are automatically installed together with the
vagrant-libvirtpackage. Testing has been done with libvirt version 1.2.18 and vagrant-libvirt version 0.0.32.
Two different virtualization providers are supported on Linux; VirtualBox and libvirt. The choice as to which to use should be driven by your preferences and environmental concerns and is outside of the scope of this document. Both will work equally well in their default configuration. You may wish to read the section onfile synchronization in the Using ADB documentation when making this decision.
-
VirtualBox installation instructions are available online at the VirtualBox website. CentOS specific instructions are also available.
While the latest stable release should work, the majority of testing has been done with version 4.3.30.
A summary of the installation is listed below:
$ sudo yum -y install epel-release $ sudo yum -y install dkms $ curl -O http://download.virtualbox.org/virtualbox/rpm/rhel/virtualbox.repo $ sudo mv virtualbox.repo /etc/yum.repos.d/ $ sudo yum -y install VirtualBox-4.3 $ sudo /etc/init.d/vboxdrv setup
-
Installing libvirt dependencies can be skipped as they are automatically installed together with the CentOS software collections build.
This section includes installation instructions according to your operating system.
-
Follow the directions at vagrantup.com. Testing has been done with version 1.7.4.
-
Install an
sshclient. Two good options are:
|
Note
|
Putty is not recommended as it doesn’t currently interface with Vagrant. |
Follow the directions at vagrantup.com. Testing has been done with version 1.7.4.
Testing has been done with version 1.7.2.
-
To install Vagrant with VirtualBox in Fedora 23/24:
$ sudo dnf install -y vagrant
-
To install Vagrant with libvirt in Fedora 23/24:
$ sudo dnf -y install vagrant-libvirt # Start libvirtd $ sudo systemctl start libvirtd # Set libvirtd to start automatically on system boot $ sudo systemctl enable libvirtd
This would install both Vagrant and Libvirt.
Vagrant packages are not available directly in CentOS core. However, they are available through official CentOS Software Collections builds.
Run the following commands to get Vagrant in CentOS:
$ sudo yum -y install centos-release-scl $ sudo yum -y install sclo-vagrant1 $ sudo scl enable sclo-vagrant1 bash
To add libvirt support, also run the following commands:
# Start libvirtd $ sudo systemctl start libvirtd # Set libvirtd to start automatically on system boot $ sudo systemctl enable libvirtd
Run the following commands to install the vagrant-service-manager, vagrant-sshfs, and landrush plugins:
$ vagrant plugin install vagrant-service-manager $ vagrant plugin install vagrant-sshfs $ vagrant plugin install landrush
There are two ways to download ADB.
The ADB project provides customized Vagrantfiles, which will download ADB and automatically set up provider-specific container development environments. They are listed below and more details are available in their respective Readmes.
To download ADB and set up a provider-specific container development environment:
-
Create a directory for the Vagrant box
$ mkdir directory && cd directory -
Download any of the following vagrantfiles, to configure the development environment you need.
-
To configure a Docker specific container development environment use:
$ curl -sL https://raw.githubusercontent.com/projectatomic/adb-atomic-developer-bundle/master/components/centos/centos-docker-base-setup/Vagrantfile > Vagrantfile
Refer: README
-
To configure a Kubernetes specific container development environment use:
$ curl -sL https://raw.githubusercontent.com/projectatomic/adb-atomic-developer-bundle/master/components/centos/centos-k8s-singlenode-setup/Vagrantfile > Vagrantfile
Refer: README
-
To configure an OpenShift Origin specific container development environment use:
$ curl -sL https://raw.githubusercontent.com/projectatomic/adb-atomic-developer-bundle/master/components/centos/centos-openshift-setup/Vagrantfile > Vagrantfile
Refer: README
-
To configure an Apache Mesos Marathon specific container development environment use:
$ curl -sL https://raw.githubusercontent.com/projectatomic/adb-atomic-developer-bundle/master/components/centos/centos-mesos-marathon-singlenode-setup/Vagrantfile > Vagrantfile
Refer: README
-
Alternatively, you can manually download the vagrant box from cloud.centos.org using your web browser or curl. For example:
# To get the libvirt box $ wget http://cloud.centos.org/centos/7/atomic/images/AtomicDeveloperBundle-<version>-CentOS7-LibVirt.box # To get the virtualbox box $ wget http://cloud.centos.org/centos/7/atomic/images/AtomicDeveloperBundle-<version>-CentOS7-VirtualBox.box
After you download the box, you can add it to vagrant with following command:
$ vagrant box add projectatomic/adb <local path to the downloaded box>
|
Note
|
If you want to use a customized name for the box, you need to:
$ vagrant box add <box-name> <local path to the downloaded box>
export BOX=<box-name> |
ADB can be set up behind a proxy server. Set the following proxy parameters in the Vagrantfile you chose in the previous step:
config.servicemanager.proxy = <Proxy URL> config.servicemanager.proxy_user = <Proxy user name> config.servicemanager.proxy_password = <Proxy user password>
Once these settings are applied, they are passed through to the Docker and
OpenShift services to enable them to function correctly.
In an unauthenticated proxy environment, the proxy_user and proxy_password
configurations can be omitted.
Start ADB by running the vagrant up command.
$ vagrant up
This will start ADB and set it up to work with the provider of
choice, for use with host-based tools or via vagrant ssh.
|
Note
|
On Fedora and CentOS you may need to specify the virtualization provider to use. For example, to use VirtualBox, the command would be: $ vagrant up --provider virtualbox |
At this point your Atomic Developer Bundle installation is complete. You can find ADB usage information in the documentation directory.