pulp / pulp/pulp-cli

container repository sync mirror option missing

Open
#1,206 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

easy fix feature request
Dominant language
Python
Stars
43
Forks
52
Avg merge
11h 38m
Merged PRs (30d)
11

Description

Summary

I'm trying to start using Pulp 3 as container registry, following official tutorial https://pulpproject.org/pulp_container/docs/user/tutorials/sync-and-host/#sync-content

The tutorial mentions mirror=False|True option and claims:

In the above example, the payload contains the field mirror=False. This means that the sync will be run in the additive mode only. Set mirror to True and Pulp will pull in new content and remove content which was also removed from upstream. The same logic will be applied when include/exclude_tags are specified together with the mirror command, but only on the subset of tags.

I don't find anything in pulp-cli documentation about this mirror option nor does pulp-cli --help provide anything related.

What is the "payload" in this context at all? How do I make sure that mirror=False? Which object should have this parameter?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked sync-and-host tutorial and the output of pulp-cli --help, then compare the documented mirror payload with the CLI's available sync options. Done means the documentation clearly states whether mirror is supported, which object accepts it, and how a user should configure it or identifies the missing implementation.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.