Skip to content

Latest commit

 

History

History
201 lines (155 loc) · 8.89 KB

sandbox.adoc

File metadata and controls

201 lines (155 loc) · 8.89 KB
Raw

Old documentation not maintained anymore

Become a Docker Machine

Turn on your machine into a Cloud Native Dev environment

Independent of the approach you choose before, you’ll be now able to configure your cluster using one of the following features and with the help of the Ansible roles we have created:

  • Create list of users/passwords and their corresponding project

  • Grant Cluster admin role to an OpenShift user

  • Set the Master-configuration of OpenShift to use htpasswd as its identity provider

  • Enable Persistence using hotPath as persistenceVolume

  • Install Nexus Repository Server

  • Install Jenkins and configure it to handle s2i builds started within an OpenShift project

  • Install Distributed Tracing - Jaeger

  • Install ServiceMesh - Istio

  • Deploy the Ansible Service Broker

  • Install and enable the Fabric8 Launcher …​

Microk8s

Vagrant

See the vagrant

Virtualbox

Why do we need a customized vm locally - see

The following section explains how you can create a customized Generic Cloud image, repackaged as a vdi file for Virtualbox.

Create vdi file from Cloud ISO

In order to customize the Linux VM for the cloud, we are using the cloud-init tool which is a set of python scripts and utilities able to perform tasks as defined hereafter :

  • Configure the Network adapters (NAT, vboxnet),

  • Add a root user and configure its password

  • Additionally add non root user

  • Import your public ssh key and authorize it,

  • Install docker, ansible, networkManager packages using yum

Note : Centos 7 ISO includes the cloud-init tool by default (version 0.7.9).

To create from the Centos ISO file a VirtualDisk that Virtualbox can use, you will have to execute the following bash script ./new-iso.sh, which will perform the following tasks :

  • Add your SSH public key within the user-data file using as input the user-data.tpl file

  • Package the files user-data and meta-data within an ISO file created using genisoimage application

  • Download the CentOS Generic Cloud image and save it under /PATH/TO/IMAGES/DIR

  • Convert the raw Centos ISO image to vdi file format

  • Save the vdi file under /PATH/TO/IMAGES/DIR

WARNING : The following tools virtualbox, mkisofs, wget are required on your machine before to execute the bash script !

Execute this bash script where you pass as parameter, the directory containing the ISO, vdi files </LOCAL/HOME/DIR> and the name of the Generic Cloud file <IMAGE_NAME> to be downloaded and next repackaged

./new-iso.sh </PATH/TO/IMAGES/DIR> <IMAGE_NAME>

Example:

./new-iso.sh /Users/dabou/images CentOS-7-x86_64-GenericCloud
#### 1. Add ssh public key and create user-data file
#### 2. http://cloud.centos.org/centos/7/images/CentOS-7-x86_64-GenericCloud.raw.tar.gz is already there
#### 3. Untar the cloud ra.tar.gz file
x CentOS-7-x86_64-GenericCloud-1802.raw
#### 4. Generating ISO file containing user-data, meta-data files and used by cloud-init at bootstrap
Total translation table size: 0
Total rockridge attributes bytes: 331
Total directory bytes: 0
Path table size(bytes): 10
Max brk space used 0
64 extents written (0 Mb)
#### 5. Converting ISO to VDI format
Converting from raw image file="/Users/dabou/images/CentOS-7-x86_64-GenericCloud-1802.raw" to file="/Users/dabou/images/centos7.vdi"...
Creating dynamic image with size 8589934592 bytes (8192MB)...
Done

The vdi file is then created on your machine under the directory passed as parameter </PATH/TO/IMAGES/DIR>

ls -la $HOME/images
-rw-r--r--    1 dabou  staff  8589934592 Mar  7 22:15 CentOS-7-x86_64-GenericCloud-1802.raw
-rw-r--r--@   1 dabou  staff   380383665 Mar  7 22:15 CentOS-7-x86_64-GenericCloud.raw.tar.gz
-rw-r--r--@   1 dabou  staff   648761897 Mar 15 18:07 CentOS-Atomic-Host-7-GenericCloud.qcow2.gz
-rw-------    1 dabou  staff   905969664 May  4 14:43 centos7.vdi
-rw-r--r--    1 dabou  staff      131072 May  4 14:43 vbox-config.iso

