almops - Ops tool for ALM solutions

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

For simple calls, you may first look at the officials clients like Azure DevOps CLI, GitHub CLI, GitLab CLI.

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

docker run -it --rm --name almops \
  -e almops__BaseUrl="https://dev.azure.com/***" -e almops__Username="***" -e almops__Token="***" \
  devprofr/almops:latest list projects

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 main branch with the release name
almops create release -p myproject --name myreleasename

How to contribute

Follow the Contributing guide.