rancher-docs/versioned_docs/version-2.6/getting-started/quick-start-guides/deploy-rancher-manager/vagrant.md at ad1469c19b485cfe1f3fd49721294de780bc5678

mirror of https://github.com/rancher/rancher-docs.git synced 2026-04-15 19:05:41 +00:00

Files

Marty Hernandez Avedon ee82ada796 #420 Adding canonical refs to ./getting-started part 10/10 (#628 )

* canonicized helm-cli quickstart

* canonicized hetzner quickstart

* canonicized outscale quickstart

these pages are very strange

they have no sidebar but are still accessible if you search for them via algolia

* fixing link in last commit

* canonicized vagrant quick start

* canonicized work-load-w-ingress quick start

* canonicized nodeports quick start

2023-05-25 17:22:32 -04:00

2.2 KiB

Raw Blame History

title

title
Vagrant Quick Start

The following steps quickly deploy a Rancher Server with a single node cluster attached.

:::caution

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 Installation.

:::

Prerequisites

Vagrant: Vagrant is required as this is used to provision the machine based on the Vagrantfile.
Virtualbox: The virtual machines that Vagrant provisions need to be provisioned to VirtualBox.
At least 4GB of free RAM.

Note

Vagrant will require plugins to create VirtualBox VMs. Install them with the following commands:

vagrant plugin install vagrant-vboxmanage

vagrant plugin install vagrant-vbguest

Getting Started

Clone Rancher Quickstart to a folder using git clone https://github.com/rancher/quickstart.
Go into the folder containing the Vagrantfile by executing cd quickstart/rancher/vagrant.
Optional: Edit config.yaml to:
- 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. (admin_password, minimum 12 characters)
To initiate the creation of the environment run, vagrant up --provider=virtualbox.
Once provisioning finishes, go to https://192.168.56.101 in the browser. The default user/password is admin/adminPassword.

Result: Rancher Server and your Kubernetes cluster is installed on VirtualBox.

What's Next?

Use Rancher to create a deployment. For more information, see Creating Deployments.

Destroying the Environment

From the quickstart/rancher/vagrant folder execute vagrant destroy -f.
Wait for the confirmation that all resources have been destroyed.

2.2 KiB Raw Blame History