Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/minghsu0107/cicd-demo
Cloud-native CI/CD with DroneCI + ArgoCD + Kubernetes.
https://github.com/minghsu0107/cicd-demo
argocd droneci gitops golang k8s
Last synced: 3 months ago
JSON representation
Cloud-native CI/CD with DroneCI + ArgoCD + Kubernetes.
- Host: GitHub
- URL: https://github.com/minghsu0107/cicd-demo
- Owner: minghsu0107
- Created: 2021-02-11T06:42:08.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-11-29T05:43:54.000Z (about 2 years ago)
- Last Synced: 2024-06-20T08:18:15.268Z (7 months ago)
- Topics: argocd, droneci, gitops, golang, k8s
- Language: Go
- Homepage:
- Size: 19.5 KB
- Stars: 58
- Watchers: 1
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CI/CD Demo
This tutorial shows how to build CI/CD pipeline with DroneCI and ArgoCD. In this demo, we use DroneCI for running tests, publishing new images, and update image tags in the manifest repository. We then use ArgoCD for continuous delivery, synchronizing application states in the Kubernetes cluster with manifests maintained in the Git repository.
This way of doing Kubernetes cluster management and application delivery is kown as GitOps. By applying GitOps, we can maintain a 'source of truth' for both the application code and infrastructure, improving system reliability and efficiency for your team.
Architecture overview:
## Prerequisites
1. A Drone server
- [Github installation](https://docs.drone.io/server/provider/github/)
2. A K8s cluster
- [K3d](https://k3d.io)
- [minikube](https://minikube.sigs.k8s.io/docs/start/)
- [K0s](https://github.com/k0sproject/k0s)
3. ArgoCD deployment
- [All-in-one installation](https://argo-cd.readthedocs.io/en/stable/getting_started/#1-install-argo-cd)
4. A Github account and a Dockerhub account
## DroneCI
### Setup
After you have connected your Github account with Drone, you can browse all your repositories on Drone dashboard. Next, clone this repo, activate it and navigate to `Repositories -> cicd-demo -> settings` to add the following secrets:
- `docker_username`: your Dockerhub account
- `docker_password`: your Dockerhub password
- `ssh_key`: base64-encoded RSA private key for accessing Github
To access Github using SSH, you should first upload a RSA public key, such as `~/.ssh/id_rsa.pub`, to Github. Then, you could generate base64-encoded RSA private key by running `cat ~/.ssh/id_rsa | base64`.
Finally, replace `minghsu0107` with your Github and Dockerhub account in `.drone.yml`. Now any push or pull request will trigger a Drone pipeline. You can check details via `your repo -> setting -> webhook` on Github.
### Local Development
For local development, you will not want to push every change to your repo just for testing whether `.drone.yml` works. Instead, you can use [Drone CLI](https://docs.drone.io/cli/install/) to execute pipeline locally.
Login to Drone:
```bash
export DRONE_SERVER=
export DRONE_TOKEN= # check token under dashboard -> user setting
drone info
```
For example, you can run step `test` only by executing the following script under the project root:
```
drone exec --include=
```
## ArgoCD
Please clone [the application manifest repository](https://github.com/minghsu0107/cicd-demo-manifests) first. This repo holds the application manifests and will be synced with ArgoCD later. The manifests are maintained by [Kustomize](https://github.com/kubernetes-sigs/kustomize), which is supported by ArgoCD out-of-the-box.
If your repository is set to private, you need to configure access credentials on ArgoCD. Otherwise you can skip this step and create new app directly.
Credentials can be configured using Argo CD CLI:
```bash
argocd repo add --username --password
```
Or you can configure via UI. Navigate to `Settings/Repositories`; click `Connect Repo using HTTPS` and enter credentials:
You will see something like:
Create new app:
Remember to place the repository with your own repo.
Now we have finish all preparations, and it's time to let the magic happen. Navigate to `/applications` and click SYNC button on your app in order to synchronize the cluster state:
You can click your app to view details:
As we can see, ArgoCD automatically sync the application to our desired state specified in `production` base. It also shows how all resources roll out in the cluster. With ArgoCD, we can not only have complete control over the entire application deployment but also track updates to branches, tags, or pinned to a specific version of manifests at a Git commit.
## Reference
- https://www.weave.works/technologies/gitops/
- https://argo-cd.readthedocs.io/en/stable/
- https://docs.drone.io
- https://hub.docker.com/r/line/kubectl-kustomize