Bug 795212 - New format for repo configuration files
Summary: New format for repo configuration files
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: PulpDist
Classification: Community
Component: Management CLI
Version: unspecified
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: 0.1.0
Assignee: Nick Coghlan
QA Contact:
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-02-20 01:43 UTC by Nick Coghlan
Modified: 2012-03-20 05:25 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-03-20 05:25:47 UTC


Attachments (Terms of Use)

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.


Note You need to log in before you can comment on or make changes to this bug.