deploy: eda6da5c7f

2026-09-25 12:38:05 +00:00 · 2024-04-09 21:36:11 +00:00
parent 40c5e16c26
commit 8942f82ef9
2574 changed files with 10333 additions and 10303 deletions
@@ -324,8 +324,8 @@ const metadata = {
    "editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.8/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster.md",
    "tags": [],
    "version": "2.8",
-    "lastUpdatedAt": 1707851107,
-    "formattedLastUpdatedAt": "Feb 13, 2024",
+    "lastUpdatedAt": 1712697092,
+    "formattedLastUpdatedAt": "Apr 9, 2024",
    "frontMatter": {
        "title": "Migrating Rancher to a New Cluster"
    },
@@ -365,6 +365,11 @@ const toc = [
        value: '4. Bring up Rancher with Helm',
        id: '4-bring-up-rancher-with-helm',
        level: 3
+    },
+    {
+        value: '5. Redirect Traffic to the New Cluster',
+        id: '5-redirect-traffic-to-the-new-cluster',
+        level: 3
    }
 ];
 const layoutProps = {
@@ -460,14 +465,14 @@ helm install rancher-backup rancher-charts/rancher-backup -n cattle-resources-sy
        parentName: "admonition"
    }, `For an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("strong", {
        parentName: "p"
-    }, `air-gapped environment`), `, use the Helm value below to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
+    }, `air-gapped environment`), `, use the following Helm value to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
        parentName: "p"
-    }, `backup-restore-operator`), ` image from your private registry when installing the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
+    }, `backup-restore-operator`), ` image from your private registry when you install the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
        parentName: "admonition"
    }, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
        parentName: "pre",
        "className": "language-bash"
-    }, `--set image.repository $REGISTRY/rancher/backup-restore-operator
+    }, `--set image.repository <registry>/rancher/backup-restore-operator
 `))))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
        "id": "2-restore-from-backup-using-a-restore-custom-resource"
    }, `2. Restore from backup using a Restore custom resource`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -690,7 +695,9 @@ spec:
        parentName: "pre",
        "className": "language-bash"
    }, `helm install rancher rancher-latest/rancher -n cattle-system -f rancher-values.yaml --version x.y.z
-`))));
+`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
+        "id": "5-redirect-traffic-to-the-new-cluster"
+    }, `5. Redirect Traffic to the New Cluster`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `After migration completes, update your DNS records and any load balancers, so that traffic is routed correctly to the migrated cluster. Remember that you must use the same hostname that was set as the server URL in the original cluster.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Full instructions on how to redirect traffic to the migrated cluster differ based on your specific environment. Refer to your hosting provider's documentation for more details.`));
 }
 MDXContent.isMDXComponent = true;

