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
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
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>
# display tool version
almops --version
# display help
almops --help
# configure
almops config --org myorg --user myemailadress --token mysecrettoken
# list
almops list projects
# 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
The tool can be easily uninstalled with:
dotnet tool uninstall -g almops
- .NET Core SDK must be installed
# build the .NET solution
dotnet build
# run the console app
dotnet src/ConsoleApp/bin/Debug/netcoreapp3.1/almops.dll --help
# 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