The Azure Container Registry (ACR) plugin displays information about your container images available in the Azure Container Registry.
npm install @janus-idp/backstage-plugin-acrThe Azure Container Registry (ACR) plugin displays information about your container images available in the Azure Container Registry.
1. Run the following command to install the ACR plugin:
``bash`
yarn workspace app add @janus-idp/backstage-plugin-acr
1. Set the proxy to the desired ACR server in the app-config.yaml file as follows:
`yaml`
# app-config.yaml
proxy:
endpoints:
'/acr/api':
target: 'https://mycontainerregistry.azurecr.io/acr/v1/'
changeOrigin: true
headers:
# If you use Bearer Token for authorization, please replace the 'Basic' with 'Bearer' in the following line.
Authorization: 'Basic ${ACR_AUTH_TOKEN}'
# Change to "false" in case of using self hosted artifactory instance with a self-signed certificate
secure: true
1. Set the authorization using one of the following options:
- Basic authorization:
- Navigate to the ACR portal and go to the Access Keys tab.
- Retrieve the username and password of the Admin user and use the Basic Auth Header Generator tool or run echo printf ' in a terminal to convert the credentials into a basic token.ACR_AUTH_TOKEN
- Set the generated token as in environment variables.
- OAuth2: - Generate bearer access token using the process described in Authenticate with an Azure Container Registry.
- One method is to generate a bearer token using your basic authorization token, i.e.
`bash`
curl --location 'https://
--header 'Authorization: Basic
- Set the generated token as ACR_AUTH_TOKEN in environment variables. Make sure to replace the Basic in the app-config.yaml with Bearer
1. Enable an additional tab on the entity view page using the packages/app/src/components/catalog/EntityPage.tsx file as follows:
`tsx title="packages/app/src/components/catalog/EntityPage.tsx"
/ highlight-add-start /
import { AcrPage, isAcrAvailable } from '@janus-idp/backstage-plugin-acr';
/ highlight-add-end /
const serviceEntityPage = (
// ...
{/ highlight-add-start /}
path="/acr"
title="ACR"
>
{/ highlight-add-end /}
);
`
1. Annotate your entity using the following annotations:
`yaml
metadata:
annotations:
'azure-container-registry/repository-name':
```
ACR is a front-end plugin that enables you to view information about the container images from your Azure Container Registry in Backstage.
#### Prerequisites
- Your Backstage application is installed and running.
- You have installed the ACR plugin. For installation instructions, see Installing and configuring the ACR plugin.
#### Procedure
1. Open your Backstage application and select a component from the Catalog page.
1. Go to the ACR tab.
The ACR tab in the Backstage UI contains a list of container images and related information, such as TAG, CREATED, LAST MODIFIED, and MANIFEST.