Manage an Edge Application Image

Introduction

This guide describes how to perform basic operations on Edge Application (App) Images, including adding and deleting app images.

Edge App Images are the raw container images or virtual machine images that you can use to create Edge Apps. The ZEDEDA Cloud Library serves as a way for you to manage images, such as upload, uplink, and more. You can pull these images to create your own Edge Apps or customize them as needed.

This is a series of articles. You will likely follow them in this order.

1. Edge Application Overview
2. Manage an Edge App Image - You are here!
3. Manage an Edge Application
   • Add a Module as an Edge App Type
   • Add a Container as an Edge App Type 
   • Add a Virtual Machine as an Edge App Type
4. Deploy an Application Instances

Prerequisites

• • You have the SysManager role in your enterprise.
  • You must have a datastore set up for your edge application.

Add an Edge App Image using the ZEDEDA GUI

1. Log in to the ZEDEDA GUI.
2. On left-hand side menu, hover over Library and click on Edge Apps Images
3. Click on the icon + to create a new edge app.
4. Fill in the Identity section. Note the following field.
   
   • Name: This value can't be changed later.
5. Uploading/Uplinking the Image
   
   • Click on Upload or Uplink.
     
     • Upload: provide the image path for uploading.
     • Uplink: Note the following fields.
       
       • Image SHA256: the SHA-256 hash output of the file, such as: a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e
       • Project: the project the Edge App Image belongs to.
       • Image Relative URL: the filename of the image, such as: my-image.img
6. After filling in all details, click the Add button.
7. A toast window will appear, confirming that your edge app image was added successfully.

Add an Edge App Image using the ZEDEDA CLI

1. Log in to ZCLI.
2. Run the following command in the ZCLI to create the edge app image.
   

   zcli image create <name> [--datastore-name=<datastore>] [--datastores=<datastore>...] (--arch=[AMD64|ARM64] | --patch-artifact-image) --image-format=[raw|qcow|qcow2|vhd|vmdk|ova|vhdx|container] [--image-url=<rel_url>] [--title=<title>] [--type=[Eve|Application|EvePrivate]] [--origin-type=<origin-type>] [--project-scope=<project-names>]

   Example

   zcli image create MY-IMAGE-V1 --datastore-name=ZEDEDA-DEMO --arch=AMD64 --image-format=qcow2 --title=MY-IMAGE-V1

3. Uplink your edge app image to associate the image entry in ZEDEDA Cloud with the file in the datastore, so ZEDEDA Cloud knows where to look for the file.
   

   zcli image uplink IMAGE_NAME --datastore-name=DATASTORE_NAME --image-sha=SHA_256_VALUE --image-size=IMAGE_SIZE_IN_BYTES

   Example

   zcli image uplink MY-IMAGE-V1 --datastore-name=ZEDEDA-DEMO --image-sha=a591a6d40bf420404a011733cfb7b190d62c65bf0bcda32b57b277d9ad9f146e --image-size=232476160

Delete an Edge App Image using ZEDEDA GUI

1. Log in to the ZEDEDA GUI.
2. On left-hand side menu, hover over Library and click on Edge Apps Images

3. Select the edge app images that you want to delete.

4. Click on the More icon (three vertical dots) in the top right.
5. Click Delete in the dialogue that appears.

Delete an Edge App Image using ZEDEDA CLI

1. Log in to ZCLI.
2. Run the following command in the ZCLI to delete the edge app image.
   

   zcli image delete [<name> | --match=<keyword>] [-f]

   Example

   zcli image delete MY-IMAGE-V1

Next steps

This is a series of articles. You will likely follow them in this order.

1. Edge Application Overview
2. Manage an Edge App Image - You are here!
3. Manage an Edge Application
   • Add a Module as an Edge App Type
   • Add a Container as an Edge App Type 
   • Add a Virtual Machine as an Edge App Type
4. Deploy an Application Instance