Editing Image Details, Tags, and End-Dating Images

You can edit details for images you created, including the image name and description, adding an end-date, and adding image tags.

End-dating allows you to set the date when you want to hide the image from public view. After you have end-dated your image, it is displayed in your list of images with Image End dated displayed over the image icon, and is no longer visible to users.

Image tags are labels you can add to an image you created, which help users know whether your image has the features they need for their instance. For example, it's a good idea to include in the tag the operating system, any software you installed in the image, and any configuration information, such as Ubuntu, NGS viewers, and MAKER. You can add tags to the image when you request the image or anytime after it has been created, and also remove any tag from an image you created. You can view the list of all existing tags, search on tags, and create new tags.

Editing image details

  1. Opening the image details window

    1. In Atmosphere, click Images on the top menu bar and then click My Images at the top of the screen.
    2. Click the image name.
  2. Editing the image name and description

    1. Click Edit details below the Tags field.
    2. To edit the name, click in the Name field and change the name.

    3. To edit the description, click in the Description field and edit the description.
  3. Adding and removing image tags

    Tips for creating useful tags

    Use tags that will help users decide whether this image will suit their needs: operating system, installed software, configuration information, e.g. Ubuntu, NGS Viewers, MAKER, QIIME, etc.
    1. To add an existing tag to an image you own, click in the Tags field, begin entering a tag name, and then click to select the existing tag.
    2. To remove a tag from an image, click the x next to the tag.
    3. To add a new tag to the images list, click Create New tag, enter the new tag name, and click Enter.
  4. If done, click Save.

Editing image version settings

In version settings you can edit the version number, change log, and set the end-date, which defines the date and time when you want to hide our image.

  1. Click Edit Version in the Versions section to open the Edit Image Version window.
  2. Changing the version number for the image

    1. Click in the Edit Version Name field and enter up to 30 alphanumeric characters (e.g., 2.0-stable, 2.1-beta, etc.).
  3. Setting the image's end-date

    1. Click in the Version End-dated On field and either:
      • Enter the date when you want the image removed.
        – or –
      • Click in the field and enter the date and time to hide the image.
  4. Updating the change log

    1. Click in the Change Log field and enter a brief description of the changes you made to the image.
  5. If done, click Save Changes.

Setting advanced image options

Advanced Options is where you enable or disable a cloud provider, share the version, list and create a software license, create a deployment script that executes when the instance is launched, move an image version to a different image you own, and define the minimum number of CPU cores and memory required for the image.

  1. Opening the image's advanced options

    1. Click Images > My Images.
    2. Click the image name, click Edit Version, and then click Advanced Options.
  2. Enabling or disabling the image's provider

    • The Available on Providers field lists the available providers for the image. Learn more about cloud providers and requesting an additional provider on Selecting Your Default Cloud Provider.

      • To disable a provider, click Disable Provider.
        – or –

      • Click Enable Provider to enable a new provider in the list.

  3. Sharing the image version

    1. Click in the Version Shared With field.

      • To share with a new user, begin typing the user's name, and click the name to select.

      • To add a member to the list, enter the user's name and press Enter.

    2. If done, click Save Changes.

  4. Documenting and creating new software licenses

    • All software licenses must be documented in this field, and users who want to use your image must agree to the software stipulations before they can launch the image.
      • To search for an existing license, click in the Search by License title field and begin entering a license title, and then click to select the title.
      • To create a new license:
        1. Click Create New License.
        2. Select either:
          • URL and enter the full URL to the license.
          • Full Text and enter the full text.
        3. Click Create and Add.
        4. If done, click Save Changes.
  5. Selecting or creating a deployment script

    • In addition to selecting or creating a deployment script in this window, you also can create a deployment script when you launch a new instance.
      • To select an existing script, click in the Search by Script title field, begin entering a title, and then click to select the script to use.
      • To create a new script:
    1. Click Create New Script.
    2. Enter the script title.
    3. Select either:
      • URL and enter the script URL.
      • Full Text and enter the full text.
    4. Click Create and Add.
  6. Moving an image version to a different image

    1. In the Select the image that best describes this image drop-down list, select a different image you own to which you want to move the image version
      If done, click S.ave Changes

  7. Defining the minimum requirements

    1. In the Minimum # of CPU cores, enter a number between 1 and 16 for the minimum CPUs for the image.
    2. In the Minimum amount of memory (GB), enter a number between 1 and 32 GB for the minimum memory for the image.
  8. Update the change log.
  9. When done, click Save Changes.

Unable to render {include} The included page could not be found.

Helpful Links