acr-browser

acr-browser PyPI version

acr-browser is a terminal-based user interface for managing container images and artifacts in Azure Container Registry.

home_view

🚀
This project owes a huge debt of gratitude to the fantastic Azure Key Vault Browser, from which it is forked, and of course, to the underlying technologies that make both of these projects possible: textual and rich!

Installation

acr-browser requires Python 3.9 or later.

pip install acr-browser

Once the app is installed you can run the application from your terminal with the acr command.

acr

Alternatively, you can run with Docker:

docker run --rm -it --volume $HOME:/app --volume $HOME/.azure:/root/.azure ghcr.io/samdobson/acr-browser:latest

Authentication

acr-browser uses the Azure CLI for authentication. Before using the app, make sure that you have logged in and set your subscription.

az login
az account set --subscription "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx"

Configuration

On first run you will be asked for some information so that the app can build your configuration file.

You’ll need to enter a valid Azure Container Registry name.

Alternatively you can create a config file at ~/.acr-browser.toml:

# .acr-browser.toml

registry = ""

Compatibility

This project has been tested on macOS and Linux with Python 3.9.

For Ubuntu 20.04, it may be necessary to install the python3.9 package.

Contributing

If you would like to contribute to acr-browser head over to the contributing guide to find out more.

GitHub

View Github