Skip to content

Latest commit

 

History

History
63 lines (53 loc) · 1.87 KB

README.md

File metadata and controls

63 lines (53 loc) · 1.87 KB
Raw

Disk Virt Sysprep Task

This task uses virt-sysprep to run a sysprep script on a target pvc.

Parameters

  • pvc: PersistentVolumeClaim to run the the virt-sysprep script in. PVC should be in the same namespace as taskrun/pipelinerun.
  • virtCommands: virt-sysprep commands in --commands-from-file format.
  • verbose: Enable verbose mode and tracing of libguestfs API calls.
  • additionalVirtOptions: Additional options to pass to virt-sysprep.

Usage

Task run using resolver:

apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
    generateName: disk-virt-sysprep-taskrun-
spec:
    params:
    -   name: pvc
        value: example-pvc
    -   name: sysprepCommands
        value: install make,ansible
    podTemplate:
        securityContext:
            fsGroup: 107
            runAsUser: 107
    taskRef:
        params:
        -   name: catalog
            value: kubevirt-tekton-tasks
        -   name: type
            value: artifact
        -   name: kind
            value: task
        -   name: name
            value: disk-virt-sysprep
        -   name: version
            value: v0.23.0
        resolver: hub

Common Errors

  • The input PVC disk should not be accessed by a running VM or other tools like virt-sysprep task concurrently. The task will fail with a generic ...guestfs_launch failed... message. A verbose parameter can be set to true for more information.

  • The task can end with error Permissions denied. This error means, the disk-virt-sysprep cannot access the VM image due to wrong permissions set on the file. This issue can be fixed by adding podTemplate to the spec of the TaskRun:

spec:
  podTemplate:
    securityContext:
      fsGroup: 107
      runAsUser: 107

OS support

  • Linux: full; all the sysprep commands work
  • Windows: partial; only some sysprep commands work