Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meteorops/crossplane-aws-provider-bootstrap

Deploy resources on AWS using Crossplane & Helm
https://github.com/meteorops/crossplane-aws-provider-bootstrap

aws crossplane devops helm kubernetes

Last synced: 19 days ago
JSON representation

Deploy resources on AWS using Crossplane & Helm

Awesome Lists containing this project

README 

        
# crossplane-aws-provider-bootstrap



Prerequisites

- kubectl

- helm

- Existing k8s cluster or kind

- aws account with access key and secret key and sufficient permissions



If using kind:



`kind create cluster`



May need to run this as well:



`kubectl cluster-info --context kind-kind`



If used kind delete the cluster in the end:



`kind delete cluster`



## Article #1



Install crossplane:

=======

Step-by-step guide and files to deploy Crossplane on AWS EKS and start using it to deploy AWS resources.  

This repository is used by the ["Deploy AWS Resources using Crossplane on Kubernetes"](https://www.meteorops.com/blog/deploy-aws-resources-using-crossplane-on-kubernetes) blog post.



### Deploy Crossplane



`helm repo add crossplane-stable https://charts.crossplane.io/stable`



`helm install crossplane crossplane-stable/crossplane --namespace crossplane-system --create-namespace`



### Deploy the AWS Provider



Insert your AWS credentials to the creds file and run the following from the same folder:



`kubectl create secret generic aws-credentials -n crossplane-system --from-file=creds=./creds`



Install aws provider bootstrap:



`kubectl apply -f crossplane-provider-bootstrap.yaml`



Wait for provider to be ready:



`kubectl get provider`



Install aws provider config:



`kubectl apply -f crossplane-provider-conf.yaml`



Apply composite bucket definitions:



`kubectl apply -f bucket-definitions.yaml`



Apply composite bucket crd:



`kubectl apply -f bucket-crd.yaml`



### Create an AWS Resource using Crossplane (S3 Bucket Example)



Create a bucket:



`kubectl apply -f bucket-example.yaml`



Check that bucket is created:



`kubectl get mys3bucket`



or



`kubectl get bucket`



Clean, delete the bucket:



`kubectl delete -f bucket-example.yaml`



### Useful Debugging Commands



`kubectl get provider`



`kubectl logs -n crossplane-system deploy/crossplane -c crossplane`



`kubectl logs -n crossplane-system -l pkg.crossplane.io/provider=provider-aws`



## Article #2



For the Crossplane Kubernetes Provider, insert your AWS credentials to the creds file and run the following from the same folder:



```bash

kubectl create secret generic aws-creds \

--from-literal=aws_access_key_id=$(grep -i aws_access_key_id creds | awk -F' = ' '{print $2}') \

--from-literal=aws_secret_access_key=$(grep -i aws_secret_access_key creds | awk -F' = ' '{print $2}')

```

### Install the k8s-provider-bootstrap file

It deploys the following resources to setup the Crossplane Kubernetes Provider: ServiceAccount, Provider (Crossplane), ClusterRole, ClusterRoleBinding.

Note that it could also be a Helm Provider if you want to use Helm instead of direct Kubernetes resources for the application part.



`kubectl apply -f k8s-provider-bootstrap.yaml`



Wait for k8s provider to be ready:



`kubectl get providers`



Install k8s provider config (points to the cluster on which the Provider is deployed, but could be pointed at other clusters as well):



`kubectl apply -f k8s-provider-conf.yaml`



Apply composite app definitions:



`kubectl apply -f composite-app-xrd.yaml`



Apply composite app crd:



`kubectl apply -f composite-app-composition.yaml`



Create a composite app:



`kubectl apply -f composite-app-example.yaml`



Check that composite app is created:



`kubectl get K8sApplication`



Check in the logs composite app is can list the bucket that was created:



`kubectl logs -l app=awscli`



Clean, delete the composite app:



`kubectl delete -f composite-app-example.yaml`