update-playbooks

Featured

(project) Use when updating install tasks in playbooks/roles/ against upstream docs — bumping a pinned version, adopting a newly recommended install method, repointing a doc link that moved, or realigning the community.general pin with the brew-installed ansible

DevOps & Infrastructure 129 stars 25 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
70
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Update Playbooks Close the **drift** between each install task in `playbooks/roles/*/tasks/main.yml` and the upstream docs it cites, then commit per tool. Drift takes three forms, and all three are read off the same page — the `#` comment URL above the task: - **Version drift** — the pin trails the newest release of its **release line**. - **Method drift** — upstream now recommends a different way to install. - **Link drift** — the doc URL itself moved. A **release line** is the version prefix a project treats as a stable series: Node `24.x`, Python `3.14.x`, kubectl `1.35.x`. Every bump stays inside the line (`24.15.0` -> `24.18.0` is in-line for Node because Node's line is the major). When a newer line exists (Node 26, Python 3.15, kubectl 1.36), keep the pin on its current line and report the newer line in the final summary so the user can decide. One pin lives outside the roles and answers to a different source of truth — `playbooks/collections/requirements.yml`, covered in §4. ## 1. Scan ```bash grep -rn -E '^# https?://|^- name:' playbooks/roles/*/tasks/main.yml ``` Adjacent line numbers pair each URL with the task it documents. Done when every install task is listed with its role, its doc URL, and any version pinned in its name, command body, or download URL. ## 2. Read the upstream docs Fetch each doc URL once and take all three answers off that one page: - **newest tag inside the release line** — `gh api repos/OWNER/REPO/releases --jq '.[].tag_name'` for...

Details

Author
vinta
Repository
vinta/hal-9000
Created
10 years ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category