Pulp CLI is a command-line interface for managing Pulp 3 resources and interacting with Pulpcore's REST API. It serves as a client for various Pulp plugins (e.g., pulp_ansible, pulp_file, pulp_rpm) to perform tasks like listing repositories, synchronizing content, and managing distributions. Currently at version 0.39.0, the library is under active development, and its status is considered 'beta', implying that future releases may introduce backwards-incompatible changes.
pip install pulp-cliNo compatibility data collected yet for this library.
The Pulp CLI requires initial configuration to connect to a Pulp 3 server. This typically involves setting the base URL, username, and password, which can be done via `pulp config create` or environment variables. After configuration, you can verify the connection with `pulp status` and interact with various Pulp resources.
Regularly consult the official Changelog (e.g., on GitHub) before upgrading and test new versions in a non-production environment.
If write operations are required and supported by your Pulp setup, append `--force` to the command, or use alternative tools like orcharhino management UI, Hammer CLI, or Foreman Ansible Modules for specific content types.
Update scripts to remove these deprecated options. Consult the `pulp_rpm` plugin documentation for current best practices for checksum and GPG handling.
If the operation is intended and safe mode can be overridden, append the `--force` global option to your Pulp CLI command (e.g., `pulp --force rpm repository update ...`).
Verify that your `~/.config/pulp/cli.toml` or environment variables (e.g., `PULP_USERNAME`, `PULP_PASSWORD`, `PULP_TOKEN`) contain correct and active credentials. If using client certificates, ensure `--cert` and `--key` paths are correct and the server accepts them. Test basic connectivity with `pulp status`, which doesn't require authentication.
Provide the path to your CA certificate bundle using the `--ca-cert` global option (e.g., `pulp --ca-cert /path/to/ca.crt ...`) or by setting the `PULP_CA_BUNDLE` environment variable. Alternatively, for testing *only*, you can disable SSL verification with `--no-verify-ssl` (not recommended for production).