Viewing and downloading container artifacts

For a workspace that writes the destination data to container artifacts, the Job History view displays a list of the generated data volumes.

For each data volume, it also provides access to

  • The digest you use to download the data volume from the registry

  • A Docker Compose file template to help you to stand up a database with a volume mount that uses the generated data volume

Viewing the list of generated container artifacts

When the workspace is configured to write the destination data to a container repository, the Job History view provides access to the generated data volumes.

The Job History view for the workspace is then divided into the following tabs:

  • The Jobs tab contains the list of jobs.

  • The Container Artifacts tab lists the data volumes that were created by data generation jobs.

On the Container Artifacts tab, each entry represents a data volume created by a data generation job. The volumes that were generated most recently are at the top of the list.

Information in the list

For each volume, the list contains:

  • The image that the volume was based on

  • The assigned tags

  • The identifier of the job

  • When the artifact was created

  • The user who ran the job that created the artifact

Viewing details for an artifact

To view the details about a data volume, click the details icon. The details panel contains:

  • The job identifier

  • The assigned tags

  • When the volume was created

  • Who created the volume

  • The full registry and reference path to the volume

From the artifact details panel, you can:

  • Copy the job identifier

  • Display the job details view

  • Download the Compose file for the volume

  • Copy the digest for the volume. You use the digest to download the data volume from the registry.

Obtaining container artifacts

For each data volume, you use the digest to retrieve the data volume from the registry. The Docker Compose file provides authentication information for the data on the data volume.

Copying the volume digest

To copy the volume digest for a generated data volume:

  1. On the Container Artifacts tab, click the details icon for the data volume.

  2. On the details panel, click the copy digest button.

Obtaining the data volume from the registry

Use the volume digest to pull the data volume from the registry.

Because this is a data volume and not an image, you must use a tool such as the ORAS CLI.

The data volume downloads as a .tar.gz file.

Extract the downloaded file to your local machine.

Here is a basic example of downloading and extracting the volume:

# Pull by tag
oras pull <registry>/<repository>:<tag>

# Pull by digest
oras pull <registry>/<repository>@<digest>

# Extract the data volume
# When you extract the tar, preserve the permissions and owners
# Note: --same-owner is specific to GNU TAR
tar --same-owner -xvf datavol.tar.gz

Downloading and updating the Docker Compose file

Downloading the file

You can download the Docker Compose file for a job from the jobs list, the job details view, or the Container Artifacts list.

From the job list:

  1. Click the download icon in the far right column.

  2. Select Volume Compose File.

From the job details view, under Generated Artifacts, click Compose File.

From the Container Artifacts list:

  1. Click the details icon for the data volume.

  2. On the details panel, click the download icon.

Updating the file with the volume path

In the volumes section of the Compose file, replace the template path value with the path to the extracted data volume.

Last updated