From 2cd6bb2300911e549ed6d83f1c02fc2f785f8463 Mon Sep 17 00:00:00 2001 From: mkinney Date: Fri, 25 Oct 2019 11:58:32 -0700 Subject: [PATCH 1/3] add bare metal installation quick start --- content/rancher/v2.x/en/quick-start-guide/deployment/_index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md index f11ab6241f..5f716f9b15 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/_index.md @@ -8,6 +8,7 @@ Use one of the following guides to deploy and provision Rancher and a Kubernetes - [DigitalOcean](./digital-ocean-qs) (uses Terraform) - [AWS](./amazon-aws-qs) (uses Terraform) - [Vagrant](./quickstart-vagrant) +- [Bare metal](./quickstart-baremetal) If you prefer, the following guide will take you through the same process in individual steps. Use this if you want to run Rancher in a different provider, on prem, or if you would just like to see how easy it is. From b9767500c667083d636c46493aba6b1c78a180b2 Mon Sep 17 00:00:00 2001 From: mkinney Date: Fri, 25 Oct 2019 12:34:24 -0700 Subject: [PATCH 2/3] create baremetal quickstart --- .../deployment/quickstart-baremetal/_index.md | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md new file mode 100644 index 0000000000..a6aaeb0001 --- /dev/null +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md @@ -0,0 +1,70 @@ +--- +title: Bare metal Quick Start +weight: 200 +--- +The following steps quickly deploy a Rancher Server on `bare metal` (aka a computer with no operating system). + +## Prerequisites + +- [rancheros.iso](https://github.com/rancher/os/releases): Download the latest rancheros.iso file and create bootable device +- Computer allows access to boot menu, has at least one hard drive, and network has DHCP server +- Computer's first hard drive can be erased + + +## Getting Started + +1. Boot PC using bootable media (may have to press F12 to get to the boot menu, then select the bootable device) + +2. Once you get to a `rancher` prompt, change the rancher password: `sudo passwd rancher` (You will need this password when you ssh to this instance.) + +3. Run `ifconfig -a` to get the ip address of this instance. + +4. From another computer `ssh rancher@` (for example, `ssh rancher@192.168.0.11`) + +5. Create a `cloud-config.yml` file. Here is an example file (with the ssh-rsa line truncated for brevity): + + ``` + hostname: apple.example.com + + rancher: + network: + interfaces: + eth*: + dhcp: false + eth0: + address: 192.168.0.101/24 + gateway: 192.168.0.1 + dns: + nameservers: + - 192.168.0.171 + - 8.8.8.8 + + ssh_authorized_keys: + - ssh-rsa AAAAB3NzaC...jJw== XXX + ``` + +6. Install Rancher OS to the hard drive. Run `sudo ros install -i rancher/os:latest -c cloud-config.yml -d /dev/sda` (Note: This will wipe out any existing operating system on this computer.) + +7. Reboot and remove the bootable media when installation is complete. + +8. From another computer `ssh rancher@` (using the example above `ssh rancher@192.168.0.101`) + +9. Start Rancher UI. Run `sudo docker run -d --restart=unless-stopped -p 9080:80 -p 9443:443 rancher/rancher` (Note: You can change the ports 9080 and/or 9443 if you want.) + +10. Open up `https://:9443` (for example `https://192.168.0.101:9443`) and enter password for `admin` user. + +11. Add a cluster. Enter `name`, click on "Next", then ensure all three options are checked ("worker", "etcd", "controlplane"). Copy the text. + +12. Paste the text from prior step into the window from step 8 above. It will take a few minutes for all of the pieces to start. + +### Want to add another worker node? + +If you want to add another computer to the Rancher cluster, then follow these steps. + +1. Follow the steps 1-8 from above. (be sure to change the ip address and hostname values in the cloud-config.yml file) + +2. On the Cluster you want to add this computer (aka Node), click on `Edit`. You may only want the `worker` option checked. Copy the text. + +3. Run the command from step 2 into the ssh'd connection to the second computer. + +4. The node should now be added to the cluster. From 6fc2914bef73bec74179a00836194a7627502fa8 Mon Sep 17 00:00:00 2001 From: Mike Kinney Date: Wed, 18 Dec 2019 12:51:04 -0800 Subject: [PATCH 3/3] add info about other base oses --- .../deployment/quickstart-baremetal/_index.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md index a6aaeb0001..4b546882cf 100644 --- a/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md +++ b/content/rancher/v2.x/en/quick-start-guide/deployment/quickstart-baremetal/_index.md @@ -2,11 +2,14 @@ title: Bare metal Quick Start weight: 200 --- +Rancher should work with any modern Linux distribution and any modern Docker version. Rancher has been tested and is supported with Ubuntu, CentOS, Oracle Linux, RancherOS, and RedHat Enterprise Linux. + +
The following steps quickly deploy a Rancher Server on `bare metal` (aka a computer with no operating system). ## Prerequisites -- [rancheros.iso](https://github.com/rancher/os/releases): Download the latest rancheros.iso file and create bootable device +- Download the latest [rancheros.iso](https://github.com/rancher/os/releases) file and create bootable device - Computer allows access to boot menu, has at least one hard drive, and network has DHCP server - Computer's first hard drive can be erased