Erich Blume
517080aeab
## Summary - Create `docs/reference/tools/` with four reference cards: Dagger (build engine), ArgoCD CLI (deployment workflows), Ansible (config management), and Pulumi (DNS/Tailscale IaC) - Move `ansible/roles.md` → `tools/ansible.md`, broadened with CLI patterns and dry-run usage - Update `reference.md` index: add "Tools" section, remove old "Ansible" section - Update `update-documentation.md` to reflect Dagger build process (workflow steps, manual build recipe, runner environment) - Update `adopt-dagger-ci.md` plan to note how-to articles were handled via reference card + existing how-to updates - Fix all broken `[[roles]]` wiki-links across 5 files → `[[ansible]]` ## Verification - `docs-check-links` ✓ — no broken wiki-links - `docs-check-index` ✓ — all docs referenced in category index - `docs-check-filenames` ✓ — no duplicate filenames - All pre-commit hooks pass Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/178
54 lines
1.2 KiB
Markdown
54 lines
1.2 KiB
Markdown
---
|
|
title: ArgoCD CLI
|
|
modified: 2026-02-12
|
|
tags:
|
|
- reference
|
|
- gitops
|
|
- argocd
|
|
---
|
|
|
|
# ArgoCD CLI
|
|
|
|
Command-line workflows for deploying and managing applications via [[argocd]].
|
|
|
|
## CLI Commands
|
|
|
|
```bash
|
|
argocd app list # List all applications and sync status
|
|
argocd app get <app> # Show app details, health, and resources
|
|
argocd app diff <app> # Preview what would change on sync
|
|
argocd app sync <app> # Apply pending changes
|
|
argocd app sync apps # Sync the app-of-apps (picks up new Application manifests)
|
|
```
|
|
|
|
## Login
|
|
|
|
```bash
|
|
argocd login argocd.ops.eblu.me \
|
|
--username admin \
|
|
--password "$(op read 'op://vg6xf6vvfmoh5hqjjhlhbeoaie/srogeebssulhtb6tnqd7ls6qey/password')"
|
|
```
|
|
|
|
## Branch-Testing Workflow
|
|
|
|
Test changes from a feature branch before merging:
|
|
|
|
```bash
|
|
# 1. Point the app at your branch
|
|
argocd app set <service> --revision <branch>
|
|
|
|
# 2. Sync to deploy the branch version
|
|
argocd app sync <service>
|
|
|
|
# 3. Test the changes...
|
|
|
|
# 4. After merge, reset to main and sync
|
|
argocd app set <service> --revision main
|
|
argocd app sync <service>
|
|
```
|
|
|
|
## Related
|
|
|
|
- [[argocd]] — Service reference (URLs, credentials, sync policy)
|
|
- [[apps]] — Full application registry
|
|
- [[forgejo]] — Git source
|