Skip to content

CLI Installation & update

The VDC CLI is a cross-platform command-line tool that provides programmatic access to VDC functionality. This guide covers installation, verification, and maintenance of the CLI.

System Requirements

  • Windows: Windows 10 or later, PowerShell 5.1 or later
  • Linux: Most modern distributions with bash

Installation

Windows Installation

$ProgressPreference = "SilentlyContinue"; (Invoke-WebRequest -Uri 'https://af01p-fm.devtools.intel.com/artifactory/vdc-client-fm-local/vdc/cli/prod/win-x64/vdc.exe' -OutFile '.\vdc.exe') | Out-Null; .\vdc.exe install; rm .\vdc.exe

Manual Installation

  1. Download the CLI executable:

    Invoke-WebRequest -Uri 'https://af01p-fm.devtools.intel.com/artifactory/vdc-client-fm-local/vdc/cli/prod/win-x64/vdc.exe' -OutFile 'vdc.exe'

  2. Install to system PATH:

    .\vdc.exe install

  3. Clean up:

    Remove-Item vdc.exe

Linux Installation

One-Line Installation

wget https://af01p-fm.devtools.intel.com/artifactory/vdc-client-fm-local/vdc/cli/prod/linux-x64/vdc && chmod +x vdc && sudo ./vdc install && rm vdc

Manual Installation

  1. Download the CLI binary:

    wget https://af01p-fm.devtools.intel.com/artifactory/vdc-client-fm-local/vdc/cli/prod/linux-x64/vdc

  2. Make executable:

    chmod +x vdc

  3. Install to system PATH:

    sudo ./vdc install

  4. Clean up:

    rm vdc

Verification

Check Installation

# Verify CLI is installed and accessible
vdc --version

# Expected output:
# Validation DevOps Center CLI 1.0.0

Test Basic Functionality

# Show help to verify CLI is working
vdc --help

# Test connectivity (requires authentication)
vdc ingredient get --help

Updates

The VDC API evolves continuously, and CLI compatibility is only guaranteed with recent versions.

Automatic Updates

The CLI includes a built-in update mechanism:

# Check for and install updates
vdc update

# Check current version
vdc --version

Update Process

  1. Check Version: CLI compares local version with latest available
  2. Download: If newer version exists, downloads automatically
  3. Install: Replaces current installation with new version
  4. Verify: Confirms successful update

Update Best Practices

  • Regular Updates: Run vdc update monthly or before major automation deployments
  • Test Updates: Test CLI updates in non-production environments first
  • Pin Versions: For CI/CD systems, consider pinning to specific versions for stability

Next Steps

After Installation

  1. Set Up Authentication - Configure tokens for VDC access
  2. Try First Steps - Execute your first VDC CLI commands
  3. Learn Basic Workflows - Common usage patterns

For Automation

  1. CI/CD Integration - Integrate into pipelines
  2. Bulk Operations - Advanced batch processing
  3. Error Handling - Robust automation patterns