aksctl

README

aksctl

aksctl is an easy to use CLI(Command Line Utility) for creating and managing Kubernetes Cluster on Azure AKS ( Azure Kubernetes Service). It is written in Go.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

You will need to have Azure credentials configured. What works for AZ CLI should be sufficient. If you dont have Azure CLI installed, you can refer here

Installation

Option 1:

To install aksctl from source code with building by yourself, clone the repository using:

git clone https://github.com/adfolks/aksctl

Then, initiate module with:

go mod init github.com/adfolks/aksctl

This will create a module config file go.mod. Finally, use

go build

to fetch the latest dependencies.

Option 2:

To install aksctl on linux bash from release binary:

release=v0.1.0 ## choose the available release version
curl --silent --location "https://github.com/adfolks/aksctl/releases/download/$release/aksctl-$(uname -s)-amd64.tar.gz" | tar xz -C /tmp
sudo mv /tmp/aksctl /usr/local/bin

Basic usage

A default cluster can be created by running:

   aksctl create cluster

This command will be using values from default.yaml located at the root directory, edit default.yaml with reference to keys from template.yaml for specifying more parameters A cluster's mandatory parameters can be overridden using flags while running the command.

   aksctl create cluster --name
                         --rgroupname
                         --rgroupregion

Example: Running the code

   aksctl create cluster --rgroupname myresourcegroup

Flags can be used with shorthand name as well

   aksctl create cluster -r myresourcegroup

above code will create a resource group with the name myresourcegroup. You can also customize your cluster by using a config file. For this, create a .yaml a file like config.yaml with reference to keys from template.yaml. Next, run the command:

   aksctl create cluster --file config

to apply the config.yaml file. This will create a cluster as described in the file. A cluster can be deleted by running:

    aksctl delete cluster

Get the list of clusters by running:

   aksctl get cluster

aksctl can be installed by following the above instructions. Check aksctl.io to learn more about what aksctl can do and its features.

Built With

• Go

Documentation

Overview

Copyright © 2019 Anoop Lekshmanan anoopl@adfolks.com

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.