pulp-webhook 0.1.0

Pulp plugin to trigger webhooks on package uploads

Pulp RPM Webhook Plugin

This plugin extends Pulp's functionality by adding webhook notifications when artifacts are published or uploaded.

Features

• Triggers webhooks on artifact publications for following types:
• RPM
• File
• Provides detailed artifact information in webhook payloads
• Supports authentication via secret tokens
• Configurable webhook endpoint URL

Installation

pip install pulp-webhook

Configuration

Add the following to your Pulp settings:

# Webhook endpoint URL
WEBHOOK_URL = "https://your-webhook-endpoint.com"

# Optional secret token for authentication (adds header X-PulpWebhook-Token)
WEBHOOK_SECRET = "your-secret-token"

Usage

RPM

1. Create an RPM repository:

pulp rpm repository create --name my-rpm-repo

2. Create a distribution:

pulp rpm distribution create --name my-dist --base-path my-dist --repository my-rpm-repo

3. Upload or sync RPM packages to the repository. The plugin will automatically trigger webhooks when packages are published.

File

1. Create a file repository:

pulp file repository create --name my-file-repo --autopublish

2. Create a distribution:

pulp file distribution create --name my-dist --base-path my-dist --repository my-file-repo

3. Upload or sync files to the repository. The plugin will automatically trigger webhooks when packages are published.

Webhook Payload Structure

The webhook payload includes:

• Event type ("rpm.published")
• Repository name
• Publication details
• List of added packages with:
  • Package metadata (name, version, release, etc.)
  • Distribution URLs
  • Upstream URLs (if synced from a remote)

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

License

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

Links

• https://github.com/cz-guardian/pulp_webhook
• https://pypi.org/project/pulp-webhook/