Bug 1793433

Summary:	[QE] [Docs] Import note from OSP14 on how to enable image_conversion glance plugin
Product:	Red Hat OpenStack	Reporter:	Giulio Fidente <gfidente>
Component:	documentation	Assignee:	Laura Marsh <lmarsh>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Mike Abrams <mabrams>
Severity:	high	Docs Contact:
Priority:	high
Version:	13.0 (Queens)	CC:	amoralej, asimonel, cyril, ekuvaja, gcharot, lmarsh, mabrams
Target Milestone:	---	Keywords:	ZStream
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:
Clones:	1831876 (view as bug list)		Environment:
Last Closed:	2020-05-27 16:03:09 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:
Bug Depends On:	1782229
Bug Blocks:	1831876, 1831878, 1831880

Description Giulio Fidente 2020-01-21 10:57:13 UTC

Following implementation of BZ#1782229, we need to import into the OSP13 docs a note which shows how to enable the image_conversion plugin.

A note appears already in the OSP14 docs [1], that should be imported in OSP13 [2]

1. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/14/html-single/instances_and_images_guide/index#section-image-conversion

2. https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html-single/instances_and_images_guide/index#section-image-conversion

Comment 3 Cyril Roelandt 2020-01-22 14:00:04 UTC

Regarding the "glance image-import" command, the Pike release notes state that it "initiates the import process for a previously created image record whose image data is currently in the staging area". So you would still need to create it first, in a separate step.

Comment 4 Cyril Roelandt 2020-01-22 19:51:43 UTC

It seems like the OSP14 note you mention in the bug report is already in OSP13, or am I mistaken?

Comment 5 Giulio Fidente 2020-01-23 11:35:48 UTC

(In reply to Cyril Roelandt from comment #4)
> It seems like the OSP14 note you mention in the bug report is already in
> OSP13, or am I mistaken?

the note in section "1.1.2.1. Enabling Image Conversion" appears only in the OSP14 docs, that's the one we need to import in OSP13 docs as well

Comment 6 Cyril Roelandt 2020-01-23 15:03:58 UTC

Oh right, sorry, I was looking at the other note right above and was confused. Thanks for the clarification!

Comment 8 Erno Kuvaja 2020-01-28 11:47:35 UTC

So you can do something like this, if the image conversion import plugin has been enabled the image format will be converted in flight:
$ glance image-create-via-import --disk-format qcow2 --container-format bare --name Fedora-31 --visibility public --store ceph-fast --import-method glance-direct --file /home/user/fedora-31.qcow2
or
$ glance image-create-via-import --disk-format qcow2 --container-format bare --name Fedora-31 --visibility public --store ceph-fast --import-method web-download --uri https://download.fedoraproject.org/pub/fedora/linux/releases/31/Cloud/x86_64/images/Fedora-Cloud-Base-31-1.9.x86_64.qcow2

NOTE: Both of these cases will create new public image record named "Fedora-31" stored in "ceph-fast" backend store. First one will create the record, upload the data from local filesystem to glance staging and process the import, second example will create the image record and import it with web-download where glance-api will download it from the "--uri <location>" during the import process. The user needs to know which import method is available in the cloud to successfully perform these commands (For example if web-download is not available, glanceclient does not download the image data automatically and upload it to be used with glance-direct method). The available methods can be listed with `glance import-info` command. 

I've intentionally omitted any login details from the commands exampled here. For these commands to work as is, one needs to have the environmental variables set with credentials.

Comment 9 Cyril Roelandt 2020-01-28 14:20:27 UTC

It seems available in Queens, so we could probably mention it in the docs, indeed.

Comment 10 Cyril Roelandt 2020-01-29 20:34:16 UTC

That being said, are we testing this feature?

@Mike: do we have tests for the feature described by Erno in #8? If not, should we add them before advertising it to our users?

Comment 11 Mike Abrams 2020-01-30 06:50:57 UTC

Cyril, qe does not have this test case covered currently, but we should test it before availability.

i will put together testing for this and send it for review; please set the release flag on this bz.

thank you

Comment 15 Laura Marsh 2020-02-21 14:07:20 UTC

*** Bug 1780133 has been marked as a duplicate of this bug. ***