Repository navigation
Expand file tree
/
Copy pathTaskfile.yml
More file actions
722 lines (654 loc) · 24.5 KB
/
Copy pathTaskfile.yml
File metadata and controls
722 lines (654 loc) · 24.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
---
version: "3"
# Task runner for Docker Infrastructure repository
# Install Task: https://taskfile.dev/installation
# Usage: task [task-name]
# List all tasks: task --list
vars:
REPO_ROOT:
sh: pwd
ANSIBLE_DIR: "{{.REPO_ROOT}}/ansible"
TEST_DIR: "{{.REPO_ROOT}}/tests/bash"
PYTHON_BIN:
sh: which python3 || which python
ANSIBLE_PLAYBOOK: "{{.ANSIBLE_DIR}}/playbooks/main.yml"
ANSIBLE_INVENTORY: "{{.ANSIBLE_DIR}}/inventory/hosts.yml"
env:
ANSIBLE_CONFIG: "{{.REPO_ROOT}}/ansible.cfg"
tasks:
default:
desc: Show available tasks
cmds:
- task --list
silent: true
# Setup and Installation
install:
desc: Install all dependencies (mise tools, Python packages, Ansible collections)
cmds:
- task: install:mise
- task: install:python
- task: install:ansible-collections
- task: install:ansible-roles
- task: install:bats
install:mise:
desc: Install mise and all configured tools
cmds:
- |
if ! command -v mise >/dev/null 2>&1; then
echo "Installing mise..."
curl https://mise.run | sh
echo 'eval "$(mise activate bash)"' >> ~/.bashrc
echo 'mise activate fish | source' >> ~/.config/fish/config.fish 2>/dev/null || true
export PATH="$HOME/.local/bin:$PATH"
else
echo "mise is already installed"
fi
- mise install
sources:
- .mise.toml
- .tool-versions
install:python:
desc: Install Python dependencies from requirements.txt
cmds:
- "{{.PYTHON_BIN}} -m pip install -r requirements.txt"
sources:
- requirements.txt
install:ansible-collections:
desc: Install required Ansible collections
cmds:
- ansible-galaxy collection install -r {{.ANSIBLE_DIR}}/requirements.yml --force
sources:
- "{{.ANSIBLE_DIR}}/requirements.yml"
install:ansible-roles:
desc: Install required Ansible roles
cmds:
- ansible-galaxy role install geerlingguy.docker --force
install:bats:
desc: Install Bats testing framework (via mise if available, otherwise fallback)
cmds:
- |
if command -v mise >/dev/null 2>&1 && mise list bats >/dev/null 2>&1; then
echo "Bats managed by mise"
mise install bats
elif ! command -v bats >/dev/null 2>&1; then
if command -v npm >/dev/null 2>&1; then
echo "Installing Bats via npm..."
npm install -g bats
elif command -v brew >/dev/null 2>&1; then
echo "Installing Bats via Homebrew..."
brew install bats-core
else
echo "Installing Bats from source..."
BATS_VERSION="1.14.0"
git clone --depth 1 --branch "v${BATS_VERSION}" https://github.com/bats-core/bats-core.git /tmp/bats-core
cd /tmp/bats-core && sudo ./install.sh /usr/local
rm -rf /tmp/bats-core
fi
else
echo "Bats is already installed"
fi
status:
- command -v bats
# Testing
test:
desc: Run all tests
cmds:
- task: test:all
test:all:
desc: Run all Bats tests
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh
test:lint:
desc: Run linting tests (yamllint, ansible-lint)
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --test lint-test.bats
test:syntax:
desc: Run syntax validation tests
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --test syntax-test.bats
test:docker:
desc: Run Docker provisioning tests
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --test docker-test.bats
test:ansible-pull:
desc: Run ansible-pull functionality tests
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --test ansible-pull-test.bats
test:github-ssh-keys:
desc: Run GitHub SSH keys role tests
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --test github-ssh-keys-test.bats
test:ci:
desc: Run tests in CI mode (installs dependencies, generates JUnit XML)
dir: "{{.TEST_DIR}}"
cmds:
- ./run-tests.sh --ci
# Linting
lint:
desc: Run all linters (yamllint and ansible-lint)
cmds:
- task: lint:yaml
- task: lint:ansible
lint:yaml:
desc: Run yamllint on all YAML files
cmds:
- yamllint .
lint:ansible:
desc: Run ansible-lint on Ansible files
dir: "{{.ANSIBLE_DIR}}"
cmds:
- ansible-lint
lint:fix:
desc: Attempt to auto-fix linting issues
cmds:
- echo "Auto-fixing YAML formatting issues..."
- yamllint --format parsable . || true
- ansible-lint --write --fix-experimental || true
# Syntax Checking
syntax:
desc: Run all syntax checks
cmds:
- task: syntax:playbook
- task: syntax:scripts
syntax:playbook:
desc: Check Ansible playbook syntax
dir: "{{.ANSIBLE_DIR}}"
cmds:
- ansible-playbook --syntax-check {{.ANSIBLE_PLAYBOOK}} -i {{.ANSIBLE_INVENTORY}}
syntax:scripts:
desc: Check shell script syntax
cmds:
- |
for script in $(find . -name '*.sh' -type f); do
echo "Checking $script..."
bash -n "$script"
done
# Ansible Operations
ansible:pull:
desc: Trigger ansible-pull service (requires sudo)
cmds:
- |
echo "Triggering ansible-pull service..."
sudo systemctl start ansible-pull.service
echo "Waiting for service to complete..."
sleep 2
sudo systemctl status ansible-pull.service --no-pager -l || true
ansible:check:
desc: Run ansible-pull in check mode (dry-run, no changes)
dir: "{{.ANSIBLE_DIR}}"
cmds:
- |
sudo ansible-pull \
--check \
--url https://github.com/DevSecNinja/docker.git \
--checkout main \
--directory /var/lib/ansible/local \
--inventory {{.ANSIBLE_INVENTORY}} \
--extra-vars "target_host=$(hostname)" \
{{.ANSIBLE_PLAYBOOK}}
ansible:playbook:
desc: Run main playbook locally (requires sudo)
dir: "{{.ANSIBLE_DIR}}"
cmds:
- sudo ansible-playbook {{.ANSIBLE_PLAYBOOK}} -i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)"
ansible:playbook:check:
desc: Run main playbook in check mode (dry-run)
dir: "{{.ANSIBLE_DIR}}"
cmds:
- sudo ansible-playbook {{.ANSIBLE_PLAYBOOK}} -i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)" --check
ansible:playbook:tags:
desc: Run playbook with specific tags (usage - task ansible:playbook:tags -- TAG=docker)
dir: "{{.ANSIBLE_DIR}}"
cmds:
- sudo ansible-playbook {{.ANSIBLE_PLAYBOOK}} -i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)" --tags
"{{.TAG}}"
ansible:logs:
desc: View ansible-pull logs (journalctl)
cmds:
- |
echo "=== Ansible Pull Service Logs ==="
sudo journalctl -u ansible-pull.service -n 5000 --no-pager -o short-precise
ansible:logs:follow:
desc: Follow ansible-pull logs in real-time
cmds:
- |
echo "Following ansible-pull service logs (Ctrl+C to exit)..."
sudo journalctl -u ansible-pull.service -f -o short-precise
ansible:status:
desc: Check ansible-pull timer and service status
cmds:
- |
echo "=== Ansible Pull Timer Status ==="
sudo systemctl list-timers ansible-pull.timer --no-pager
echo ""
echo "=== Service Status ==="
sudo systemctl status ansible-pull.timer --no-pager -l || true
echo ""
sudo systemctl status ansible-pull.service --no-pager -l || true
# Maintenance
# Note: run from repo root and pass ANSIBLE_CONFIG explicitly so manual
# invocations pick up roles_path. Timer-driven runs use the systemd unit's
# WorkingDirectory (the ansible-pull workdir) where ansible.cfg also lives.
maintenance:update:
desc: Run maintenance update playbook (update config & images)
dir: "{{.REPO_ROOT}}"
cmds:
- sudo ANSIBLE_CONFIG={{.REPO_ROOT}}/ansible.cfg ansible-playbook {{.ANSIBLE_DIR}}/playbooks/maintenance-update.yml
-i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)"
maintenance:daily:
desc: Run daily maintenance playbook (OS patches)
dir: "{{.REPO_ROOT}}"
cmds:
- sudo ANSIBLE_CONFIG={{.REPO_ROOT}}/ansible.cfg ansible-playbook {{.ANSIBLE_DIR}}/playbooks/maintenance-daily.yml -i
{{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)"
maintenance:weekly:
desc: Run weekly maintenance playbook (patches & reboot)
dir: "{{.REPO_ROOT}}"
cmds:
- sudo ANSIBLE_CONFIG={{.REPO_ROOT}}/ansible.cfg ansible-playbook {{.ANSIBLE_DIR}}/playbooks/maintenance-weekly.yml
-i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)"
maintenance:user-tools:
desc: Run user-tools maintenance playbook (chezmoi, Homebrew, mise)
dir: "{{.REPO_ROOT}}"
cmds:
- sudo ANSIBLE_CONFIG={{.REPO_ROOT}}/ansible.cfg ansible-playbook {{.ANSIBLE_DIR}}/playbooks/maintenance-user-tools.yml
-i {{.ANSIBLE_INVENTORY}} --extra-vars "target_host=$(hostname)"
maintenance:logs:
desc: View maintenance logs (usage - task maintenance:logs [-- daily|weekly|all])
cmds:
- |
TYPE="{{.CLI_ARGS | default "all"}}"
case "$TYPE" in
daily)
echo "=== Daily Maintenance Logs ==="
sudo journalctl -u maintenance-daily.service -n 100 --no-pager
;;
weekly)
echo "=== Weekly Maintenance Logs ==="
sudo journalctl -u maintenance-weekly.service -n 100 --no-pager
;;
all|*)
echo "=== Daily Maintenance Logs ==="
sudo journalctl -u maintenance-daily.service -n 50 --no-pager
echo ""
echo "=== Weekly Maintenance Logs ==="
sudo journalctl -u maintenance-weekly.service -n 50 --no-pager
;;
esac
maintenance:logs:follow:
desc: Follow maintenance logs in real-time (usage - task maintenance:logs:follow [-- daily|weekly])
cmds:
- |
TYPE="{{.CLI_ARGS | default "daily"}}"
case "$TYPE" in
weekly)
echo "Following weekly maintenance logs..."
sudo journalctl -u maintenance-weekly.service -f
;;
daily|*)
echo "Following daily maintenance logs..."
sudo journalctl -u maintenance-daily.service -f
;;
esac
maintenance:status:
desc: Check maintenance timer status
cmds:
- |
echo "=== Maintenance Timer Status ==="
sudo systemctl list-timers maintenance-* --no-pager
echo ""
echo "=== Service Status ==="
sudo systemctl status maintenance-daily.timer --no-pager -l || true
echo ""
sudo systemctl status maintenance-weekly.timer --no-pager -l || true
# dccd Deployment
dccd:run:
desc: Manually trigger dccd deployment now
cmds:
- |
echo "Triggering dccd deployment..."
sudo systemctl start dccd-deploy.service
echo "Waiting for service to complete..."
sleep 2
sudo systemctl status dccd-deploy.service --no-pager -l || true
dccd:status:
desc: Check dccd deployment timer and service status
cmds:
- |
echo "=== dccd Deployment Timer Status ==="
sudo systemctl list-timers dccd-deploy.timer --no-pager --all 2>/dev/null || true
echo ""
echo "=== Service Status ==="
sudo systemctl status dccd-deploy.timer --no-pager -l || true
echo ""
sudo systemctl status dccd-deploy.service --no-pager -l || true
dccd:logs:
desc: View dccd deployment logs
cmds:
- |
echo "=== dccd Deployment Logs ==="
sudo journalctl -u dccd-deploy.service -n 100 --no-pager
dccd:logs:follow:
desc: Follow dccd deployment logs in real-time
cmds:
- |
echo "Following dccd deployment logs (Ctrl+C to exit)..."
sudo journalctl -u dccd-deploy.service -f -o short-precise
# Devcontainer Prebuild
devcontainer:run:
desc: Run both phases - build images (Phase 1) then prewarm containers (Phase 2) via systemd OnSuccess chain
cmds:
- |
echo "Triggering devcontainer-build.service (Phase 1 + Phase 2 via OnSuccess chain)..."
sudo systemctl start devcontainer-build.service
echo "Waiting for service to complete..."
sleep 2
sudo systemctl status devcontainer-build.service --no-pager -l || true
devcontainer:build:
desc: Run Phase 1 only - build all devcontainer images (does not trigger Phase 2)
cmds:
- |
echo "Running devcontainer-build.sh directly (Phase 1 only, bypasses OnSuccess chain)..."
sudo /usr/local/bin/devcontainer-build.sh
devcontainer:up:
desc: Run Phase 2 only - prewarm containers from existing images (does not rebuild)
cmds:
- |
echo "Triggering devcontainer-up.service (Phase 2)..."
sudo systemctl start devcontainer-up.service
sleep 2
sudo systemctl status devcontainer-up.service --no-pager -l || true
devcontainer:status:
desc: Check devcontainer prebuild timer and service status
cmds:
- |
echo "=== Devcontainer Prebuild Timer Status ==="
sudo systemctl list-timers devcontainer-prebuild.timer --no-pager --all 2>/dev/null || true
echo ""
echo "=== Build Service Status (Phase 1) ==="
sudo systemctl status devcontainer-build.service --no-pager -l || true
echo ""
echo "=== Up Service Status (Phase 2) ==="
sudo systemctl status devcontainer-up.service --no-pager -l || true
devcontainer:logs:
desc: View devcontainer prebuild logs (usage - task devcontainer:logs [-- build|up|all])
cmds:
- |
TYPE="{{.CLI_ARGS | default "all"}}"
case "$TYPE" in
build)
echo "=== Devcontainer Build Logs (Phase 1) ==="
sudo journalctl -u devcontainer-build.service -n 100 --no-pager
;;
up)
echo "=== Devcontainer Up Logs (Phase 2) ==="
sudo journalctl -u devcontainer-up.service -n 100 --no-pager
;;
all|*)
echo "=== Devcontainer Build Logs (Phase 1) ==="
sudo journalctl -u devcontainer-build.service -n 50 --no-pager
echo ""
echo "=== Devcontainer Up Logs (Phase 2) ==="
sudo journalctl -u devcontainer-up.service -n 50 --no-pager
;;
esac
devcontainer:logs:follow:
desc: Follow devcontainer logs in real-time (usage - task devcontainer:logs:follow [-- build|up])
cmds:
- |
TYPE="{{.CLI_ARGS | default "build"}}"
case "$TYPE" in
up)
echo "Following devcontainer-up logs (Phase 2)..."
sudo journalctl -u devcontainer-up.service -f -o short-precise
;;
build|*)
echo "Following devcontainer-build logs (Phase 1)..."
sudo journalctl -u devcontainer-build.service -f -o short-precise
;;
esac
devcontainer:images:
desc: List all prebuilt devcontainer images
cmds:
- |
echo "=== Prebuilt Devcontainer Images ==="
docker images --filter "reference=devcontainer-*" --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}\t{{.CreatedSince}}"
# Development
dev:format:
desc: Format code (YAML files)
cmds:
- echo "YAML formatting is done via yamllint checks. Run 'task lint:yaml' to check."
dev:clean:
desc: Clean temporary files and caches
cmds:
- find . -type d -name '__pycache__' -exec rm -rf {} + 2>/dev/null || true
- find . -type f -name '*.pyc' -delete 2>/dev/null || true
- find . -type f -name '*.pyo' -delete 2>/dev/null || true
- find . -type f -name '.DS_Store' -delete 2>/dev/null || true
- rm -f test-results.tap test-results.xml 2>/dev/null || true
- echo "Cleaned temporary files"
dev:inventory:
desc: Display Ansible inventory
dir: "{{.ANSIBLE_DIR}}"
cmds:
- ansible-inventory -i {{.ANSIBLE_INVENTORY}} --list
dev:vars:
desc: Display variables for a host (usage - task dev:vars -- HOST=svlazext)
dir: "{{.ANSIBLE_DIR}}"
cmds:
- ansible-inventory -i {{.ANSIBLE_INVENTORY}} --host "{{.HOST}}"
# Documentation
docs:readme:
desc: Validate README links and structure
cmds:
- |
echo "Checking README.md structure..."
if ! grep -q "## Quick Start" README.md; then
echo "Warning: Quick Start section not found"
fi
echo "README.md validation complete"
# Git Operations
git:status:
desc: Show git status and current branch
cmds:
- git status --short --branch
git:log:
desc: Show recent git commits
cmds:
- git --no-pager log --oneline --graph --decorate -10
# CI/CD
ci:local:
desc: Run full CI pipeline locally
cmds:
- task: install
- task: lint
- task: syntax
- task: test:all
- echo "✅ All CI checks passed!"
ci:quick:
desc: Run quick CI checks (lint and syntax only)
cmds:
- task: lint
- task: syntax
- echo "✅ Quick checks passed!"
# Information
services:
desc: Show status of all Ansible-managed systemd services and timers
cmds:
- |
echo "═══════════════════════════════════════"
echo " Ansible-Managed Services & Timers"
echo "═══════════════════════════════════════"
echo ""
echo "--- Timers ---"
sudo systemctl list-timers ansible-pull.timer maintenance-daily.timer maintenance-weekly.timer dccd-deploy.timer devcontainer-prebuild.timer --no-pager --all 2>/dev/null || true
echo ""
echo "--- Service Status ---"
for svc in ansible-pull maintenance-daily maintenance-weekly dccd-deploy devcontainer-build devcontainer-up; do
echo "────────────────────────────────────"
echo " ${svc}"
echo "────────────────────────────────────"
if sudo systemctl is-enabled "${svc}.timer" >/dev/null 2>&1; then
TIMER_STATE="enabled"
else
TIMER_STATE="disabled/not found"
fi
if sudo systemctl is-active "${svc}.timer" >/dev/null 2>&1; then
TIMER_ACTIVE="active"
else
TIMER_ACTIVE="inactive"
fi
SVC_RESULT=$(sudo systemctl show "${svc}.service" --property=Result --value 2>/dev/null || echo "unknown")
SVC_LAST=$(sudo systemctl show "${svc}.service" --property=ExecMainStartTimestamp --value 2>/dev/null || echo "n/a")
echo " Timer: ${TIMER_ACTIVE} (${TIMER_STATE})"
echo " Last result: ${SVC_RESULT}"
echo " Last run: ${SVC_LAST}"
echo ""
done
silent: true
info:
desc: Display environment and tool information
cmds:
- |
echo "═══════════════════════════════════════"
echo " Docker Infrastructure - System Info"
echo "═══════════════════════════════════════"
echo ""
echo "Repository: {{.REPO_ROOT}}"
echo "Hostname: $(hostname)"
echo ""
echo "--- Tool Versions ---"
echo "Ansible: $(ansible --version | head -n1)"
echo "Python: $({{.PYTHON_BIN}} --version)"
echo "Task: $(task --version)"
if command -v bats >/dev/null 2>&1; then
echo "Bats: $(bats --version)"
else
echo "Bats: Not installed"
fi
if command -v docker >/dev/null 2>&1; then
echo "Docker: $(docker --version)"
else
echo "Docker: Not installed"
fi
echo ""
echo "--- Ansible Configuration ---"
echo "Config file: $ANSIBLE_CONFIG"
echo "Inventory: {{.ANSIBLE_INVENTORY}}"
echo "Playbook: {{.ANSIBLE_PLAYBOOK}}"
echo ""
echo "--- Tool Version Manager ---"
if command -v mise >/dev/null 2>&1; then
echo "mise: $(mise --version)"
echo "Managed tools:"
mise list 2>/dev/null || echo " No tools installed yet"
else
echo "mise: Not installed"
fi
echo ""
silent: true
# mise operations
mise:install:
desc: Install mise tool version manager
cmds:
- task: install:mise
mise:doctor:
desc: Check mise configuration and health
cmds:
- mise doctor
mise:list:
desc: List all installed mise tools
cmds:
- mise list
mise:upgrade:
desc: Upgrade all mise-managed tools
cmds:
- mise upgrade
mise:trust:
desc: Trust the .mise.toml configuration file
cmds:
- mise trust
help:
desc: Show detailed help and usage examples
cmds:
- |
echo "════════════════════════════════════════════════════"
echo " Docker Infrastructure - Task Runner Help"
echo "════════════════════════════════════════════════════"
echo ""
echo "USAGE:"
echo " task [task-name] Run a specific task"
echo " task --list List all available tasks"
echo " task help Show this help message"
echo ""
echo "COMMON WORKFLOWS:"
echo ""
echo " Setup new environment:"
echo " task install Install all dependencies"
echo " task mise:install Install mise only"
echo ""
echo " Development:"
echo " task lint Run all linters"
echo " task test Run all tests"
echo " task ci:quick Quick CI checks (lint + syntax)"
echo " task ci:local Full local CI pipeline"
echo ""
echo " Testing:"
echo " task test:lint Run linting tests only"
echo " task test:syntax Run syntax tests only"
echo " task test:docker Run Docker tests only"
echo ""
echo " Tool Management (mise):"
echo " task mise:doctor Check mise health"
echo " task mise:list List installed tools"
echo " task mise:upgrade Upgrade all tools"
echo ""
echo " Ansible operations:"
echo " task ansible:check Dry-run ansible-pull"
echo " task ansible:pull Run ansible-pull (applies config)"
echo " task ansible:playbook:check Dry-run playbook locally"
echo ""
echo " Maintenance:"
echo " task maintenance:update Update configs and images"
echo " task maintenance:daily Run daily patches"
echo ""
echo " dccd Deployment:"
echo " task dccd:status Check dccd timer and service status"
echo " task dccd:run Manually trigger dccd deployment"
echo " task dccd:logs View dccd deployment logs"
echo ""
echo " Devcontainer Prebuild:"
echo " task devcontainer:status Check prebuild timer and service status"
echo " task devcontainer:run Manually trigger prebuild now"
echo " task devcontainer:logs View prebuild logs"
echo " task devcontainer:images List all prebuilt devcontainer images"
echo ""
echo " Information:"
echo " task info Show system information"
echo " task dev:inventory Display Ansible inventory"
echo ""
echo "EXAMPLES:"
echo ""
echo " # Install dependencies and run tests"
echo " task install && task test"
echo ""
echo " # Check what would change without applying"
echo " task ansible:check"
echo ""
echo " # Run playbook with specific tags"
echo " task ansible:playbook:tags -- TAG=docker"
echo ""
echo " # Show variables for a specific host"
echo " task dev:vars -- HOST=svlazext"
echo ""
echo "════════════════════════════════════════════════════"
echo ""
echo "For more information, see: https://taskfile.dev"
echo ""
silent: true