Skip to content

slsnow/suse-vagrant-labs

 
 

Repository files navigation

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

About

Vagrant labs for SUSE-based environments

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 68.9%
  • Shell 29.6%
  • PowerShell 1.5%