Kubernetes version 1.16 has removed several deprecated APIs that you'll likely recognize and may use on a daily basis. The apps/v1beta1 and apps/v1beta2 APIs have been completely removed. In addition, the extensions/v1beta1 API has been removed for select resources

Overview

---

Helm2Ansible-Operator-SDK (H2A) is a tool which creates the scaffold for Helm Operators corresponding to Helm Charts in a reproducible and scalable way. Read more about the design in the design doc.

Helm is a tool used for managing Kubernetes charts. Charts are packages of pre-configured Kubernetes resources. Helm allows for versioning and distribution of native Kubernetes applications.

Prerequisites

---

• git
• go version v1.13+
• operator-sdk version v0.13+

Compile and install from master

$ go get -d github.com/redhat-nfvpe/helm2ansible-operator-sdk # This will download the git repository and not install it
$ cd $GOPATH/src/github.com/redhat-nfvpe/helm2ansible-operator-sdk
$ git checkout master
$ make tidy
$ make dependency  # Installs operator sdk 
$ make install

Quick Start

---

In the following example, we will create an nginx-operator using the existing Bitnami Nginx Helm Chart.

Create, Build and Deploy an nginx-operator from Local Chart

# Create an nginx-operator that defines the Ngnix CR
# Begin scaffolding process
$ helm2ansible-operator-sdk new nginx-operator --helm-chart=/path/to/nginx --api-version=web.example.com/v1alpha1 --kind=Ngnix
# Enter operator directory
$ cd nginx-operator

# Build the operator
$ operator-sdk build quay.io/example/image
$ docker push quay.io/example/image

# Deploy the Operator
# Update the operator manifest to use the built image name (if you are performing these steps on OSX, see note below)
$ sed -i 's|REPLACE_IMAGE|quay.io/example/app-operator|g' deploy/operator.yaml
# On OSX use:
$ sed -i "" 's|REPLACE_IMAGE|quay.io/example/app-operator|g' deploy/operator.yaml

# Setup Service Account
$ kubectl create -f deploy/service_account.yaml
# Setup RBAC
$ kubectl create -f deploy/role.yaml
$ kubectl create -f deploy/role_binding.yaml
# Setup the CRD
$ kubectl create -f deploy/crds/web_v1alpha1_nginx_crd.yaml
# Deploy the app-operator
$ kubectl create -f deploy/operator.yaml

# Create an AppService CR
# The default controller will watch for AppService objects and create a pod for each CR
$ kubectl create -f deploy/crds/app_v1alpha1_nginx_cr.yaml

# Verify that a pod is created
$ kubectl get pod -l app=example-nginx
NAME                     READY     STATUS    RESTARTS   AGE
example-nginx-pod   1/1       Running   0          1m

Supported Kubernetes Resources

---

The tool currently supports a very limited selection of Kubernetes resources, as listed here:

RoleKubernetes version 1.16 has removed several deprecated APIs that you'll likely recognize and may use on a daily basis. The apps/v1beta1 and apps/v1beta2 APIs have been completely removed. In addition, the extensions/v1beta1 API has been removed for select resources
ClusterRole
RoleBinding
ClusterRoleBinding
ServiceAccount
Service
Deployment

If attempting to parse a Kubernetes resource other than the ones listed above the tool will prompt the user to either continue code generation without the unsupported resources or stop the code generation all together.

Note: H2A currently only supports non-deprecated resources. Thus, API Versions such as apiVersion: extensions/v1beta1 should be updated to apiVersion: apps/v1 or similar.