Bug 795212

Summary:	New format for repo configuration files
Product:	[Community] PulpDist	Reporter:	Nick Coghlan <ncoghlan>
Component:	Management CLI	Assignee:	Nick Coghlan <ncoghlan>
Status:	CLOSED NEXTRELEASE	QA Contact:
Severity:	high	Docs Contact:
Priority:	high
Version:	unspecified
Target Milestone:	0.1.0
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-03-20 05:25:47 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Nick Coghlan 2012-02-20 01:43:05 UTC

The current repo configuration file format is powerful and flexible, but very low level (settings map pretty much directly to rsync commands).

The default format should be made higher level, allowing some options to be specified *once* rather than being defined implicitly in each repository definition.

This new format will allow the following to be specified once and then referenced:

"Source Settings"
- common settings that apply to all sources

"Source Servers"
- details of servers that offer up trees via rsync

"Sources"
- common settings for a group of source trees (each source names a source server)

"Remote Trees"
- details of trees that are available via rsync (each remote tree names a source)

"Local Settings"
- common settings that apply to all local trees

"Local Trees"
- details of trees that are to be created locally (each local tree names a remote tree to be created)
- corresponds to the actual repos created on the local Pulp server

"Raw Trees"
- fully specified trees that can be passed directly to the importer plugins (the existing format)

The existing low level format that only contains a list of raw tree definitions will still be supported, but will need to be requested explicitly via a "--raw" flag to affected commands.

Comment 1 Nick Coghlan 2012-03-02 07:06:21 UTC

Various name changes as noted in the draft docs:

http://readthedocs.org/docs/pulpdist/en/latest/cli.html#site-configuration-format

Further name changes being considered:

  default_* names will probably lose the "default_" prefix
  version_suffix will likely change from a site setting to a remote source setting (or perhaps a server setting)
  subdir_filters in importer configs will likely become "version_filters" to match the "excluded_versions" naming. Alternatively, both may become "ls_filters" to parallel the "sync_filters" name. "excluded_files" would then become "exclude_from_sync" and "excluded_versions" would become "exclude_from_ls".

Comment 2 Nick Coghlan 2012-03-19 07:48:18 UTC

Name changes:

"default_" prefix dropped
"version" -> "listing" in all field names
"subdir_filters" -> "listing_filters"
"excluded_files" -> "exclude_from_sync"
"excluded_versions" -> "exclude_from_listing"

Comment 3 Nick Coghlan 2012-03-20 05:25:47 UTC

0.0.7 will use the new format exclusively.