Azure Pipeline Notifier for VS Code

A VS Code extension that automatically notifies you when YOU execute Azure DevOps pipelines manually and when they complete.

Features

• 🔔 Automatic Detection: Automatically detects when YOU execute pipelines in Azure DevOps
• 🚀 Start Notifications: Get notified immediately when your pipeline execution starts
• ✅ Completion Notifications: Receive notifications when your pipelines finish (success, failed, or canceled)
• 🔗 Direct Navigation: Click notifications to view pipeline results in Azure DevOps
• 📊 Personal Monitoring: Only monitors pipelines that you execute manually (filters out other team members)
• 💾 Persistent Tracking: Pipeline tracking survives VS Code restarts

How It Works

1. Configure your Azure DevOps connection once
2. Execute a pipeline manually in Azure DevOps
3. Get notified in VS Code: "[Pipeline Name] execution started"
4. Wait for the pipeline to complete
5. Get notified again: "[Pipeline Name] execution finished" with results and a link

The extension filters pipeline executions to only show those YOU initiated - you won't see notifications for pipelines executed by other team members!

Getting Started

Prerequisites

• Access to MarsDevTeam Azure DevOps organization
• Access to RoyalCaninTestFactory project
• Personal Access Token (PAT) with "Build (Read)" permissions

Configuration

1. Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P)
2. Run Pipeline Notifier: Configure Azure DevOps Connection
3. Enter your:
   • Email address
   • Personal Access Token (PAT)

That's it! The extension will automatically monitor pipeline executions in the RoyalCaninTestFactory project every 10 seconds.

Usage

Once configured, the extension automatically:

• Monitors your Azure DevOps project for pipelines YOU execute
• Notifies you when your pipelines start
• Notifies you when your pipelines complete with status and results link
• Filters out pipelines executed by other team members

Manual Control

• Pipeline Notifier: Disable Monitoring - Temporarily stop monitoring
• Pipeline Notifier: Enable Monitoring - Resume monitoring

Commands

• Pipeline Notifier: Configure Azure DevOps Connection - Set up your Azure DevOps credentials
• Pipeline Notifier: Enable Monitoring - Start automatic pipeline monitoring
• Pipeline Notifier: Disable Monitoring - Stop automatic pipeline monitoring

Configuration Settings

You can also manually configure the extension in VS Code settings:

{
  "pipelineNotifier.emailAddress": "your.email@example.com",
  "pipelineNotifier.personalAccessToken": "your-pat-token"
}

Note: The extension is preconfigured for:

• Organization: MarsDevTeam
• Project: RoyalCaninTestFactory
• Polling Interval: 10 seconds

How It Works

1. When you configure the extension, it retrieves your user profile from Azure DevOps
2. It starts automatically polling the Azure DevOps API for pipeline runs
3. It filters to only show pipeline runs that YOU requested/executed
4. When a new pipeline execution is detected, you receive a notification: "[Pipeline Name] execution started"
5. The extension continues tracking that pipeline until completion
6. When the pipeline completes, you receive another notification with:
   • ✅ Success status (if succeeded)
   • ❌ Failure status (if failed)
   • ⚠️ Canceled status (if canceled)
   • 🔗 A clickable link to view the full results in Azure DevOps

Note: Only pipelines that you manually execute will trigger notifications. Pipelines executed by other team members, scheduled builds, or automated triggers will be ignored.

Security Note

Your Personal Access Token is stored in VS Code's secure storage. However, always follow these best practices:

• Use a PAT with minimal required permissions (Build: Read)
• Set an expiration date for your PAT
• Never commit your PAT to source control

Development

Build from Source

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch mode for development
npm run watch

Package Extension

# Install vsce
npm install -g @vscode/vsce

# Package extension
vsce package

Troubleshooting

Not Receiving Notifications

1. Verify your email address and PAT are correct
2. Check that your PAT has the "Build (Read)" permission
3. Ensure monitoring is enabled (run Pipeline Notifier: Enable Monitoring)
4. Ensure you have access to the RoyalCaninTestFactory project
5. Check the Output panel (View > Output) and select "Azure Pipeline Notifier" for logs

Pipeline Not Detected

• Ensure you're the one who manually executed the pipeline (not another team member)
• The extension monitors the last 50 pipeline runs you've executed
• Ensure the pipeline is in the RoyalCaninTestFactory project
• Verify your PAT has access to MarsDevTeam organization and RoyalCaninTestFactory project

License

MIT License - see LICENSE file for details

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Feedback

If you have suggestions or encounter issues, please file them in the repository's issue tracker.