Skip to main content

Template Details and Image History

The Template Details page provides a deep dive into a specific image template. It is the central hub for monitoring build progress, auditing historical images, and updating template configurations.

Template Summary​

The top section of the page displays a summary of the template's current state:

  • Metadata: Displays the template name, cloud provider, OS distribution, and description.
  • Current Status: Shows the real-time status of the template (e.g., IDLE, BUILDING, TESTING).
  • Rebuild Button: Triggers a manual rebuild of the template. This button is disabled while a build is already in progress to prevent overlapping executions.

The page is organized into three primary tabs: Images, Components, and Settings.

Images Tab​

This tab contains a table of all images built from this template. It serves as the historical record of your image production.

  • Table Columns: Displays the build status, compliance score, and completion time for each image.
  • Image Detail Sidebar: Clicking on any image row opens a sidebar with comprehensive details:
    • Build/Test Components: A list of the specific component versions used for that build.
    • Build Duration: The total time taken to complete the build and test phases.
    • Source Image: The base image used as the starting point for the build.
    • Compliance Reports: Links to download detailed compliance reports in JSON and PDF formats.
    • Package Inventory: A link to view the full list of packages installed on the image.
    • SBOM: Access to the Software Bill of Materials for the image.
    • Change Log: A summary of changes compared to the previous successful build.
    • Distribution Results: A detailed breakdown of which cloud accounts received the image, including the resulting Image ID in each account and any distribution errors.

Components Tab​

The Components tab allows you to manage the building blocks of your template without going through the full wizard.

  • View and Edit: You can see the current list of build and test components.
  • Modify: Add or remove components, change their versions, or drag them to reorder the execution sequence.
  • Save Changes: Updates made here will be applied to the next build of the template.

Settings Tab​

The Settings tab provides access to the template's configuration parameters.

  • General Settings: Edit the template name, description, and tags.
  • Automation: Toggle cyclical rebuilds and adjust the image retention count.
  • Provider Settings: Update provider-specific configurations such as AWS EBS settings, Azure replica regions, or target cloud accounts.
  • Notifications: Modify the notification groups or endpoints associated with the template.
Via API

You can use the GraphQL API to query template details, trigger rebuilds, and fetch specific image information.

query GetTemplateDetails($id: ID!) {
  template(id: $id) {
    name
    status
    images {
      id
      status
      complianceScore
    }
  }
}

mutation TriggerRebuild($id: ID!) {
  rebuildTemplate(id: $id) {
    success
    message
  }
}

The Template Details page ensures you have full visibility into your image lifecycle. Whether you are troubleshooting a failed build by reviewing the distribution results or updating a component version for a new security requirement, this page provides the necessary tools and information.