Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/devpro/almops

Command line tool to administrate ALM solutions such as Azure DevOps, GitHub or GitLab
https://github.com/devpro/almops

alm azure-devops dotnet github gitlab

Last synced: 2 days ago
JSON representation

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

Host: GitHub
URL: https://github.com/devpro/almops
Owner: devpro
License: apache-2.0
Created: 2020-02-03T10:40:34.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2023-08-04T15:24:26.000Z (over 1 year ago)
Last Synced: 2024-08-09T06:53:31.150Z (3 months ago)
Topics: alm, azure-devops, dotnet, github, gitlab
Language: C#
Homepage:
Size: 86.9 KB
Stars: 2
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # almops - Ops tool for ALM solutions

[![Build Status](https://dev.azure.com/devprofr/open-source/_apis/build/status/almops-ci?branchName=master)](https://dev.azure.com/devprofr/open-source/_build/latest?definitionId=24&branchName=master)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=devpro.almops&metric=alert_status)](https://sonarcloud.io/dashboard?id=devpro.almops)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=devpro.almops&metric=coverage)](https://sonarcloud.io/dashboard?id=devpro.almops)

[![Nuget](https://img.shields.io/nuget/v/almops.svg)](https://www.nuget.org/packages/almops)

Command line tool to administrate [ALM (Application lifecycle management)](https://en.wikipedia.org/wiki/Application_lifecycle_management) solutions such as Azure DevOps, GitHub, GitLab.

## How to install

### Option 1 - .NET global tool

* Install [.NET CLI](https://learn.microsoft.com/en-us/dotnet/core/install/)

* Install `almops` globally

```bash

dotnet tool install --global almops

```

* If needed, uninstall `almops`

```bash

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](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate)).

## How to configure

### Option 1 - Use config action

```bash

almops config --org  --user  --token 

```

### Option 2 - Set environment variables

```dos

SET almops__BaseUrl=

SET almops__Username=

SET almops__Token=

```

## How to use

### Quick start

```bash

# displays tool version

almops --version

# displays help

almops --help

# configures

almops config --org https://dev.azure.com/ --user  --token 

# lists

almops list projects

```

### Examples

```bash

# 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](CONTRIBUTING.md).