Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wingkwong/argocd-playground
Demonstrating how to setup Argo CD on a k3s cluster using arkade and k3d
https://github.com/wingkwong/argocd-playground
argocd arkade gitops k3d
Last synced: about 2 months ago
JSON representation
Demonstrating how to setup Argo CD on a k3s cluster using arkade and k3d
- Host: GitHub
- URL: https://github.com/wingkwong/argocd-playground
- Owner: wingkwong
- License: mit
- Created: 2020-03-30T12:16:40.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T11:56:34.000Z (about 1 year ago)
- Last Synced: 2024-06-21T15:44:17.917Z (6 months ago)
- Topics: argocd, arkade, gitops, k3d
- Language: Go
- Homepage:
- Size: 9.77 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# argocd-playground
Demonstrating how to setup Argo CD on a k3s cluster using arkade and k3d.
> This is just a learning playground
# Prerequisites
You need to install Docker on your machine and you need to register for a Docker Hub account as your Docker images will be stored there
# Install k3d
k3d is a little helper to run k3s in docker, where k3s is the lightweight Kubernetes distribution by Rancher. It actually removes millions of lines of code from k8s. If you just need a learning playground, k3s is definitely your choice.
Check out [k3d Github Page](https://github.com/rancher/k3d#get) to see the installation guide.
> When creating a cluster, ``k3d`` utilises ``kubectl`` and ``kubectl`` is not part of ``k3d``. If you don't have ``kubectl``, please install and set up [here](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
Once you've installed ``k3d`` and ``kubectl``, run
```
k3d create -n argocd-playground
```
We need to make ``kubectl`` to use the kubeconfig for that cluster.
```
export KUBECONFIG="$(k3d get-kubeconfig --name='argocd-playground')"
```
# Install arkade
Moving on to [arkade](https://github.com/alexellis/arkade), it provides a simple Golang CLI with strongly-typed flags to install charts and apps to your cluster in one command. Originally, the codebase is derived from [k3sup](https://github.com/alexellis/k3sup) which I've contributed last month.
```
curl -sLS https://dl.get-arkade.dev | sudo sh
```
Once you've installed it, you should see the following
```
New version of arkade installed to /usr/local/bin
_ _
__ _ _ __| | ____ _ __| | ___
/ _` | '__| |/ / _` |/ _` |/ _ \
| (_| | | | < (_| | (_| | __/
\__,_|_| |_|\_\__,_|\__,_|\___|
Get Kubernetes apps the easy way
Version: 0.2.2
Git Commit: 9063b6eb16deae5978805f71b0e749828c815490
```
Install Argo CD via arkade. You can use an alias ``ark`` or ``arkade``.
```
ark install argocd
```
You should see the following info
```
Using kubeconfig: /Users/wingkwong/.config/k3d/argocd-playground/kubeconfig.yaml
Node architecture: "amd64"
=======================================================================
= ArgoCD has been installed =
=======================================================================
# Get the ArgoCD CLI
brew tap argoproj/tap
brew install argoproj/tap/argocd
# Or download via https://github.com/argoproj/argo-cd/releases/latest
# Username is "admin", get the password
kubectl get pods -n argocd -l app.kubernetes.io/name=argocd-server -o name | cut -d'/' -f 2
# Port-forward
kubectl port-forward svc/argocd-server -n argocd 8081:443 &
http://localhost:8081
# Get started with ArgoCD at
# https://argoproj.github.io/argo-cd/#quick-start
Thanks for using arkade!
```
Follow the step to enable port forwarding
```
kubectl port-forward svc/argocd-server -n argocd 8081:443 &
```
```
Forwarding from [::1]:8081 -> 8080
```
Open your browser and browse ``http://localhost:8080/``. You should see the Argo CD UI.
As stated in the console info upon the completion of installation, the username is ``admin`` and you can get hte password by running
```
kubectl get pods -n argocd -l app.kubernetes.io/name=argocd-server -o name | cut -d'/' -f 2
```
> If you want to check out the info, you can run ``ark info argocd``.
After logging in, you should see the application page.
Set your application name. Use the project ``default`` and choose the sync policy to ``Manual``.
Connect your repository to Argo CD. Select the revision and the path where your manifests files are located.
Set the cluster to ``https://kubernetes.default.svc`` with ``default`` namespace.
Click ``Create``. Then you should see there is an application on the portal.
You can also switch it to the list view
or summary view
Here is my application
```go
package main
import (
"io"
"log"
"net/http"
)
func main() {
http.HandleFunc("/", Handler)
if err := http.ListenAndServe(":8888", nil); err != nil {
log.Fatal(err)
}
}
func Handler(w http.ResponseWriter, r *http.Request) {
w.Header().Add("Content-Type", "application/json")
io.WriteString(w, `{"status":"ok"}`)
}
```
Let's add ``deployment.yaml``
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: argocd-playground
spec:
replicas: 1
revisionHistoryLimit: 3
selector:
matchLabels:
app: argocd-playground
template:
metadata:
labels:
app: argocd-playground
spec:
containers:
- image: wingkwong/argocd-playground:v1
name: argocd-playground
ports:
- containerPort: 8888
```
and ``service.yaml``
```yml
apiVersion: v1
kind: Service
metadata:
name: argocd-playground
spec:
ports:
- port: 8888
targetPort: 8888
selector:
app: argocd-playground
```
Once you've pushed your commit, Argo CD detects changes under ``manifests``. It updates the status to ``OutOfSync``.
Let's sync.
Enable port forwarding
```
kubectl port-forward svc/argocd-playground 8888:8888
```
Verify v1 in the browser
```
http://localhost:8888/
```
You should see
```
{"status":"ok"}
```
Update the application
Build and push the docker image to docker hub. Then update the image tag to v2 in ``deployment.yaml``.
```yaml
- image: wingkwong/argocd-playground:v2
```
Go back to Argo CD UI, the status becomes ``OutofSync``.
Click ``SYNC``
A new pod is being created, while the original one is still here.
Once it is ready, the original one will be deleted.
You should see the below error
```
E0331 20:24:00.727018 61938 portforward.go:400] an error occurred forwarding 8888 -> 8888: error forwarding port 8888 to pod 0f8b6902adcdbfdcde17a17bc1d182db8c4c849ba50ef369d90969e1349797b5, uid : failed to find sandbox "0f8b6902adcdbfdcde17a17bc1d182db8c4c849ba50ef369d90969e1349797b5" in store: does not exist
```
We should stop port forwarding before redeploying a different version. Let's kill it and do it again.
```
kubectl port-forward svc/argocd-playground 8888:8888
```
Go to
```
http://localhost:8888/
```
Now you can see the new changes
```
{"status":"ok", "message": "hello-world"}
```
# Clean up
```
k3d delete -n argocd-playground
```
# Compare with FluxCD
Argo CD allows users to sync in an application level instead of a repository level by setting the Path. It supports different templating such as kustomize, helm, ksonnet, jsonnet, etc. With an UI portal, users can simply manage the application there. However, it cannot monitor a docker repository and deploy from the repository. The docker image needs to be manually updated for each updates.
# Useful links
- [Argo CD](https://argoproj.github.io/argo-cd/)
- [arkade](https://github.com/alexellis/arkade#get-arkade)
- [k3d](https://github.com/rancher/k3d)