656 words
3 min read

GitOps on AWS — Real-World DevOps Pipeline with Argo CD, Terraform & EKS

By · Solutions Architect · Docker Captain · IBM Champion
Wooden desk with dual ultrawide monitors showing a minimalist "DO MORE" wallpaper, a tidy mechanical keyboard, open notepad, large potted monstera, and a shelf with retro license plates

This is how I built a production-grade GitOps pipeline on AWS. Fully containerized, drawn straight from what I run in production.

No buzzwords. No clickbait. The architecture works, and the mindset behind it holds up as you grow.


Why I Chose GitOps#

GitOps is about control. Git becomes the one place that tells the truth about your system.

  • Every change goes through a pull request.
  • Every rollback is just a git revert.

No guesswork. Nobody asking who deployed what on Friday night. By 2025 this stopped being a trend. If your team is serious about infrastructure, it’s the floor you start from, not the ceiling you reach for.

So why does my setup look the way it does? Start with the stack.


My Stack at a Glance#

One terraform apply. That gets you a reproducible platform, codified end to end, with nothing done by hand.


Why Containers?#

A container is the smallest unit of reliability I know of. It runs the same way in dev, in staging, and in production. Isolated, predictable, pinned to a version. CI builds the image and tags it, say release-2025.04.16-prod, then pushes it to Amazon ECR. What runs in production is that exact artifact, byte for byte.

You know the old joke about how it works on my machine? Containers retire it. You ship systems instead of chaos.


The GitOps Mindset Shift#

GitOps asks you to rethink one thing, and it trips up plenty of experienced teams. Here’s the mistake I keep running into.

They assume CI should handle deployments. Under GitOps it doesn’t.

  • CI’s job is simply to push changes to Git.
  • Argo CD handles the deploy. On its own. On schedule. No manual triggers.

That split is the whole point. Git holds the truth. CI is just the courier that gets your change there.


How It All Connects#

  • CI runs on GitHub Actions.
  • It builds the Docker image, pushes it to Amazon ECR, updates Helm values, and commits to Git.
  • Argo CD detects changes and applies them to the cluster.
  • Terraform provisions the entire platform, Argo CD included.
  • Vault integrates securely, providing secrets at runtime.

So there are no plain-text tokens sitting around. No unencrypted environment variables either.

This stack does the job, and it holds up when something goes wrong.


Hard-Earned Lessons#

Getting here took a while, and I paid for a few of these the hard way. Here’s what I’d tell you so you skip my mistakes.

1. Bootstrapping#

Argo CD doesn’t magically install itself.

You need a plan for that first install. I use Terraform and the Helm Provider to automate it.

2. Namespaces#

Never run Argo CD alongside your applications.

Keep it isolated. Your future self will thank you for it.

3. Secrets#

If your secrets live in YAML files, that isn’t GitOps. That’s hopeOps.

Use Vault or AWS Secrets Manager. Credentials never go in the open.


Monitoring: The Non-Negotiable#

If your monitoring is users calling you at 3 AM, that isn’t monitoring. It’s a nightmare with a phone number.

For metrics I run Prometheus and Grafana. Loki handles logs, Alertmanager handles alerts. Argo CD exposes its own metrics too, so the moment the cluster drifts from Git, I see it.

Monitoring isn’t a bolt-on you add later. Skip it and you’re flying blind.


What Success Looks Like#

  • Deployment time: minutes, not hours.
  • Rollbacks: one click.
  • New environments: one command.
  • New developers: clone and go.
  • Everything documented, repeatable, and under control.

None of that is hype. That’s the day-to-day.


Final Thoughts#

This is more than a list of tools. It’s a way of working. Containers, infrastructure as code, every change routed through Git: that’s what a mature system looks like in 2025. GitOps was never really about YAML. It’s about building something you can actually trust.

Thank you for reading! Don’t forget to check out the video version for additional insights and visuals.


Vladimir Mikhalev

Docker Captain  ·  IBM Champion  ·  AWS Community Builder

The Verdict — production-tested analysis on YouTube.

Related Posts

Same category
  1. 1
    Docker supply chain hardening — from Scout D to OpenSSF 7.8 on a 730K-pull image
    DevOps & Cloud · How I hardened a 730K-pull public Docker image from Scout grade D to OpenSSF Scorecard 7.8. Multi-stage build, cosign signing, SLSA provenance, non-root default, and the incident that changed how I ship attestations.
  2. 2
    Cloudflare Web Analytics on Astro — Why Removing GA4 Unlocked Lighthouse 100
    DevOps & Cloud · How removing Google Analytics 4 from an Astro site unlocked Lighthouse 100, why Cloudflare Web Analytics replaced it, and what the tradeoffs actually cost.
  3. 3
    Platform Engineering — The Complete, Practical Guide to Building Internal Developer Platforms That Scale
    DevOps & Cloud · A deep, practical guide to Platform Engineering. Learn how to build internal developer platforms, golden paths, GitOps workflows, and scalable cloud foundations.
  4. 4
    Amazon Q vs DevOps Chaos — Can This AI Fix AWS Faster Than You?
    DevOps & Cloud · Fix AWS issues faster with Amazon Q, the AI assistant built for DevOps. Real-world examples, limitations, and how it compares to ChatGPT.

Random Posts

Random
  1. 1
    Install Minecraft on Windows
    SysAdmin & IT Pro · Step-by-step guide on how to install Minecraft Java Edition on Windows. Learn how to download, install, and launch Minecraft quickly and easily.
  2. 2
    Install Home Assistant Using Docker Compose
    Self-Hosting · Step-by-step guide to install Home Assistant with Docker Compose and Traefik. Secure your smart home with HTTPS using Let's Encrypt.
  3. 3
    Git Cheat Sheet
    DevOps & Cloud · Fast and practical Git cheat sheet for developers. Learn essential Git commands for setup, commits, branching, merging, and more in one convenient guide.
  4. 4
    Configure Exchange Server 2016
    SysAdmin & IT Pro · Step-by-step guide to configure Exchange Server 2019. Learn how to set up mailbox databases, public folders, DNS, certificates, send/receive connectors, and more.
GitOps on AWS — Real-World DevOps Pipeline with Argo CD, Terraform & EKS
https://heyvaldemar.com/gitops-on-aws-real-world-devops-pipeline-with-argo-cd-terraform-and-eks/
Author
Vladimir Mikhalev
Published
2025-04-22
License
CC BY-NC-SA 4.0