Skip to content

Latest commit

 

History

History
131 lines (102 loc) · 4.76 KB

README.md

File metadata and controls

131 lines (102 loc) · 4.76 KB
Raw

suse-vagrant-labs

Vagrant labs for SUSE-based environments

Lab Overview

The VM names will start with the name of the directory you were in when you ran `vagrant up` followed by an underscore and the short hostname of the machine. Example if I ran `vagrant up` in the base directory of the project `./suse-vagrant-labs/`: suse-vagrant-labs_basic15sp5, suse-vagrant-labs_basic12sp5

The custom.yaml in the same directory as the Vagrantfile you are using will determine several default values including cpus, memory, primarysubnet, etc. In this case, using the default custom.yaml file we might see:

Servers OS Specs IP User Password
basic15sp5.labs.suse.com 15 SP5 1 vCPU, 2GB RAM, 42GB Disk 192.168.0.9 root vagrant
basic12sp5.labs.suse.com 12 SP5 1 vCPU, 2GB RAM, 42GB Disk 192.168.0.12 root vagrant

Minimum Hypervisor Requirements:

This has been tested most recently with no issues on OpenSUSE Leap 15.4. If you have a different hypervisor OS, make sure you test the deployment of the lab. Different labs may have different requirements.

  • Hypervisor: KVM
  • Processors: 4 (basic lab example)
  • RAM: 8GB (basic lab example)
  • Available Disk space: 60GB (basic lab example)
  • Access to SCC, download.opensuse.org, github, and the vagrant public cloud.
  • Packages installed in addition to KVM stack: vagrant, vagrant-libvirt, git
  • A vagrant network will be created using a 192.168.0.* range by default. (see custom.yaml primarysubnet value)

Lab Deployment

Pre-requisites

  1. KVM's libvirtd service is enabled and running:

    chamilton2:~ # systemctl is-enabled libvirtd
enabled
chamilton2:~ # systemctl is-active libvirtd
active

  2. git, vagrant, and vagrant-libvirt packages are installed.

    chamilton2:~ # rpm -q git vagrant vagrant-libvirt
git-2.35.3-150300.10.18.1.x86_64
vagrant-2.2.18-bp153.2.1.x86_64
vagrant-libvirt-0.5.3-bp153.2.1.x86_64

  3. run git clone https://github.com/ZeTopHat/suse-vagrant-labs.git in order to pull the project

    chamilton2:~ # git clone https://github.com/ZeTopHat/suse-vagrant-labs.git
Cloning into 'suse-vagrant-labs'...
remote: Enumerating objects: 562, done.
remote: Counting objects: 100% (87/87), done.
remote: Compressing objects: 100% (76/76), done.
remote: Total 562 (delta 17), reused 37 (delta 4), pack-reused 475
Receiving objects: 100% (562/562), 16.66 MiB | 20.48 MiB/s, done.
Resolving deltas: 100% (218/218), done.

  4. Change directories into the project and set the config/secret.yaml with your registration codes (for the basic lab only a standard registration code is needed in the sleregcode variable.)

    chamilton2:~ # cd suse-vagrant-labs
chamilton2:~/suse-vagrant-labs # cp config/secret_example.yaml config/secret.yaml
chamilton2:~/suse-vagrant-labs # vim config/secret.yaml
chamilton2:~/suse-vagrant-labs # cat config/secret.yaml
# The purpose of this file is to provide confidential variables, such as registration codes.
# Note that the GitHub project does not sync this file.
# Rename this file as secret.yaml, and configure below.

sleregcode: "REALCODE"
haregcode: "REALCODE2"
sapregcode: ""
sumaregcode: ""
sumaproxyregcode: ""
livepatchregcode: ""
sccorguser: ""
sccorgpass: ""
sccemptyuser: ""
sccemptypass: ""

  5. If you want to use a different lab, either change directories to the authentication Vagrantfile or make a new symbolic link in the primary directory:

    Option 1 (example auth lab):

    chamilton2:~/suse-vagrant-labs # cd vagrantfiles/auth/
chamilton2:~/suse-vagrant-labs/vagrantfiles/auth # ls Vagrantfile
Vagrantfile

    Option 2 (example auth lab):

    chamilton2:~/suse-vagrant-labs # unlink Vagrantfile
chamilton2:~/suse-vagrant-labs # ln -s vagrantfiles/auth/Vagrantfile Vagrantfile
chamilton2:~/suse-vagrant-labs # ls Vagrantfile
Vagrantfile

  6. Some labs may have multiple deployment options. The basic lab does not. You would change the custom.yaml file of your current working directory (established by the previous step) so that the variable (auth lab example) deployment is set to "training" instead of "fulldeploy":

    chamilton2:~/suse-vagrant-labs # vim custom.yaml
chamilton2:~/suse-vagrant-labs # cat custom.yaml
---
wheredir: "./"
deployment: "training"
extra: false
libvirt:
  cpus: 1
  memory: 2048
  machine_virtual_size: 42
network:
  bridgename: "br0"
  nameserver: "192.168.0.1"
  primarysubnet: "192.168.0"
  secondarysubnet: "192.168.1"

Inititate

Run the following command:

# vagrant up