mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-11-09 10:19:16 +00:00
1 line
12 KiB
JavaScript
1 line
12 KiB
JavaScript
"use strict";(self.webpackChunkrancher_docs=self.webpackChunkrancher_docs||[]).push([[78404],{3905:(e,t,n)=>{n.d(t,{Zo:()=>u,kt:()=>d});var a=n(67294);function r(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function o(e,t){var n=Object.keys(e);if(Object.getOwnPropertySymbols){var a=Object.getOwnPropertySymbols(e);t&&(a=a.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),n.push.apply(n,a)}return n}function l(e){for(var t=1;t<arguments.length;t++){var n=null!=arguments[t]?arguments[t]:{};t%2?o(Object(n),!0).forEach((function(t){r(e,t,n[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(n)):o(Object(n)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(n,t))}))}return e}function i(e,t){if(null==e)return{};var n,a,r=function(e,t){if(null==e)return{};var n,a,r={},o=Object.keys(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||(r[n]=e[n]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(a=0;a<o.length;a++)n=o[a],t.indexOf(n)>=0||Object.prototype.propertyIsEnumerable.call(e,n)&&(r[n]=e[n])}return r}var s=a.createContext({}),p=function(e){var t=a.useContext(s),n=t;return e&&(n="function"==typeof e?e(t):l(l({},t),e)),n},u=function(e){var t=p(e.components);return a.createElement(s.Provider,{value:t},e.children)},c={inlineCode:"code",wrapper:function(e){var t=e.children;return a.createElement(a.Fragment,{},t)}},m=a.forwardRef((function(e,t){var n=e.components,r=e.mdxType,o=e.originalType,s=e.parentName,u=i(e,["components","mdxType","originalType","parentName"]),m=p(n),d=r,k=m["".concat(s,".").concat(d)]||m[d]||c[d]||o;return n?a.createElement(k,l(l({ref:t},u),{},{components:n})):a.createElement(k,l({ref:t},u))}));function d(e,t){var n=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=n.length,l=new Array(o);l[0]=m;var i={};for(var s in t)hasOwnProperty.call(t,s)&&(i[s]=t[s]);i.originalType=e,i.mdxType="string"==typeof e?e:r,l[1]=i;for(var p=2;p<o;p++)l[p]=n[p];return a.createElement.apply(null,l)}return a.createElement.apply(null,n)}m.displayName="MDXCreateElement"},92523:(e,t,n)=>{n.r(t),n.d(t,{assets:()=>s,contentTitle:()=>l,default:()=>c,frontMatter:()=>o,metadata:()=>i,toc:()=>p});var a=n(87462),r=(n(67294),n(3905));const o={title:"Manual Quick Start"},l=void 0,i={unversionedId:"getting-started/quick-start-guides/deploy-rancher-manager/helm-cli",id:"version-2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli",title:"Manual Quick Start",description:"Howdy Partner! This tutorial walks you through:",source:"@site/versioned_docs/version-2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli.md",sourceDirName:"getting-started/quick-start-guides/deploy-rancher-manager",slug:"/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli",permalink:"/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli",draft:!1,editUrl:"https://github.com/rancher/rancher-docs/edit/main/versioned_docs/version-2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli.md",tags:[],version:"2.5",lastUpdatedAt:1663953084,formattedLastUpdatedAt:"Sep 23, 2022",frontMatter:{title:"Manual Quick Start"},sidebar:"tutorialSidebar",previous:{title:"Vagrant Quick Start",permalink:"/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/vagrant"},next:{title:"Deploying Workloads",permalink:"/v2.5/pages-for-subheaders/deploy-rancher-workloads"}},s={},p=[{value:"2. Install Rancher",id:"2-install-rancher",level:3},{value:"3. Log In",id:"3-log-in",level:3},{value:"4. Create the Cluster",id:"4-create-the-cluster",level:3},{value:"Finished",id:"finished",level:4},{value:"What's Next?",id:"whats-next",level:4}],u={toc:p};function c(e){let{components:t,...n}=e;return(0,r.kt)("wrapper",(0,a.Z)({},u,n,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"Howdy Partner! This tutorial walks you through:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"Installation of Rancher 2.x"),(0,r.kt)("li",{parentName:"ul"},"Creation of your first cluster"),(0,r.kt)("li",{parentName:"ul"},"Deployment of an application, Nginx")),(0,r.kt)("blockquote",null,(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"Note:")," The intent of these guides is to quickly launch a sandbox that you can use to evaluate Rancher. These guides are not intended for production environments. For comprehensive setup instructions, see ",(0,r.kt)("a",{parentName:"p",href:"/v2.5/pages-for-subheaders/installation-and-upgrade"},"Installation"),".")),(0,r.kt)("br",null),"### 1. Provision a Linux Host",(0,r.kt)("p",null," Begin creation of a custom cluster by provisioning a Linux host. Your host can be:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"A cloud-host virtual machine (VM)")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"An on-prem VM")),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("p",{parentName:"li"},"A bare-metal server"),(0,r.kt)("blockquote",{parentName:"li"},(0,r.kt)("p",{parentName:"blockquote"},(0,r.kt)("strong",{parentName:"p"},"Note:"),"\nWhen using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host's documentation for information regarding port configuration."),(0,r.kt)("p",{parentName:"blockquote"},"For a full list of port requirements, refer to ",(0,r.kt)("a",{parentName:"p",href:"/v2.5/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/node-requirements-for-rancher-managed-clusters"},"Docker Installation"),".")),(0,r.kt)("p",{parentName:"li"},"Provision the host according to our ",(0,r.kt)("a",{parentName:"p",href:"/v2.5/pages-for-subheaders/installation-requirements"},"Requirements"),"."))),(0,r.kt)("h3",{id:"2-install-rancher"},"2. Install Rancher"),(0,r.kt)("p",null,"To install Rancher on your host, connect to it and then use a shell to install."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"From your shell, enter the following command:"),(0,r.kt)("pre",{parentName:"li"},(0,r.kt)("code",{parentName:"pre"},"sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher\n")))),(0,r.kt)("p",null,(0,r.kt)("strong",{parentName:"p"},"Result:")," Rancher is installed."),(0,r.kt)("h3",{id:"3-log-in"},"3. Log In"),(0,r.kt)("p",null,"Log in to Rancher to begin using the application. After you log in, you'll make some one-time configurations."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Open a web browser and enter the IP address of your host: ",(0,r.kt)("inlineCode",{parentName:"p"},"https://<SERVER_IP>"),"."),(0,r.kt)("p",{parentName:"li"},"Replace ",(0,r.kt)("inlineCode",{parentName:"p"},"<SERVER_IP>")," with your host IP address.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"When prompted, create a password for the default ",(0,r.kt)("inlineCode",{parentName:"p"},"admin")," account there cowpoke!")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Set the ",(0,r.kt)("strong",{parentName:"p"},"Default View"),"."))),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},"If ",(0,r.kt)("inlineCode",{parentName:"li"},"I want to create or manage multiple clusters")," is selected, the Cluster Manager UI is used as the default view."),(0,r.kt)("li",{parentName:"ul"},"If ",(0,r.kt)("inlineCode",{parentName:"li"},"I'm only going to use the cluster Rancher was installed on")," is selected, the Cluster Explorer UI is used as the default view.")),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},"Set the ",(0,r.kt)("strong",{parentName:"li"},"Rancher Server URL"),". The URL can either be an IP address or a host name. However, each node added to your cluster must be able to connect to this URL.",(0,r.kt)("br",null),(0,r.kt)("br",null),"If you use a hostname in the URL, this hostname must be resolvable by DNS on the nodes you want to add to you cluster.")),(0,r.kt)("br",null),(0,r.kt)("h3",{id:"4-create-the-cluster"},"4. Create the Cluster"),(0,r.kt)("p",null,"Welcome to Rancher! You are now able to create your first Kubernetes cluster."),(0,r.kt)("p",null,"In this task, you can use the versatile ",(0,r.kt)("strong",{parentName:"p"},"Custom")," option. This option lets you add ",(0,r.kt)("em",{parentName:"p"},"any")," Linux host (cloud-hosted VM, on-prem VM, or bare-metal) to be used in a cluster."),(0,r.kt)("ol",null,(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"If you chose ",(0,r.kt)("inlineCode",{parentName:"p"},"I'm only going to use the cluster Rancher was installed on")," when setting the default view, click the ",(0,r.kt)("strong",{parentName:"p"},"Cluster Manager")," button in the upper-right of the UI to access the ",(0,r.kt)("strong",{parentName:"p"},"Clusters")," page.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"From the ",(0,r.kt)("strong",{parentName:"p"},"Clusters")," page, click ",(0,r.kt)("strong",{parentName:"p"},"Add Cluster"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Choose ",(0,r.kt)("strong",{parentName:"p"},"Existing Nodes"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Enter a ",(0,r.kt)("strong",{parentName:"p"},"Cluster Name"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Skip ",(0,r.kt)("strong",{parentName:"p"},"Member Roles")," and ",(0,r.kt)("strong",{parentName:"p"},"Cluster Options"),". We'll tell you about them later.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Click ",(0,r.kt)("strong",{parentName:"p"},"Next"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"From ",(0,r.kt)("strong",{parentName:"p"},"Node Role"),", select ",(0,r.kt)("em",{parentName:"p"},"all")," the roles: ",(0,r.kt)("strong",{parentName:"p"},"etcd"),", ",(0,r.kt)("strong",{parentName:"p"},"Control"),", and ",(0,r.kt)("strong",{parentName:"p"},"Worker"),".")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},(0,r.kt)("strong",{parentName:"p"},"Optional"),": Rancher auto-detects the IP addresses used for Rancher communication and cluster communication. You can override these using ",(0,r.kt)("inlineCode",{parentName:"p"},"Public Address")," and ",(0,r.kt)("inlineCode",{parentName:"p"},"Internal Address")," in the ",(0,r.kt)("strong",{parentName:"p"},"Node Address")," section.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Skip the ",(0,r.kt)("strong",{parentName:"p"},"Labels")," stuff. It's not important for now.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Copy the command displayed on screen to your clipboard.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. Run the command copied to your clipboard.")),(0,r.kt)("li",{parentName:"ol"},(0,r.kt)("p",{parentName:"li"},"When you finish running the command on your Linux host, click ",(0,r.kt)("strong",{parentName:"p"},"Done"),"."))),(0,r.kt)("p",null,(0,r.kt)("strong",{parentName:"p"},"Result:")),(0,r.kt)("p",null,"Your cluster is created and assigned a state of ",(0,r.kt)("strong",{parentName:"p"},"Provisioning.")," Rancher is standing up your cluster."),(0,r.kt)("p",null,"You can access your cluster after its state is updated to ",(0,r.kt)("strong",{parentName:"p"},"Active.")),(0,r.kt)("p",null,(0,r.kt)("strong",{parentName:"p"},"Active")," clusters are assigned two Projects:"),(0,r.kt)("ul",null,(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"Default"),", containing the ",(0,r.kt)("inlineCode",{parentName:"li"},"default")," namespace"),(0,r.kt)("li",{parentName:"ul"},(0,r.kt)("inlineCode",{parentName:"li"},"System"),", containing the ",(0,r.kt)("inlineCode",{parentName:"li"},"cattle-system"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"ingress-nginx"),", ",(0,r.kt)("inlineCode",{parentName:"li"},"kube-public"),", and ",(0,r.kt)("inlineCode",{parentName:"li"},"kube-system")," namespaces")),(0,r.kt)("h4",{id:"finished"},"Finished"),(0,r.kt)("p",null,"Congratulations! You have created your first cluster."),(0,r.kt)("h4",{id:"whats-next"},"What's Next?"),(0,r.kt)("p",null,"Use Rancher to create a deployment. For more information, see ",(0,r.kt)("a",{parentName:"p",href:"/v2.5/pages-for-subheaders/deploy-rancher-workloads"},"Creating Deployments"),"."))}c.isMDXComponent=!0}}]); |