provider-helm is a Crossplane Provider that enables deployment and management of Helm Releases on Kubernetes clusters typically provisioned by Crossplane:

• A Provider resource type that only points to a credentials Secret.
• A Release resource type that is to manage Helm Releases.
• A managed resource controller that reconciles Release objects and manages Helm releases.

If you would like to install provider-helm without modifications, you may do so using the Crossplane CLI in a Kubernetes cluster where Crossplane is installed:

kubectl crossplane install provider crossplane/provider-helm:master

You may also manually install provider-helm by creating a Provider directly:

apiVersion: pkg.crossplane.io/v1alpha1
kind: Provider
metadata:
  name: provider-helm
spec:
  package: "crossplane/provider-helm:master"

See the design document.

Start a local development environment with Kind where crossplane is installed:

make local-dev

Run controller against the cluster:

make run

Since controller is running outside of the Kind cluster, you need to make api server accessible (on a separate terminal):

sudo kubectl proxy --port=8081

1. Prepare KUBECONFIG for local cluster:

   1. If helm provider running in cluster (e.g. provider installed with crossplane):

      KUBECONFIG=$(kind get kubeconfig --name local-dev | sed -e 's|server:\s*.*$|server: https://kubernetes.default.svc|g')
      

   2. If provider helm running outside of the cluster (e.g. running locally with make run)

      KUBECONFIG=$(kind get kubeconfig --name local-dev | sed -e 's|server:\s*.*$|server: http://localhost:8081|g')
      

2. Create KUBECONFIG secret for local cluster and deploy local-provider.yaml.

   kubectl -n crossplane-system create secret generic local-cluster --from-literal=kubeconfig="${KUBECONFIG}" 
   kubectl apply -f examples/provider-config/local-provider-config.yaml 
   

3. Now you can create Release resources with provider reference, see sample release.yaml.

   kubectl create -f examples/sample/release.yaml
   

make local.down