Skip to content

Latest commit

 

History

History
77 lines (61 loc) · 2.38 KB

README.md

File metadata and controls

77 lines (61 loc) · 2.38 KB
Raw

Overview

This repo aims to present gitops principles by showing the automatic reconciliation steps with ArgoCD. It uses minikube as a replacement for a real k8s cluster.

Prerequisites

  • Docker v26.1.3 or higher
  • Minikube v1.33.1 or higher
  • kubectl v1.22.10 or higher
  • argocd CLI v2.11.3 or higher

How to install argocd CLI

Steps taken from: https://argo-cd.readthedocs.io/en/stable/cli_installation/

  1. curl -sSL -o argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
  2. chmod +x argocd
  3. sudo mv argocd /usr/local/bin/

First time setup

Start minikube and install argocd

Steps taken from argocd docs: https://argo-cd.readthedocs.io/en/stable/getting_started/#1-install-argo-cd

  1. minikube start
  2. kubectl create namespace argocd
  3. kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
  4. kubectl get pods -n argocd
  5. argocd login --core

If these steps have been followed once, steps 2-4 can be skipped.

Build Docker image and push to minikube

Build the image

  1. docker build -t shrimp:latest .

Check image is present

  1. docker images | grep shrimp

Verify image runs as intended and returns a message every second

  1. docker run --name shrimp -e MESSAGE="test" shrimp:latest
  2. docker logs -f shrimp

Stop the container

  1. docker stop shrimp

Make minikube use docker-env

  1. eval $(minikube docker-env)

Load docker image via minikube

  1. minikube image load shrimp

Optional: Verify deployment

  1. kubectl apply -f infra/deployment.yaml
  2. kubectl logs -f

Create argocd application

Port-forward argocd-server service

  1. kubectl port-forward svc/argocd-server -n argocd 8080:443

Access the UI

  1. Go to https://localhost:8080

Get initial password

  1. argocd admin initial-password -n argocd

Log in with user:admin and password from above

Apply argocd application CRD

  1. kubectl apply -f application.yaml

See some syncing happen, trigger it manually after mering PR

How to Demo

  1. minikube start
  2. kubectl port-forward svc/argocd-server -n argocd 8080:443
  3. Go to http://localhost:8080
  4. Create new branch
  5. Open infra/deployment.yaml
  6. Change message, push, merge PR
  7. Checkout main again and pull
  8. In new terminal: kubectl get pods -w
  9. In argocd UI: trigger sync with prune enabled
  10. Watch the new pod come up in CLI and argocd UI.