Skip to content
forked from devpro/almops

Command line tool to administrate ALM solutions such as GitLab or Azure DevOps

License

Notifications You must be signed in to change notification settings

JamiePed/almops

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

almops - Ops tool for ALM solutions

Build Status Quality Gate Status Coverage Nuget

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

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

References

Microsoft documentation

About

Command line tool to administrate ALM solutions such as GitLab or Azure DevOps

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%