MIG-1017 Document network bridge solution for air gapped customers #41620

stoobie · 2022-02-09T13:26:28Z

This PR addresses https://issues.redhat.com/browse/MIG-1017.

This applies to:
enterprise-4.10

Preview:
https://deploy-preview-41620--osdocs.netlify.app/openshift-enterprise/latest/migrating_from_ocp_3_to_4/advanced-migration-options-3-4.html#migration-migrating-applications-on-prem-to-cloud_advanced-migration-options-3-4

Added a new module:
modules/migration-migrating-on-prem-to-cloud.adoc

Minor fix in existing module (sentence was incomplete)

stoobie · 2022-02-09T13:28:01Z

@jmontleon Please review for accuracy and completeness, and there are several questions that need answers.

Also, please make sure that I correctly fixed the incomplete sentence in modules/migration-adding-cluster-to-cam.adoc.

netlify · 2022-02-09T13:29:12Z

✅ Deploy Preview for osdocs ready!

Name	Link
🔨 Latest commit	`b040dea`
🔍 Latest deploy log	https://app.netlify.com/sites/osdocs/deploys/623cb78f676855000886bed7
😎 Deploy Preview	https://deploy-preview-41620--osdocs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

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

apinnick · 2022-02-13T16:13:45Z

modules/migration-migrating-on-prem-to-cloud.adoc

For the UI, you create a MigCluster CR by adding a cluster. Here's the documentation.

OK, I added links in the parent assembly under .Additional resources, following this module.

apinnick · 2022-02-13T16:42:38Z

modules/migration-migrating-on-prem-to-cloud.adoc

Looks like you get it by running $ oc config view. See docs.

apinnick · 2022-02-13T16:45:29Z

modules/migration-migrating-on-prem-to-cloud.adoc

The logs for the OpenVPN pods.

oc get po is short for oc get pods.

OK. Thanks.

modules/migration-migrating-on-prem-to-cloud.adoc

apinnick · 2022-02-13T16:48:47Z

modules/migration-migrating-on-prem-to-cloud.adoc

= token of the migration controller service account.

modules/migration-migrating-on-prem-to-cloud.adoc

apinnick · 2022-02-13T16:54:27Z

modules/migration-migrating-on-prem-to-cloud.adoc

A list of pods in the namespace, with their status, restarts, and age,

The video demo shows the result. Source cluster at 2:12.

Thanks. I added that, but I'm not sure how to refer to the string following openvpn. I referred to is <log-hash>. @jmontleon Can you weigh in?

apinnick · 2022-02-13T17:00:37Z

modules/migration-migrating-on-prem-to-cloud.adoc

Jason posted the command to install it in one of the comments on your Jira.

Added this as a step in the procedure.

apinnick · 2022-02-17T10:52:40Z

modules/migration-migrating-on-prem-to-cloud.adoc

$ oc logs -f <openvpn> -n <namespace> -c openvpn

midays · 2022-03-09T11:26:17Z

modules/migration-migrating-on-prem-to-cloud.adoc

Why is Jason's name mentioned here ? is it relevant to the customers ?

Thanks for catching this @midays - the entire bit in parenthesis should be removed.

midays · 2022-03-09T11:28:26Z

modules/migration-migrating-on-prem-to-cloud.adoc

at the end of the url it's also requried to specify the port as follows:
https://proxied-cluster.${namespace}.svc.cluster.local:8443

stoobie · 2022-03-09T16:58:22Z

@midays Please review my changes.

stillalearner · 2022-03-10T13:10:40Z

modules/migration-migrating-on-prem-to-cloud.adoc

The source cluster needs to be added to the mtc console, not the destination.

stillalearner · 2022-03-10T13:10:59Z

modules/migration-migrating-on-prem-to-cloud.adoc

Cluster name: Source cluster name.

michaelryanpeter

Please let me know if you have questions. I tried to provide references to the style rules where I could find them.

michaelryanpeter · 2022-03-11T16:22:25Z

migrating_from_ocp_3_to_4/advanced-migration-options-3-4.adoc

