Bug 1757222 - [Docs] Document known issue of imagestreams in openshift namespace are not handled with migrations.
Summary: [Docs] Document known issue of imagestreams in openshift namespace are not ha...
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: OpenShift Container Platform
Classification: Red Hat
Component: Migration Tooling
Version: 4.2.0
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: 4.2.0
Assignee: Avital Pinnick
QA Contact: Xin jiang
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2019-09-30 21:04 UTC by John Matthews
Modified: 2019-10-25 14:47 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-10-16 06:41:54 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2019:2922 0 None None None 2019-10-16 06:42:08 UTC

Description John Matthews 2019-09-30 21:04:56 UTC
We want to ensure we have a documentation note that users may hit an issue if they migrate an application that relies on images in the openshift namespace.

Certain images like postgres for example are upgraded throughout OCP releases.  An older application running on OCP 3.7 may reference an older postgres version which is not installed in an OCP 4.2 cluster.

For 4.2.0 we will not be able to help a user with this problem, we want to document this as a known issue.

A user should:
 - Inspect their application to determine if they are using images from the openshift namespace.
 - If they are, check to see if the needed version is present on the destination cluster, if not they will want to recreate the ImageStream with needed version on destination cluster prior to performing the migration

Comment 3 Scott Seago 2019-10-07 17:59:50 UTC
One comment on the doc wording. I think this section is somewhat vague: "If your applications use images from the openshift namespace, the required versions of the images must be present on the target cluster. If not, you must update the imagestreamtags." I'd suggest something like this instead: "If your applications use images from the openshift namespace, the required versions of the images must be present on the target cluster. If not, you must update the imagestreamtags references to use an available version, making sure that the updated version is compatible with your application."

Comment 4 Avital Pinnick 2019-10-10 06:48:28 UTC
(In reply to Scott Seago from comment #3)
> One comment on the doc wording. I think this section is somewhat vague: "If
> your applications use images from the openshift namespace, the required
> versions of the images must be present on the target cluster. If not, you
> must update the imagestreamtags." I'd suggest something like this instead:
> "If your applications use images from the openshift namespace, the required
> versions of the images must be present on the target cluster. If not, you
> must update the imagestreamtags references to use an available version,
> making sure that the updated version is compatible with your application."

LGTM. I updated the second sentence: "If not, you must update the imagestreamtags references to use an available version that is compatible with your application."

Comment 6 Xin jiang 2019-10-11 05:26:39 UTC
Reviewed. LGTM.

Comment 7 errata-xmlrpc 2019-10-16 06:41:54 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, 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/RHBA-2019:2922


Note You need to log in before you can comment on or make changes to this bug.