Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178)
## 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
2026-02-12 19:18:46 -08:00
|
|
|
---
|
|
|
|
|
title: ArgoCD CLI
|
|
|
|
|
modified: 2026-02-12
|
2026-04-01 20:35:18 -07:00
|
|
|
last-reviewed: 2026-04-01
|
Add reference/tools/ category with Dagger, ArgoCD CLI, Ansible, and Pulumi cards (#178)
## 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
2026-02-12 19:18:46 -08:00
|
|
|
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
|