Copying an image manually

In some cases where your organization’s security policies require it, you must manually copy images to the storage account designated for image storage.

When copying the images, follow these high-level steps:

  1. Create a container named “images” and copy all images to that container. Make sure to create a page blob.
    • Note the URL of the created container. You will need it to perform the copying process.
  2. Identify the FreeIPA image that needs to be copied. You should use the latest image from the FreIPA image catalog available at https://cloudbreak-imagecatalog.s3.amazonaws.com/v3-prod-freeipa-image-catalog.json.
  3. Identify the Data Lake and Data Hub image(s) that need to be copied and note the VHD URLs. Both Data Lake and Data Hub use the same image, so there is one image used for both for each Runtime version. There are two ways to find these images in the CDP image catalog:

  4. Use azcopy tool to copy the images. When copying the images via the azcopy tool, you have two options for authentication and authorization:

    • Azcopy login: Perform azcopy login with a service principal that has the permission to copy into images container.

    • SAS token: Create a SAS token for the images container.

Option 1: Azcopy login

Issue the following command and it will perform an interactive login:

azcopy login

If you want to set up an automatic script then you can use:

azcopy login --service-principal \
 --application-id <YOUR_APPLICATION_ID> \ 
 --tenant-id <YOUR_TENANT_ID>

To run azcopy, use:

azcopy copy \
 'https://<SOURCE_BLOB_URL>' \
 'https://<DESTINATION_BLUB_URL>

As mentioned earlier, the https://<SOURCE_BLOB_URL> can be found in the image catalog.

Option 2: SAS-token

Go to the Azure portal and generate a SAS-token. Then, you can issue azcopy:

azcopy copy \
 'https://<SOURCE_BLOB_URL>' \
 'https://<DESTINATION_BLUB_URL>?<YOUR_SAS_TOKEN>'

As mentioned earlier, the https://<SOURCE_BLOB_URL> can be found in the image catalog.

For more information about Azure copy syntax and examples, refer to Get started with AzCopy in Azure docs.