Skip to content

docs(release-notes): tell pre-zero-touch federation bundle customers to re-download#64

Merged
cristim merged 2 commits into
feat/multicloud-web-frontendfrom
docs/release-notes-bundle-redownload
Apr 25, 2026
Merged

docs(release-notes): tell pre-zero-touch federation bundle customers to re-download#64
cristim merged 2 commits into
feat/multicloud-web-frontendfrom
docs/release-notes-bundle-redownload

Conversation

@cristim
Copy link
Copy Markdown
Member

@cristim cristim commented Apr 25, 2026

Summary

Adds a Notices subsection under [Unreleased] in CHANGELOG.md informing customers that federation IaC bundles downloaded before the zero-touch registration fix landed on 2026-04-22 need to be re-downloaded to get auto-registration. Old bundles silently skip registration unless manually edited.

Why

The zero-touch registration fix (commit 3b4dc5108 fix(federation): zero-touch self-registration across all IaC formats) only takes effect in bundles downloaded after the fix shipped — there's no way to back-fix files customers already have on disk. Without this notice, affected customers complete terraform apply / shell-script deploys with no error and then wonder why their account never appears in CUDly.

Old bundles included:

  • Terraform registration.tf with do_register = var.cudly_api_url != "" && var.contact_email != ""
  • CLI shell scripts gated on if [[ -n "${CUDLY_CONTACT_EMAIL:-}" ]]; then ...
  • CFN deploy scripts with no registration curl call at all

Tracked in known_issues/27_federation_old_bundle_redownload_notice.md.

Test plan

  • cat CHANGELOG.md — markdown renders cleanly, ### Notices subsection sits above ### Fixed under [Unreleased].
  • Pre-commit hooks pass (Lint Markdown files passed).
  • No code changes — docs only; no tests apply.

Closes #43

Summary by CodeRabbit

  • Documentation
    • Added a notice regarding Federation IaC bundles released before April 22, 2026. Users must re-download their bundles to restore zero-touch registration functionality. Previously downloaded bundles will not auto-register without manual modifications.

…to re-download

Customers who downloaded a federation IaC bundle before the zero-touch
registration fix landed on 2026-04-22 keep their old copy, which silently
skips auto-registration unless manually edited. Old bundles had:

- Terraform `registration.tf` gating `do_register` on `contact_email`
- CLI shell scripts gating the registration call on `CUDLY_CONTACT_EMAIL`
- CloudFormation deploy scripts with no registration curl call at all

The fix only takes effect in bundles downloaded after it ships, and there
is no way to back-fix already-downloaded files. Add a Notices subsection
under `[Unreleased]` in CHANGELOG.md telling affected customers to
re-download the bundle from the CUDly UI.

Tracked in `known_issues/27_federation_old_bundle_redownload_notice.md`.

Closes #43
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 25, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 29f51cb2-75bb-4600-bc94-f96c2db53a2c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

A release-notes notice is added to CHANGELOG.md advising customers that federation Infrastructure-as-Code bundles downloaded before the zero-touch registration feature must be re-downloaded to enable automatic account registration without manual configuration edits.

Changes

Cohort / File(s) Summary
Release Notes
CHANGELOG.md
Added Unreleased notice warning users that pre-zero-touch-registration federation IaC bundles require re-download to enable automatic registration; older bundles include conditional gates preventing auto-registration.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

🐰 A bundle grows old, its gating gates tight,
But fear not, dear user—re-download to set it right!
Fresh from the warren, no edits in sight,
Zero-touch magic makes registration just right.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately reflects the main change—adding a release-notes notice instructing customers to re-download pre-zero-touch federation bundles for auto-registration to work.
Linked Issues check ✅ Passed The PR fulfills the core requirement from issue #43: adding a Notices entry in CHANGELOG.md instructing customers to re-download pre-zero-touch federation bundles for auto-registration.
Out of Scope Changes check ✅ Passed The PR contains only documentation changes (CHANGELOG.md update) directly aligned with the release-notes notice requirement in issue #43, with no out-of-scope modifications.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/release-notes-bundle-redownload

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@cristim
Copy link
Copy Markdown
Member Author

cristim commented Apr 25, 2026

