devpro/almops

almops - Ops tool for ALM solutions

Command line tool to administrate ALM (Application lifecycle management) solutions such as Azure DevOps, GitHub, GitLab.

How to install

Option 1 - .NET global tool

Install .NET CLI
Install almops globally

dotnet tool install --global almops

If needed, uninstall almops

dotnet tool uninstall -g almops

Option 2 - Container

TODO

How to authenticate

Azure DevOps

Create a Personal Access Token (PAT) in your Azure DevOps organization (ref. Authenticate access with personal access tokens).

How to configure

Option 1 - Use config action

almops config --org <organization> --user <username> --token <token>

Option 2 - Set environment variables

SET almops__BaseUrl=<url>
SET almops__Username=<username>
SET almops__Token=<token>

How to use

Quick start

# displays tool version
almops --version

# displays help
almops --help

# configures
almops config --org https://dev.azure.com/<organization> --user <email_address> --token <token>

# lists
almops list projects

Examples

# lists all builds
almops list builds -p myproject

# queues a new build
almops queue build -p myproject --id 3 --branch mybranch

# shows build information
almops show build -p myproject --id 264

# lists build artifacts
almops list artifacts -p myproject --id 90

# creates a new release from a feature branch with the release definition id
almops create release -p myproject --id 1 --branch "feature/something-awesome"

# creates a new release from master branch with the release name
almops create release -p myproject --name myreleasename

How to contribute

Follow the Contributing guide.