Additional resources are limited to an unordered list of links or xrefs. (See the peer review checklist

Also, this is duplicated at the end of the modules/migration-migrating-on-prem-to-cloud.adoc file.

I think that this would work better at the end of the procedure module as a [TIP] admonition. This is how I have most commonly seen these examples presented.

I added it as a tip close to where I first mentioned the command.

michaelryanpeter · 2022-03-11T16:38:23Z

migrating_from_ocp_3_to_4/advanced-migration-options-3-4.adoc

Suggested change

* For information on creating a MigCluster CR manifest for each remote cluster, see

* For information about creating a MigCluster CR manifest for each remote cluster, see

Re: CCS IBM style guide quick reference

@michaelryanpeter Fixed.

michaelryanpeter · 2022-03-11T16:41:01Z

migrating_from_ocp_3_to_4/advanced-migration-options-3-4.adoc

Suggested change

.Additional resources

[role="_additional-resources"]

.Additional resources

Re: Jupiter guidelines from the OSDOCS peer review checklist

michaelryanpeter · 2022-03-11T16:43:40Z

migrating_from_ocp_3_to_4/advanced-migration-options-3-4.adoc

Suggested change

* For information on adding a cluster using the web console, see xref:../migrating_from_ocp_3_to_4/migrating-applications-3-4.adoc#migrating-applications-mtc-web-console_migrating-applications-3-4[Migrating your applications by using the {mtc-short} web console]

* For information about adding a cluster using the web console, see xref:../migrating_from_ocp_3_to_4/migrating-applications-3-4.adoc#migrating-applications-mtc-web-console_migrating-applications-3-4[Migrating your applications by using the {mtc-short} web console]

michaelryanpeter · 2022-03-11T16:48:13Z

migrating_from_ocp_3_to_4/advanced-migration-options-3-4.adoc

Please remove the hard wrap/line break here. It shows up inline in the preview, but we don't want to have the line break in the .adoc.

Re: repo guidelines

michaelryanpeter · 2022-03-11T20:24:26Z

modules/migration-migrating-on-prem-to-cloud.adoc

Suggested change

$ oc get service -n _<namespace>_

$ oc get service -n <namespace>

michaelryanpeter · 2022-03-11T20:26:23Z

modules/migration-migrating-on-prem-to-cloud.adoc

Suggested change

. On the source node, get the SA token for the migration controller:

. On the source node, get the service account (SA) token for the migration controller:

michaelryanpeter · 2022-03-11T20:29:42Z

modules/migration-migrating-on-prem-to-cloud.adoc

This is duplicated in the assembly file. Please see that note for a comment on replacing the example --help command as a [TIP] admonition in this procedure module.

michaelryanpeter · 2022-03-11T20:32:24Z

modules/migration-migrating-on-prem-to-cloud.adoc

Suggested change

. Launch the {mtc-short} web console and add the source cluster, using the following values:

. Open the {mtc-short} web console and add the source cluster, using the following values:

ISG recommends using start or open instead of launch unless it is part of the product terminology.

michaelryanpeter · 2022-03-11T20:40:15Z

modules/migration-migrating-on-prem-to-cloud.adoc

Suggested change

For example:

.Example command

stoobie · 2022-03-16T09:34:33Z

@michaelryanpeter Please do not merge this until the MTC 1.7 release. I don't believe there is any way to automatically indicate this, so I or someone else on the team will give the go-ahead.

stoobie · 2022-03-24T16:05:13Z

@michaelryanpeter Please merge. MTC 1.7 is now live.

michaelryanpeter · 2022-03-24T18:15:43Z

modules/migration-migrating-on-prem-to-cloud.adoc

Suggested change

.Example output

[source,terminal]

----

NAME READY STATUS RESTARTS AGE

<pod_name> 2/2 Running 0 44s

[source,terminal,subs="+quotes"]

----

# oc logs -f -n <namespace> <pod_name> -c openvpn

----

When the address of the load balancer is resolved, the message `Initialization Sequence Completed` appears at the end of the log.

====

.Example output

[source,terminal]

----

NAME READY STATUS RESTARTS AGE

<pod_name> 2/2 Running 0 44s

----

[source,terminal,subs="+quotes"]

----

# oc logs -f -n <namespace> <pod_name> -c openvpn

----

When the address of the load balancer is resolved, the message `Initialization Sequence Completed` appears at the end of the log.

====

@michaelryanpeter Fixed.

michaelryanpeter · 2022-03-24T18:31:50Z

/cherrypick enterprise-4.10

michaelryanpeter · 2022-03-24T18:32:11Z

/cherrypick enterprise-4.11

openshift-cherrypick-robot · 2022-03-24T18:34:51Z

@michaelryanpeter: new pull request created: #43793

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 · 2022-03-24T18:35:04Z

@michaelryanpeter: new pull request created: #43794

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.

openshift-ci bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Feb 9, 2022

stoobie force-pushed the MIG-1017 branch from b206139 to 811e3ba Compare February 9, 2022 15:59

apinnick reviewed Feb 13, 2022

View reviewed changes

modules/migration-migrating-on-prem-to-cloud.adoc Outdated Show resolved Hide resolved

apinnick reviewed Feb 13, 2022

View reviewed changes

modules/migration-migrating-on-prem-to-cloud.adoc Outdated Show resolved Hide resolved

apinnick reviewed Feb 13, 2022

View reviewed changes

stoobie force-pushed the MIG-1017 branch 3 times, most recently from 5fdf51a to 69bcc86 Compare February 17, 2022 10:35

apinnick reviewed Feb 17, 2022

View reviewed changes

stoobie force-pushed the MIG-1017 branch 6 times, most recently from 5fffee3 to d09fc74 Compare February 17, 2022 16:42

stoobie force-pushed the MIG-1017 branch 2 times, most recently from f81d37a to a67157d Compare March 7, 2022 17:12

midays reviewed Mar 9, 2022

View reviewed changes

stoobie force-pushed the MIG-1017 branch from a67157d to 300d40a Compare March 9, 2022 16:58

stillalearner reviewed Mar 10, 2022

View reviewed changes

stoobie force-pushed the MIG-1017 branch 2 times, most recently from e272611 to e998a20 Compare March 10, 2022 17:31

stillalearner approved these changes Mar 10, 2022

View reviewed changes

michaelryanpeter added peer-review-needed Signifies that the peer review team needs to review this PR branch/enterprise-4.10 branch/enterprise-4.11 labels Mar 11, 2022

michaelryanpeter added this to the Next Release milestone Mar 11, 2022

michaelryanpeter reviewed Mar 11, 2022

View reviewed changes

michaelryanpeter added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-needed Signifies that the peer review team needs to review this PR labels Mar 11, 2022

stoobie force-pushed the MIG-1017 branch from e998a20 to 46e498d Compare March 15, 2022 16:22

michaelryanpeter reviewed Mar 24, 2022

View reviewed changes

MIG-1017 Initial commit, rough draft.

b040dea

stoobie force-pushed the MIG-1017 branch from 46e498d to b040dea Compare March 24, 2022 18:25

michaelryanpeter merged commit 1502b7c into openshift:main Mar 24, 2022

openshift-cherrypick-robot mentioned this pull request Mar 24, 2022

[enterprise-4.10] MIG-1017 Document network bridge solution for air gapped customers #43793

Merged

openshift-cherrypick-robot mentioned this pull request Mar 24, 2022

[enterprise-4.11] MIG-1017 Document network bridge solution for air gapped customers #43794

Merged

stoobie deleted the MIG-1017 branch March 31, 2022 09:25

	* For information on creating a MigCluster CR manifest for each remote cluster, see
	* For information about creating a MigCluster CR manifest for each remote cluster, see

	.Additional resources
	[role="_additional-resources"]
	.Additional resources

	* For information on adding a cluster using the web console, see xref:../migrating_from_ocp_3_to_4/migrating-applications-3-4.adoc#migrating-applications-mtc-web-console_migrating-applications-3-4[Migrating your applications by using the {mtc-short} web console]
	* For information about adding a cluster using the web console, see xref:../migrating_from_ocp_3_to_4/migrating-applications-3-4.adoc#migrating-applications-mtc-web-console_migrating-applications-3-4[Migrating your applications by using the {mtc-short} web console]

	$ oc get service -n _<namespace>_
	$ oc get service -n <namespace>

	. On the source node, get the SA token for the migration controller:
	. On the source node, get the service account (SA) token for the migration controller:

	. Launch the {mtc-short} web console and add the source cluster, using the following values:
	. Open the {mtc-short} web console and add the source cluster, using the following values:

-.Example output
-[source,terminal]
-----
-NAME            READY     STATUS      RESTARTS    AGE
-<pod_name>    2/2       Running     0           44s
-[source,terminal,subs="+quotes"]
-----
-# oc logs -f -n <namespace> <pod_name> -c openvpn
-----
-When the address of the load balancer is resolved, the message `Initialization Sequence Completed` appears at the end of the log.
-====
+.Example output
+[source,terminal]
+----
+NAME            READY     STATUS      RESTARTS    AGE
+<pod_name>    2/2       Running     0           44s
+----
+[source,terminal,subs="+quotes"]
+----
+# oc logs -f -n <namespace> <pod_name> -c openvpn
+----
+When the address of the load balancer is resolved, the message `Initialization Sequence Completed` appears at the end of the log.
+====

MIG-1017 Document network bridge solution for air gapped customers #41620

MIG-1017 Document network bridge solution for air gapped customers #41620

Uh oh!

Conversation

stoobie commented Feb 9, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

stoobie commented Feb 9, 2022

Uh oh!

netlify bot commented Feb 9, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for osdocs ready!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apinnick Feb 13, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

apinnick Feb 13, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

stoobie commented Mar 9, 2022

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

michaelryanpeter left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

stoobie commented Feb 9, 2022 •

edited

Loading

netlify bot commented Feb 9, 2022 •

edited

Loading

apinnick Feb 13, 2022 •

edited

Loading

apinnick Feb 13, 2022 •

edited

Loading

stoobie Mar 15, 2022 •

edited

Loading