acr-browser
acr-browser
is a terminal-based user interface for managing container images and artifacts in Azure Container Registry.
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.