This commit is contained in:
github-actions[bot]
2023-09-13 22:26:03 +00:00
parent 3e121711a7
commit 87177160de
2120 changed files with 4349 additions and 4406 deletions
+2 -2
View File
@@ -12,7 +12,7 @@
<script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js" charset="UTF-8" data-domain-script="0f98beb0-fc4c-417d-a42e-564e2cae42d2" async></script>
<script src="/scripts/optanonwrapper.js" async></script><link rel="stylesheet" href="/assets/css/styles.efd70281.css">
<link rel="preload" href="/assets/js/runtime~main.bfc92d4f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.61c797db.js" as="script">
<link rel="preload" href="/assets/js/main.7c8ccb50.js" as="script">
</head>
<body class="navigation-with-keyboard">
@@ -20,7 +20,7 @@
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--light_HNdA"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate"></b></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/">Latest</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/">Latest</a></li><li><a class="dropdown__link" href="/v2.7">v2.7</a></li><li><a class="dropdown__link" href="/v2.6">v2.6</a></li><li><a class="dropdown__link" href="/v2.5">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4">v2.0-v2.4</a></li><li><a class="dropdown__link" href="/versions">All versions</a></li></ul></div></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_nlXk"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/404" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/404" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh">简体中文</a></li></ul></div><a href="https://github.com/rancher/rancher-docs" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link navbar__github">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><a href="https://www.rancher.com" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link">Rancher Home<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a><div class="searchBox_ZlJk"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0"><main class="container margin-vert--xl"><div class="row"><div class="col col--6 col--offset-3"><h1 class="hero__title">Page Not Found</h1><p>We could not find what you were looking for.</p><p>Please contact the owner of the site that linked you to the original URL and let them know their link is broken.</p></div></div></main></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2023 SUSE Rancher. All Rights Reserved.</div></div></div></footer></div>
<script src="/assets/js/runtime~main.bfc92d4f.js"></script>
<script src="/assets/js/runtime~main.61c797db.js"></script>
<script src="/assets/js/main.7c8ccb50.js"></script>
</body>
</html>
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.6/pages-for-subheaders/enable-experimental-features.md",
"tags": [],
"version": "2.6",
"lastUpdatedAt": 1692817960,
"formattedLastUpdatedAt": "Aug 23, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Enabling Experimental Features"
},
@@ -352,8 +352,8 @@ const toc = [
level: 3
},
{
value: 'Rendering the Helm Chart for Air Gap Installations',
id: 'rendering-the-helm-chart-for-air-gap-installations',
value: 'Enabling Features for Air Gap Installs',
id: 'enabling-features-for-air-gap-installs',
level: 3
},
{
@@ -447,14 +447,13 @@ function MDXContent(_param) {
}, `If you are installing an alpha version, Helm requires adding the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `--devel`), ` option to the command.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rendering-the-helm-chart-for-air-gap-installations"
}, `Rendering the Helm Chart for Air Gap Installations`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `For an air gap installation of Rancher, you need to add a Helm chart repository and render a Helm template before installing Rancher with Helm. For details, refer to the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
"id": "enabling-features-for-air-gap-installs"
}, `Enabling Features for Air Gap Installs`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To perform an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
parentName: "p",
"href": "/v2.6/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha"
}, `air gap installation documentation.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Here is an example of a command for passing in the feature flag names when rendering the Helm template. In the below example, two features are enabled by passing the feature flag names in a comma separated list.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `The Helm command is as follows:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
}, `air gap installation of Rancher`), `, add a Helm chart repository and download a Helm chart, then install Rancher with Helm.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `When you install the Helm chart, you should pass in feature flag names in a comma separated list, as in the following example:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm install rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.7/pages-for-subheaders/enable-experimental-features.md",
"tags": [],
"version": "2.7",
"lastUpdatedAt": 1692817960,
"formattedLastUpdatedAt": "Aug 23, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Enabling Experimental Features"
},
@@ -352,8 +352,8 @@ const toc = [
level: 3
},
{
value: 'Rendering the Helm Chart for Air Gap Installations',
id: 'rendering-the-helm-chart-for-air-gap-installations',
value: 'Enabling Features for Air Gap Installs',
id: 'enabling-features-for-air-gap-installs',
level: 3
},
{
@@ -451,14 +451,13 @@ function MDXContent(_param) {
}, `If you are installing an alpha version, Helm requires adding the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `--devel`), ` option to the command.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rendering-the-helm-chart-for-air-gap-installations"
}, `Rendering the Helm Chart for Air Gap Installations`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `For an air gap installation of Rancher, you need to add a Helm chart repository and render a Helm template before installing Rancher with Helm. For details, refer to the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
"id": "enabling-features-for-air-gap-installs"
}, `Enabling Features for Air Gap Installs`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To perform an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
parentName: "p",
"href": "/v2.7/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha"
}, `air gap installation documentation.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Here is an example of a command for passing in the feature flag names when rendering the Helm template. In the below example, two features are enabled by passing the feature flag names in a comma separated list.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `The Helm command is as follows:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
}, `air gap installation of Rancher`), `, add a Helm chart repository and download a Helm chart, then install Rancher with Helm.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `When you install the Helm chart, you should pass in feature flag names in a comma separated list, as in the following example:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm install rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -308,13 +308,13 @@ function _object_without_properties_loose(source, excluded) {
const frontMatter = {
title: 'Rendering the Helm Template in an Air-Gapped Environment'
title: 'Upgrading in an Air-Gapped Environment'
};
const contentTitle = undefined;
const metadata = {
"unversionedId": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"id": "version-2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"description": "These instructions assume you have already followed the instructions for a Kubernetes upgrade on this page, including the prerequisites, up until step 3. Upgrade Rancher.",
"source": "@site/versioned_docs/version-2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"sourceDirName": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster",
@@ -324,10 +324,10 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"tags": [],
"version": "2.7",
"lastUpdatedAt": 1686095509,
"formattedLastUpdatedAt": "Jun 6, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Rendering the Helm Template in an Air-Gapped Environment"
"title": "Upgrading in an Air-Gapped Environment"
},
"sidebar": "tutorialSidebar",
"previous": {
@@ -342,8 +342,8 @@ const metadata = {
const assets = {};
const toc = [
{
value: 'Rancher Helm Template Options',
id: 'rancher-helm-template-options',
value: 'Rancher Helm Upgrade Options',
id: 'rancher-helm-upgrade-options',
level: 3
},
{
@@ -356,11 +356,6 @@ const toc = [
id: 'option-b-certificates-from-files-using-kubernetes-secrets',
level: 3
},
{
value: 'Apply the Rendered Templates',
id: 'apply-the-rendered-templates',
level: 3
},
{
value: 'Verify the Upgrade',
id: 'verify-the-upgrade',
@@ -394,8 +389,8 @@ function MDXContent(_param) {
parentName: "p",
"href": "/v2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades"
}, `this page,`), ` including the prerequisites, up until step 3. Upgrade Rancher.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rancher-helm-template-options"
}, `Rancher Helm Template Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Render the Rancher template using the same chosen options that were used when installing Rancher. Use the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
"id": "rancher-helm-upgrade-options"
}, `Rancher Helm Upgrade Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To upgrade with Helm, apply the same options that you used when installing Rancher. Refer to the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
parentName: "table"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("tr", {
parentName: "thead"
@@ -451,8 +446,7 @@ function MDXContent(_param) {
"id": "option-a-default-self-signed-certificate"
}, `Option A: Default Self-signed Certificate`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set certmanager.version=<CERTMANAGER_VERSION> \\
@@ -464,8 +458,7 @@ function MDXContent(_param) {
}, `Option B: Certificates from Files using Kubernetes Secrets`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -479,8 +472,7 @@ function MDXContent(_param) {
}, `--set ingress.tls.source=secret`), `:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -488,14 +480,6 @@ function MDXContent(_param) {
--set privateCA=true \\
--set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \\ # Set a default private registry to be used in Rancher
--set useBundledSystemChart=true # Use the packaged Rancher system charts
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "apply-the-rendered-templates"
}, `Apply the Rendered Templates`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the rendered manifest directories to a system with access to the Rancher server cluster and apply the rendered templates.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Use `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `kubectl`), ` to apply the rendered manifests.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl -n cattle-system apply -R -f ./rancher
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h2", {
"id": "verify-the-upgrade"
}, `Verify the Upgrade`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Log into Rancher to confirm that the upgrade succeeded.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/docs/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha.md",
"tags": [],
"version": "current",
"lastUpdatedAt": 1688405692,
"formattedLastUpdatedAt": "Jul 3, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "4. Install Rancher"
},
@@ -691,11 +691,9 @@ helm repo update
"id": "4-install-rancher"
}, `4. Install Rancher`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the fetched charts to a system that has access to the Rancher server cluster to complete installation.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h5", {
"id": "1-install-cert-manager"
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the options you would like to use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the same options you would use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `image.repository`), ` option to pull the image from your private registry. This will create a `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `cert-manager`), ` directory with the Kubernetes manifest files.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
}, `image.repository`), ` option to pull the image from your private registry.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
"type": "note"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
parentName: "admonition"
@@ -723,7 +721,7 @@ helm repo update
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl apply -f cert-manager/cert-manager-crd.yaml
}, `kubectl apply -f cert-manager-crd.yaml
`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("li", {
parentName: "ol"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -331,7 +331,7 @@ const metadata = {
},
"sidebar": "tutorialSidebar",
"previous": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
},
"next": {
@@ -335,7 +335,7 @@ const metadata = {
"permalink": "/v2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/rollbacks"
},
"next": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/v2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
}
};
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/docs/pages-for-subheaders/enable-experimental-features.md",
"tags": [],
"version": "current",
"lastUpdatedAt": 1692817960,
"formattedLastUpdatedAt": "Aug 23, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Enabling Experimental Features"
},
@@ -352,8 +352,8 @@ const toc = [
level: 3
},
{
value: 'Rendering the Helm Chart for Air Gap Installations',
id: 'rendering-the-helm-chart-for-air-gap-installations',
value: 'Enabling Features for Air Gap Installs',
id: 'enabling-features-for-air-gap-installs',
level: 3
},
{
@@ -451,14 +451,13 @@ function MDXContent(_param) {
}, `If you are installing an alpha version, Helm requires adding the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `--devel`), ` option to the command.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rendering-the-helm-chart-for-air-gap-installations"
}, `Rendering the Helm Chart for Air Gap Installations`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `For an air gap installation of Rancher, you need to add a Helm chart repository and render a Helm template before installing Rancher with Helm. For details, refer to the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
"id": "enabling-features-for-air-gap-installs"
}, `Enabling Features for Air Gap Installs`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To perform an `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("a", {
parentName: "p",
"href": "/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha"
}, `air gap installation documentation.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Here is an example of a command for passing in the feature flag names when rendering the Helm template. In the below example, two features are enabled by passing the feature flag names in a comma separated list.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `The Helm command is as follows:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
}, `air gap installation of Rancher`), `, add a Helm chart repository and download a Helm chart, then install Rancher with Helm.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `When you install the Helm chart, you should pass in feature flag names in a comma separated list, as in the following example:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm install rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -335,7 +335,7 @@ const metadata = {
"permalink": "/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/rollbacks"
},
"next": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
}
};
@@ -331,7 +331,7 @@ const metadata = {
},
"sidebar": "tutorialSidebar",
"previous": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/v2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
},
"next": {
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -331,7 +331,7 @@ const metadata = {
},
"sidebar": "tutorialSidebar",
"previous": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/v2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
},
"next": {
@@ -308,13 +308,13 @@ function _object_without_properties_loose(source, excluded) {
const frontMatter = {
title: 'Rendering the Helm Template in an Air-Gapped Environment'
title: 'Upgrading in an Air-Gapped Environment'
};
const contentTitle = undefined;
const metadata = {
"unversionedId": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"id": "version-2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"description": "These instructions assume you have already followed the instructions for a Kubernetes upgrade on this page, including the prerequisites, up until step 3. Upgrade Rancher.",
"source": "@site/versioned_docs/version-2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"sourceDirName": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster",
@@ -324,10 +324,10 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"tags": [],
"version": "2.6",
"lastUpdatedAt": 1685111429,
"formattedLastUpdatedAt": "May 26, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Rendering the Helm Template in an Air-Gapped Environment"
"title": "Upgrading in an Air-Gapped Environment"
},
"sidebar": "tutorialSidebar",
"previous": {
@@ -342,8 +342,8 @@ const metadata = {
const assets = {};
const toc = [
{
value: 'Rancher Helm Template Options',
id: 'rancher-helm-template-options',
value: 'Rancher Helm Upgrade Options',
id: 'rancher-helm-upgrade-options',
level: 3
},
{
@@ -356,11 +356,6 @@ const toc = [
id: 'option-b-certificates-from-files-using-kubernetes-secrets',
level: 3
},
{
value: 'Apply the Rendered Templates',
id: 'apply-the-rendered-templates',
level: 3
},
{
value: 'Verify the Upgrade',
id: 'verify-the-upgrade',
@@ -394,8 +389,8 @@ function MDXContent(_param) {
parentName: "p",
"href": "/v2.6/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades"
}, `this page,`), ` including the prerequisites, up until step 3. Upgrade Rancher.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rancher-helm-template-options"
}, `Rancher Helm Template Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Render the Rancher template using the same chosen options that were used when installing Rancher. Use the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
"id": "rancher-helm-upgrade-options"
}, `Rancher Helm Upgrade Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To upgrade with Helm, apply the same options that you used when installing Rancher. Refer to the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
parentName: "table"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("tr", {
parentName: "thead"
@@ -451,8 +446,7 @@ function MDXContent(_param) {
"id": "option-a-default-self-signed-certificate"
}, `Option A: Default Self-signed Certificate`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set certmanager.version=<CERTMANAGER_VERSION> \\
@@ -464,8 +458,7 @@ function MDXContent(_param) {
}, `Option B: Certificates from Files using Kubernetes Secrets`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -479,8 +472,7 @@ function MDXContent(_param) {
}, `--set ingress.tls.source=secret`), `:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -488,14 +480,6 @@ function MDXContent(_param) {
--set privateCA=true \\
--set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \\ # Set a default private registry to be used in Rancher
--set useBundledSystemChart=true # Use the packaged Rancher system charts
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "apply-the-rendered-templates"
}, `Apply the Rendered Templates`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the rendered manifest directories to a system with access to the Rancher server cluster and apply the rendered templates.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Use `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `kubectl`), ` to apply the rendered manifests.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl -n cattle-system apply -R -f ./rancher
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h2", {
"id": "verify-the-upgrade"
}, `Verify the Upgrade`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Log into Rancher to confirm that the upgrade succeeded.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.7/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha.md",
"tags": [],
"version": "2.7",
"lastUpdatedAt": 1688405692,
"formattedLastUpdatedAt": "Jul 3, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "4. Install Rancher"
},
@@ -691,11 +691,9 @@ helm repo update
"id": "4-install-rancher"
}, `4. Install Rancher`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the fetched charts to a system that has access to the Rancher server cluster to complete installation.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h5", {
"id": "1-install-cert-manager"
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the options you would like to use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the same options you would use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `image.repository`), ` option to pull the image from your private registry. This will create a `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `cert-manager`), ` directory with the Kubernetes manifest files.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
}, `image.repository`), ` option to pull the image from your private registry.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
"type": "note"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
parentName: "admonition"
@@ -723,7 +721,7 @@ helm repo update
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl apply -f cert-manager/cert-manager-crd.yaml
}, `kubectl apply -f cert-manager-crd.yaml
`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("li", {
parentName: "ol"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
@@ -308,13 +308,13 @@ function _object_without_properties_loose(source, excluded) {
const frontMatter = {
title: 'Rendering the Helm Template in an Air-Gapped Environment'
title: 'Upgrading in an Air-Gapped Environment'
};
const contentTitle = undefined;
const metadata = {
"unversionedId": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"id": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades",
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"description": "These instructions assume you have already followed the instructions for a Kubernetes upgrade on this page, including the prerequisites, up until step 3. Upgrade Rancher.",
"source": "@site/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"sourceDirName": "getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster",
@@ -324,10 +324,10 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/docs/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades.md",
"tags": [],
"version": "current",
"lastUpdatedAt": 1686178389,
"formattedLastUpdatedAt": "Jun 7, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "Rendering the Helm Template in an Air-Gapped Environment"
"title": "Upgrading in an Air-Gapped Environment"
},
"sidebar": "tutorialSidebar",
"previous": {
@@ -342,8 +342,8 @@ const metadata = {
const assets = {};
const toc = [
{
value: 'Rancher Helm Template Options',
id: 'rancher-helm-template-options',
value: 'Rancher Helm Upgrade Options',
id: 'rancher-helm-upgrade-options',
level: 3
},
{
@@ -356,11 +356,6 @@ const toc = [
id: 'option-b-certificates-from-files-using-kubernetes-secrets',
level: 3
},
{
value: 'Apply the Rendered Templates',
id: 'apply-the-rendered-templates',
level: 3
},
{
value: 'Verify the Upgrade',
id: 'verify-the-upgrade',
@@ -394,8 +389,8 @@ function MDXContent(_param) {
parentName: "p",
"href": "/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/upgrades"
}, `this page,`), ` including the prerequisites, up until step 3. Upgrade Rancher.`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "rancher-helm-template-options"
}, `Rancher Helm Template Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Render the Rancher template using the same chosen options that were used when installing Rancher. Use the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
"id": "rancher-helm-upgrade-options"
}, `Rancher Helm Upgrade Options`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `To upgrade with Helm, apply the same options that you used when installing Rancher. Refer to the reference table below to replace each placeholder. Rancher needs to be configured to use the private registry in order to provision any Rancher launched Kubernetes clusters or Rancher tools.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Based on the choice you made during installation, complete one of the procedures below.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("table", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("thead", {
parentName: "table"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("tr", {
parentName: "thead"
@@ -451,8 +446,7 @@ function MDXContent(_param) {
"id": "option-a-default-self-signed-certificate"
}, `Option A: Default Self-signed Certificate`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set certmanager.version=<CERTMANAGER_VERSION> \\
@@ -464,8 +458,7 @@ function MDXContent(_param) {
}, `Option B: Certificates from Files using Kubernetes Secrets`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -479,8 +472,7 @@ function MDXContent(_param) {
}, `--set ingress.tls.source=secret`), `:`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `helm template rancher ./rancher-<VERSION>.tgz --output-dir . \\
--no-hooks \\ # prevent files for Helm hooks from being generated
}, `helm upgrade rancher ./rancher-<VERSION>.tgz \\
--namespace cattle-system \\
--set hostname=<RANCHER.YOURDOMAIN.COM> \\
--set rancherImage=<REGISTRY.YOURDOMAIN.COM:PORT>/rancher/rancher \\
@@ -488,14 +480,6 @@ function MDXContent(_param) {
--set privateCA=true \\
--set systemDefaultRegistry=<REGISTRY.YOURDOMAIN.COM:PORT> \\ # Set a default private registry to be used in Rancher
--set useBundledSystemChart=true # Use the packaged Rancher system charts
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h3", {
"id": "apply-the-rendered-templates"
}, `Apply the Rendered Templates`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the rendered manifest directories to a system with access to the Rancher server cluster and apply the rendered templates.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Use `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `kubectl`), ` to apply the rendered manifests.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("pre", null, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl -n cattle-system apply -R -f ./rancher
`)), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h2", {
"id": "verify-the-upgrade"
}, `Verify the Upgrade`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Log into Rancher to confirm that the upgrade succeeded.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
@@ -324,8 +324,8 @@ const metadata = {
"editUrl": "https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.6/getting-started/installation-and-upgrade/other-installation-methods/air-gapped-helm-cli-install/install-rancher-ha.md",
"tags": [],
"version": "2.6",
"lastUpdatedAt": 1685717408,
"formattedLastUpdatedAt": "Jun 2, 2023",
"lastUpdatedAt": 1694642522,
"formattedLastUpdatedAt": "Sep 13, 2023",
"frontMatter": {
"title": "4. Install Rancher"
},
@@ -684,11 +684,9 @@ helm repo update
"id": "4-install-rancher"
}, `4. Install Rancher`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Copy the fetched charts to a system that has access to the Rancher server cluster to complete installation.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("h5", {
"id": "1-install-cert-manager"
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the options you would like to use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
}, `1. Install Cert-Manager`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", null, `Install cert-manager with the same options you would use to install the chart. Remember to set the `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `image.repository`), ` option to pull the image from your private registry. This will create a `, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("inlineCode", {
parentName: "p"
}, `cert-manager`), ` directory with the Kubernetes manifest files.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
}, `image.repository`), ` option to pull the image from your private registry.`), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("admonition", {
"type": "note"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
parentName: "admonition"
@@ -716,7 +714,7 @@ helm repo update
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("code", {
parentName: "pre",
"className": "language-plain"
}, `kubectl apply -f cert-manager/cert-manager-crd.yaml
}, `kubectl apply -f cert-manager-crd.yaml
`))), /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("li", {
parentName: "ol"
}, /*#__PURE__*/ (0,_mdx_js_react__WEBPACK_IMPORTED_MODULE_1__/* .mdx */ .kt)("p", {
@@ -335,7 +335,7 @@ const metadata = {
"permalink": "/v2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/rollbacks"
},
"next": {
"title": "Rendering the Helm Template in an Air-Gapped Environment",
"title": "Upgrading in an Air-Gapped Environment",
"permalink": "/v2.7/getting-started/installation-and-upgrade/install-upgrade-on-a-kubernetes-cluster/air-gapped-upgrades"
}
};
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+2 -2
View File
File diff suppressed because one or more lines are too long
+2 -2
View File
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+2 -2
View File
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
+2 -2
View File
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long

Some files were not shown because too many files have changed in this diff Show More