@@ -324,8 +324,8 @@ const metadata = {
    "editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.6/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster.md",
    "tags": [],
    "version": "2.6",
-    "lastUpdatedAt": 1707851107,
-    "formattedLastUpdatedAt": "Feb 13, 2024",
+    "lastUpdatedAt": 1712697092,
+    "formattedLastUpdatedAt": "Apr 9, 2024",
    "frontMatter": {
        "title": "Migrating Rancher to a New Cluster"
    },
@@ -365,6 +365,11 @@ const toc = [
        value: '4. Bring up Rancher with Helm',
        id: '4-bring-up-rancher-with-helm',
        level: 3
+    },
+    {
+        value: '5. Redirect Traffic to the New Cluster',
+        id: '5-redirect-traffic-to-the-new-cluster',
+        level: 3
    }
 ];
 const layoutProps = {
@@ -460,14 +465,14 @@ helm install rancher-backup rancher-charts/rancher-backup -n cattle-resources-sy
        parentName: "admonition"
    }, `For an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("strong", {
        parentName: "p"
-    }, `air-gapped environment`), `, use the Helm value below to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
+    }, `air-gapped environment`), `, use the following Helm value to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
        parentName: "p"
-    }, `backup-restore-operator`), ` image from your private registry when installing the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
+    }, `backup-restore-operator`), ` image from your private registry when you install the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
        parentName: "admonition"
    }, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
        parentName: "pre",
        "className": "language-bash"
-    }, `--set image.repository $REGISTRY/rancher/backup-restore-operator
+    }, `--set image.repository <registry>/rancher/backup-restore-operator
 `))))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
        "id": "2-restore-from-backup-using-a-restore-custom-resource"
    }, `2. Restore from backup using a Restore custom resource`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -686,7 +691,9 @@ spec:
        parentName: "pre",
        "className": "language-bash"
    }, `helm install rancher rancher-latest/rancher -n cattle-system -f rancher-values.yaml --version x.y.z
-`))));
+`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
+        "id": "5-redirect-traffic-to-the-new-cluster"
+    }, `5. Redirect Traffic to the New Cluster`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `After migration completes, update your DNS records and any load balancers, so that traffic is routed correctly to the migrated cluster. Remember that you must use the same hostname that was set as the server URL in the original cluster.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Full instructions on how to redirect traffic to the migrated cluster differ based on your specific environment. Refer to your hosting provider's documentation for more details.`));
 }
 MDXContent.isMDXComponent = true;

@@ -324,8 +324,8 @@ const metadata = {
    "editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.7/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster.md",
    "tags": [],
    "version": "2.7",
-    "lastUpdatedAt": 1707851107,
-    "formattedLastUpdatedAt": "Feb 13, 2024",
+    "lastUpdatedAt": 1712697092,
+    "formattedLastUpdatedAt": "Apr 9, 2024",
    "frontMatter": {
        "title": "Migrating Rancher to a New Cluster"
    },
@@ -365,6 +365,11 @@ const toc = [
        value: '4. Bring up Rancher with Helm',
        id: '4-bring-up-rancher-with-helm',
        level: 3
+    },
+    {
+        value: '5. Redirect Traffic to the New Cluster',
+        id: '5-redirect-traffic-to-the-new-cluster',
+        level: 3
    }
 ];
 const layoutProps = {
@@ -460,14 +465,14 @@ helm install rancher-backup rancher-charts/rancher-backup -n cattle-resources-sy
        parentName: "admonition"
    }, `For an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("strong", {
        parentName: "p"
-    }, `air-gapped environment`), `, use the Helm value below to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
+    }, `air-gapped environment`), `, use the following Helm value to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
        parentName: "p"
-    }, `backup-restore-operator`), ` image from your private registry when installing the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
+    }, `backup-restore-operator`), ` image from your private registry when you install the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
        parentName: "admonition"
    }, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
        parentName: "pre",
        "className": "language-bash"
-    }, `--set image.repository $REGISTRY/rancher/backup-restore-operator
+    }, `--set image.repository <registry>/rancher/backup-restore-operator
 `))))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
        "id": "2-restore-from-backup-using-a-restore-custom-resource"
    }, `2. Restore from backup using a Restore custom resource`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -690,7 +695,9 @@ spec:
        parentName: "pre",
        "className": "language-bash"
    }, `helm install rancher rancher-latest/rancher -n cattle-system -f rancher-values.yaml --version x.y.z
-`))));
+`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
+        "id": "5-redirect-traffic-to-the-new-cluster"
+    }, `5. Redirect Traffic to the New Cluster`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `After migration completes, update your DNS records and any load balancers, so that traffic is routed correctly to the migrated cluster. Remember that you must use the same hostname that was set as the server URL in the original cluster.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Full instructions on how to redirect traffic to the migrated cluster differ based on your specific environment. Refer to your hosting provider's documentation for more details.`));
 }
 MDXContent.isMDXComponent = true;

