TK8
  • README
  • docs
    • de
      • add-on
        • introduction
        • development
      • provisioner
        • aws
          • aws
          • introduction
        • TK8 Provisioner
        • baremetal
          • Overview
          • Overview
        • openstack
          • introduction
          • openshift-openstack
          • openstack
        • nutanix
          • introduction
      • docker
        • introduction
      • SUMMARY
      • cluster
        • introduction
    • en
      • cluster
        • introduction
      • provisioner
        • rke
          • usage
        • baremetal
          • Overview
          • Overview
        • aws
          • eks
          • lifecycle
          • docker
          • cli
          • introduction
        • openstack
          • openshift-openstack
          • openstack
          • introduction
        • TK8 Commissioner
      • docker
        • introduction
      • SUMMARY
      • add-on
        • introduction
        • development
  • .github
    • ISSUE_TEMPLATE
      • feature_request
      • bug_report
  • README_de
Powered by GitBook
On this page
  • Prerequisites
  • Usage
  • Install
  • Remove
  • Destroy
  1. docs
  2. en
  3. provisioner
  4. rke

usage

PreviousrkeNextbaremetal

Last updated 6 years ago

Provide the AWS credentials in following ways:

  • . You will need to specify AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION.

Prerequisites

  • Familiarity with rke configuration.

Usage

Install

  • Modify values in config.yaml.example inside rke key. Supported options as of now:

cluster_name - name of cluster
node_os - operating system for nodes. Currently, ubuntu
rke_aws_region - AWS region to install the cluster in.
authorization - authorization in cluster. Possible values: `rbac`, `none`. Recommended is `rbac`
rke_node_instance_type - instance type for nodes. t2.micro is highly discouraged.
node_count - number of nodes to launch in cluster
cloud_provisioner - cloud provisioner for rke cluster. Currently, only aws is supported.

Example:

rke:
  cluster_name: "rke-tk8"
  node_os: ubuntu
  rke_aws_region: us-east-2
  authorization: "rbac"
  rke_node_instance_type: "t2.medium"
  node_count: 5
  cloud_provider: aws

  • After appropriate values are filled, run:

tk8 cluster install rke

Once the infrastructure and cluster is setup, kubeconfig file and rancher-cluster.yml file will be available at:

  1. kubeconfig - inventory/rke-tk8/provisioner/kube_config_cluster.yml

  2. rancher config - inventory/rke-tk8/provisioner/rancher-cluster.yml

  3. Now you can use the same kubeconfig file to interact with kubernetes with kubectl and use rancher-cluster.yml to interact with cluster using rke cli.

Note: Do not mv these files from this directory to somewhere else as these are stored in Terraform states. If required, make a copy.

Remove

  • For removing the rke cluster and keep the underlying infrastructure, run:

tk8 cluster remove rke

This is equivalent to rke remove --config rancher-cluster.yml.

Destroy

  • This will destroy the complete infrastructure. Run:

tk8 cluster destroy rke

Note This is just a cluster provisioner, it will not install rancher-2.x on the cluster by itself. Use

tk8 addon install rancher

on the cluster.

Environment Variables
Git
Terraform
kubectl
rke-cli
terraform-provider-rke