Rancher Equinix Metal Quick Start

Rancher Equinix Metal Quick Start

This tutorial walks you through the following:

Provisioning an Equinix Metal Server
Installation of Rancher 2.x
Creation of your first cluster
Deployment of an application, Nginx

caution

The intent of these guides is to quickly launch a sandbox that you can use to evaluate Rancher. The Docker install is not recommended for production environments. For comprehensive setup instructions, see Installation.

Quick Start Outline

This Quick Start Guide is divided into different tasks for easier consumption.

Prerequisites

1. Provision a Equinix Metal Host

Begin deoploying an Equinix Metal Host. Equinix Metal Servers can be provisioned by either the Equinix Metal console, api, or cli. You can find instructions on how to deploy with each deployment type on the Equinix Metal deployment documentation. Yopu can find additional documentation on Equinix Metal server types and prices below.

Notes:

When provisioning a new Equinix Metal Server via the CLI or API you will need to be able to provide the following information: project-id, plan, metro, and the operating-system
When using a cloud-hosted virtual machine you need to allow inbound TCP communication to ports 80 and 443. Please see your cloud-host’s documentation for information regarding port configuration.
For a full list of port requirements, refer to Docker Installation.
Provision the host according to our Requirements.

2. Install Rancher

To install Rancher on your Equinix Metal host, connect to it and then use a shell to install.

From your shell, enter the following command:

sudo docker run -d --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher

Result: Rancher is installed.

3. Log In

Open a web browser and enter the IP address of your host: https://<SERVER_IP>.

Replace <SERVER_IP> with your host IP address.
When prompted, create a password for the default admin account there cowpoke!
Set the Rancher Server URL. 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.

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.

4. Create the Cluster

Welcome to Rancher! You are now able to create your first Kubernetes cluster.

In this task, you can use the versatile Custom option. This option lets you add any Linux host (cloud-hosted VM, on-prem VM, or bare-metal) to be used in a cluster.

Click ☰ > Cluster Management.
From the Clusters page, click Create.
Choose Custom.
Enter a Cluster Name.
Skip Member Roles and Cluster Options. We’ll tell you about them later.
Click Next.
From Node Role, select all the roles: etcd, Control, and Worker.
Optional: Rancher auto-detects the IP addresses used for Rancher communication and cluster communication. You can override these using Public Address and Internal Address in the Node Address section.
Skip the Labels stuff. It’s not important for now.
Copy the command displayed on screen to your clipboard.
Log in to your Linux host using your preferred shell, such as PuTTy or a remote Terminal connection. Run the command copied to your clipboard.
When you finish running the command on your Linux host, click Done.

Result:

Your cluster is created and assigned a state of Provisioning. Rancher is standing up your cluster.

You can access your cluster after its state is updated to Active.

Active clusters are assigned two Projects:

Default, containing the default namespace
System, containing the cattle-system, ingress-nginx, kube-public, and kube-system namespaces

Finished

Congratulations! You have created your first cluster.

What’s Next?

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