Files
rancher-docs/assets/js/e829d8bf.185d19b5.js
T

1 line
6.9 KiB
JavaScript

"use strict";(self.webpackChunkrancher_docs=self.webpackChunkrancher_docs||[]).push([[68970],{3905:(e,n,t)=>{t.d(n,{Zo:()=>c,kt:()=>m});var r=t(67294);function a(e,n,t){return n in e?Object.defineProperty(e,n,{value:t,enumerable:!0,configurable:!0,writable:!0}):e[n]=t,e}function o(e,n){var t=Object.keys(e);if(Object.getOwnPropertySymbols){var r=Object.getOwnPropertySymbols(e);n&&(r=r.filter((function(n){return Object.getOwnPropertyDescriptor(e,n).enumerable}))),t.push.apply(t,r)}return t}function i(e){for(var n=1;n<arguments.length;n++){var t=null!=arguments[n]?arguments[n]:{};n%2?o(Object(t),!0).forEach((function(n){a(e,n,t[n])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(t)):o(Object(t)).forEach((function(n){Object.defineProperty(e,n,Object.getOwnPropertyDescriptor(t,n))}))}return e}function l(e,n){if(null==e)return{};var t,r,a=function(e,n){if(null==e)return{};var t,r,a={},o=Object.keys(e);for(r=0;r<o.length;r++)t=o[r],n.indexOf(t)>=0||(a[t]=e[t]);return a}(e,n);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(r=0;r<o.length;r++)t=o[r],n.indexOf(t)>=0||Object.prototype.propertyIsEnumerable.call(e,t)&&(a[t]=e[t])}return a}var s=r.createContext({}),u=function(e){var n=r.useContext(s),t=n;return e&&(t="function"==typeof e?e(n):i(i({},n),e)),t},c=function(e){var n=u(e.components);return r.createElement(s.Provider,{value:n},e.children)},p={inlineCode:"code",wrapper:function(e){var n=e.children;return r.createElement(r.Fragment,{},n)}},d=r.forwardRef((function(e,n){var t=e.components,a=e.mdxType,o=e.originalType,s=e.parentName,c=l(e,["components","mdxType","originalType","parentName"]),d=u(t),m=a,h=d["".concat(s,".").concat(m)]||d[m]||p[m]||o;return t?r.createElement(h,i(i({ref:n},c),{},{components:t})):r.createElement(h,i({ref:n},c))}));function m(e,n){var t=arguments,a=n&&n.mdxType;if("string"==typeof e||a){var o=t.length,i=new Array(o);i[0]=d;var l={};for(var s in n)hasOwnProperty.call(n,s)&&(l[s]=n[s]);l.originalType=e,l.mdxType="string"==typeof e?e:a,i[1]=l;for(var u=2;u<o;u++)i[u]=t[u];return r.createElement.apply(null,i)}return r.createElement.apply(null,t)}d.displayName="MDXCreateElement"},83209:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>s,contentTitle:()=>i,default:()=>p,frontMatter:()=>o,metadata:()=>l,toc:()=>u});var r=t(87462),a=(t(67294),t(3905));const o={title:"Running on ARM64 (Experimental)"},i=void 0,l={unversionedId:"how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64",id:"how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64",title:"Running on ARM64 (Experimental)",description:"Running on an ARM64 platform is currently an experimental feature and is not yet officially supported in Rancher. Therefore, we do not recommend using ARM64 based nodes in a production environment.",source:"@site/docs/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64.md",sourceDirName:"how-to-guides/advanced-user-guides/enable-experimental-features",slug:"/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64",permalink:"/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64",draft:!1,editUrl:"https://github.com/rancher/rancher-docs/edit/main/docs/how-to-guides/advanced-user-guides/enable-experimental-features/rancher-on-arm64.md",tags:[],version:"current",lastUpdatedAt:1666730466,formattedLastUpdatedAt:"Oct 25, 2022",frontMatter:{title:"Running on ARM64 (Experimental)"},sidebar:"tutorialSidebar",previous:{title:"Enabling Experimental Features",permalink:"/pages-for-subheaders/enable-experimental-features"},next:{title:"Allow Unsupported Storage Drivers",permalink:"/how-to-guides/advanced-user-guides/enable-experimental-features/unsupported-storage-drivers"}},s={},u=[],c={toc:u};function p(e){let{components:n,...t}=e;return(0,a.kt)("wrapper",(0,r.Z)({},c,t,{components:n,mdxType:"MDXLayout"}),(0,a.kt)("admonition",{type:"caution"},(0,a.kt)("p",{parentName:"admonition"},"Running on an ARM64 platform is currently an experimental feature and is not yet officially supported in Rancher. Therefore, we do not recommend using ARM64 based nodes in a production environment.")),(0,a.kt)("p",null,"The following options are available when using an ARM64 platform:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},(0,a.kt)("p",{parentName:"li"},"Running Rancher on ARM64 based node(s)"),(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},"Only for Docker Install. Please note that the following installation command replaces the examples found in the ",(0,a.kt)("a",{parentName:"li",href:"/pages-for-subheaders/rancher-on-a-single-node-with-docker"},"Docker Install link"),":")),(0,a.kt)("pre",{parentName:"li"},(0,a.kt)("code",{parentName:"pre"},'# In the last line `rancher/rancher:vX.Y.Z`, be certain to replace "X.Y.Z" with a released version in which ARM64 builds exist. For example, if your matching version is v2.5.8, you would fill in this line with `rancher/rancher:v2.5.8`.\ndocker run -d --restart=unless-stopped \\\n -p 80:80 -p 443:443 \\\n --privileged \\\n rancher/rancher:vX.Y.Z\n')))),(0,a.kt)("admonition",{type:"note"},(0,a.kt)("p",{parentName:"admonition"},"To check if your specific released version is compatible with the ARM64 architecture, you may navigate to your\nversion's release notes in the following two ways:"),(0,a.kt)("ul",{parentName:"admonition"},(0,a.kt)("li",{parentName:"ul"},"Manually find your version using ",(0,a.kt)("a",{parentName:"li",href:"https://github.com/rancher/rancher/releases"},"https://github.com/rancher/rancher/releases"),"."),(0,a.kt)("li",{parentName:"ul"},"Go directly to your version using the tag and the specific version number. If you plan to use v2.5.8, for example, you may navigate to ",(0,a.kt)("a",{parentName:"li",href:"https://github.com/rancher/rancher/releases/tag/v2.5.8"},"https://github.com/rancher/rancher/releases/tag/v2.5.8"),"."))),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"Create custom cluster and adding ARM64 based node(s)",(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},"Kubernetes cluster version must be 1.12 or higher"),(0,a.kt)("li",{parentName:"ul"},"CNI Network Provider must be ",(0,a.kt)("a",{parentName:"li",href:"/faq/container-network-interface-providers#flannel"},"Flannel")))),(0,a.kt)("li",{parentName:"ul"},"Importing clusters that contain ARM64 based nodes",(0,a.kt)("ul",{parentName:"li"},(0,a.kt)("li",{parentName:"ul"},"Kubernetes cluster version must be 1.12 or higher")))),(0,a.kt)("p",null,"Please see ",(0,a.kt)("a",{parentName:"p",href:"cluster-provisioning/rke-clusters/options/"},"Cluster Options")," how to configure the cluster options."),(0,a.kt)("p",null,"The following features are not tested:"),(0,a.kt)("ul",null,(0,a.kt)("li",{parentName:"ul"},"Monitoring, alerts, notifiers, pipelines and logging"),(0,a.kt)("li",{parentName:"ul"},"Launching apps from the catalog")))}p.isMDXComponent=!0}}]);