Create VM on VirtualBox

To automate the process to create a vm top of Virtualbox, you will then execute the following script create_vm.sh.

This script will perform the following tasks:

  • Power off the virtual machine if it is running

  • Unregister the vm $VIRTUAL_BOX_NAME and delete it

  • Rename Centos vdi to disk.vdi

  • Resize the vdi disk to 15GB

  • Create vboxnet0 network and set dhcp server IP : 192.168.99.50/24

  • Create Virtual Machine

  • Define NIC adapters; NAT accessing internet and vboxnet0 to create a private network between the host and the guest

  • Customize vm; ram, cpu, …​

  • Create IDE Controller, attach iso dvd and vdi disk

  • Start vm and configure SSH Port forward

  • Create an ansible inventory file (of type simple) that can be used to execute the project’s playbooks against the newly created vm (this is only done if Ansible is installed)

cd virtualbox
Usage : ./create-vm.sh -i /PATH/TO/IMAGE/DIR -c 4 -m 4000 -d 20000
i - /path/to/image/dir - mandatory
c - cpu option - default to 4
m - memory (ram) option - default to 4000
d - hard disk size (option) - default to 20000

Example:

./create-vm.sh -i /Users/dabou/images
######### Poweroff machine if it runs
VBoxManage: error: Machine 'CentOS-7' is not currently running
######### .............. Done
######### unregister vm CentOS-7 and delete it
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
######### Copy disk.vdi created
######### Create vboxnet0 network and set dhcp server : 192.168.99.0/24
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
Interface 'vboxnet0' was successfully created
######### Create VM
Virtual machine 'CentOS-7' is created and registered.
UUID: ac99a6b7-0415-41b3-82ff-46f1b9dc4fec
Settings file: '/Users/dabou/VirtualBox VMs/CentOS-7/CentOS-7.vbox'
######### Define NIC adapters; NAT and vboxnet0
######### Customize vm; ram, cpu, ....
######### Resize VDI disk to 15GB
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%
######### Create IDE Controller, attach vdi disk and iso dvd
######### start vm and configure SSH Port forward
Waiting for VM "CentOS-7" to power on...
VM "CentOS-7" has been successfully started.
######### Generating Ansible inventory file
 [WARNING]: Unable to parse /etc/ansible/hosts as an inventory source

 [WARNING]: No inventory was parsed, only implicit localhost is available

 [WARNING]: provided hosts list is empty, only localhost is available. Note that the implicit localhost does not match 'all'


PLAY [localhost] ********************************************************************************************************************************************************************************************************

TASK [generate_inventory : set_fact] ************************************************************************************************************************************************************************************
ok: [localhost]

TASK [generate_inventory : Create Ansible Host file] ********************************************************************************************************************************************************************
ok: [localhost]

TASK [generate_inventory : command] *************************************************************************************************************************************************************************************
changed: [localhost]

TASK [generate_inventory : Show inventory file location] ****************************************************************************************************************************************************************
ok: [localhost] => {
    "msg": "Inventory file created at : /Users/dabou/Code/snowdrop/k8s-infra/ansible/inventory/simple_host"
}

PLAY RECAP **************************************************************************************************************************************************************************************************************
localhost                  : ok=4    changed=1    unreachable=0    failed=0

Note : VirtualBox will fail to unregister and remove the vm the first time you execute the script; warning messages will be displayed!

Test if you can ssh to the newly created vm using the private address 192.168.99.50!

ssh root@192.168.99.50
The authenticity of host '192.168.99.50 (192.168.99.50)' can't be established.
ECDSA key fingerprint is SHA256:0yyu8xv/SD++5MbRFwc1QKXXgbV1AQOQnVf1YjqQkj4.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.99.50' (ECDSA) to the list of known hosts.

[root@cloud ~]#