cumulusci-plus-azure-devops 0.0.5b1

A plugin for cumulusci plus supporting Azure DevOps

cumulusci-azure-devops

A plugin for CumulusCI supporting Azure DevOps integration.

Features

• Integrates Azure DevOps pipelines with CumulusCI
• Provides tasks and utilities for Azure DevOps automation

Installation

Recommended Installation (with conflict checking)

For the best experience, use our custom installation script that checks for conflicts:

# Download and run the installation script
curl -O https://raw.githubusercontent.com/jorgesolebur/CumulusCI_AzureDevOps/main/install.py
python install.py

Manual Installation via pipx (recommended)

pipx install cumulusci-plus-azure-devops

Manual Installation via pip

pip install cumulusci-plus-azure-devops

Upgrading

Recommended Upgrade Method

Use our custom upgrade script for the best experience:

# Download and run the upgrade script
curl -O https://raw.githubusercontent.com/jorgesolebur/CumulusCI_AzureDevOps/main/upgrade.py
python upgrade.py

Manual Upgrade via pipx

# Standard upgrade (may not update dependencies)
pipx upgrade cumulusci-plus-azure-devops

# Force reinstall to ensure dependencies are updated
pipx uninstall cumulusci-plus-azure-devops
pipx install cumulusci-plus-azure-devops

Why Use the Upgrade Script?

pipx has limitations with dependency upgrades - it only upgrades the main package, not its dependencies. Our upgrade script:

• ✅ Checks current dependency versions
• ✅ Offers force reinstall option to update dependencies
• ✅ Verifies successful upgrade
• ✅ Provides clear feedback and next steps

Important Notes

• Conflict Warning: This package is designed to work with cumulusci-plus (version 5.0.0+), not the original cumulusci package. Having both installed may cause conflicts.
• pipx vs pip: We recommend using pipx for CLI tools as it provides better isolation and prevents dependency conflicts.
• Dependencies: All required dependencies (including cumulusci-plus, azure-devops, etc.) are automatically installed.
• CLI Tools: After installation, you'll have access to cumulusci-ado and cci-ado commands for plugin management.

Usage

Plugin Management Commands

After installation, you can use these commands to manage the plugin:

# Check plugin installation status
cumulusci-ado status

# Show version information
cumulusci-ado version

# Get help
cumulusci-ado help

# Short alias versions
cci-ado status
cci-ado version
cci-ado help

CumulusCI Integration

Add the plugin to your cumulusci.yml:

plugins:
  azure_devops:
    path: cumulusci_ado

Or use via the CumulusCI CLI if installed as a package. The plugin will automatically integrate with CumulusCI when installed.

Development

• Requires Python 3.11+
• See CONTRIBUTING.md for development guidelines (if available)

License

GNU General Public License v3.0

Links

• CumulusCI
• Azure DevOps Python API