This commit is contained in:
github-actions[bot] committed 2023-02-24 00:05:50 +00:00
1 parent 2c57f83a55
commit 3ea1b85e61
3320 files changed
+6634 -6634

No files matched your search

@@ -10,7 +10,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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
@@ -19,7 +19,7 @@
Deploying to Amazon AWS will incur charges.</p></blockquote><ul><li><a href="https://aws.amazon.com/account/" target="_blank" rel="noopener noreferrer">Amazon AWS Account</a>: An Amazon AWS Account is required to create resources for deploying Rancher and Kubernetes.</li><li><a href="https://docs.aws.amazon.com/general/latest/gr/managing-aws-access-keys.html" target="_blank" rel="noopener noreferrer">Amazon AWS Access Key</a>: Use this link to follow a tutorial to create an Amazon AWS Access Key if you don&#x27;t have one yet.</li><li><a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-start" target="_blank" rel="noopener noreferrer">IAM Policy created</a>: Defines the permissions an account attached with this policy has.</li><li>Install <a href="https://www.terraform.io/downloads.html" target="_blank" rel="noopener noreferrer">Terraform</a>: Used to provision the server and cluster in Amazon AWS.</li></ul><h3 class="anchor anchorWithStickyNavbar_LWe7" id="example-iam-policy">Example IAM Policy<a class="hash-link" href="#example-iam-policy" title="Direct link to heading">​</a></h3><p>The AWS module just creates an EC2 KeyPair, an EC2 SecurityGroup and an EC2 instance. A simple policy would be:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">{</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> &quot;Version&quot;: &quot;2012-10-17&quot;,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> &quot;Statement&quot;: [</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> {</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> &quot;Effect&quot;: &quot;Allow&quot;,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> &quot;Action&quot;: &quot;ec2:*&quot;,</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> &quot;Resource&quot;: &quot;*&quot;</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> }</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"> ]</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><h2 class="anchor anchorWithStickyNavbar_LWe7" id="getting-started">Getting Started<a class="hash-link" href="#getting-started" title="Direct link to heading">​</a></h2><ol><li><p>Clone <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Rancher Quickstart</a> to a folder using <code>git clone https://github.com/rancher/quickstart</code>.</p></li><li><p>Go into the AWS folder containing the Terraform files by executing <code>cd quickstart/rancher/aws</code>.</p></li><li><p>Rename the <code>terraform.tfvars.example</code> file to <code>terraform.tfvars</code>.</p></li><li><p>Edit <code>terraform.tfvars</code> and customize the following variables:</p><ul><li><code>aws_access_key</code> - Amazon AWS Access Key</li><li><code>aws_secret_key</code> - Amazon AWS Secret Key</li><li><code>rancher_server_admin_password</code> - Admin password for created Rancher server</li></ul></li><li><p><strong>Optional:</strong> Modify optional variables within <code>terraform.tfvars</code>.
See the <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Quickstart Readme</a> and the <a href="https://github.com/rancher/quickstart/tree/master/rancher/aws" target="_blank" rel="noopener noreferrer">AWS Quickstart Readme</a> for more information.
Suggestions include:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `aws_region` - Amazon AWS region, choose the closest instead of the default (`us-east-1`)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `prefix` - Prefix for all created resources</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `instance_type` - EC2 instance size used, minimum is `t3a.medium` but `t3a.large` or `t3a.xlarge` could be used if within budget</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `add_windows_node` - If true, an additional Windows worker node is added to the workload cluster</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Run <code>terraform init</code>.</p></li><li><p>To initiate the creation of the environment, run <code>terraform apply --auto-approve</code>. Then wait for output similar to the following:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Apply complete! Resources: 16 added, 0 changed, 0 destroyed.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Outputs:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_node_ip = xx.xx.xx.xx</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_server_url = https://rancher.xx.xx.xx.xx.sslip.io</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">workload_node_ip = yy.yy.yy.yy</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Paste the <code>rancher_server_url</code> from the output above into the browser. Log in when prompted (default username is <code>admin</code>, use the password set in <code>rancher_server_admin_password</code>).</p></li><li><p>ssh to the Rancher server using the <code>id_rsa</code> key generated in <code>quickstart/rancher/aws</code>.</p></li></ol><h4 class="anchor anchorWithStickyNavbar_LWe7" id="result">Result<a class="hash-link" href="#result" title="Direct link to heading">​</a></h4><p>Two Kubernetes clusters are deployed into your AWS account, one running Rancher Server and the other ready for experimentation deployments. Please note that while this setup is a great way to explore Rancher functionality, a production setup should follow our high availability setup guidelines. SSH keys for the VMs are auto-generated and stored in the module directory.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="whats-next">What&#x27;s Next?<a class="hash-link" href="#whats-next" title="Direct link to heading">​</a></h3><p>Use Rancher to create a deployment. For more information, see <a href="/v2.5/pages-for-subheaders/deploy-rancher-workloads">Creating Deployments</a>.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="destroying-the-environment">Destroying the Environment<a class="hash-link" href="#destroying-the-environment" title="Direct link to heading">​</a></h2><ol><li><p>From the <code>quickstart/rancher/aws</code> folder, execute <code>terraform destroy --auto-appLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,7 +10,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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
@@ -19,7 +19,7 @@
Deploying to Microsoft Azure will incur charges.</p></blockquote><ul><li><a href="https://azure.microsoft.com/en-us/free/" target="_blank" rel="noopener noreferrer">Microsoft Azure Account</a>: A Microsoft Azure Account is required to create resources for deploying Rancher and Kubernetes.</li><li><a href="https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/create-subscription#create-a-subscription-in-the-azure-portal" target="_blank" rel="noopener noreferrer">Microsoft Azure Subscription</a>: Use this link to follow a tutorial to create a Microsoft Azure subscription if you don&#x27;t have one yet.</li><li><a href="https://docs.microsoft.com/en-us/azure/active-directory/develop/quickstart-create-new-tenant" target="_blank" rel="noopener noreferrer">Micsoroft Azure Tenant</a>: Use this link and follow instructions to create a Microsoft Azure tenant.</li><li><a href="https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal" target="_blank" rel="noopener noreferrer">Microsoft Azure Client ID/Secret</a>: Use this link and follow instructions to create a Microsoft Azure client and secret.</li><li><a href="https://www.terraform.io/downloads.html" target="_blank" rel="noopener noreferrer">Terraform</a>: Used to provision the server and cluster in Microsoft Azure.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="getting-started">Getting Started<a class="hash-link" href="#getting-started" title="Direct link to heading">​</a></h2><ol><li><p>Clone <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Rancher Quickstart</a> to a folder using <code>git clone https://github.com/rancher/quickstart</code>.</p></li><li><p>Go into the Azure folder containing the Terraform files by executing <code>cd quickstart/rancher/azure</code>.</p></li><li><p>Rename the <code>terraform.tfvars.example</code> file to <code>terraform.tfvars</code>.</p></li><li><p>Edit <code>terraform.tfvars</code> and customize the following variables:</p><ul><li><code>azure_subscription_id</code> - Microsoft Azure Subscription ID</li><li><code>azure_client_id</code> - Microsoft Azure Client ID</li><li><code>azure_client_secret</code> - Microsoft Azure Client Secret</li><li><code>azure_tenant_id</code> - Microsoft Azure Tenant ID</li><li><code>rancher_server_admin_password</code> - Admin password for created Rancher server</li></ul></li><li><p><strong>Optional:</strong> Modify optional variables within <code>terraform.tfvars</code>.
See the <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Quickstart Readme</a> and the <a href="https://github.com/rancher/quickstart/tree/master/rancher/azure" target="_blank" rel="noopener noreferrer">Azure Quickstart Readme</a> for more information.
Suggestions include:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `azure_location` - Microsoft Azure region, choose the closest instead of the default (`East US`)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `prefix` - Prefix for all created resources</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `instance_type` - Compute instance size used, minimum is `Standard_DS2_v2` but `Standard_DS2_v3` or `Standard_DS3_v2` could be used if within budget</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `add_windows_node` - If true, an additional Windows worker node is added to the workload cluster</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `windows_admin_password` - The admin password of the windows worker node</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Run <code>terraform init</code>.</p></li><li><p>To initiate the creation of the environment, run <code>terraform apply --auto-approve</code>. Then wait for output similar to the following:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Apply complete! Resources: 16 added, 0 changed, 0 destroyed.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Outputs:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_node_ip = xx.xx.xx.xx</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_server_url = https://rancher.xx.xx.xx.xx.sslip.io</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">workload_node_ip = yy.yy.yy.yy</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Paste the <code>rancher_server_url</code> from the output above into the browser. Log in when prompted (default username is <code>admin</code>, use the password set in <code>rancher_server_admin_password</code>).</p></li><li><p>ssh to the Rancher Server using the <code>id_rsa</code> key generated in <code>quickstart/rancher/azure</code>.</p></li></ol><h4 class="anchor anchorWithStickyNavbar_LWe7" id="result">Result<a class="hash-link" href="#result" title="Direct link to heading">​</a></h4><p>Two Kubernetes clusters are deployed into your Azure account, one running Rancher Server and the other ready for experimentation deployments. Please note that while this setup is a great way to explore Rancher functionality, a production setup should follow our high availability setup guidelines. SSH keys for the VMs are auto-generated and stored in the module directory.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="whats-next">What&#x27;s Next?<a class="hash-link" href="#whats-next" title="Direct link to heading">​</a></h3><p>Use Rancher to create a deployment. For more information, see <a href="/v2.5/pages-for-subheaders/deploy-rancher-workloads">Creating Deployments</a>.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="destroying-the-environment">Destroying the Environment<a class=Line truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,7 +10,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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
@@ -19,7 +19,7 @@
Deploying to DigitalOcean will incur charges.</p></blockquote><ul><li><a href="https://www.digitalocean.com" target="_blank" rel="noopener noreferrer">DigitalOcean Account</a>: You will require an account on DigitalOcean as this is where the server and cluster will run.</li><li><a href="https://www.digitalocean.com/community/tutorials/how-to-create-a-digitalocean-space-and-api-key" target="_blank" rel="noopener noreferrer">DigitalOcean Access Key</a>: Use this link to create a DigitalOcean Access Key if you don&#x27;t have one.</li><li><a href="https://www.terraform.io/downloads.html" target="_blank" rel="noopener noreferrer">Terraform</a>: Used to provision the server and cluster to DigitalOcean.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="getting-started">Getting Started<a class="hash-link" href="#getting-started" title="Direct link to heading">​</a></h2><ol><li><p>Clone <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Rancher Quickstart</a> to a folder using <code>git clone https://github.com/rancher/quickstart</code>.</p></li><li><p>Go into the DigitalOcean folder containing the Terraform files by executing <code>cd quickstart/rancher/do</code>.</p></li><li><p>Rename the <code>terraform.tfvars.example</code> file to <code>terraform.tfvars</code>.</p></li><li><p>Edit <code>terraform.tfvars</code> and customize the following variables:</p><ul><li><code>do_token</code> - DigitalOcean access key</li><li><code>rancher_server_admin_password</code> - Admin password for created Rancher server</li></ul></li><li><p><strong>Optional:</strong> Modify optional variables within <code>terraform.tfvars</code>.
See the <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Quickstart Readme</a> and the <a href="https://github.com/rancher/quickstart/tree/master/rancher/do" target="_blank" rel="noopener noreferrer">DO Quickstart Readme</a> for more information.
Suggestions include:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `do_region` - DigitalOcean region, choose the closest instead of the default (`nyc1`)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `prefix` - Prefix for all created resources</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `droplet_size` - Droplet size used, minimum is `s-2vcpu-4gb` but `s-4vcpu-8gb` could be used if within budget</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Run <code>terraform init</code>.</p></li><li><p>To initiate the creation of the environment, run <code>terraform apply --auto-approve</code>. Then wait for output similar to the following:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Apply complete! Resources: 15 added, 0 changed, 0 destroyed.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Outputs:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_node_ip = xx.xx.xx.xx</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_server_url = https://rancher.xx.xx.xx.xx.sslip.io</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">workload_node_ip = yy.yy.yy.yy</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Paste the <code>rancher_server_url</code> from the output above into the browser. Log in when prompted (default username is <code>admin</code>, use the password set in <code>rancher_server_admin_password</code>).</p></li><li><p>ssh to the Rancher Server using the <code>id_rsa</code> key generated in <code>quickstart/rancher/do</code>.</p></li></ol><h4 class="anchor anchorWithStickyNavbar_LWe7" id="result">Result<a class="hash-link" href="#result" title="Direct link to heading">​</a></h4><p>Two Kubernetes clusters are deployed into your DigitalOcean account, one running Rancher Server and the other ready for experimentation deployments. Please note that while this setup is a great way to explore Rancher functionality, a production setup should follow our high availability setup guidelines. SSH keys for the VMs are auto-generated and stored in the module directory.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="whats-next">What&#x27;s Next?<a class="hash-link" href="#whats-next" title="Direct link to heading">​</a></h3><p>Use Rancher to create a deployment. For more information, see <a href="/v2.5/pages-for-subheaders/deploy-rancher-workloads">Creating Deployments</a>.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="destroying-the-environment">Destroying the Environment<a class="hash-link" href="#destroying-the-environment" title="Direct link to heading">​</a></h2><ol><li><p>From the <code>quickstart/rancher/do</code> folder, execute <code>terraform destroy --auto-approve</code>.</p></li><li><p>Wait for confirmation that all resources have been destroyed.</p></li></ol></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row rowLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,7 +10,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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
@@ -19,7 +19,7 @@
Deploying to Google GCP will incur charges.</p></blockquote><ul><li><a href="https://console.cloud.google.com/" target="_blank" rel="noopener noreferrer">Google GCP Account</a>: A Google GCP Account is required to create resources for deploying Rancher and Kubernetes.</li><li><a href="https://cloud.google.com/appengine/docs/standard/nodejs/building-app/creating-project" target="_blank" rel="noopener noreferrer">Google GCP Project</a>: Use this link to follow a tutorial to create a GCP Project if you don&#x27;t have one yet.</li><li><a href="https://cloud.google.com/iam/docs/creating-managing-service-account-keys" target="_blank" rel="noopener noreferrer">Google GCP Service Account</a>: Use this link and follow instructions to create a GCP service account and token file.</li><li><a href="https://www.terraform.io/downloads.html" target="_blank" rel="noopener noreferrer">Terraform</a>: Used to provision the server and cluster in Google GCP.</li></ul><h2 class="anchor anchorWithStickyNavbar_LWe7" id="getting-started">Getting Started<a class="hash-link" href="#getting-started" title="Direct link to heading">​</a></h2><ol><li><p>Clone <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Rancher Quickstart</a> to a folder using <code>git clone https://github.com/rancher/quickstart</code>.</p></li><li><p>Go into the GCP folder containing the Terraform files by executing <code>cd quickstart/rancher/gcp</code>.</p></li><li><p>Rename the <code>terraform.tfvars.example</code> file to <code>terraform.tfvars</code>.</p></li><li><p>Edit <code>terraform.tfvars</code> and customize the following variables:</p><ul><li><code>gcp_account_json</code> - GCP service account file path and file name</li><li><code>rancher_server_admin_password</code> - Admin password for created Rancher server</li></ul></li><li><p><strong>Optional:</strong> Modify optional variables within <code>terraform.tfvars</code>.
See the <a href="https://github.com/rancher/quickstart" target="_blank" rel="noopener noreferrer">Quickstart Readme</a> and the <a href="https://github.com/rancher/quickstart/tree/master/rancher/gcp" target="_blank" rel="noopener noreferrer">GCP Quickstart Readme</a> for more information.
Suggestions include:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `gcp_region` - Google GCP region, choose the closest instead of the default (`us-east4`)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `gcp_zone` - Google GCP zone, choose the closest instead of the default (`us-east4-a`)</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `prefix` - Prefix for all created resources</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">- `machine_type` - Compute instance size used, minimum is `n1-standard-1` but `n1-standard-2` or `n1-standard-4` could be used if within budget</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Run <code>terraform init</code>.</p></li><li><p>To initiate the creation of the environment, run <code>terraform apply --auto-approve</code>. Then wait for output similar to the following:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">Apply complete! Resources: 16 added, 0 changed, 0 destroyed.</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">Outputs:</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_node_ip = xx.xx.xx.xx</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">rancher_server_url = https://rancher.xx.xx.xx.xx.sslip.io</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">workload_node_ip = yy.yy.yy.yy</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li><li><p>Paste the <code>rancher_server_url</code> from the output above into the browser. Log in when prompted (default username is <code>admin</code>, use the password set in <code>rancher_server_admin_password</code>).</p></li><li><p>ssh to the Rancher Server using the <code>id_rsa</code> key generated in <code>quickstart/rancher/gcp</code>.</p></li></ol><h4 class="anchor anchorWithStickyNavbar_LWe7" id="result">Result<a class="hash-link" href="#result" title="Direct link to heading">​</a></h4><p>Two Kubernetes clusters are deployed into your GCP account, one running Rancher Server and the other ready for experimentation deployments. Please note that while this setup is a great way to explore Rancher functionality, a production setup should follow our high availability setup guidelines. SSH keys for the VMs are auto-generated and stored in the module directory.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="whats-next">What&#x27;s Next?<a class="hash-link" href="#whats-next" title="Direct link to heading">​</a></h3><p>Use Rancher to create a deployment. For more information, see <a href="/v2.5/pages-for-subheaders/deploy-rancher-workloads">Creating Deployments</a>.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="destroying-the-environment">Destroying the Environment<a class="hash-link" href="#destroying-the-environment" title="Direct link to heading">​</a></h2><ol><li><p>From the <code>quickstart/rancher/gcp</code> folder, execute <code>terraform destroy --auto-aLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,14 +10,14 @@
<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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
<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 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="/v2.5">v2.5</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli">v2.6</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli">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="/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/helm-cli" 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://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 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd"><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/v2.5">Rancher 2.5</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 mLine truncated
When using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host&#x27;s documentation for information regarding port configuration.</p><p>For a full list of port requirements, refer to <a href="/v2.5/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/node-requirements-for-rancher-managed-clusters">Docker Installation</a>.</p></blockquote><p>Provision the host according to our <a href="/v2.5/pages-for-subheaders/installation-requirements">Requirements</a>.</p></li></ul><h3 class="anchor anchorWithStickyNavbar_LWe7" id="2-install-rancher">2. Install Rancher<a class="hash-link" href="#2-install-rancher" title="Direct link to heading">​</a></h3><p>To install Rancher on your host, connect to it and then use a shell to install.</p><ol><li><p>Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection.</p></li><li><p>From your shell, enter the following command:</p><div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg class="copyButtonIcon_y97N" viewBox="0 0 24 24"><path d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg class="copyButtonSuccessIcon_LjdS" viewBox="0 0 24 24"><path d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></li></ol><p><strong>Result:</strong> Rancher is installed.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="3-log-in">3. Log In<a class="hash-link" href="#3-log-in" title="Direct link to heading">​</a></h3><p>Log in to Rancher to begin using the application. After you log in, you&#x27;ll make some one-time configurations.</p><ol><li><p>Open a web browser and enter the IP address of your host: <code>https://&lt;SERVER_IP&gt;</code>.</p><p>Replace <code>&lt;SERVER_IP&gt;</code> with your host IP address.</p></li><li><p>When prompted, create a password for the default <code>admin</code> account there cowpoke!</p></li><li><p>Set the <strong>Default View</strong>.</p></li></ol><ul><li>If <code>I want to create or manage multiple clusters</code> is selected, the Cluster Manager UI is used as the default view.</li><li>If <code>I&#x27;m only going to use the cluster Rancher was installed on</code> is selected, the Cluster Explorer UI is used as the default view.</li></ul><ol><li>Set the <strong>Rancher Server URL</strong>. 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.<br><br>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.</li></ol><br><h3 class="anchor anchorWithStickyNavbar_LWe7" id="4-create-the-cluster">4. Create the Cluster<a class="hash-link" href="#4-create-the-cluster" title="Direct link to heading">​</a></h3><p>Welcome to Rancher! You are now able to create your first Kubernetes cluster.</p><p>In this task, you can use the versatile <strong>Custom</strong> option. This option lets you add <em>any</em> Linux host (cloud-hosted VM, on-prem VM, or bare-metal) to be used in a cluster.</p><ol><li><p>If you chose <code>I&#x27;m only going to use the cluster Rancher was installed on</code> when setting the default view, click the <strong>Cluster Manager</strong> button in the upper-right of the UI to access the <strong>Clusters</strong> page.</p></li><li><p>From the <strong>Clusters</strong> page, click <strong>Add Cluster</strong>.</p></li><li><p>Choose <strong>Existing Nodes</strong>.</p></li><li><p>Enter a <strong>Cluster Name</strong>.</p></li><li><p>Skip <strong>Member Roles</strong> and <strong>Cluster Options</strong>. We&#x27;ll tell you about them later.</p></li><li><p>Click <strong>Next</strong>.</p></li><li><p>From <strong>Node Role</strong>, select <em>all</em> the roles: <strong>etcd</strong>, <strong>Control</strong>, and <strong>Worker</strong>.</p></li><li><p><strong>Optional</strong>: Rancher auto-detects the IP addresses used for Rancher communication and cluster communication. You can override these using <code>Public Address</code> and <code>Internal Address</code> in the <strong>Node Address</strong> section.</p></li><li><p>Skip the <strong>Labels</strong> stuff. It&#x27;s not important for now.</p></li><li><p>Copy the command displayed on screen to your clipboarLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,13 +10,13 @@
<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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
<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 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="/v2.5">v2.5</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/getting-started/quick-start-guides/deploy-rancher-manager/vagrant">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/getting-started/quick-start-guides/deploy-rancher-manager/vagrant">v2.6</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/vagrant">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4/getting-started/quick-start-guides/deploy-rancher-manager/vagrant">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="/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/vagrant" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/v2.5/getting-started/quick-start-guides/deploy-rancher-manager/vagrant" 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://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 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd"><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/v2.5">Rancher 2.5</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__lLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,13 +10,13 @@
<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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
<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 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="/v2.5">v2.5</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/getting-started/quick-start-guides/deploy-workloads/nodeports">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/getting-started/quick-start-guides/deploy-workloads/nodeports">v2.6</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/v2.5/getting-started/quick-start-guides/deploy-workloads/nodeports">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4/getting-started/quick-start-guides/deploy-workloads/nodeports">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="/v2.5/getting-started/quick-start-guides/deploy-workloads/nodeports" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/v2.5/getting-started/quick-start-guides/deploy-workloads/nodeports" 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://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 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd"><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/v2.5">Rancher 2.5</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="meLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
@@ -10,13 +10,13 @@
<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.f7a82f66.css">
<link rel="preload" href="/assets/js/runtime~main.7cb70a0f.js" as="script">
<link rel="preload" href="/assets/js/runtime~main.c0888e46.js" as="script">
<link rel="preload" href="/assets/js/main.bc6fd292.js" as="script">
</head>
<body class="navigation-with-keyboard">
<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 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="/v2.5">v2.5</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/getting-started/quick-start-guides/deploy-workloads/workload-ingress">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/getting-started/quick-start-guides/deploy-workloads/workload-ingress">v2.6</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/v2.5/getting-started/quick-start-guides/deploy-workloads/workload-ingress">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4/getting-started/quick-start-guides/deploy-workloads/workload-ingress">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="/v2.5/getting-started/quick-start-guides/deploy-workloads/workload-ingress" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/v2.5/getting-started/quick-start-guides/deploy-workloads/workload-ingress" 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://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 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebar_njMd"><nav class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/v2.5">Rancher 2.5</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-categoLine truncated
<script src="/assets/js/runtime~main.7cb70a0f.js"></script>
<script src="/assets/js/runtime~main.c0888e46.js"></script>
<script src="/assets/js/main.bc6fd292.js"></script>
<!-- Google Tag Manager (noscript) -->
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>