Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Azure/azure-devops-cli-extension
Azure DevOps Extension for Azure CLI
https://github.com/Azure/azure-devops-cli-extension
agile artifacts azure azure-cli azure-cli-extension azure-devops azure-devops-extension boards cicd command-line command-line-tool devops git pipelines repos
Last synced: about 1 month ago
JSON representation
Azure DevOps Extension for Azure CLI
- Host: GitHub
- URL: https://github.com/Azure/azure-devops-cli-extension
- Owner: Azure
- License: mit
- Created: 2017-10-20T17:39:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-24T16:10:27.000Z (about 1 month ago)
- Last Synced: 2024-06-02T21:52:39.620Z (about 1 month ago)
- Topics: agile, artifacts, azure, azure-cli, azure-cli-extension, azure-devops, azure-devops-extension, boards, cicd, command-line, command-line-tool, devops, git, pipelines, repos
- Language: Python
- Homepage: https://docs.microsoft.com/en-us/cli/azure/ext/azure-devops/?view=azure-cli-latest
- Size: 6.27 MB
- Stars: 613
- Watchers: 41
- Forks: 236
- Open Issues: 292
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Lists
- jimsghstars - Azure/azure-devops-cli-extension - Azure DevOps Extension for Azure CLI (Python)
README
# Azure DevOps Extension for Azure CLI
[](https://dev.azure.com/ms/azure-devops-cli-extension/_build/latest?definitionId=39&branchName=master)
The Azure DevOps Extension for Azure CLI adds Pipelines, Boards, Repos, Artifacts and DevOps commands to the Azure CLI 2.0.
> The Azure CLI with the Azure DevOps Extension has replaced the VSTS CLI. The VSTS CLI has been deprecated and will no longer be receiving new features. We recommend that users of the VSTS CLI switch to the Azure CLI and add the Azure DevOps extension. See the [Command Mapping](/doc/command_mapping.md) section to view the mapping between VSTS CLI and Azure DevOps Extension commands.
## Quick start
1. [Install the Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli). You must have at least `v2.0.69`, which you can verify with `az --version` command.
1. Add the Azure DevOps Extension `az extension add --name azure-devops`
1. Run the `az login` command.
If the CLI can open your default browser, it will do so and load a sign-in page. Otherwise, you need to open a
browser page and follow the instructions on the command line to enter an authorization code after navigating to
[https://aka.ms/devicelogin](https://aka.ms/devicelogin) in your browser. For more information, see the
[Azure CLI login page](https://docs.microsoft.com/cli/azure/authenticate-azure-cli).
See the [Get started guide](https://docs.microsoft.com/azure/devops/cli/get-started?view=azure-devops) for detailed setup instructions.
## Usage
```bash
$az [group] [subgroup] [command] {parameters}
```
Adding the Azure DevOps Extension adds `devops`, `pipelines`, `artifacts`, `boards` and `repos` groups.
For usage and help content for any command, pass in the -h parameter, for example:
```bash
$ az devops -h
Group
az devops : Manage Azure DevOps organization level operations.
Related Groups
az pipelines: Manage Azure Pipelines
az boards: Manage Azure Boards
az repos: Manage Azure Repos
az artifacts: Manage Azure Artifacts.
Subgroups:
admin : Manage administration operations.
extension : Manage extensions.
project : Manage team projects.
security : Manage security related operations.
service-endpoint : Manage service endpoints/service connections.
team : Manage teams.
user : Manage users.
wiki : Manage wikis.
Commands:
configure : Configure the Azure DevOps CLI or view your configuration.
feedback : Displays information on how to provide feedback to the Azure DevOps CLI team.
invoke : This command will invoke request for any DevOps area and resource. Please use
only json output as the response of this command is not fixed. Helpful docs -
https://docs.microsoft.com/en-us/rest/api/azure/devops/.
login : Set the credential (PAT) to use for a particular organization.
logout : Clear the credential for all or a particular organization.
```
- Checkout the CLI docs at [docs.microsoft.com - Azure DevOps CLI](https://docs.microsoft.com/azure/devops/cli/).
- Check out other examples in the [How-to guides](https://docs.microsoft.com/azure/devops/cli/?view=azure-devops#how-to-guides) section.
- You can view the various commands and its usage here - [docs.microsoft.com - Azure DevOps Extension Reference](https://docs.microsoft.com/en-us/cli/azure/devops?view=azure-cli-latest)
## Contribute
See our [contribution guidelines](CONTRIBUTING.md) to learn how you can contribute to this project.
TLDR of [contribution guidelines](CONTRIBUTING.md)
Questions : [Stack Overflow](https://stackoverflow.com/questions/tagged/azure-devops)
Bug reports : [Developer Community](https://developercommunity.visualstudio.com/spaces/21/index.html)
New Feature request : [Azure DevOps repo](https://github.com/Microsoft/azure-devops-cli-extension/issues/new/choose)
## License
[MIT License](LICENSE)