mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-11-09 10:19:16 +00:00
1 line
9.9 KiB
JavaScript
1 line
9.9 KiB
JavaScript
"use strict";(self.webpackChunkrancher_docs=self.webpackChunkrancher_docs||[]).push([[30951],{3905:(e,t,a)=>{a.d(t,{Zo:()=>u,kt:()=>m});var n=a(67294);function r(e,t,a){return t in e?Object.defineProperty(e,t,{value:a,enumerable:!0,configurable:!0,writable:!0}):e[t]=a,e}function o(e,t){var a=Object.keys(e);if(Object.getOwnPropertySymbols){var n=Object.getOwnPropertySymbols(e);t&&(n=n.filter((function(t){return Object.getOwnPropertyDescriptor(e,t).enumerable}))),a.push.apply(a,n)}return a}function i(e){for(var t=1;t<arguments.length;t++){var a=null!=arguments[t]?arguments[t]:{};t%2?o(Object(a),!0).forEach((function(t){r(e,t,a[t])})):Object.getOwnPropertyDescriptors?Object.defineProperties(e,Object.getOwnPropertyDescriptors(a)):o(Object(a)).forEach((function(t){Object.defineProperty(e,t,Object.getOwnPropertyDescriptor(a,t))}))}return e}function s(e,t){if(null==e)return{};var a,n,r=function(e,t){if(null==e)return{};var a,n,r={},o=Object.keys(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||(r[a]=e[a]);return r}(e,t);if(Object.getOwnPropertySymbols){var o=Object.getOwnPropertySymbols(e);for(n=0;n<o.length;n++)a=o[n],t.indexOf(a)>=0||Object.prototype.propertyIsEnumerable.call(e,a)&&(r[a]=e[a])}return r}var c=n.createContext({}),l=function(e){var t=n.useContext(c),a=t;return e&&(a="function"==typeof e?e(t):i(i({},t),e)),a},u=function(e){var t=l(e.components);return n.createElement(c.Provider,{value:t},e.children)},d={inlineCode:"code",wrapper:function(e){var t=e.children;return n.createElement(n.Fragment,{},t)}},p=n.forwardRef((function(e,t){var a=e.components,r=e.mdxType,o=e.originalType,c=e.parentName,u=s(e,["components","mdxType","originalType","parentName"]),p=l(a),m=r,h=p["".concat(c,".").concat(m)]||p[m]||d[m]||o;return a?n.createElement(h,i(i({ref:t},u),{},{components:a})):n.createElement(h,i({ref:t},u))}));function m(e,t){var a=arguments,r=t&&t.mdxType;if("string"==typeof e||r){var o=a.length,i=new Array(o);i[0]=p;var s={};for(var c in t)hasOwnProperty.call(t,c)&&(s[c]=t[c]);s.originalType=e,s.mdxType="string"==typeof e?e:r,i[1]=s;for(var l=2;l<o;l++)i[l]=a[l];return n.createElement.apply(null,i)}return n.createElement.apply(null,a)}p.displayName="MDXCreateElement"},11750:(e,t,a)=>{a.r(t),a.d(t,{assets:()=>c,contentTitle:()=>i,default:()=>d,frontMatter:()=>o,metadata:()=>s,toc:()=>l});var n=a(87462),r=(a(67294),a(3905));const o={title:"EC2 Machine Configuration Reference"},i=void 0,s={unversionedId:"reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2",id:"reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2",title:"EC2 Machine Configuration Reference",description:"For more details about EC2 nodes, refer to the official documentation for the EC2 Management Console.",source:"@site/docs/reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2.md",sourceDirName:"reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration",slug:"/reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2",permalink:"/reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2",draft:!1,editUrl:"https://github.com/rancher/rancher-docs/edit/main/docs/reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/amazon-ec2.md",tags:[],version:"current",lastUpdatedAt:1663953084,formattedLastUpdatedAt:"Sep 23, 2022",frontMatter:{title:"EC2 Machine Configuration Reference"},sidebar:"tutorialSidebar",previous:{title:"Machine Configuration",permalink:"/pages-for-subheaders/machine-configuration"},next:{title:"DigitalOcean Machine Configuration",permalink:"/reference-guides/cluster-configuration/downstream-cluster-configuration/machine-configuration/digitalocean"}},c={},l=[{value:"Region",id:"region",level:3},{value:"Zone",id:"zone",level:3},{value:"Instance Type",id:"instance-type",level:3},{value:"Root Disk Size",id:"root-disk-size",level:3},{value:"VPC/Subnet",id:"vpcsubnet",level:3},{value:"IAM Instance Profile Name",id:"iam-instance-profile-name",level:3},{value:"Advanced Options",id:"advanced-options",level:2},{value:"AMI ID",id:"ami-id",level:3},{value:"SSH Username for AMI",id:"ssh-username-for-ami",level:3},{value:"Security Group",id:"security-group",level:3},{value:"EBS Root Volume Type",id:"ebs-root-volume-type",level:3},{value:"Encrypt EBS Volume",id:"encrypt-ebs-volume",level:3},{value:"Request Spot Instance",id:"request-spot-instance",level:3},{value:"Use only private address",id:"use-only-private-address",level:3},{value:"EBS-Optimized Instance",id:"ebs-optimized-instance",level:3},{value:"Allow access to EC2 metadata",id:"allow-access-to-ec2-metadata",level:3},{value:"Use tokens for metadata",id:"use-tokens-for-metadata",level:3},{value:"Add Tag",id:"add-tag",level:3}],u={toc:l};function d(e){let{components:t,...a}=e;return(0,r.kt)("wrapper",(0,n.Z)({},u,a,{components:t,mdxType:"MDXLayout"}),(0,r.kt)("p",null,"For more details about EC2 nodes, refer to the official documentation for the ",(0,r.kt)("a",{parentName:"p",href:"https://aws.amazon.com/ec2"},"EC2 Management Console"),"."),(0,r.kt)("h3",{id:"region"},"Region"),(0,r.kt)("p",null,"The geographical ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html"},"region")," in which to build your cluster."),(0,r.kt)("h3",{id:"zone"},"Zone"),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-availability-zones"},"zone"),", an isolated location within a region to build your cluster"),(0,r.kt)("h3",{id:"instance-type"},"Instance Type"),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html"},"instance type"),", which determines the hardware characteristics, used to provision your cluster."),(0,r.kt)("h3",{id:"root-disk-size"},"Root Disk Size"),(0,r.kt)("p",null,"Configure the size (in GB) for your ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/RootDeviceStorage.html"},"root device"),"."),(0,r.kt)("h3",{id:"vpcsubnet"},"VPC/Subnet"),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/vpc/latest/userguide/configure-your-vpc.html"},"VPC")," or specific ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/vpc/latest/userguide/configure-subnets.html"},"subnet"),", an IP range in your VPC, to add your resources to."),(0,r.kt)("h3",{id:"iam-instance-profile-name"},"IAM Instance Profile Name"),(0,r.kt)("p",null,"The name of the ","[instance profile]"," used to pass an IAM role to an EC2 instance."),(0,r.kt)("h2",{id:"advanced-options"},"Advanced Options"),(0,r.kt)("h3",{id:"ami-id"},"AMI ID"),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html"},"Amazon Machine Image")," used for the nodes in your cluster."),(0,r.kt)("h3",{id:"ssh-username-for-ami"},"SSH Username for AMI"),(0,r.kt)("p",null,"The username for connecting to your launched instances. Refer to ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connection-prereqs.html"},"here")," for the default usernames to selected AMIs. For AMIs not listed, check with the AMI provider."),(0,r.kt)("h3",{id:"security-group"},"Security Group"),(0,r.kt)("p",null,"Choose the default security group or configure a security group."),(0,r.kt)("p",null,"Please refer to ",(0,r.kt)("a",{parentName:"p",href:"/getting-started/installation-and-upgrade/installation-requirements/port-requirements#rancher-aws-ec2-security-group"},"Amazon EC2 security group when using Node Driver")," to see what rules are created in the ",(0,r.kt)("inlineCode",{parentName:"p"},"rancher-nodes")," Security Group."),(0,r.kt)("h3",{id:"ebs-root-volume-type"},"EBS Root Volume Type"),(0,r.kt)("p",null,"The ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-volume-types.html"},"EBS volume type")," to use for the root device."),(0,r.kt)("h3",{id:"encrypt-ebs-volume"},"Encrypt EBS Volume"),(0,r.kt)("p",null,"Enable ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSEncryption.html"},"Amazon EBS Encryption"),"."),(0,r.kt)("h3",{id:"request-spot-instance"},"Request Spot Instance"),(0,r.kt)("p",null,"Enable option to ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-requests.html"},"request spot instances")," and specify the maximum instance price per hour you're willing to pay."),(0,r.kt)("h3",{id:"use-only-private-address"},"Use only private address"),(0,r.kt)("p",null,"Enable option on use only ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-instance-addressing.html"},"private addresses"),"."),(0,r.kt)("h3",{id:"ebs-optimized-instance"},"EBS-Optimized Instance"),(0,r.kt)("p",null,"Use an ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-optimized.html"},"EBS-optimized instance"),"."),(0,r.kt)("h3",{id:"allow-access-to-ec2-metadata"},"Allow access to EC2 metadata"),(0,r.kt)("p",null,"Enable access to ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html"},"EC2 metadata"),"."),(0,r.kt)("h3",{id:"use-tokens-for-metadata"},"Use tokens for metadata"),(0,r.kt)("p",null,"Use ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html"},"Instance Metadata Service Version 2 (IMDSv2)"),", a token-based method to access metadata."),(0,r.kt)("h3",{id:"add-tag"},"Add Tag"),(0,r.kt)("p",null,"Add metadata using ",(0,r.kt)("a",{parentName:"p",href:"https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html"},"tags")," to categorize resources."))}d.isMDXComponent=!0}}]); |