openshift-docs icon indicating copy to clipboard operation
openshift-docs copied to clipboard

OSDOCS-12623: Documented the Ansible playbook offline migration method

Open dfitzmau opened this issue 10 months ago • 10 comments

SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

dfitzmau avatar Mar 11 '25 16:03 dfitzmau

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [ ] SME has approved this change.
  • [ ] QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Mar 11 '25 16:03 openshift-ci-robot

🤖 Fri Jul 04 08:46:27 - Prow CI generated the docs preview:

https://90108--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.html https://90108--ocpdocs-pr.netlify.app/openshift-enterprise/latest/networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.html

ocpdocs-previewbot avatar Mar 11 '25 16:03 ocpdocs-previewbot

/retest

dfitzmau avatar Mar 13 '25 08:03 dfitzmau

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [ ] SME has approved this change.
  • [ ] QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Mar 13 '25 11:03 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Mar 13 '25 11:03 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar May 27 '25 10:05 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar May 27 '25 11:05 openshift-ci-robot

@dfitzmau can you please just add description, requirements, installation, use cases frrom https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created in the doc.

For installation we will need just need few more steps before the ansible-galaxy collection install network.offline_migration_sdn_to_ovnk:

# touch ansible.cfg

#cat << EOF >> ansible.cfg
[galaxy]
server_list = automation_hub, validated

[galaxy_server.automation_hub]
url=https://console.redhat.com/api/automation-hub/content/published/
auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
token=

#[galaxy_server.release_galaxy]
#url=https://galaxy.ansible.com/

[galaxy_server.validated]
url=https://console.redhat.com/api/automation-hub/content/validated/
auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
token=
EOF

Open ansible.cfg and populate token= field: To fetch the token: Navigate to https://cloud.redhat.com/ansible/automation-hub/token/. Click Load Token. Click copy icon to copy the API token to the clipboard. Paste the API token into a file and store in a secure location.

Where Ansible Collections Are Installed Ansible collections are installed in a specific directory based on your Ansible configuration and environment. The default path depends on the scope (system-wide or user-specific) and the Ansible version.

Default Installation Path By default, ansible-galaxy collection install places collections in the user-specific collections path unless otherwise specified. The default path is: ~/.ansible/collections/ansible_collections/

This directory is structured as: ~/.ansible/collections/ansible_collections//<collection_name>/

For example, installing network.offline_migration_sdn_to_ovnk:1.0.2 would create: ~/.ansible/collections/ansible_collections/network/offline_migration_sdn_to_ovnk/

miheer avatar Jun 30 '25 06:06 miheer

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jun 30 '25 11:06 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 01 '25 10:07 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 01 '25 10:07 openshift-ci-robot

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

High-priority PR as software is released. SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [ ] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 01 '25 10:07 openshift-ci-robot

/label peer-review-in-progress

michaelryanpeter avatar Jul 01 '25 19:07 michaelryanpeter

/lgtm

Meina-rh avatar Jul 03 '25 13:07 Meina-rh

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

High-priority PR as software is released. SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [] SME has approved this change [Miheer Salunke].
  • [x] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 03 '25 13:07 openshift-ci-robot

/lgtm

miheer avatar Jul 04 '25 01:07 miheer

@dfitzmau: This pull request references OSDOCS-12623 which is a valid jira issue.

In response to this:

High-priority PR as software is released. SDN Plugin was dropped from 4.17 onwards, so PR only targets 4.16 to 4.12.

Version(s): 4.12 to 4.16

Issue: OSDOCS-12623

Link to docs preview:

  • [x] SME has approved this change [Miheer Salunke].
  • [x] QE has approved this change.

