Model Solution: Ansible Assessment 01 – Fundamentals · Ansible

1. Usage Notes

Deep Dive and Submission Example for Usage Notes

A complete treatment of Usage Notes contains both a technical artifact and a short domain explanation. The artifact can be an inventory, a playbook, a role, a template, a Vault file with dummy values, a CI configuration, or an evidence file. The explanation states why this path was chosen and which alternative was deliberately not used.

Submission Part	Content	Minimum Quality
target description	what should be true after the run	measurable and without hidden assumptions
scope evidence	which hosts are affected	output from `--list-hosts` or inventory graph
implementation	which files were changed	small reviewable YAML files
validation	how it was checked	syntax check, check mode, diff, real run, second run
risk decision	what can go wrong	privileges, secrets, external dependencies, and rollback considered

Minimal Artifacts for Usage Notes

submission/
  inventory/hosts.yml
  playbooks/site.yml
  evidence.md
  cleanup.md

For roles or collections, the structure expands:

submission/
  ansible.cfg
  collections/requirements.yml
  inventory/hosts.yml
  roles/<role>/defaults/main.yml
  roles/<role>/tasks/main.yml
  roles/<role>/handlers/main.yml
  playbooks/site.yml
  evidence.md

Grading Expectation for Usage Notes

A reviewable solution must be understandable to people who did not run it themselves. Screenshots or uncommented terminal output are not enough. Good evidence states context, command, relevant output, and assessment. If a module behaves differently in check mode, that limitation is explicitly documented.

Transfer to Real Teams

In a team context, Usage Notes is connected to code review, branch rules, CI, role ownership, release notes, and operational approval. Production-like usage also documents ownership, maintenance window, monitoring, alerting, and rollback criteria.

Practical Relevance of Usage Notes

This section is not just a definition. In the workshop, Usage Notes is always validated through a concrete flow: inspect inventory, prove target hosts, check the playbook, simulate the change, run the change, evaluate a second run, and document cleanup. This shows whether Ansible really models desired state or merely executes a command successfully once.

Review Question	Expected Answer
Which hosts are affected?	Pattern, group, `--limit`, and inventory output are documented.
Which data sources apply?	`group_vars`, `host_vars`, defaults, extra vars, and facts are known.
Which privileges are required?	`become` is close to the task and justified.
How is success proven?	Syntax check, check mode, diff, play recap, and second run are present.

Example Flow for Usage Notes

ansible-inventory -i inventory/hosts.yml --graph
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --list-hosts
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --syntax-check
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --check --diff
ansible-playbook -i inventory/hosts.yml playbooks/site.yml
ansible-playbook -i inventory/hosts.yml playbooks/site.yml

The flow is intentionally complete. In real teams, some steps are automated but not skipped. CI can run syntax checks and linting; the domain review of scope, privileges, secret flows, and rollout risk remains a human engineering task.

Review Criteria for Usage Notes

Inventory and patterns are narrower than all unless a reason is documented.
Modules from ansible.builtin or reviewed collections are preferred.
Shell or command tasks include changed_when, failed_when, or a clear reason.
Variables are placed predictably and do not override each other surprisingly.
Secrets do not appear in plaintext, diffs, debug tasks, or CI logs.
The playbook can run repeatedly without unnecessary changes.
Cleanup, fix-forward, or controlled acceptance of the target state is documented.

Common Failure Modes for Usage Notes

Failure	Cause	Diagnosis
wrong hosts targeted	pattern or inventory misunderstood	`--list-hosts`, `ansible-inventory --host`
`unreachable`	SSH, user, Python, or network issue	`-vvvv`, SSH test, inventory variables
unexpected change	module not idempotent or wrong data source	second run, diff, variable inspection
secret leak	debug, diff, or log not scoped	check `no_log`, Vault, CI artifacts
handler does not run	no `changed` result or wrong handler name	inspect task result and handler name

Operations Note for Usage Notes

For production-like usage, the lab must become a runbook. The runbook states target systems, owners, prerequisites, stop criteria, expected duration, validation, monitoring, and cleanup. Without those details, a playbook is executable but not operationally mature.

This model solution shows grading expectations. Concrete host names, paths, and output may differ as long as scope, security, and validation are correct.

