os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Note that pkg(8) uses the official mirrors by default and link to the Poudriere section for more information about building a custom repository.

Browse source 
Clean up some man page links.
Add a section about configuring Poudriere repositories and configuring pkg(8) to use them.
This commit is contained in:
Brad Davis 2015-05-16 21:32:51 +00:00
parent 452bd53262
commit e80f03390f
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=46699
1 changed files with 40 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

49
en_US.ISO8859-1/books/handbook/ports/chapter.xml
View file

@ -698,18 +698,15 @@ docbook =
<programlisting>WITH_PKGNG= yes</programlisting>
<para>The <application>pkg</application> package management
system uses a package repository for most operations. The
default package repository location is defined in
<filename>/usr/local/etc/pkg.conf</filename> or by the
<envar>PACKAGESITE</envar> environment variable, which
overrides the configuration file.</para>
<para>By default <application>pkg</application> uses the &os;
package mirrors. For information about building a custom
package repository, see <xref linkend="ports-poudriere"/></para>
<para>Additional <application>pkg</application>
configuration options are described in pkg.conf(5).</para>
configuration options are described in &man.pkg.conf.5;.</para>
<para>Usage information for <application>pkg</application> is
available in pkg(8) or by running
available in the &man.pkg.8; manpage or by running
<command>pkg</command> without additional arguments.</para>
<para>Each <application>pkg</application> command argument is
@ -1319,7 +1316,7 @@ Deinstalling ca_root_nss-3.15.1_1... done</screen>
<para>Installed ports can be uninstalled using <command>pkg
delete</command>. Examples for using this command can be
found in <xref linkend="pkgng-intro"/>.</para>
found in the &man.pkg-delete.8; manpage.</para>
<para>Alternately, <command>make deinstall</command> can be
run in the port's directory:</para>
@ -1764,6 +1761,40 @@ ports-mgmt/pkg
and the main web site, <link
xlink:href="https://github.com/freebsd/poudriere/wiki"></link>.</para>
</sect2>
<sect2>
<title>Configuring pkg clients to use a Poudriere repository</title>
<para>While it is possible to use both a custom repository along
side of the official repository. Sometimes it is useful to
disable the official repository. This is done by creating a
configuration file that overrides and disables the official
configuration file. Create
<filename>/usr/local/etc/pkg/repos/FreeBSD.conf</filename>
that contains the following:</para>
<screen>FreeBSD: {
enabled: no
}</screen>
<para>Usually it is easiest to serve a poudriere repository to the
client machines via HTTP. Setup a webserver to serve up the
package directory, usually something like:
<filename>/usr/local/poudriere/data/packages/<replaceable>10amd64</replaceable></filename>.
Where <filename>10amd64</filename> is the name of the build.
</para>
<para>If the URL to the package repository is:
<literal>http://pkg.example.com/10amd64</literal>, then the
repository configuration file in
<filename>/usr/local/etc/pkg/repos/custom.conf</filename> would
look like:</para>
<screen>custom: {
url: "<replaceable>http://pkg.example.com/10amd64</replaceable>",
mirror_type: "http",
enabled: yes,
}</screen>
</sect2>
</sect1>
<sect1 xml:id="ports-nextsteps">