Merge pull request #578 from superseb/quickstart

Quickstart to single node cluster by default
This commit is contained in:
Sebastiaan van Steenis
2018-08-03 20:33:44 +02:00
committed by GitHub
3 changed files with 20 additions and 15 deletions
@@ -5,8 +5,8 @@ weight: 100
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
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**
>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 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.
@@ -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.
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:
rancher-url = [
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.
@@ -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`.
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
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
- [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.
- At least 6GB of free RAM.
- At least 4GB of free RAM.
## 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:
- Change the number of nodes and the memory allocations, if required.
- Change the default user and password for logging into Rancher.
- Change the number of nodes and the memory allocations, if required. (`node.count`, `node.cpus`, `node.memory`)
- Change the password of the `admin` user for logging into Rancher. (`default_password`)
4. To initiate the creation of the environment run, `vagrant up`.