2. Part A: Model Answers

Deep Dive and Submission Example for Part A: Model Answers

A complete treatment of Part A: Model Answers contains both a technical artifact and a short domain explanation. The artifact can be an inventory, a playbook, a role, a template, a Vault file with dummy values, a CI configuration, or an evidence file. The explanation states why this path was chosen and which alternative was deliberately not used.

Submission Part	Content	Minimum Quality
target description	what should be true after the run	measurable and without hidden assumptions
scope evidence	which hosts are affected	output from `--list-hosts` or inventory graph
implementation	which files were changed	small reviewable YAML files
validation	how it was checked	syntax check, check mode, diff, real run, second run
risk decision	what can go wrong	privileges, secrets, external dependencies, and rollback considered

Minimal Artifacts for Part A: Model Answers

submission/
  inventory/hosts.yml
  playbooks/site.yml
  evidence.md
  cleanup.md

For roles or collections, the structure expands:

submission/
  ansible.cfg
  collections/requirements.yml
  inventory/hosts.yml
  roles/<role>/defaults/main.yml
  roles/<role>/tasks/main.yml
  roles/<role>/handlers/main.yml
  playbooks/site.yml
  evidence.md

Grading Expectation for Part A: Model Answers

A reviewable solution must be understandable to people who did not run it themselves. Screenshots or uncommented terminal output are not enough. Good evidence states context, command, relevant output, and assessment. If a module behaves differently in check mode, that limitation is explicitly documented.

Transfer to Real Teams

In a team context, Part A: Model Answers is connected to code review, branch rules, CI, role ownership, release notes, and operational approval. Production-like usage also documents ownership, maintenance window, monitoring, alerting, and rollback criteria.

Practical Relevance of Part A: Model Answers

This section is not just a definition. In the workshop, Part A: Model Answers is always validated through a concrete flow: inspect inventory, prove target hosts, check the playbook, simulate the change, run the change, evaluate a second run, and document cleanup. This shows whether Ansible really models desired state or merely executes a command successfully once.

Review Question	Expected Answer
Which hosts are affected?	Pattern, group, `--limit`, and inventory output are documented.
Which data sources apply?	`group_vars`, `host_vars`, defaults, extra vars, and facts are known.
Which privileges are required?	`become` is close to the task and justified.
How is success proven?	Syntax check, check mode, diff, play recap, and second run are present.

Example Flow for Part A: Model Answers

ansible-inventory -i inventory/hosts.yml --graph
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --list-hosts
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --syntax-check
ansible-playbook -i inventory/hosts.yml playbooks/site.yml --check --diff
ansible-playbook -i inventory/hosts.yml playbooks/site.yml
ansible-playbook -i inventory/hosts.yml playbooks/site.yml

The flow is intentionally complete. In real teams, some steps are automated but not skipped. CI can run syntax checks and linting; the domain review of scope, privileges, secret flows, and rollout risk remains a human engineering task.

Review Criteria for Part A: Model Answers

Inventory and patterns are narrower than all unless a reason is documented.
Modules from ansible.builtin or reviewed collections are preferred.
Shell or command tasks include changed_when, failed_when, or a clear reason.
Variables are placed predictably and do not override each other surprisingly.
Secrets do not appear in plaintext, diffs, debug tasks, or CI logs.
The playbook can run repeatedly without unnecessary changes.
Cleanup, fix-forward, or controlled acceptance of the target state is documented.

Common Failure Modes for Part A: Model Answers

Failure	Cause	Diagnosis
wrong hosts targeted	pattern or inventory misunderstood	`--list-hosts`, `ansible-inventory --host`
`unreachable`	SSH, user, Python, or network issue	`-vvvv`, SSH test, inventory variables
unexpected change	module not idempotent or wrong data source	second run, diff, variable inspection
secret leak	debug, diff, or log not scoped	check `no_log`, Vault, CI artifacts
handler does not run	no `changed` result or wrong handler name	inspect task result and handler name

Operations Note for Part A: Model Answers

For production-like usage, the lab must become a runbook. The runbook states target systems, owners, prerequisites, stop criteria, expected duration, validation, monitoring, and cleanup. Without those details, a playbook is executable but not operationally mature.