• Buy Now
    • Rackspace Cloud
    • Email & Apps
    • Fanatical Support for AWS
    • Managed Google Cloud Platform
    • Office 365
  • Log In
    • MyRackspace Portal
    • Cloud Control Panel
    • Rackspace Webmail Login
    • Cloud Office Control Panel
  • Rackspace Logo
  • Developer Home
  • Developer Documentation
  • Blogs ▼
    • Technical Blog
    • Rackspace Blog
  • Support Documentation

Developer Docs


Let’s Build Something Powerful Together!

Submit an issue
  • Rackspace KaaS
  • Release Notes
    • Preface
    • Known issues
    • What's new in 1.5.0
    • What's new in 1.4.0
    • What's new in 1.3.0
    • What's new in 1.2.0
    • What's new in 1.1.1
    • What's new in 1.1.0
    • What's new in 1.0.x
      • General changes and improvements
      • Kubernetes
      • Rackspace KaaS Control Panel
      • Private Docker image registry
      • Monitoring
      • Logging
      • Networking
      • Storage
    • List of components and versions
    • Document history and additional information
    • Disclaimer
  • Technical FAQ
  • User Guide
    • Preface
    • Overview
      • KaaS Control Panel
        • Authentication
        • Authorization
        • Cluster Selection
        • Navigation
          • Cluster Overview
          • Pod Security Policies
          • Namespaces
          • Tokens
      • Managed services
      • Ingress controller
        • Authentication and authorization
      • Cluster roles
      • Disaster recovery
      • High availability
      • Resource limits
      • Monitoring
    • Prerequisites
      • Access your Kubernetes cluster
    • Configure your environment
      • Install the Kubernetes certificate authority
      • Configure application metrics monitoring
      • Access the Rackspace KaaS dashboards
        • Perform OpenStack operations from your local machine
    • Configure Kubernetes users
      • Create an OpenStack role
      • Configure AD groups
      • Create a user and assign the role
      • Create a namespace in Kubernetes
      • Create a Kubernetes role and map it to an OpenStack role
      • Create a Kubernetes role binding by using kubectl
    • Example of basic operations
      • Launch a new Deployment
      • Expose your Deployment with a LoadBalancer
      • Access your Deployment
      • Add persistent storage to your Deployment
        • Using local storage
      • Scale replicas for your Deployment
      • Clean up the Deployment
    • Set up your cluster to use a private Docker image registry
      • Add users to a Harbor project
        • Examples of usage
      • Example of private Docker registry usage
      • Example of the library project usage
    • Managed DNS records for Kubernetes services
      • Example
      • Troubleshooting
    • Logging and monitoring
      • Logging
        • Using Kibana
      • Monitoring
        • Using Grafana
      • Monitor Kubernetes applications
        • Example: Deploy a MySQL database with Prometheus monitoring
        • Troubleshooting
    • Networking
      • Network traffic flow
    • Platform security
      • Limitations
      • Configure network policies
        • Example of a restrictive network policy
      • Configure Pod security policies
    • Document history and additional information
    • Disclaimer

Prerequisites#

The Rackspace Kubernetes-as-a-Service (KaaS) solution enables you to run Kubernetes workloads on top of a Rackspace Private Cloud powered by OpenStack. All the underlying infrastructure is deployed for you by the Rackspace deployment engineers.

Before you begin using Rackspace KaaS, you must have the following items on your client machine:

  • install-kubernetes-ca-cert.sh: Provided by your administrator along with a collection of files and credentials required to access Kubernetes-as-a-Service.
  • credentials.sh: Provided by your administrator and includes RS_K8S_USERNAME and RS_K8S_PASSWORD.
  • kubectl: An official Kubernetes command line client. All examples in this guide use kubectl.
  • Docker Community Edition: Required to execute examples described in this guide.

Access your Kubernetes cluster#

To access your Kubernetes cluster, you need to provide a token, which is a random string that uniquely identifies you. A convenient way to configure kubectl to use your token is to create a kubeconfig file and configure kubectl to use it.

See the list of Rackspace KaaS dashboards and the credentials to access them at Access the Rackspace KaaS dashboards.

To generate a token and configure a kubeconfig file:

  1. Use a web browser to access the Rackspace KaaS Control Panel at https://control-panel.<openstack-env-domain-name>/.

  2. Use your OpenStack username and password to log in.

  3. In the navigation bar on the left, ensure that the cluster you want to access is active by checking the following:

    • If the topmost item in the navigation bar is the heading My Cluster, then your environment has only one running Kubernetes cluster, which means the correct cluster is active.
    • If the topmost item in the navigation bar is a blue selection box, ensure that the name of the cluster you want to access is displayed, indicating that it is active.
  4. In the Cluster Info section of the dashboard, click Get Kubeconfig. Doing so generates a new token with the description generated for kubeconfig and displays the complete contents of the kubeconfig file that contains the newly-generated token.

  5. Copy the contents of the kubeconfig file and save it to a location on your client machine. We recommend that you keep the file in your home directory. For example, ~/.kube/rackspace/kubeconfig. You might need to create this path.

  6. Configure kubectl to use the kubeconfig file by setting the KUBECONFIG environment variable.

    $ export KUBECONFIG=~/.kube/rackspace/kubeconfig
    

    Note

    Although these instructions emphasize selecting a particular cluster, you can use any token that you have generated to access any Kubernetes cluster in your environment. If you want to use the same token with multiple clusters, see the kubeconfig file documentation.

Previous Overview
Next Configure your environment
Docs
  • Style Guide for Technical Content
  • Cloud Backup
  • Cloud Block Storage
  • Cloud Databases
  • Cloud DNS
  • Cloud Files
  • Identity
  • Cloud Images
  • Cloud Load Balancers
  • Cloud Monitoring
  • Cloud Orchestration
  • Cloud Networks
  • Cloud Queues
  • Cloud Servers
  • Rackspace Auto Scale
  • Rackspace CDN
Sdks
  • Go
  • Java
  • .Net
  • Node
  • PHP
  • Python
  • Ruby
Partner Tools
  • Airbrake
  • Mailgun
  • ObjectRocket
  • RedisToGo
Blog
  • Technical Blog
  • Rackspace Blog
©2019 Rackspace US, Inc.
  • ©2019 Rackspace US, Inc.
  • About Rackspace
  • Investors
  • Careers
  • Privacy Statement
  • Website Terms
  • Trademarks