@@ -324,8 +324,8 @@ const metadata = {
    "editUrl": "https://github.com/rancher/rancher-docs/edit/main/docs/how-to-guides/new-user-guides/backup-restore-and-disaster-recovery/migrate-rancher-to-new-cluster.md",
    "tags": [],
    "version": "current",
-    "lastUpdatedAt": 1707851107,
-    "formattedLastUpdatedAt": "Feb 13, 2024",
+    "lastUpdatedAt": 1712697092,
+    "formattedLastUpdatedAt": "Apr 9, 2024",
    "frontMatter": {
        "title": "Migrating Rancher to a New Cluster"
    },
@@ -365,6 +365,11 @@ const toc = [
        value: '4. Bring up Rancher with Helm',
        id: '4-bring-up-rancher-with-helm',
        level: 3
+    },
+    {
+        value: '5. Redirect Traffic to the New Cluster',
+        id: '5-redirect-traffic-to-the-new-cluster',
+        level: 3
    }
 ];
 const layoutProps = {
@@ -390,7 +395,9 @@ function MDXContent(_param) {
        "type": "caution"
    }, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
        parentName: "admonition"
-    }, `It is required to use the same hostname that was set as the server URL in the first cluster. If not done, downstream clusters will show as unavailable in the cluster management page of the UI, and you won't be able to click inside the cluster or on the cluster's `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("b", null, `Explore`), ` button.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Rancher version must be v2.5.0 and up`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Rancher can be installed on any Kubernetes cluster, including hosted Kubernetes clusters such as Amazon EKS clusters. For help installing Kubernetes, refer to the documentation of the Kubernetes distribution. A Rancher-created Kubernetes distributions such as, but not limited to, `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
+    }, `You must use the same hostname that was set as the server URL in the original cluster. If you don't, downstream clusters will show as unavailable in the cluster management page of the UI, and you won't be able to click inside the cluster or on the cluster's `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("strong", {
+        parentName: "p"
+    }, `Explore`), ` button.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Rancher version must be v2.5.0 and up`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Rancher can be installed on any Kubernetes cluster, including hosted Kubernetes clusters such as Amazon EKS clusters. For help installing Kubernetes, refer to the documentation of the Kubernetes distribution. A Rancher-created Kubernetes distributions such as, but not limited to, `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
        parentName: "p",
        "href": "https://rke.docs.rancher.com/installation"
    }, `RKE`), ` or `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
@@ -460,14 +467,14 @@ helm install rancher-backup rancher-charts/rancher-backup -n cattle-resources-sy
        parentName: "admonition"
    }, `For an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("strong", {
        parentName: "p"
-    }, `air-gapped environment`), `, use the Helm value below to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
+    }, `air-gapped environment`), `, use the following Helm value to pull the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
        parentName: "p"
-    }, `backup-restore-operator`), ` image from your private registry when installing the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
+    }, `backup-restore-operator`), ` image from your private registry when you install the rancher-backup Helm chart.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", {
        parentName: "admonition"
    }, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
        parentName: "pre",
        "className": "language-bash"
-    }, `--set image.repository $REGISTRY/rancher/backup-restore-operator
+    }, `--set image.repository <registry>/rancher/backup-restore-operator
 `))))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
        "id": "2-restore-from-backup-using-a-restore-custom-resource"
    }, `2. Restore from backup using a Restore custom resource`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -690,7 +697,9 @@ spec:
        parentName: "pre",
        "className": "language-bash"
    }, `helm install rancher rancher-latest/rancher -n cattle-system -f rancher-values.yaml --version x.y.z
-`))));
+`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
+        "id": "5-redirect-traffic-to-the-new-cluster"
+    }, `5. Redirect Traffic to the New Cluster`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `After migration completes, update your DNS records and any load balancers, so that traffic is routed correctly to the migrated cluster. Remember that you must use the same hostname that was set as the server URL in the original cluster.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Full instructions on how to redirect traffic to the migrated cluster differ based on your specific environment. Refer to your hosting provider's documentation for more details.`));
 }
 MDXContent.isMDXComponent = true;

--- a/Show More
+++ b/Show More