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
This commit is contained in:
parent
9c789a1868
commit
517080aeab
13 changed files with 237 additions and 48 deletions
54
docs/reference/tools/argocd-cli.md
Normal file
54
docs/reference/tools/argocd-cli.md
Normal file
|
|
@ -0,0 +1,54 @@
|
|||
---
|
||||
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
|
||||
Loading…
Add table
Add a link
Reference in a new issue