Heads up: Community templates repo will be archived tomorrow!

Following the long discussion in Provisioning Templates / Testing & Separate Repository, and now that 2.1 has been released, I will be archiving the community templates repository tomorrow.

How should changes to templates be handled going forward?

  • Provisioning templates, partition tables and report templates will all live in Foreman core repository, under app/views/unattended folder. PRs can be submitted normally to develop branch as well as to stable branches when needed for backports. Note that from now we will require redmine issues for all changes, as this will allow us to better control what template changes have been released in each version of Foreman. If the template change leads to change in the snapshot, rake snapshots:generate RAILS_ENV=test can be used to update the snapshot accordingly.
  • Remote execution job templates will reside in either the Remote Execution plugin for generic ssh templates, or in another plugin that adds them. For example, templates for the Ansible REX provider will reside in the Ansible plugin, while templates for Katello actions will reside in the Katello plugin.
4 Likes

The repo has now been archived.

@tbrisker does PRs for provisioning templates also need to follow these guidelines? Foreman :: Contribute

In general, yes.
You don’t usually need to run all of the tests, but if snapshots change you will need to update the snapshot accordingly.
Also, you will need to make sure that every change has a redmine issue related to it. In the past we’ve had issues where changes in the community templates which did not have an issue led to problems and it was difficult to identify when the change was made, or when we wanted to pull some fix to an older release but had trouble with identifying which change was needed or only realized it at a very late stage in the release cycle.
This way nightly builds will also contain the latest templates so they can be tested right away and not only when a new release is done.