Bug 1771435
Summary: | [OCPv4.2] "oc adm must-gather" command must be used by "--image" option in disconnected env | ||
---|---|---|---|
Product: | OpenShift Container Platform | Reporter: | Angelo Gabrieli <agabriel> |
Component: | Documentation | Assignee: | Kevin Lamenzo <klamenzo> |
Status: | CLOSED CURRENTRELEASE | QA Contact: | zhou ying <yinzhou> |
Severity: | low | Docs Contact: | Vikram Goyal <vigoyal> |
Priority: | low | ||
Version: | 4.2.0 | CC: | agabriel, aos-bugs, jokerman, kalexand, klamenzo, yinzhou |
Target Milestone: | --- | ||
Target Release: | 4.2.z | ||
Hardware: | Unspecified | ||
OS: | Unspecified | ||
Whiteboard: | |||
Fixed In Version: | Doc Type: | If docs needed, set a value | |
Doc Text: | Story Points: | --- | |
Clone Of: | Environment: | ||
Last Closed: | 2021-02-08 21:16:48 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
Angelo Gabrieli
2019-11-12 11:27:11 UTC
I added the following note to the procedure: "If your cluster is using a restricted network you must mirror the latest must-gather image and then use it with the --image option. oc image mirror quay.io/openshift/origin-must-gather:latest \ <image destination> \ -a <path to your registry credentials> oc adm must-gather --image=<path to mirrored must-gather image>" @yinzhou can you confirm this is 4.2 and future 4.x versions (4.3, 4.4, etc.)? Preview is available in the PR here: https://github.com/openshift/openshift-docs/pull/20768 @Kevin Lamenzo `oc image mirror` then use `oc adm must-gather --image` works well , but without mirror , use the default image in the payload also works well , just need to import the image . What's your opinion for command `oc import-image is must-gather -n openshift` then only use `oc adm must-gather`. Thanks @yinzhou. I added importing the default image as an option. I'm not sure which scenario is better for customers with a disconnected install, so I think including both is safest. Can you help confirm which versions of 4.x this applies to? Same link for the PR - https://github.com/openshift/openshift-docs/pull/20768/files (In reply to Kevin Lamenzo from comment #4) > Thanks @yinzhou. I added importing the default image as an option. I'm not > sure which scenario is better for customers with a disconnected install, so > I think including both is safest. > > Can you help confirm which versions of 4.x this applies to? This could apply to 4.1 to latest. (In reply to zhou ying from comment #6) > (In reply to Kevin Lamenzo from comment #4) > > Thanks @yinzhou. I added importing the default image as an option. I'm not > > sure which scenario is better for customers with a disconnected install, so > > I think including both is safest. > > > > Can you help confirm which versions of 4.x this applies to? > > This could apply to 4.1 to latest. Should be ocp 4.2 to latest. because ocp4.1 not support restricted env. All the command lgtm in PR, will verify it. Thanks. Per doc review we're going to take a second look at this. Can you help clarify some things: - First, for the option to import the default must-gather image (oc import-image is/must-gather -n openshift, then oc adm must-gather), do all clusters have this option available, or do they need to perform any prerequisites? Also, is there "build-in" image stream actually named "is" (from "is/must-gather"), or is that something the customer needs to set up. I tested this option on a cluster-bot cluster and it worked, but I don't know how close a cluster-bot install is to a restricted network install. - Second, if the above option works for all (or most clusters), then I think we should document it as the solution. My team member pointed out that clusters in a restricted network will likely not have a connection to the internet and therefore would need to perform additional prerequisites in order to mirror the latest must-gather image. I appreciate your feedback on these few things. (In reply to Kevin Lamenzo from comment #9) > Thanks. Per doc review we're going to take a second look at this. Can you > help clarify some things: > > - First, for the option to import the default must-gather image (oc > import-image is/must-gather -n openshift, then oc adm must-gather), do all > clusters have this option available, or do they need to perform any > prerequisites? Also, is there "build-in" image stream actually named "is" > (from "is/must-gather"), or is that something the customer needs to set up. > Must be cluster-admin to run the command, 'is' is the short-name of 'image stream' . > I tested this option on a cluster-bot cluster and it worked, but I don't > know how close a cluster-bot install is to a restricted network install. > > - Second, if the above option works for all (or most clusters), then I think > we should document it as the solution. My team member pointed out that > clusters in a restricted network will likely not have a connection to the > internet and therefore would need to perform additional prerequisites in > order to mirror the latest must-gather image. This works out for all cluster include the restricted network, because the default must-gather image from payload . > I appreciate your feedback on these few things. Thanks. We're going to simplify down to one option then. https://github.com/openshift/openshift-docs/pull/20768 I'll send this to the doc team for review and wrap up once we've published. |