build-kernel/README.md

### build-kernel
This playbook is used to automatically build a kernel with an ACS overrides patch applied as well as Valve's fsync patches.  

The ACS patch is useful to isolate PCI-e devices to their own IOMMU group for VFIO passthrough.

The fsync patches improve Proton performance.

See this page for ACS kernel configuration details: https://copr.fedorainfracloud.org/coprs/jlay/kernel-acspatch/

### Requirements
 - Inventory with one host 
   - `hosts-local` provided as a sample inventory for localhost
 - This host must be running Fedora (builds use mock)

### Usage

#### Notes
Target Fedora version is controlled by the variable `fedora_version` in [./playbook.yml](./playbook.yml)  

Patch to apply is determined by the `patch_file` variable, stored in [./payload/](./payload)

Patches for many different kernel versions provided, the highest version available should be current/working.  Patch versions only change when `diffs` change.

#### Output:
```
$ ansible-playbook -i buildserver playbook.yml -b --ask-become-pass
BECOME password: 

PLAY [buildservers] *******************************************************************************************************************************************

TASK [Gathering Facts] ****************************************************************************************************************************************
ok: [buildserver]

TASK [Ensure fedpkg is installed] *****************************************************************************************************************************
changed: [buildserver]

TASK [Find old mock chroots] **********************************************************************************************************************************
ok: [buildserver]

TASK [Clean old mock chroots] *********************************************************************************************************************************

TASK [Clean old build dir] ************************************************************************************************************************************
ok: [buildserver]

TASK [Clone f32 kernel to /tmp/f32_kernel] ********************************************************************************************************************
changed: [buildserver]

TASK [Copy patch to build dir] ********************************************************************************************************************************
changed: [buildserver]

TASK [Copy newpatch.sh on master branch, for 5.6 on f31] ******************************************************************************************************
changed: [buildserver]

TASK [Apply patch and build kernel (logs in /tmp/f32_kernel/results_kernel/*)] ********************************************************************************
changed: [buildserver] => (item=./scripts/newpatch.sh acso-5.4.6.patch)
changed: [buildserver] => (item=/usr/bin/sed -i -e 's/%define buildid .*$/%define buildid .acspatch/' kernel.spec)
changed: [buildserver] => (item=/usr/bin/make release)
changed: [buildserver] => (item=fedpkg mockbuild)

TASK [Find RPMs in /tmp/f32_kernel/results_kernel/*/*/*.rpm] **************************************************************************************************
ok: [buildserver]

TASK [Copy RPMs to /tmp/ (local)] *****************************************************************************************************************************
[...]

PLAY RECAP ****************************************************************************************************************************************************
buildserver                      : ok=10   changed=6    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0
```
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`### build-kernel`
reflect fsync changes 2020-07-03 16:51:40 +00:00			`This playbook is used to automatically build a kernel with an ACS overrides patch applied as well as Valve's fsync patches.`
initial commit 2019-02-26 03:48:16 +00:00
reflect fsync changes 2020-07-03 16:51:40 +00:00			`The ACS patch is useful to isolate PCI-e devices to their own IOMMU group for VFIO passthrough.`

			`The fsync patches improve Proton performance.`

			`See this page for ACS kernel configuration details: https://copr.fedorainfracloud.org/coprs/jlay/kernel-acspatch/`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`### Requirements`
			`- Inventory with one host`
			- `hosts-local` provided as a sample inventory for localhost
			`- This host must be running Fedora (builds use mock)`

minor wording 2020-04-16 03:56:05 +00:00			`### Usage`
add notes 2020-04-16 03:55:00 +00:00
			`#### Notes`
			Target Fedora version is controlled by the variable `fedora_version` in [./playbook.yml](./playbook.yml)

			Patch to apply is determined by the `patch_file` variable, stored in [./payload/](./payload)

clarify patches 2020-04-16 03:59:04 +00:00			Patches for many different kernel versions provided, the highest version available should be current/working. Patch versions only change when `diffs` change.

add notes 2020-04-16 03:55:00 +00:00			`#### Output:`
initial commit 2019-02-26 03:48:16 +00:00			```
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`$ ansible-playbook -i buildserver playbook.yml -b --ask-become-pass`
			`BECOME password:`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`PLAY [buildservers] *******************************************************************************************************************************************`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Gathering Facts] ****************************************************************************************************************************************`
			`ok: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Ensure fedpkg is installed] *****************************************************************************************************************************`
			`changed: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Find old mock chroots] **********************************************************************************************************************************`
			`ok: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Clean old mock chroots] *********************************************************************************************************************************`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Clean old build dir] ************************************************************************************************************************************`
			`ok: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Clone f32 kernel to /tmp/f32_kernel] ********************************************************************************************************************`
			`changed: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Copy patch to build dir] ********************************************************************************************************************************`
			`changed: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Copy newpatch.sh on master branch, for 5.6 on f31] ******************************************************************************************************`
			`changed: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Apply patch and build kernel (logs in /tmp/f32_kernel/results_kernel/)] *******************************************************************************`
			`changed: [buildserver] => (item=./scripts/newpatch.sh acso-5.4.6.patch)`
			`changed: [buildserver] => (item=/usr/bin/sed -i -e 's/%define buildid .*$/%define buildid .acspatch/' kernel.spec)`
			`changed: [buildserver] => (item=/usr/bin/make release)`
			`changed: [buildserver] => (item=fedpkg mockbuild)`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Find RPMs in /tmp/f32_kernel/results_kernel///.rpm] *************************************************************************************************`
			`ok: [buildserver]`
initial commit 2019-02-26 03:48:16 +00:00
Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`TASK [Copy RPMs to /tmp/ (local)] *****************************************************************************************************************************`
initial commit 2019-02-26 03:48:16 +00:00			`[...]`

Update example/add reqs, support for f32 and kernel 5.6+ 2020-04-16 03:46:14 +00:00			`PLAY RECAP ****************************************************************************************************************************************************`
			`buildserver : ok=10 changed=6 unreachable=0 failed=0 skipped=1 rescued=0 ignored=0`
initial commit 2019-02-26 03:48:16 +00:00			```