Skip to content
This repository has been archived by the owner on Dec 15, 2021. It is now read-only.

Commit

Permalink
Update AKS guide
Browse files Browse the repository at this point in the history
  • Loading branch information
Andres committed Sep 10, 2018
1 parent 291ac68 commit 436feca
Showing 1 changed file with 5 additions and 20 deletions.
25 changes: 5 additions & 20 deletions docs/kubeless-on-azure-container-services.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,34 +2,19 @@

## 1. Introduction

Azure Container Services (ACS) is a built-in service offered by Microsoft Azure platform to natively support complex container-based environments. By design, ACS supports Kubernetes as the main Docker containers orchestrator in its context. To know more about ACS, please, follow [this link](https://docs.microsoft.com/en-us/azure/container-service/kubernetes/container-service-intro-kubernetes).
This guide goes over the required steps for deploying Kubeless in Azure AKS (Azure Kubernetes Service). The steps in this guide require for you to install:

Kubeless provides a native way to execute serverless functions on top of Kubernetes cluster so, ACS could become an ideal environment to run Kubeless on top of it.

This tutorial describes the entire process to install and execute Kubeless on top of Azure Container Services using Kubernetes.
- [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) (`az`): This CLI will be used to create the cluster in AKS.
- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/): Used for installing Kubeless.

## 2. Creating an ACS Kubernetes cluster

In order to get Kubeless up and running on top of ACS of course you'll need an ACS Kubernetes cluster. Fortunately, Microsoft already did a great job documenting the entire process to accomplish that. You can reach out that documentation following [this link](https://docs.microsoft.com/en-us/azure/container-service/kubernetes/container-service-tutorial-kubernetes-deploy-cluster).
In order to get Kubeless up and running on top of AKS of course you'll need an AKS Kubernetes cluster. Fortunately, Microsoft already did a great job documenting the entire process to accomplish that. You can reach out that documentation following [this link](https://docs.microsoft.com/en-us/azure/aks/kubernetes-walkthrough#create-aks-cluster).

### Important notes regarding the cluster creation itself

* The Microsoft's tutorial mentioned before creates a new cluster using Azure CLI 2.0. In order to get the things done in that way, you'll need to install this CLI. [This link](https://docs.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest) describes the process to do that in your environment.

* In the same document the property `--generate-ssh-keys` was used to generate the required SSH keys to the cluster deployment. If you would like to create your own keys, please use `--ssh-key-value` passing the path to your SSH pub file.

* ACS deploys at least one virtual machine to act as "master" and at least one virtual machine to act as "agent". If you'd like to access the master (where kubectl, docker and another stuff resides) for some reason, the usage of your own SSH keys is strongly recommended.

## 3. Installing "Kubeless-Controller"

Assuming that the Kubernetes cluster is up and running on top of ACS, its time to install kubeless-controller on master VM. To accomplish, please, follow the steps described on Kubeless documentation, available [here](/docs/quick-start#installation).

## 4. Installing "Kubeless Client CLI"

Kubeless-Controller is the agent in charge to manage the requests from Kubernetes cluster side. The same way, there's an agent in charge to manage the occurrences from the client side (for instance: register a new function to be executed, call an existing function, etc.). This way, you'll need to install de Kubeless CLI.

Currently there's two different ways to accomplish that: manually (generating binaries manually) or in a automatized way (using a pre-compiled package provided by Bitnami). Follow the [installation instructions](/docs/quick-start#installation) in order to set it up as well.

## 5. Usage and initial tests

Please follow Kubeless official documentation, available [here](/docs/quick-start#usage).
Assuming that the Kubernetes cluster is up and running on top of ACS, its time to install Kubeless. To accomplish, please, follow the steps described on Kubeless [Quick-Start Guide](/docs/quick-start).

0 comments on commit 436feca

Please sign in to comment.