Skip to content

Conversation

subhtk
Copy link
Contributor

@subhtk subhtk commented Jun 11, 2024

oc-mirror v2 Assembly PR - Part 1- #76917
oc-mirror v2 PR - Part 2- #77247

original PR-#74485

Version(s): 4.16+

Issue: OSDOCS 8197

Link to docs preview: https://77289--ocpdocs-pr.netlify.app/openshift-enterprise/latest/installing/disconnected_install/about-installing-oc-mirror-v2.html

QE review:

  • QE has approved this change.

Additional information:

@openshift-ci openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Jun 11, 2024
@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented Jun 11, 2024

@subhtk subhtk force-pushed the ocm-v2-part3 branch 2 times, most recently from 33eb6a7 to fda49cc Compare June 11, 2024 13:49
@openshift-ci openshift-ci bot added size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Jun 11, 2024
@subhtk subhtk force-pushed the ocm-v2-part3 branch 3 times, most recently from a52653a to a29f590 Compare June 19, 2024 14:03
@subhtk
Copy link
Contributor Author

subhtk commented Jun 20, 2024

/label peer-review-needed

@openshift-ci openshift-ci bot added the peer-review-needed Signifies that the peer review team needs to review this PR label Jun 20, 2024
@dfitzmau
Copy link
Contributor

/remove-label peer-review-needed

/label peer-review-in-progress

@openshift-ci openshift-ci bot added the peer-review-in-progress Signifies that the peer review team is reviewing this PR label Jun 20, 2024
@dfitzmau
Copy link
Contributor

HI @subhtk . Nice work. This PR is alrger than I though. I need to return to release note duties :). I added comments inline. Some changes are needed before I can mark this PR as done. COntact me if you have any Qs.

@subhtk
Copy link
Contributor Author

subhtk commented Jun 20, 2024

Thanks @dfitzmau. Really appreciate the review!

|Description

|`help`
|Show help about any subcommand
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK.

+
It is recommended to store the file under `$HOME/.config/containers/registries.conf` or `/etc/containers/registries.conf`.
+
The TOML format of the file is described in this specification.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe group all these paragraphs into one so that step 1 is not overly padded with line breaks?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Group into one step and add the recommended step as a note?

[id="prerequisites_oc-mirror-v2_{context}"]
== Prerequisites

* You must have a container image registry that supports link:https://docs.docker.com/registry/spec/manifest-v2-2[Docker V2-2] in the location that hosts the {product-title} cluster, such as Red Hat Quay.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Red Hat Quay has an attribute = {quay}. Swap throughout?

[id="oc-mirror-v2-about-dry-run_{context}"]
= Verifying your selected images for mirroring

You can use oc-mirror plugin v2 to perform a test run (dry run) that does not actually mirror any images. This allows you to review the list of images that would be mirrored. You can also use a dry run to catch any errors with your image set configuration early. When running a dry run on a mirror-to-disk workflow, the oc-mirror plugin v2 checks if all the images within the image set are available in its cache. Any missing images are listed in the `missing.txt` file. When a dry run is performed before mirroring, both `missing.txt` and `mapping.txt` contain the same list of images. No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"This allows you" is an:

Screenshot from 2024-06-21 12-18-18

Consider:

This means that you can review...

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This enables you to review?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Enables" would also be considered anthrophmorphic. Best to state what the "user can do".

@subhtk subhtk force-pushed the ocm-v2-part3 branch 4 times, most recently from 5cfd782 to 864fcd7 Compare June 21, 2024 12:08
@dfitzmau
Copy link
Contributor

Thanks for your patience and speed on making a few rounds of updates.

LGTM

/remove-label peer-review-in-progress

/label peer-review-done

@openshift-ci openshift-ci bot added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-in-progress Signifies that the peer review team is reviewing this PR labels Jun 21, 2024
@subhtk
Copy link
Contributor Author

subhtk commented Jun 21, 2024

/label merge-review-needed

@openshift-ci openshift-ci bot added the merge-review-needed Signifies that the merge review team needs to review this PR label Jun 21, 2024
@bscott-rh bscott-rh added merge-review-in-progress Signifies that the merge review team is reviewing this PR branch/enterprise-4.16 and removed merge-review-needed Signifies that the merge review team needs to review this PR labels Jun 21, 2024
@bscott-rh bscott-rh added this to the Planned for 4.16 GA milestone Jun 21, 2024
Copy link

openshift-ci bot commented Jun 21, 2024

@subhtk: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@bscott-rh
Copy link
Contributor

Merge review LGTM.

@bscott-rh bscott-rh removed the merge-review-in-progress Signifies that the merge review team is reviewing this PR label Jun 21, 2024
@bscott-rh bscott-rh merged commit bb191ac into openshift:main Jun 21, 2024
@bscott-rh
Copy link
Contributor

/cherrypick enterprise-4.16

@openshift-cherrypick-robot

@bscott-rh: new pull request created: #77864

In response to this:

/cherrypick enterprise-4.16

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

branch/enterprise-4.16 peer-review-done Signifies that the peer review team has reviewed this PR size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants