Oracle Cloud Infrastructure Documentation

Artifact Images For Deployments

Deployment artifacts represent the container image versions used by a deployment. You add artifacts to roll out new repository tags and activate an artifact to make it the running version.

Deployment artifacts are created and managed from an application's deployment details. Each artifact is defined by the selected container repository and version tag.

Only one artifact can be active at a time. When you activate a new artifact, the artifact that was active before becomes inactive. Artifacts for deployments are Docker container images that package the agent server and its dependencies.

About Deployment Artifacts

A deployment artifact is the container image reference (repository and version tag) that a deployment uses. Adding a new artifact is the mechanism for introducing a new container image version to an existing deployment.

When you activate an artifact, it becomes the active artifact for the deployment and the artifact that was active before becomes inactive.

Note

Artifacts don't have tags or a Copy OCID action. Only one artifact can be active at a time. You can delete only inactive artifacts.

Limits

The following limits apply to deployment artifacts and applications:

  • You can add up to 20 artifacts to an application. This also limits the maximum number of deployments per application to 20.
  • You can request an increase to 50 artifacts per application.
  • You can create up to 10 applications per tenancy.
  • You can request an increase to 50 applications per tenancy.

Managing Artifacts

You can manage artifacts from the deployment details page:

  1. Select Add artifact.
  2. Select the compartment, repository compartment, repository, and version tag for the container image.
  3. Create the artifact. The new artifact is added in an inactive state.
  4. To switch the running version, use the artifact Actions menu and select Activate. Confirm the activation.
  5. To remove an artifact, use the artifact Actions menu and select Delete. You can delete only inactive artifacts.

In the artifact Actions menu, the available actions are Activate and Delete.

Tip

When you update an agent, for example, after fixing a bug or adding new features, update the agent to a new version.