Bug 1875725

Summary:	document how to build a container disk and when it should be used
Product:	Container Native Virtualization (CNV)	Reporter:	Tomas Jelinek <tjelinek>
Component:	Documentation	Assignee:	Andrew Burden <aburden>
Status:	CLOSED ERRATA	QA Contact:	Israel Pinto <ipinto>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	2.5.0	CC:	cnv-qe-bugs, danken, fdeutsch
Target Milestone:	---
Target Release:	2.5.0
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	2.5.0	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2020-11-17 13:24:22 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Tomas Jelinek 2020-09-04 08:07:11 UTC

CNV supports to create container disks and than attaching them to VMs and boot the VM from them. The ask is to document this functionality.

Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 1 Dan Kenigsberg 2020-09-04 08:31:13 UTC

Upstream has

cat << END > Dockerfile
FROM scratch
ADD fedora25.qcow2 /disk/
END
docker build -t vmdisks/fedora25:latest .
docker push vmdisks/fedora25:latest


We should use podman and rhel.

Comment 3 Dan Kenigsberg 2020-09-08 17:58:18 UTC

Reintroducing the target milestone. containerDisks are already being used. We should document when they can be used (immutable filesystems) and how to create them.

Comment 4 Andrew Burden 2020-09-08 19:23:29 UTC

Thanks for the PR, Dan; always appreciated. Unfortunately I'll have to open a separate PR to cover this because it breaks our FCC conventions (procedure within a reference module) - happy to talk more about that, if you'd like. 
Moving this to Assigned.

Comment 5 Andrew Burden 2020-09-10 17:29:02 UTC

Dan has kindly reviewed and acked. Moving to ON_QA:
PR: https://github.com/openshift/openshift-docs/pull/25359

New assembly: https://cnv-bz1875725-containerdisk--ocpdocs.netlify.app/openshift-enterprise/latest/virt/virtual_machines/advanced_vm_management/virt-using-containerdisk-volumes.html
Updated storage types table: https://cnv-bz1875725-containerdisk--ocpdocs.netlify.app/openshift-enterprise/latest/virt/virtual_machines/virt-create-vms.html#virt-vm-storage-volume-types_virt-create-vms

Comment 6 Israel Pinto 2020-10-27 07:01:34 UTC

Reviewed doc, LGTM.

Comment 9 errata-xmlrpc 2020-11-17 13:24:22 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (OpenShift Virtualization 2.5.0 Images), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHEA-2020:5127

Comment 10 Andrew Burden 2020-11-18 10:48:01 UTC

This content has now been published and can be viewed here:
https://docs.openshift.com/container-platform/4.6/virt/virtual_machines/virtual_disks/virt-using-container-disks-with-vms.html