@coderabbitai review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 25, 2026

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CHANGELOG.md`:
- Around line 12-15: Update the CHANGELOG notice to correct the gating
variables: replace references to contact_email and CUDLY_CONTACT_EMAIL with
cudly_api_url and CUDLYAPIURL to match the actual implementation; ensure the
sentence that currently reads "...gated `do_register` on `contact_email`; CLI
shell scripts gated the registration call on `CUDLY_CONTACT_EMAIL`" is rewritten
to reference `cudly_api_url` and `CUDLYAPIURL` respectively so the wording
aligns with the code paths (see the registration Terraform logic and the
templates_test.go expectations).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3d5a1fab-3d1c-4a71-aa7b-697fe0b526b0

📥 Commits

Reviewing files that changed from the base of the PR and between 148c4b1 and aa16fdf.

📒 Files selected for processing (1)
  • CHANGELOG.md

Comment thread CHANGELOG.md Outdated
Comment on lines +12 to +15
skip auto-registration unless manually edited (Terraform `registration.tf`
gated `do_register` on `contact_email`; CLI shell scripts gated the
registration call on `CUDLY_CONTACT_EMAIL`; CloudFormation deploy scripts
had no registration call at all). Re-download the bundle from the CUDly
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Correct the gate-condition details in the notice.

On Line 13 and Line 14, the described gating conditions don’t match the implementation shown in iac/federation/aws-target/terraform/registration.tf:1-14 and internal/iacfiles/templates_test.go:203-221.
Both Terraform and CLI auto-registration are gated by presence of cudly_api_url / CUDlyAPIURL, not contact_email / CUDLY_CONTACT_EMAIL.

Proposed wording tweak
--  skip auto-registration unless manually edited (Terraform `registration.tf`
--  gated `do_register` on `contact_email`; CLI shell scripts gated the
--  registration call on `CUDLY_CONTACT_EMAIL`; CloudFormation deploy scripts
+-  skip auto-registration unless manually edited (Terraform `registration.tf`
+-  gated `do_register` on `cudly_api_url`; CLI shell scripts included the
+-  registration call only when `CUDlyAPIURL` was present; CloudFormation deploy scripts
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
skip auto-registration unless manually edited (Terraform `registration.tf`
gated `do_register` on `contact_email`; CLI shell scripts gated the
registration call on `CUDLY_CONTACT_EMAIL`; CloudFormation deploy scripts
had no registration call at all). Re-download the bundle from the CUDly
skip auto-registration unless manually edited (Terraform `registration.tf`
gated `do_register` on `cudly_api_url`; CLI shell scripts included the
registration call only when `CUDlyAPIURL` was present; CloudFormation deploy scripts
had no registration call at all). Re-download the bundle from the CUDly
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CHANGELOG.md` around lines 12 - 15, Update the CHANGELOG notice to correct
the gating variables: replace references to contact_email and
CUDLY_CONTACT_EMAIL with cudly_api_url and CUDLYAPIURL to match the actual
implementation; ensure the sentence that currently reads "...gated `do_register`
on `contact_email`; CLI shell scripts gated the registration call on
`CUDLY_CONTACT_EMAIL`" is rewritten to reference `cudly_api_url` and
`CUDLYAPIURL` respectively so the wording aligns with the code paths (see the
registration Terraform logic and the templates_test.go expectations).

…ownload notice

Addresses CodeRabbit nitpick on PR #64.

The Notices entry described the old bundles as gating registration on
`contact_email` (Terraform) and `CUDLY_CONTACT_EMAIL` (CLI), but the
actual gates are `cudly_api_url` and `CUDlyAPIURL` respectively:

- iac/federation/aws-target/terraform/registration.tf:1 —
  `do_register = var.cudly_api_url != ""`.
- internal/iacfiles/templates/aws-cross-account-cli.sh.tmpl:83 —
  `{{- if .CUDlyAPIURL}}` gates the entire register block.
- internal/iacfiles/templates_test.go:205 —
  `TestCLITemplatesOmitRegisterBlock` pins this contract.

The `contact_email` field still exists in the bundles but is the email
*sent* in the registration body — not the gate that decides whether
registration runs at all.
@cristim
Copy link
Copy Markdown
Member Author

cristim commented Apr 25, 2026

Addressed CodeRabbit's actionable nitpick in 30366e27:

  • Triage: Actionable. CodeRabbit was correct — iac/federation/aws-target/terraform/registration.tf:1 reads do_register = var.cudly_api_url != "", and internal/iacfiles/templates/aws-cross-account-cli.sh.tmpl:83 gates the register block on {{- if .CUDlyAPIURL}}. The contract is pinned by internal/iacfiles/templates_test.go:205::TestCLITemplatesOmitRegisterBlock. The original wording ("contact_email / CUDLY_CONTACT_EMAIL") confused the gating variable with the email sent in the registration body.
  • Change: rewrote the parenthetical in the Notices entry to reference cudly_api_url (Terraform) and CUDlyAPIURL (CLI templates). No other dismissed suggestions.

@cristim cristim merged commit dab3618 into feat/multicloud-web-frontend Apr 25, 2026
3 checks passed
@cristim cristim added triaged Item has been triaged priority/p3 Polish / idea / may never ship severity/low Minor harm urgency/this-quarter Within the quarter impact/few Limited audience effort/xs Trivial / one-liner type/docs Documentation labels Apr 28, 2026
@cristim cristim deleted the docs/release-notes-bundle-redownload branch April 29, 2026 10:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

effort/xs Trivial / one-liner impact/few Limited audience priority/p3 Polish / idea / may never ship severity/low Minor harm triaged Item has been triaged type/docs Documentation urgency/this-quarter Within the quarter

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant