[Pulp-list] Pulp V2 export API

[Randy Barlow]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Fri, 8 Mar 2013 09:53:40 +0100
Lukas Zapletal <lzap at redhat.com> wrote:
> so is my understanding correct: Pulp V2 cannot export into standard
> repository, only as ISO files?

I'm not clear as to what you mean by "export into standard repository".
We can copy units from one repository to another inside of Pulp. We can
also bundle units into ISOs that can be retrieved from the Pulp server.
Can you clarify?

> Can you describe me the full process of exporting part of our CDN
> structure and importing it into another Pulp V2 instance? I mean, from
> the Pulp perspective there is no directory structure, it is just a
> bunch of repositories.

I believe that you would make a call to publish using the export
distributor with the repo_id that you wish to publish. There is also a
group export distributor that accepts the group_id that you wish to
publish. There are a few filters you can place on the publish
operation, as described in the docs.

Once Pulp builds the ISO, you can retrieve it at
http://<pulp-server-hostname>/pulp/isos. If you then mount that ISO on
the host you wish to import the repositories to, you can use
file:///path/to/iso/mountpoint as the --feed-url for a repository on
the other Pulp instance.

> How many ISO files do I need to create and transfer?

This depends entirely on the size of the repositories that you are
exporting. An ISO is roughly 630 MB (I think), so it will export as
many as it takes to fit your content.

> How do I create these PULP_MANIFEST file for ISO importer?

You may be confusing the ISO Export Distributor with the ISO
Importer and Distributor, which I imagine is easy to do. The ISO
Importer and Distributor are not related to the Export
Distributor, though you could use the ISO Importer and Distributor to
import ISOs made with the Export Distributor if you made your own ISO
repository. The ISO Plugins are meant to be used to synchronize with
and distribute ISOs provided by the CDN.

The PULP_MANIFEST file format is described here:

https://pulp-rpm-dev-guide.readthedocs.org/en/pulp-2.1/iso-plugins.html#iso-importer

> What happens when I re-export new content?

If you call the export operation again when there is new content, you
will get an ISO that has all content currently in the repository that
meets your filter criteria.

> How do I re-import new content?

Mount the new ISO that you created when you exported the new content,
and run a repo sync with the file:// path pointed at the mountpoint.

Let me know if you have any more questions!

- -- 
Randy Barlow
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.19 (GNU/Linux)

iQIcBAEBAgAGBQJROg8LAAoJEIyFaKUJtmpiAQcP/05jflhT3jYajFvs0lf06Nae
29w3Hxuya8caYZ5xIdQ5NWfjjw580J2Sry0FdWQnhGucXBZU0I+s/rs5KIgqfZtC
SwDnteTymCB1FuNgCzHGOGOKJ6tlkL6RN5HfS9FT3SrQRVCiAgk+ylPyGByDkOTF
C6AxMeO9XYp1AG0kxQLmNzDkjWUrae15BysOdzVhBYmDXw6se6Esb36q3WREx6DM
pxnayWGhVcPXrlK8RQkbUHHyIYfaAn8T7QtIukQ2u4/G4x6SbWrxF3pmMNWT4t/D
FSrKDHP5h6dThBjN+dYa5i5jMp9LFNNsbEA1JuoN/Lpgok5zKENp00dVpwnp77IO
dH48adb0+K2nqv6gt++pzkiq0zmyi94mkBRIvzQnDXZDhk2aNq4yJ7PoF0zNKkxB
Grp9XWE8TlvKPjT4GO3xmNdXcZqWkrNJxDzDLoe2AJNOSozx+fMdpPrhJYgeot0M
gniRIaOy6atlbXmWi+XQh2/vWONLDqkQGCqYBnpduPvKS4sZpI4ONBHDosdy6FNq
BqW4ZlBnAV2bZBd0tgAyxuC+RqGKvudKbAaD2RhywYvLoV4XVCQijsHlsZIRZesf
VCD+YnGpcV8mdX1RGV9w4OSMd2afChHxSjT4fp2cEdjf7DI5g/68Hbij7rvAMtGf
VRjbbvefezfnKIKT0cRt
=qtN6
-----END PGP SIGNATURE-----