https://github.com/kjenney/gitops-local-with-cloud-infra
Local K8S that provisions infrastructure on a cloud provider
https://github.com/kjenney/gitops-local-with-cloud-infra
argocd aws crossplane
Last synced: 4 months ago
JSON representation
Local K8S that provisions infrastructure on a cloud provider
- Host: GitHub
- URL: https://github.com/kjenney/gitops-local-with-cloud-infra
- Owner: kjenney
- Created: 2023-12-23T10:54:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-28T18:53:54.000Z (over 1 year ago)
- Last Synced: 2025-01-07T20:12:43.322Z (5 months ago)
- Topics: argocd, aws, crossplane
- Language: Smarty
- Homepage:
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# gitops-local-with-cloud-infra
Local K8S that provisions infrastructure on a cloud provider that supports a Database API
## Chosen Tools
* Rancher Desktop
* AWS Cloud
* Crossplane
* Argo CD
* kubectx
## Requirements
* [Rancher Desktop](https://rancherdesktop.io/) already installed
* [kubectx](https://github.com/ahmetb/kubectx) already installed
* AWS credentials for Cloud Infra saved in `/tmp/credentials`
## Quickstart
Run the following commands:
1. `kubectx rancher-desktop`
2. Install Argo CD. Use [Getting Started](https://argo-cd.readthedocs.io/en/stable/getting_started/).
3. Deploy Crossplane using Argo CD [here](#Deploy-CrossPlane-using-Argo-CD).
4. Deploy Kubernetes Secret with AWS Credentials [here](#Create-Kubernetes-Secret-for-AWS-Providers).
5. Deploy Crossplane's AWS Providers with Argo CD [here](#Deploy-Crossplane-AWS-Providers-using-Argo-CD).
7. Deploy Infra using Argo CD [here](#Deploy-Infra).
8. Test Infra using Argo CD [here](#Test-Infra).
## Deploy CrossPlane using Argo CD
Run the following code:
```
kubectl create ns crossplane
argocd app create crossplane --repo https://charts.crossplane.io/stable --helm-chart crossplane --revision 1.14.5 --dest-namespace crossplane --dest-server https://kubernetes.default.svc
argocd app sync crossplane
```
## Create Kubernetes Secret for AWS Providers
Use [AWS Quickstart](https://docs.crossplane.io/latest/getting-started/provider-aws/#create-a-kubernetes-secret-for-aws). Update the namespace to use `crossplane` like so:
```
kubectl create secret generic aws-secret -n crossplane --from-file=creds=/tmp/credentials
```
## Deploy CrossPlane AWS Providers using Argo CD
```
argocd app create crossplane-aws-provider --repo https://github.com/kjenney/gitops-local-with-cloud-infra --path charts/crossplane-aws --dest-server https://kubernetes.default.svc
argocd app sync crossplane-aws-provider
```
## Deploy Infra
Run the following code:
```
argocd app create infra-tester --repo https://github.com/kjenney/gitops-local-with-cloud-infra --path charts/infra-tester --dest-server https://kubernetes.default.svc
argocd app sync infra-tester
```
Wait for `example-dbinstance-out` secret to populate connection info before continuing. You'll see a value under `DATA` for the secret. `kubernetes get secret -n smart-search example-dbinstance-out`
## Test Infra
TODO
## Cleaning Up
Run the following code:
```
argocd app delete infra-tester
argocd app delete crossplane-aws-provider
argocd app delete crossplane
```
## Troubleshooting
### Rancher Desktop Troubleshooting
If you have issues with Rancher Desktop try the following:
1. Run `rdctl factory-reset`
2. Relaunch Rancher Desktop from your desktop
3. Ensure you are on the latest version - upgrade if necessary
### CrossPlane Troubleshooting
To get the latest versions of Crossplane packages, go [here](https://marketplace.upbound.io/providers/upbound/provider-family-aws)
## Decisions
- Rancher Desktop
- Minikube wouldn't work with my version of Virtualbox and it was too difficult to downgrade on a Mac
- Useful because it bundles dependencies, such as kubectl
- AWS Cloud
- It's well-known
- I know it very well
- Crossplane
- It's CNCF and well-known
- I want to be able to bundle infra with services during deployment
- Argo CD
- It's CNCF and well-known
- kubectx
- Becaus I don't feel like running more than one command if I don't have to