Uploaded image for project: 'Puppet'
  1. Puppet
  2. PUP-9251

Deprecate 'application orchestration' features

    XMLWordPrintable

    Details

    • Template:
    • Acceptance Criteria:
      Hide

      Puppet issues a deprecation warning when using application orchestration constructs site, application, produces and consumes, and the warning links to text in https://puppet.com/docs/puppet/5.5/deprecated_language.html describing the deprecated language features.

      Show
      Puppet issues a deprecation warning when using application orchestration constructs site, application, produces and consumes, and the warning links to text in https://puppet.com/docs/puppet/5.5/deprecated_language.html describing the deprecated language features.
    • Team:
      Coremunity
    • Sprint:
      Platform Core KANBAN
    • Release Notes:
      Deprecation
    • Release Notes Summary:
      Hide
      The application orchestration feature is being deprecated and will be removed in Puppet 7. Puppetserver will emit a deprecation warning if {{site}}, {{produces}} or {{consumes}} keywords are used in puppet manifests. Puppetserver's environment catalog REST API is also deprecated: https://puppet.com/docs/puppet/latest/http_api/http_environment.html. The export and consume metaparameters are also deprecated. https://puppet.com/docs/puppet/latest/metaparameter.html#consume, https://puppet.com/docs/puppet/latest/metaparameter.html#export
      Show
      The application orchestration feature is being deprecated and will be removed in Puppet 7. Puppetserver will emit a deprecation warning if {{site}}, {{produces}} or {{consumes}} keywords are used in puppet manifests. Puppetserver's environment catalog REST API is also deprecated: https://puppet.com/docs/puppet/latest/http_api/http_environment.html . The export and consume metaparameters are also deprecated. https://puppet.com/docs/puppet/latest/metaparameter.html#consume, https://puppet.com/docs/puppet/latest/metaparameter.html#export
    • QA Risk Assessment:
      Needs Assessment

      Description

      We should deprecate the 'application orchestration' features in the puppet language. This means the following should be flagged as deprecated:

      • Keywords site, application, consumes, and produces
      • Metaparameters export and consume
      • Puppet::Parser::EnvironmentCompiler
      • Puppet::Parser::Compiler::CatalogValidator::SiteValidator & Puppet::Parser::Compiler::CatalogValidator::EnvironmentRelationshipValidator
      • Resource kinds: application, site, capability_mapping
      • Puppet::Type#is_capability? and application?
      • Environment catalog REST API: https://puppet.com/docs/puppet/latest/http_api/http_environment.html

      Deprecation also needs to be marked in documentation and in specifications. The documentation is here: https://puppet.com/docs/pe/2017.3/managing_applications.html. When doing this work, please also add the tickets for documentation and specification deprecations.

      The intent is to remove these features in Puppet 7.0.0.

      Deprecation is easy as it can be done during validation of the parsed result. Removal is a bit more involved as there is a separate "site catalog compiler" and related features to remove. When spending time on the deprecation it is worth also writing the tickets for the removal.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              josh Josh Cooper
              Reporter:
              henrik.lindberg Henrik Lindberg
              Votes:
              0 Vote for this issue
              Watchers:
              7 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:

                  Zendesk Support