JamiePed / almops

almops - Ops tool for ALM solutions

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

Examples:

# List your projects
almops list projects -p myproject

# Queue a new build
almops queue build -p myproject --id 42

# Show build status
almops show build -p myproject --id 123

User manual

How to install

As a requirement, you only have to install the latest .NET Core CLI (open source tool with a minimized footprint).

As a .NET global tool, almops is installed from the NuGet package:

dotnet tool install --global almops

How to configure

Azure DevOps

A personal access token (PAT) to work with Azure DevOps. If you're not familier with it, the instructions are given in the page Authenticate access with personal access tokens.

Use the tool config action

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

(alternative) Set environment variables

SET almops__BaseUrl=https://dev.azure.com/<organization>
SET almops__Username=<username>
SET almops__Token=<token>

How to use

Quick start

# display tool version
almops --version

# display help
almops --help

# configure
almops config --org myorg --user myemailadress --token mysecrettoken

# list
almops list projects

Examples

# list all builds
almops list builds -p myproject

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

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

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

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

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

How to uninstall

The tool can be easily uninstalled with:

dotnet tool uninstall -g almops

Contribue

Requirements

.NET Core SDK must be installed

Local project debug

# build the .NET solution
dotnet build

# run the console app
dotnet src/ConsoleApp/bin/Debug/netcoreapp3.1/almops.dll --help

Local installation

# pack the projects
dotnet pack

# install from local package
dotnet tool update -g almops --add-source=src/ConsoleApp/nupkg --version 1.1.0-alpha-000000

# run the tool
almops list projects

# uninstall the tool
dotnet tool uninstall -g almops