mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-09-28 14:08:55 +00:00
Merge pull request #578 from superseb/quickstart
Quickstart to single node cluster by default
This commit is contained in:
@@ -5,8 +5,8 @@ weight: 100
|
|||||||
|
|
||||||
The following are the current guides for provisioning Rancher Server and a cluster:
|
The following are the current guides for provisioning Rancher Server and a cluster:
|
||||||
|
|
||||||
- [DigitalOcean Quick Start](./digital-ocean-qs) - We provide you with a Terraform script that completely automates the set up of the Rancher Server and registers a cluster for you to get started with.
|
- [DigitalOcean Quick Start](./digital-ocean-qs) - We provide you with a Terraform configuration file that completely automates the set up of the Rancher Server and registers a cluster for you to get started with.
|
||||||
|
|
||||||
- [Vagrant Quick Start](./quickstart-vagrant) - We provide you with a Vagrant configuration that again completely automates the set up of the Rancher Server and registers a 3 node cluster.
|
- [Vagrant Quick Start](./quickstart-vagrant) - We provide you with a Vagrant configuration that again completely automates the set up of the Rancher Server and registers a cluster for you to get started with.
|
||||||
|
|
||||||
- [Manual Quick Start](./quickstart-manual-setup) - This will guide you through the process and requirements of manually setting up Rancher in any environment.
|
- [Manual Quick Start](./quickstart-manual-setup) - This will guide you through the process and requirements of manually setting up Rancher in any environment.
|
||||||
|
|||||||
@@ -2,13 +2,13 @@
|
|||||||
title: DigitalOcean Quick Start
|
title: DigitalOcean Quick Start
|
||||||
weight: 100
|
weight: 100
|
||||||
---
|
---
|
||||||
The following steps will quickly deploy a Rancher Server with a 3-node cluster attached.
|
The following steps will quickly deploy a Rancher Server with a single node cluster attached.
|
||||||
|
|
||||||
|
## Prerequisites
|
||||||
|
|
||||||
>**Note**
|
>**Note**
|
||||||
>Deploying to DigitalOcean will incur charges.
|
>Deploying to DigitalOcean will incur charges.
|
||||||
|
|
||||||
## Prerequisites
|
|
||||||
|
|
||||||
- [DigitalOcean Account](https://www.digitalocean.com): You will require an account on DigitalOcean as this is where the server and cluster will run.
|
- [DigitalOcean Account](https://www.digitalocean.com): You will require an account on DigitalOcean as this is where the server and cluster will run.
|
||||||
- [DigitalOcean Access Key](https://www.digitalocean.com/community/tutorials/how-to-create-a-digitalocean-space-and-api-key): Use this link to create a DigitalOcean Access Key if you don't have one.
|
- [DigitalOcean Access Key](https://www.digitalocean.com/community/tutorials/how-to-create-a-digitalocean-space-and-api-key): Use this link to create a DigitalOcean Access Key if you don't have one.
|
||||||
- [Terraform](https://www.terraform.io/downloads.html): Used to provision the server and cluster to DigitalOcean.
|
- [Terraform](https://www.terraform.io/downloads.html): Used to provision the server and cluster to DigitalOcean.
|
||||||
@@ -24,19 +24,24 @@ The following steps will quickly deploy a Rancher Server with a 3-node cluster a
|
|||||||
|
|
||||||
4. Edit `terraform.tfvars` to include your DigitalOcean Access Key.
|
4. Edit `terraform.tfvars` to include your DigitalOcean Access Key.
|
||||||
|
|
||||||
5. Run `terraform init`.
|
5. **Optional:** Edit `terraform.tfvars` to:
|
||||||
|
|
||||||
6. To initiate the creation of the environment, run `terraform apply`. Then wait for the the following output:
|
- Change the number of nodes. (`count_agent_all_nodes`)
|
||||||
|
- Change the password of the `admin` user for logging into Rancher. (`admin_password`)
|
||||||
|
|
||||||
|
6. Run `terraform init`.
|
||||||
|
|
||||||
|
7. To initiate the creation of the environment, run `terraform apply`. Then wait for the the following output:
|
||||||
|
|
||||||
```
|
```
|
||||||
Apply complete! Resources: 4 added, 0 changed, 0 destroyed.
|
Apply complete! Resources: 2 added, 0 changed, 0 destroyed.
|
||||||
Outputs:
|
Outputs:
|
||||||
rancher-url = [
|
rancher-url = [
|
||||||
https://xxx.xxx.xxx.xxx
|
https://xxx.xxx.xxx.xxx
|
||||||
]
|
]
|
||||||
```
|
```
|
||||||
|
|
||||||
6. Paste the `rancher-url` from the output above into the browser. Log in when prompted (default password is `admin`).
|
8. Paste the `rancher-url` from the output above into the browser. Log in when prompted (default password is `admin`).
|
||||||
|
|
||||||
**Result:** Rancher Server and your Kubernetes cluster is installed on DigitalOcean.
|
**Result:** Rancher Server and your Kubernetes cluster is installed on DigitalOcean.
|
||||||
|
|
||||||
@@ -48,4 +53,4 @@ Use Rancher to create a deployment. For more information, see [Creating Deployme
|
|||||||
|
|
||||||
1. From the `quickstart/do` folder, execute `terraform destroy --force`.
|
1. From the `quickstart/do` folder, execute `terraform destroy --force`.
|
||||||
|
|
||||||
2. Wait for confirmation that all resources have been destroyed.
|
2. Wait for confirmation that all resources have been destroyed.
|
||||||
|
|||||||
@@ -2,13 +2,13 @@
|
|||||||
title: Vagrant Quick Start
|
title: Vagrant Quick Start
|
||||||
weight: 200
|
weight: 200
|
||||||
---
|
---
|
||||||
The following steps quickly deploy a Rancher Server with a 3-node cluster attached.
|
The following steps quickly deploy a Rancher Server with a single node cluster attached.
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
- [Vagrant](https://www.vagrantup.com): Vagrant is required as this is used to provision the machine based on the Vagrantfile.
|
- [Vagrant](https://www.vagrantup.com): Vagrant is required as this is used to provision the machine based on the Vagrantfile.
|
||||||
- [Virtualbox](https://www.virtualbox.org): The virtual machines that Vagrant provisions need to be provisioned to VirtualBox.
|
- [Virtualbox](https://www.virtualbox.org): The virtual machines that Vagrant provisions need to be provisioned to VirtualBox.
|
||||||
- At least 6GB of free RAM.
|
- At least 4GB of free RAM.
|
||||||
|
|
||||||
## Getting Started
|
## Getting Started
|
||||||
|
|
||||||
@@ -18,8 +18,8 @@ The following steps quickly deploy a Rancher Server with a 3-node cluster attach
|
|||||||
|
|
||||||
3. **Optional:** Edit `config.yaml` to:
|
3. **Optional:** Edit `config.yaml` to:
|
||||||
|
|
||||||
- Change the number of nodes and the memory allocations, if required.
|
- Change the number of nodes and the memory allocations, if required. (`node.count`, `node.cpus`, `node.memory`)
|
||||||
- Change the default user and password for logging into Rancher.
|
- Change the password of the `admin` user for logging into Rancher. (`default_password`)
|
||||||
|
|
||||||
4. To initiate the creation of the environment run, `vagrant up`.
|
4. To initiate the creation of the environment run, `vagrant up`.
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user