This article explains how to add Azure Container Registry (ACR) in SWIFT. You just need to give the ACR configuration. Once added, SWIFT will connect and show your container images from ACR. Also you can do image registry sync.
Pre-requisite:
1. To discover the ACR , you must have a registry created in the Azure cloud.
2. To add an ACR in SWIFT, you need Azure Active Directory and subscription details along with a service principal for authentication. For that please refer to the Pre-requisite Guide (pages 52–64) in the KB document provided below.
https://rackware.freshdesk.com/a/solutions/articles/5000888958?lang=en
3. An Azure account with an existing ACR.
Following are steps to discover the ACR registry in SWIFT.
1. We need to login to the ‘SWIFT’ dashboard and navigate to the ‘container registries’ menu and click on ‘Add’ button. Please check below screenshot for your reference.
2. When you click on the Add button, a new window will appear to add an image registry. In that window, you need to provide your Azure cloud credentials to add the ACR in SWIFT.
| Field Name | Field Description |
| Friendly name | You need to enter a friendly name according to your project. |
| Registry Cloud Type | Select the Registry cloud type of Azure from the dropdown. |
| Subscription ID | Unique identifier of your Azure subscription where the AKS cluster is deployed (found in Azure Portal → Subscriptions |
| Tenant ID | Identifier of your Azure Active Directory tenant (found in Azure Portal → Azure Active Directory → Overview) |
| Client ID | Identifier of the Service Principal created in Azure AD (App registrations → Overview). |
| Resource Group | The Azure resource group that contains your AKS cluster (Azure Portal → Resource groups) |
| Registry Name | The name of your Azure Container Registry. It is used in the login server URL |
| Registry Password | The access key (also called password) used to log in to ACR. |
| Client Secret | Secret (password) generated for the Service Principal during app registration (used with Client ID for authentication). |
| User Email | Azure AD user email or account email associated with the registry |
3. After filling in the required details to add the ACR, click on the ‘Add’ button. The ACR will then be discovered. Please refer to the screenshot below .
4. Once the Image registry is discovered, you can view all information like Summary and image repos. Please refer to the screenshot below .
- When you go to the Summary tab, you will find information about the registry, such as Friendly name, Registry cloud type, resource group and more.
- When you go to the Image Repositories tab, you will see all the images, tags, and repository URLs under the registry.
What next:
- Re-Discover : This option allows you to re-discover the image registry. If you have added new images or changed some image tags and want them to be reflected in the SWIFT portal, you can re-discover the image registry. Please refer to the link below for detailed steps on how to re-discover a Image registry.
<link>
- Configure : Use this option if you want to modify the image registry configuration. Please check KB Article on 'Configure the image registry'
<link>
- Delete : Use this option to delete the image registry. It will delete from SWIFT dashboard only not from cloud.
## Now that the image registry has been discovered, you may want to set up a DR Policy for Image registry sync Then follow below KB links.
<kb_link>
## If you want to sync one image registry with another, you can do that as well. For detailed steps, please refer to the KB article linked below.
<kb_link>