Access and Share SBC Image in Azure

To share the SBC image in Azure between regions, Ribbon provides a Share Access Signature (SAS) URL with read permission to use the image while you to get it to your own tenant and subscription. This section describes how access and use the SBC images.

Create a Storage Blob from the SAS URL

To create a storage blob from the SA URL:

1. Create a storage account.
   Syntax

   az storage account create --name <account name> 
                             --resource-group <resource group name> 
                             --kind storageV2

   
   Example

   az storage account create --name ribbonsharedimages --resource-group example-resource-group --kind storageV2

2. Create a container to store the blob.
   Syntax

   az storage container create --name <container name> 
                               --account-name <account name> 
                               --public-access off

   
   Example

   az storage container create --name ribbon-sbc-container --account-name ribbonsharedimages --public-access off

3. Start creating the blob.
   Syntax

   az storage blob copy start --destination-blob <blob name> 
                              --destination-container <container name> 
                              --account-name <account name> 
                              --source-uri "<SAS URL>"

   Note

   Enclose SAS URL within double quotation marks "".

   
   Example

   az storage blob copy start --destination-blob "rbbn-sbc-v09.01.00.vhd" --destination-container "ribbon-sbc-container" --account-name "ribbonsharedimages" --source-uri "https://rbbncustomerimagestorage.blob.core.windows.net/swe-initial-image-share/example-sbc.vhd?sp=r&st=2020-09-15T08:08:34Z&se=2020-09-15T16:08:34Z&spr=https&sv=2019-12-12&sr=b&sig=CdK%2FYi3sWlU2ydLdMxrijrv%2FraQ1aGaOWf7FGk%3D"

4. Check the status of blob creation.
   Syntax

   az storage blob show --name <blob name> 
                        --container-name <container name> 
                        --acount-name <account name> 
                        --query [properities.copy] -o table

   
   Example

   az storage blob show --name "rbbn-sbc-v09.01.00.vhd" --container-name "ribbon-sbc-container" --account-name "ribbonsharedimages" --query [properties.copy] -o table

Create a Snapshot from the Storage Blob

To create a snapshot from the storage blob:

Syntax

az snapshot create --name <snapshot name> 
                   --resource-group <resource group name> 
                   --source <blob URL>

Example

az snapshot create --name rbbn-sbc-v09.01.00.snap --resource-group example-resource-group --source "https://ribbonsharedimages.blob.core.windows.net/ribbon-sbc-container/rbbn-sbc-v09.01.00.vhd"

Create an Image from the Storage Blob

To create an image from the storage blob:

Syntax

az image create --name <image name> 
                --resource-group <resource group name> 
                --os-type Linux 
                --source <blob URL>

Example

az snapshot create --name rbbn-sbc-v09.01.00.img --resource-group example-resource-group --os-type Linux --source "https://ribbonsharedimages.blob.core.windows.net/ribbon-sbc-container/rbbn-sbc-v09.01.00.vhd"

Copy Images between Regions

To copy images between regions:

1. Install the Azure image copy extension.

   az extension add --name image-copy-extension

2. Copy image from one region to another.
   Syntax

   az image copy --source-resource-group <resource-group> 
                 --source-object-name <image name> 
                 --target-location <space separated list of regions> 
                 --target-resource-group <target resource group> 
                 --cleanup

   
   Example

   az image copy --source-resource-group mySources-rg --source-object-name myImage --target-location uksouth northeurope --target-resource-group "images-repo-rg" --cleanup

   Note

   Ensure that the target location is a single world and in lowercase version. For example: "eastus", and not East US.