Skip to content

[Deprecation] file { content => <checksum> } Filebucket Retrieval Behavior #335

@silug

Description

@silug

Summary

Using checksum literals in file resource content is deprecated and explicitly marked for future removal.

Evidence

  • lib/puppet/type/file/content.rb:55 warns checksum-in-content usage is deprecated.
  • lib/puppet/type/file/content.rb:57 states checksum retrieval through content will be removed.
  • Guidance in warning points to static catalogs as replacement.

Proposed OpenVox 9 Change

  • Remove checksum-special-case behavior in content munge path.
  • Treat checksum-like strings as literal file content unless explicit supported mechanism is used.

Compatibility / Risk

  • Medium risk for manifests relying on this legacy filebucket shortcut.
  • Clear migration needed to static catalogs / explicit source workflows.

Implementation Notes

  • Delete checksum detection branch tied to deprecated behavior.
  • Keep behavior explicit and unsurprising for literal strings.
  • Update docs/examples if any still mention checksum-in-content patterns.

Acceptance Criteria

  • content no longer performs implicit filebucket retrieval from checksum literals.
  • Deprecation warning path removed.
  • Existing supported source and static-catalog flows are unaffected.

Suggested Tests

  • Unit tests for content munge with checksum-like strings now expecting literal handling.
  • Integration test confirming recommended replacement paths still work.

Metadata

Metadata

Assignees

No one assigned

    Labels

    deprecationThis issue pertains to an item/topic which has been deprecated.

    Type

    No type

    Projects

    Status

    Deprecated

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions