Skip to content

Docker Execution for device-certificate-report

Run device-certificate-report in Docker for a consistent setup across systems. This guide details the steps for Docker configuration and execution, including options for generating reports from Panorama or CSV files.

Pulling the Docker Image

Pull the device-certificate-report image from GitHub Packages:

docker pull ghcr.io/cdot65/device-certificate-report:latest

Or build your own custom version of the Dockerfile in this getting started guide.

Running the Container

Basic Execution

To run the container with interactive prompts:

docker run -it --rm ghcr.io/cdot65/device-certificate-report:latest

Executing with Command-Line Arguments

For Panorama-based report generation:

docker run -it --rm \ -v "$(pwd):/app" \ ghcr.io/cdot65/device-certificate-report:latest \ panorama --hostname <panorama_ip> --username <username> --password <password>

For CSV-based report generation:

docker run -it --rm \ -v "$(pwd):/app" \ ghcr.io/cdot65/device-certificate-report:latest \ csv --file /app/devices.csv

Command-Line Arguments

The device-certificate-report Docker container supports various arguments to customize its execution:

Global Options

  • --help: Show the help message and exit.
  • --version: Show the version and exit.

Panorama Report Command

docker run ... panorama [OPTIONS]

Options: - --hostname TEXT: Panorama IP address or hostname [required] - --username TEXT: Username for Panorama authentication [required] - --password TEXT: Password for Panorama authentication [required] - --port INTEGER: Port number for Panorama connection [default: 443]

CSV Report Command

docker run ... csv [OPTIONS]

Options: - --file PATH: Path to the input CSV file within the container [required]

Volume Mounts

  • Mount your local directory to import local files and export generated reports: -v "$(pwd):/app"

Examples

Generating a Report from Panorama

docker run -it --rm \ -v "$(pwd):/app" \ ghcr.io/cdot65/device-certificate-report:latest \ panorama --hostname 192.168.1.1 --username admin --password admin123

Generating a Report from CSV

docker run -it --rm \ -v "$(pwd):/app" \ ghcr.io/cdot65/device-certificate-report:latest \ csv --file /app/panorama.csv

Output

The generated reports (PDF and CSV) will be available in the mounted directory on your host system.

Troubleshooting

If you encounter issues:

  1. Ensure Docker is properly installed and running on your system.
  2. Verify that you have the latest version of the device-certificate-report image.
  3. Check network connectivity if connecting to Panorama.
  4. Review the console output for any error messages.

For persistent issues, please open an issue on our GitHub repository with a detailed description of the problem and any relevant error messages.