Cloudsmith CLI Installer for Azure DevOps Pipelines

Overview

This extension allows Azure DevOps pipelines to easily install and authenticate the Cloudsmith CLI. The Cloudsmith CLI provides powerful command-line tools to manage packages, repositories, and various artifact types on Cloudsmith.

With this extension, you can:

• Install the Cloudsmith CLI directly in your CI/CD pipelines.
• Authenticate using either an API Key or OpenID Connect (OIDC).

Features

• Cloudsmith CLI Installation: Easily install the latest or a specific version of the Cloudsmith CLI in your Azure DevOps pipeline.
• Authentication: Choose between API Key authentication or OIDC authentication.
• Customizable: Specify the version of the Cloudsmith CLI or use the latest by default.

Getting Started

1. Add this task to your Azure DevOps pipeline.
2. Choose your authentication method (API Key or OIDC).
   • If using API Key authentication, you must provide the apiKey.
   • If using OIDC authentication, you must provide the oidcNamespace and oidcServiceSlug.
3. Optionally, specify the Cloudsmith CLI version you want to install.
4. Enjoy seamless integration with Cloudsmith for managing your artifacts.

Example YAML Configuration

Below is an example of how to use the Cloudsmith CLI Installer in your Azure DevOps pipeline YAML:

jobs:
  - job: InstallCloudsmith
    pool:
      vmImage: 'ubuntu-latest'
    steps:
    # Install and Authenticate with Cloudsmith CLI
    - task: CloudsmithCliInstallAndAuthenticate
      inputs:
        authMethod: 'apiKey'          # Choose 'apiKey' for API Key authentication or 'oidc' for OIDC authentication
        apiKey: '$(CLOUDSMITH_API_KEY)'  # Only required if using 'apiKey' authentication
        oidcNamespace: '$(your-namespace)'  # Only required if using OIDC authentication
        oidcServiceSlug: '$(your-service-slug)'  # Optional: Provide if needed for OIDC authentication
        cliVersion: 'latest'  # Optional: Specify Cloudsmith CLI version to install (Leave empty to install the latest version)

    # Example Cloudsmith push
    - script: |
        cloudsmith whoami
        cloudsmith push raw $(CLOUDSMITH_ORG)/$(CLOUDSMITH_REPO) my-package.zip
      displayName: 'Push package to Cloudsmith'

Support

If you encounter any issues or need help, feel free to reach out to us via the Cloudsmith support team at support@cloudsmith.io.