CONTRIBUTING.md

Project areas

Base OS images

openSUSE images are built and tracked in the Open Build Service:

• libvirt project

Submit Requests can be created with a free account, project maintainership is given to meritable community members.

SUSE Linux Enterprise images are built and tracked in SUSE's internal OBS instance:

• libvirt project
• AWS project

Access is limited to SUSE employees at this time.

Please note that all of the above projects have the build flag disabled unless some change is ongoing to prevent spontaneous rebuilds. Please click on Repositories -> Build Flag -> hover the gear icon in the top-left corner of the table (All, All) -> Enable until all images are rebuilt.

Non-SUSE images are built and tracked in the sumaform-images GitHub project. Pull Requests can be created with a free account, write access is given to meritable community members.

Software Packages

sumaform requires a specific Terraform version and provides several special-purpose RPM packages as well. Those are built and tracked inthe Open Build Service:

• the systemsmanagement:sumaform project builds terraform and terraform-provider-libvirt with some dependencies
• the systemsmanagement:sumaform:tools project builds other software meant to be installed in sumaformed machines

Submit Requests can be created with a free account, project maintainership is given to meritable community members.

Terraform and terraform-provider libvirt upgrade instructions

Terraform:

osc checkout systemsmanagement:sumaform
osc up systemsmanagement:sumaform
cd systemsmanagement:sumaform/terraform
vim _service # change versions
osc service disabledrun
osc build openSUSE_Leap_15.0 # check building is fine
osc add <new files>
osc rm <old files>
osc vc # describe changes
osc commit

terraform-provider-libvirt:

osc checkout systemsmanagement:sumaform
osc up systemsmanagement:sumaform
cd systemsmanagement:sumaform/terraform-provider-libvirt
vim _service # change versions
osc service disabledrun
osc build openSUSE_Leap_15.0 # check building is fine
osc add <new files>
osc rm <old files>
osc vc # describe changes
osc commit

Salt states and Terraform modules

Those are tracked in this project. Pull Requests can be created with a free account, write access is given to meritable community members.