Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

MIG-1107 MTC 1.7 Release Notes #43766

Merged
merged 1 commit into from
Mar 31, 2022
Merged

MIG-1107 MTC 1.7 Release Notes #43766

merged 1 commit into from
Mar 31, 2022

Conversation

stoobie
Copy link
Contributor

@stoobie stoobie commented Mar 24, 2022

@openshift-ci openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Mar 24, 2022
@netlify
Copy link

netlify bot commented Mar 24, 2022

Deploy Preview for osdocs ready!

Name Link
🔨 Latest commit 779b7dd
🔍 Latest deploy log https://app.netlify.com/sites/osdocs/deploys/62457351de21450009b37960
😎 Deploy Preview https://deploy-preview-43766--osdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.


The following features are deprecated:

* {mtc-short} version 1.5 and 1.6 are deprecated. Support for them will be removed in a future version.

Choose a reason for hiding this comment

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

1.5 and 1.6 are not deprecated unless there is some formal definition for this that I'm unaware of. We intend to fully support this until 1.8 is released when support will be dropped.

Choose a reason for hiding this comment

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

+1

@stoobie
Copy link
Contributor Author

stoobie commented Mar 24, 2022

@eriknelson My understanding of "deprecated" is exactly what you said: We still support it, but we know that in the future we will stop supporting it.
In 1.6, we had this message for 1.4.
But I can just remove the message if I'm wrong or you if you disagree about the messaging. Or if I'm wrong about the definition of "deprecated".

@eriknelson
Copy link

@stoobie We've never used that language for our supported currentRelease - 1 channel, I'd prefer not to introduce it now should it discourage users from using it or suggest that is in any way not supported at the same level that 1.7 is.

@stoobie
Copy link
Contributor Author

stoobie commented Mar 29, 2022

@eriknelson I made the change you requested, but here's my experience with the definition of Deprecated (In RHV): https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.4/html-single/release_notes/index#Deprecated_Features_RHV

Copy link

@stillalearner stillalearner left a comment

Choose a reason for hiding this comment

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

/lgtm

@openshift-ci
Copy link

openshift-ci bot commented Mar 29, 2022

@stillalearner: changing LGTM is restricted to collaborators

In response to this:

/lgtm

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/test-infra repository.

The {mtc-full} ({mtc-short}) enables you to migrate application workloads between {product-title} clusters at the granularity of a namespace.

You can migrate from xref:../migrating_from_ocp_3_to_4/about-migrating-from-3-to-4.adoc[{product-title} 3 to {product-version}] and between {product-title} 4 clusters.

{mtc-short} provides a web console and an API, based on Kubernetes custom resources, to help you control the migration and minimize application downtime.

For information on the support policy for {mtc-short}, see link:https://access.redhat.com/support/policy/updates/openshift#app_migration[OpenShift Application and Cluster Migration Solutions], part of the _Red Hat OpenShift Container Platform Life Cycle Policy_
Copy link
Contributor

Choose a reason for hiding this comment

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

For information on the support policy for {mtc-short}, see link:https://access.redhat.com/support/policy/updates/openshift#app_migration[OpenShift Application and Cluster Migration Solutions], part of the Red Hat {product-title} Life Cycle Policy.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks, @darshan-nagaraj . I made the change.
In the future, I suggest using the Add a suggestion
image
button, because it makes the diffs in your suggestion much clearer.

Copy link
Contributor

Choose a reason for hiding this comment

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

@stoobie Noted. Thanks for letting me know.

Copy link
Contributor

@darshan-nagaraj darshan-nagaraj left a comment

Choose a reason for hiding this comment

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

Looks good to me. Left some nits inline.

@@ -6,12 +6,16 @@ include::_attributes/common-attributes.adoc[]

toc::[]

The release notes for {mtc-full} ({mtc-short}) describe new features and enhancements, deprecated features, and known issues.

The {mtc-full} ({mtc-short}) enables you to migrate application workloads between {product-title} clusters at the granularity of a namespace.
Copy link
Contributor

Choose a reason for hiding this comment

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

Remove {mtc-full} because it is already abbreviated in the first sentence.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done.

// Module included in the following assemblies:
//
// * migration_toolkit_for_containers/mtc-release-notes.adoc

Copy link
Contributor

Choose a reason for hiding this comment

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

:_content-type: REFERENCE

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done.

@stoobie stoobie force-pushed the MIG-1107 branch 6 times, most recently from 5f3e3d5 to d778d93 Compare March 29, 2022 14:40
:_content-type: REFERENCE
[id="migration-mtc-release-notes-1-7_{context}"]
= {mtc-full} 1.7 release notes

Copy link
Contributor

Choose a reason for hiding this comment

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

You need some introductory text between the H1 and H2.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Will not fix. I hope this isn't a blocker.

Copy link
Contributor

Choose a reason for hiding this comment

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

@RichardHoch, please consider opening a follow-up PR to add this heading. It's a mod docs and Jupiter requirement that's not quite a blocker and not quite enough for a bug.


This release has the following new features and enhancements:

* The {mtc-full} ({mtc-short}) operator now depends upon the OpenShift API for Data Protection (OADP) operator. When you install the {mtc-short} operator, the Operator Lifecycle Manager (OLM) automatically installs the OADP operator in the same namespace.
Copy link
Contributor

Choose a reason for hiding this comment

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

"Operator" is always capitalized.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed.


* The {mtc-full} ({mtc-short}) operator now depends upon the OpenShift API for Data Protection (OADP) operator. When you install the {mtc-short} operator, the Operator Lifecycle Manager (OLM) automatically installs the OADP operator in the same namespace.

* You can migrate from a source cluster that is behind a firewall to a cloud-based destination cluster by establishing a network tunnel between the two clusters using the `crane tunnel-api` command.
Copy link
Contributor

Choose a reason for hiding this comment

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

This sounds like it should be "by using." Per the ISG:

! using noun
To avoid ambiguity, replace this gerund with either "by using" or "that uses".

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed.


This release has the following known issues:

* On {product-title} 3.10, the `MigrationController` pod takes too long to restart. The Bugzilla report contains a workaround. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1986796[*BZ#1986796*])
Copy link
Contributor

Choose a reason for hiding this comment

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

I am confused by this line. 3.10 is EOL.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Removed the line.


* On {product-title} 3.10, the `MigrationController` pod takes too long to restart. The Bugzilla report contains a workaround. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1986796[*BZ#1986796*])
* `MigPlan` custom resource does not display a warning when an AWS gp2 PVC has no available space. (link:https://bugzilla.redhat.com/show_bug.cgi?id=1963927[*BZ#1963927*])
* Block storage for IBM Cloud must be in the same availability zone. See the link:https://cloud.ibm.com/docs/vpc?topic=vpc-block-storage-vpc-faq[IBM FAQ for block storage for virtual private cloud].
Copy link
Contributor

Choose a reason for hiding this comment

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

Consider specifying what also needs to be in the same availability zone. I assume that it's the cluster, but I am not sure based on the current context.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Will not fix. I hope this isn't high priority.

@kalexand-rh
Copy link
Contributor

/cherrypick enterprise-4.10

@kalexand-rh
Copy link
Contributor

/cherrypick enterprise-4.11

@openshift-cherrypick-robot

@kalexand-rh: new pull request created: #44013

In response to this:

/cherrypick enterprise-4.10

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/test-infra repository.

@openshift-cherrypick-robot

@kalexand-rh: new pull request created: #44014

In response to this:

/cherrypick enterprise-4.11

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/test-infra repository.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
branch/enterprise-4.10 branch/enterprise-4.11 size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

6 participants