Skip to main content ホーム クリエイター canonical discourse-k8s-operator upgrade-discourse-workload
upgrade-discourse-workload Guides the full upgrade of the Discourse workload version in the discourse-k8s-operator charm. Handles rockcraft.yaml source-tag bumps, Node.js/Ruby/pnpm/bundler version checks, plugin source-commit updates, patch regeneration (db_migrations, lp1903695, sigterm, discourse-charm), testing-database refresh, and integration test updates. Includes diagnostic scripts for checking requirements, patch applicability, and plugin compatibility automatically. WHEN: upgrade discourse version, bump discourse workload, update discourse tag, new discourse release, discourse version bump, update rockcraft.yaml discourse, upgrade discourse charm, update source-tag, discourse patch update, update discourse plugins, discourse rock upgrade, discourse rock build, update discourse bundler, update discourse ruby, update discourse node.
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/canonical/discourse-k8s-operator --skill upgrade-discourse-workloadコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... name upgrade-discourse-workload description Guides the full upgrade of the Discourse workload version in the discourse-k8s-operator charm. Handles rockcraft.yaml source-tag bumps, Node.js/Ruby/pnpm/bundler version checks, plugin source-commit updates, patch regeneration (db_migrations, lp1903695, sigterm, discourse-charm), testing-database refresh, and integration test updates. Includes diagnostic scripts for checking requirements, patch applicability, and plugin compatibility automatically. WHEN: upgrade discourse version, bump discourse workload, update discourse tag, new discourse release, discourse version bump, update rockcraft.yaml discourse, upgrade discourse charm, update source-tag, discourse patch update, update discourse plugins, discourse rock upgrade, discourse rock build, update discourse bundler, update discourse ruby, update discourse node.
license Apache-2.0 metadata {"author":"canonical","version":"1.0.0","summary":"Automates and guides the Discourse workload version upgrade process in the discourse-k8s-operator charm.","tags":["discourse","charm","rockcraft","upgrade"]}
Upgrade Discourse Workload
Run all scripts from the repo root. Scripts require gh (authenticated) and git.
Skill dir: .agents/skills/upgrade-discourse-workload/ (<skill-dir> below).
Entry Point
Identify NEW_TAG and OLD_TAG (current source-tag in discourse_rock/rockcraft.yaml).
Work through §1–§5 in order. For large version jumps (multiple months), also run §6.
Run all scripts regardless of bump size — do not pre-judge scope.
§1 — Update source-tag and renovate.json Edit discourse_rock/rockcraft.yaml:
discourse:
source-tag: <NEW_TAG>
If the minor version changed (e.g. v2026.1.x → v2026.2.x), also update renovate.json so Renovate auto-proposes future patches within the new series:
{
"allowedVersions" : "/^v<YEAR>.<NEW_MINOR>\./"
}
Find this rule by matchDepNames: ["discourse/discourse"] in packageRules.
§2 — Runtime requirements Sub-agent: provide NEW_TAG, current rockcraft.yaml, references/guide-core-versions.md.
Run bash <skill-dir>/scripts/check_discourse_requirements.sh <NEW_TAG>
Return field-value pairs that differ from current rockcraft.yaml
Apply the returned changes.
§3 — Plugin commits Sub-agent: provide NEW_TAG, current rockcraft.yaml, references/guide-plugins.md.
Run bash <skill-dir>/scripts/check_plugin_commits.sh <NEW_TAG>
Return plugin name → new source-commit map; flag any ⚠️ FALLBACK plugins
Apply the returned changes. Note FALLBACK plugins in the PR description.
§4 — Patches Four patches, all must be verified:
# Patch Target 1 db_migrations.patchdb/post_migrate/<TIMESTAMP>_<name>.rb2 lp1903695.patchlib/middleware/anonymous_cache.rb3 discourse-charm.patchlib/tasks/discourse-charm.rake4 sigterm.patchconfig/unicorn.conf.rb
Step 1: bash <skill-dir>/scripts/check_patch_applicability.sh <NEW_TAG>
Step 2: For each ❌, delegate regeneration to a sub-agent:
Provide: patch name, NEW_TAG, OLD_TAG, current patch content, relevant section of references/guide-patches.md
Sub-agent must: work in a unique /tmp dir, clone Discourse at NEW_TAG, produce the new patch, clean up, return it
Apply the returned patch
Step 3: Re-run the check — all four must be ✅ before proceeding.
Step 4: Update apply-patches > prime in rockcraft.yaml if any target filename changed.
§5 — Build and validate Mandatory. Do not skip or defer to CI.
Delegate to a sub-agent with NEW_TAG and the repo path.
5a — Rock cd discourse_rock && rockcraft pack --verbosity brief
5b — Push to registry sudo rockcraft.skopeo --insecure-policy copy \
--dest-tls-verify=false \
oci-archive:discourse_rock/discourse_*.rock \
docker://localhost:32000/discourse:<NEW_TAG>
5c — Charm CHARM_BUILD=$(mktemp -d /tmp/charm-build.XXXXXX)
git archive HEAD | tar -x -C "$CHARM_BUILD "
cd "$CHARM_BUILD " && charmcraft pack
CHARM_FILE="$(ls "$CHARM_BUILD " /*.charm | head -1) "
5d — Unit tests PATH="$HOME /.local/bin:$PATH " UV_PROJECT_ENVIRONMENT=/tmp/discourse-venv \
uv run --group unit pytest tests/unit -v
5e — Integration tests Juju with MicroK8s is available (concierge-microk8s controller, testing model).
Refresh the testing model, then run main tests with --use-existing:
juju refresh discourse-k8s --model testing \
--path="$CHARM_FILE " \
--resource discourse-image=localhost:32000/discourse:<NEW_TAG>
PATH="$HOME /.local/bin:$PATH " UV_PROJECT_ENVIRONMENT=/tmp/discourse-venv \
uv run --group integration pytest \
tests/integration/test_charm.py \
tests/integration/test_users.py \
tests/integration/test_saml.py \
-v --model testing --use-existing \
--charm-file "$CHARM_FILE " \
--discourse-image localhost:32000/discourse:<NEW_TAG>
DB migration test (fresh temp model):
PATH="$HOME /.local/bin:$PATH " UV_PROJECT_ENVIRONMENT=/tmp/discourse-venv \
uv run --group integration pytest \
tests/integration/test_db_migration.py -v \
--charm-file "$CHARM_FILE " \
--discourse-image localhost:32000/discourse:<NEW_TAG>
5f — Shellcheck If any .sh files under .agents/skills/ were modified:
shellcheck -f gcc .agents/skills/upgrade-discourse-workload/scripts/*.sh
For build and test failure modes, see references/guide-troubleshooting.md.
§6 — Testing database (major upgrades only) Triggered when test_db_migration fails with "git_version does not match".
Sub-agent: provide OLD_TAG, testing_database/creating-the-testing-database.md,
references/guide-db-migration.md, tests/integration/test_db_migration.py.
Regenerate testing_database/testing_database.sql from OLD_TAG
Return the updated SQL and the updated assertion line for test_db_migration.py
Apply the changes and check .trivyignore per references/guide-db-migration.md.
Completion checklist
References File Load when references/guide-core-versions.mdNode/Ruby/pnpm/bundler version details references/guide-plugins.mdPlugin compatibility, inventory, additions/removals references/guide-patches.mdPer-patch background and regeneration procedure references/guide-db-migration.mdTesting database refresh, trivy CVE handling references/guide-troubleshooting.mdBuild/test failure modes and fixes
Scripts Script Purpose scripts/check_discourse_requirements.sh <TAG>Node/Ruby/pnpm/bundler version check scripts/check_plugin_commits.sh <TAG>Resolve plugin commits via .discourse-compatibility scripts/check_patch_applicability.sh <TAG>Test all patches against new Discourse scripts/find_db_migration_target.sh <NEW_TAG> <OLD_TAG>Find db_migrations.patch target scripts/regenerate_patch.sh <TAG> <patch-name>Interactive patch regeneration
