Pulp CLI Debian Plugin

0.4.3 · active · verified Thu Apr 16

pulp-cli-deb is a command-line interface plugin for pulp-cli, designed to manage Debian repositories by interacting with pulpcore's REST API. It allows system administrators to perform various operations on Debian content within a Pulp instance. The library is actively maintained as part of the broader Pulp Project ecosystem, with the current version being 0.4.3, released on February 16, 2026.

Common errors

```
Error: Call aborted due to safe mode
```
cause Attempting to perform write operations (add, update, delete content) directly through the Pulp CLI when it's configured in a 'read-only' mode for certain operations or content types.

fix Use alternative tools like the Pulp UI, Hammer CLI, or Foreman Ansible Modules for content modification tasks. Consult the Pulp documentation for specific content type limitations.
```
ImportError: cannot import name 'PulpDebClient' from 'pulp_deb.client'
```
cause Attempting to import Python classes from `pulp-cli-deb` or related `pulp_deb` packages directly, assuming it's a programmatic API client, when the package is primarily a CLI extension. You might also be trying to use an outdated client import path.

fix For programmatic interaction with the Pulp Deb REST API, install and use `pulp-deb-client` (`pip install pulp-deb-client`). This package provides Python API bindings. `pulp-cli-deb` is for command-line usage.
```
pip install pulp-cli-deb fails with 'ERROR: Could not find a version that satisfies the requirement pulp-glue-deb'
```
cause An older or corrupted pip cache, or an issue with dependency resolution for `pulp-glue-deb`, which is a critical dependency. This was a known issue with earlier 0.4.x releases of `pulp-cli-deb`.

fix Try `pip install --no-cache-dir pulp-cli-deb pulp-glue-deb` to force a fresh download and ensure both are explicitly installed. Verify your `pip` is up-to-date. If issues persist, check PyPI for the latest compatible versions of both packages.

Warnings

breaking Older versions of `pulp-cli-deb` (including some 0.4.x releases) were yanked from PyPI due to insufficient `pulp-glue-deb` dependency handling, leading to broken installations. While 0.4.3 aims to resolve this, ensure a clean installation.
Fix: Upgrade to the latest `pulp-cli-deb` (0.4.3 or newer) and ensure `pulp-glue-deb` is also installed and up-to-date. `pip install --upgrade pulp-cli-deb pulp-glue-deb`
gotcha The `pulp` CLI is primarily designed for reading information about synchronized content. Attempts to add, update, or delete certain content types directly via `pulp-cli` might result in 'Error: Call aborted due to safe mode'.
Fix: For write operations (add, update, delete) on certain content, consider using other Pulp management tools like the Pulp management UI, Hammer CLI, or Foreman Ansible Modules, as recommended by the documentation.
deprecated The underlying `pulp_deb` plugin, which `pulp-cli-deb` interacts with, removed deprecated release file fields such as `PUBLISH_RELEASE_FILE_LABEL` and `PUBLISH_RELEASE_FILE_VERSION` in `pulp_deb` 3.3.0. Using these fields in older configurations might lead to unexpected behavior or errors.
Fix: Update your Pulp instance's `pulp_deb` plugin to the latest version and adjust any automation or configurations that rely on these removed fields.

Install

pip install pulp-cli-deb Install pulp-cli-deb

Imports

NotApplicable

This library is primarily a command-line interface (CLI) plugin and is not typically imported for direct Python programmatic use of its commands. Instead, it extends the `pulp` CLI tool.

For programmatic interaction with the Pulp Deb REST API, use the `pulp-deb-client` library.

Quickstart

The quickstart involves installing the `pulp-cli-deb` package, which will also install `pulp-cli`. After installation, configure the Pulp CLI to connect to your Pulp instance by setting environment variables or creating a configuration file. Then, you can use `pulp` commands, particularly the `pulp deb` subcommand group, to manage Debian content.

# Install the CLI plugin
pip install pulp-cli-deb

# Configure Pulp CLI to connect to your Pulp instance
# Replace <PULP_BASE_URL>, <PULP_API_ROOT>, <USERNAME>, <PASSWORD> with your details
# It's recommended to set these via environment variables or a configuration file
# For example, create ~/.config/pulp/cli.toml or use `pulp config create -e`
# For demonstration, assuming a local Pulp instance and default credentials:
# export PULP_BASE_URL="https://localhost"
# export PULP_API_ROOT="/api/v3"
# export PULP_USERNAME="admin"
# export PULP_PASSWORD="password"

# Test connectivity to the Pulp API
pulp status

# List available Debian repositories
pulp deb repository list

# Get help for Debian commands
pulp deb --help
pulp deb repository --help

view raw JSON →