diff options
author | Chris St. Pierre <chris.a.st.pierre@gmail.com> | 2012-05-23 10:47:13 -0400 |
---|---|---|
committer | Chris St. Pierre <chris.a.st.pierre@gmail.com> | 2012-05-23 10:47:13 -0400 |
commit | 4c4534c2302c869f5f8258eb7107dcf531e0edc7 (patch) | |
tree | 42c98b2d2540f93d32a389dce7b9ce6b116bccdd /doc | |
parent | ff5f8989262f9c3c449bd68b459fec8e955f34c9 (diff) | |
download | bcfg2-4c4534c2302c869f5f8258eb7107dcf531e0edc7.tar.gz bcfg2-4c4534c2302c869f5f8258eb7107dcf531e0edc7.tar.bz2 bcfg2-4c4534c2302c869f5f8258eb7107dcf531e0edc7.zip |
added ability to specify arbitrary repository options to Packages
Diffstat (limited to 'doc')
-rw-r--r-- | doc/server/plugins/generators/packages.txt | 30 |
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/server/plugins/generators/packages.txt b/doc/server/plugins/generators/packages.txt index 76454b8f5..54e92f1f6 100644 --- a/doc/server/plugins/generators/packages.txt +++ b/doc/server/plugins/generators/packages.txt @@ -182,6 +182,36 @@ There is no need to specify ``<GPGKey>`` tags for :ref:`Pulp sources <pulp-source-support>`; that data is pulled directly from the Pulp REST API. +Arbitrary Repo Options +---------------------- + +.. versionadded:: 1.2.3 + +You can specify arbitrary options to be added to the repository config +on the server side, if you are using the native yum libraries, and on +the client side if you are using the ability of Packages to +automatically generate your Yum config. To do this, add an +``<Options>`` tag to a Source; all of its attributes will be added +verbatim to the repository in the generated config. For instance:: + + <Source type="yum" rawurl="http://mirror.example.com/centos-6-os"> + <Arch>x86_64</Arch> + <Options proxy="http://proxy.example.com"/> + </Source> + +If you are using native yum libraries and need to set options only on +the Bcfg2 server, you can set the ``serveronly`` attribute to "true"; +or, if you need to set options only on the client, you can set the +``clientonly`` attribute to "true". For instance, if your Bcfg2 +server needed to use a proxy to access a repo, and you wanted to +expire metadata caches very quickly on the client, you could do:: + + <Source type="yum" rawurl="http://mirror.example.com/centos-6-os"> + <Arch>x86_64</Arch> + <Options serveronly="true" proxy="http://proxy.example.com"/> + <Options clientonly="true" metadata_expire="0"/> + </Source> + .. _packages-exampleusage: Example usage |