Additional resources

  • 1
  • 2
  • [3] (https://console.redhat.com/ansible/automation-hub/repo/validated/network/offline_migration_sdn_to_ovnk/docs/?sort=-pulp_created)

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 04 '25 08:07 openshift-ci-robot

New changes are detected. LGTM label has been removed.

openshift-ci[bot] avatar Jul 04 '25 08:07 openshift-ci[bot]

@dfitzmau: 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.

openshift-ci[bot] avatar Jul 04 '25 08:07 openshift-ci[bot]

/cherrypick enterprise-4.15

dfitzmau avatar Jul 04 '25 09:07 dfitzmau

/cherrypick enterprise-4.14

dfitzmau avatar Jul 04 '25 09:07 dfitzmau

/cherrypick enterprise-4.13

dfitzmau avatar Jul 04 '25 09:07 dfitzmau

/cherrypick enterprise-4.12

dfitzmau avatar Jul 04 '25 09:07 dfitzmau

@dfitzmau: #90108 failed to apply on top of branch "enterprise-4.15":

Applying: OSDOCS-12623: Documented the Ansible playbook offline migration method
.git/rebase-apply/patch:31: trailing whitespace.
* `playbooks/playbook-migration.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the migration process. 
.git/rebase-apply/patch:32: trailing whitespace.
* `playbooks/playbook-rollback.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the rollback process. 
.git/rebase-apply/patch:103: trailing whitespace.
$ ansible-galaxy collection list | grep network.offline_migration_sdn_to_ovnk 
.git/rebase-apply/patch:133: trailing whitespace.
`migration_disable_auto_migration`:: Disables the auto-migration of OpenShift SDN CNI plug-in features to the OVN-Kubernetes plugin. If you disable auto-migration of features, you must also set the `migration_egress_ip`, `migration_egress_firewall`, and `migration_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
.git/rebase-apply/patch:160: trailing whitespace.
`rollback_disable_auto_migration`:: Disables the auto-migration of OVN-Kubernetes plug-in features to the OpenShift SDN CNI plug-in. If you disable auto-migration of features, you must also set the `rollback_egress_ip`, `rollback_egress_firewall`, and `rollback_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
warning: 5 lines add whitespace errors.
Using index info to reconstruct a base tree...
M	modules/nw-ovn-kubernetes-migration-about.adoc
M	networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
M	networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Falling back to patching base and 3-way merge...
Auto-merging networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Auto-merging networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
Auto-merging modules/nw-ovn-kubernetes-migration-about.adoc
CONFLICT (content): Merge conflict in modules/nw-ovn-kubernetes-migration-about.adoc
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS-12623: Documented the Ansible playbook offline migration method

In response to this:

/cherrypick enterprise-4.15

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.

@dfitzmau: #90108 failed to apply on top of branch "enterprise-4.14":

Applying: OSDOCS-12623: Documented the Ansible playbook offline migration method
.git/rebase-apply/patch:31: trailing whitespace.
* `playbooks/playbook-migration.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the migration process. 
.git/rebase-apply/patch:32: trailing whitespace.
* `playbooks/playbook-rollback.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the rollback process. 
.git/rebase-apply/patch:103: trailing whitespace.
$ ansible-galaxy collection list | grep network.offline_migration_sdn_to_ovnk 
.git/rebase-apply/patch:133: trailing whitespace.
`migration_disable_auto_migration`:: Disables the auto-migration of OpenShift SDN CNI plug-in features to the OVN-Kubernetes plugin. If you disable auto-migration of features, you must also set the `migration_egress_ip`, `migration_egress_firewall`, and `migration_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
.git/rebase-apply/patch:160: trailing whitespace.
`rollback_disable_auto_migration`:: Disables the auto-migration of OVN-Kubernetes plug-in features to the OpenShift SDN CNI plug-in. If you disable auto-migration of features, you must also set the `rollback_egress_ip`, `rollback_egress_firewall`, and `rollback_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
warning: 5 lines add whitespace errors.
Using index info to reconstruct a base tree...
M	modules/nw-ovn-kubernetes-migration-about.adoc
M	networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
M	networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Falling back to patching base and 3-way merge...
Auto-merging networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Auto-merging networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
Auto-merging modules/nw-ovn-kubernetes-migration-about.adoc
CONFLICT (content): Merge conflict in modules/nw-ovn-kubernetes-migration-about.adoc
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS-12623: Documented the Ansible playbook offline migration method

In response to this:

/cherrypick enterprise-4.14

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.

@dfitzmau: #90108 failed to apply on top of branch "enterprise-4.13":

Applying: OSDOCS-12623: Documented the Ansible playbook offline migration method
.git/rebase-apply/patch:31: trailing whitespace.
* `playbooks/playbook-migration.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the migration process. 
.git/rebase-apply/patch:32: trailing whitespace.
* `playbooks/playbook-rollback.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the rollback process. 
.git/rebase-apply/patch:103: trailing whitespace.
$ ansible-galaxy collection list | grep network.offline_migration_sdn_to_ovnk 
.git/rebase-apply/patch:133: trailing whitespace.
`migration_disable_auto_migration`:: Disables the auto-migration of OpenShift SDN CNI plug-in features to the OVN-Kubernetes plugin. If you disable auto-migration of features, you must also set the `migration_egress_ip`, `migration_egress_firewall`, and `migration_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
.git/rebase-apply/patch:160: trailing whitespace.
`rollback_disable_auto_migration`:: Disables the auto-migration of OVN-Kubernetes plug-in features to the OpenShift SDN CNI plug-in. If you disable auto-migration of features, you must also set the `rollback_egress_ip`, `rollback_egress_firewall`, and `rollback_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
warning: 5 lines add whitespace errors.
Using index info to reconstruct a base tree...
M	modules/nw-ovn-kubernetes-migration-about.adoc
M	networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
M	networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Falling back to patching base and 3-way merge...
Auto-merging networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Auto-merging networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
Auto-merging modules/nw-ovn-kubernetes-migration-about.adoc
CONFLICT (content): Merge conflict in modules/nw-ovn-kubernetes-migration-about.adoc
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS-12623: Documented the Ansible playbook offline migration method

In response to this:

/cherrypick enterprise-4.13

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.

@dfitzmau: #90108 failed to apply on top of branch "enterprise-4.12":

Applying: OSDOCS-12623: Documented the Ansible playbook offline migration method
.git/rebase-apply/patch:31: trailing whitespace.
* `playbooks/playbook-migration.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the migration process. 
.git/rebase-apply/patch:32: trailing whitespace.
* `playbooks/playbook-rollback.yml`: Includes playbooks that execute in a sequence where each playbook represents a step in the rollback process. 
.git/rebase-apply/patch:103: trailing whitespace.
$ ansible-galaxy collection list | grep network.offline_migration_sdn_to_ovnk 
.git/rebase-apply/patch:133: trailing whitespace.
`migration_disable_auto_migration`:: Disables the auto-migration of OpenShift SDN CNI plug-in features to the OVN-Kubernetes plugin. If you disable auto-migration of features, you must also set the `migration_egress_ip`, `migration_egress_firewall`, and `migration_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
.git/rebase-apply/patch:160: trailing whitespace.
`rollback_disable_auto_migration`:: Disables the auto-migration of OVN-Kubernetes plug-in features to the OpenShift SDN CNI plug-in. If you disable auto-migration of features, you must also set the `rollback_egress_ip`, `rollback_egress_firewall`, and `rollback_multicast` parameters to `false`. If you need to enable auto-migration of features, set the parameter to `false`. 
warning: 5 lines add whitespace errors.
Using index info to reconstruct a base tree...
M	modules/nw-ovn-kubernetes-migration-about.adoc
M	networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
M	networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Falling back to patching base and 3-way merge...
Auto-merging networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/rollback-to-openshift-sdn.adoc
Auto-merging networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
CONFLICT (content): Merge conflict in networking/ovn_kubernetes_network_provider/migrate-from-openshift-sdn.adoc
Auto-merging modules/nw-ovn-kubernetes-migration-about.adoc
CONFLICT (content): Merge conflict in modules/nw-ovn-kubernetes-migration-about.adoc
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 OSDOCS-12623: Documented the Ansible playbook offline migration method

In response to this:

/cherrypick enterprise-4.12

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.