DO NOT SHARE THESE DOCS WITH CUSTOMERS!
This is an LA release that will only be provided to a select number of PLM-sanctioned customers (PDFs only). Contact PLM for details.
In this section:
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.
Before you execute the commands below, refer to Install Azure CLI.
To create a storage blob from the SA URL:
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
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
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>"
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"
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
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"
Ensure that the blob URL follows the format:
https://<account_name>.blob.core.windows.net/<container_name>/<blob_name>
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"
Ensure that the blob URL follows the format:
https://<account_name>.blob.core.windows.net/<container_name>/<blob_name>
To copy images between regions:
Install the Azure image copy extension.
az extension add --name image-copy-extension
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
Ensure that the target location is a single world and in lowercase version. For example: "eastus", and not East US.