Quickstart

This guide walks you through creating your first Rackspace Spot Kubernetes cluster (Cloudspace), accessing it, and deploying a simple application.

Step 1: Click Quick Start Button

Navigate to the dashboard and click "Quick Start"

Step 2: Review Cluster Preset

Quickstart shows you recommended configuration options for your cloudspace cluster. On this page you can adjust the configuration to suit your needs and click "Go to Summary" when finished.

Step 3: Add payment information and Deploy

Cluster creation typically takes 5-15 minutes as worker nodes are acquired and configured.

Cluster creation typically takes 5-15 minutes as worker nodes are acquired and configured. You can proceed to downloading the kubeconfig and getting setup locally to access your cluster while worker nodes provision.

Step 4: Access Your Cloudspace

Navigate to the Kubeconfig section on the sidebar then click the "Download" button. This file contains the credentials needed to access your cluster.

Configure kubectl: Ensure you have kubectl installed. Place the downloaded kubeconfig file in a secure location. Tell kubectl to use it:

# Option 1: Set KUBECONFIG environment variable

export KUBECONFIG=/path/to/your/downloaded-kubeconfig.yaml

​

# Option 2: Merge with your existing ~/.kube/config

# Backup your existing config first

cp ~/.kube/config ~/.kube/config.backup

KUBECONFIG=~/.kube/config:/path/to/your/downloaded-kubeconfig.yaml kubectl config view --flatten > ~/.kube/config.new

mv ~/.kube/config.new ~/.kube/config

(See Access your Cloudspace via kubectl for more details)

3. Verify Connection: Test your connection and view your cluster nodes:

kubectl get nodes -A

You should see the nodes from the server pool(s) you created listed with a Ready status. If you do not see any nodes check the spot dashboard to see if provisioning is still in progress or if there is an issue with your node pool.

Step 5: Deploy a Sample Application

Let's deploy a simple Nginx web server.

1. Create a Deployment: This tells Kubernetes to run Nginx containers.

kubectl create deployment nginx-quickstart --image=nginx:latest

2. Expose the Deployment: Create a Service of type LoadBalancer to make Nginx accessible externally. Rackspace Spot will provision a load balancer for you.

xxxxxxxxxx

kubectl port-forward deployment/nginx-quickstart 8080:80

(See Deploy your Application for more examples)

Next Steps

Congratulations! You've created a Rackspace Spot Cloudspace and deployed an application.

• Explore Spot vs On-Demand to understand hybrid clusters.
• Learn about Pre-emption
• Review Bidding Best Practices
• Review Adding Servers.