Cloud customer?
Start for Free >
Upgrade in MyJFrog >
What's New in Cloud >

Search





Overview

An Image resource is used to add a reference to a Docker image to your pipeline.


An Image resource holds information of a docker image that is stored through a Docker Registry Integration that may in one of the following registry sources:

  • JFrog Artifactory / JFrog Container Registry
  • Amazon Container Registry
  • Google Container Registry
  • Azure Container Registry
  • Docker Hub

An Image resource can be used as both input and output. Step like DockerBuild will generate it as an output and steps like DockerPublish will use it as input to publish to a Docker registry.

Page Contents

Usage

resources:
  - name: 		<string>
     type: 		Image
     configuration:
       registry:        	<docker integration name>
       sourceRepository: 	<name of the artifactory repo>   # required if registry is Artifactory
       region:              <string>                         # required if registry is on AWS
       imageName:	    	<imageRepo/imageName>
       imageTag: 			<string>
       autoPull: 			<boolean> #(default false)

Tags

name 

An alphanumeric string (underscores are permitted) that identifies the resource.

type 

Must be Image for this resource type.

configuration

Specifies all configuration selections for the resource.

Tag

Description

Required/Optional
registry The name of a Docker Registry IntegrationRequired
sourceRepository The name of the repository in Artifactory to which the images will be publishedRequired if registry is in JFrog Artifactory
regionRequired if registry is on AWS
imageName The file path of the Docker image, of the form imageRepo/imageNameRequired
imageTagThe version tag of the initial version of the Docker imageRequired
autoPull 

When true, the image is automatically pulled to the machine running the step.

Defaults to false.

Optional

Environment Variables

Whenever Image is used in a step, a set of environment variables is automatically made available that you can use in your step.

Environment Variable

Description

res_<resource_name>_name
Name of the resource
res_<resource_name>_sourceRepository
The name of the repository in Artifactory
res_<resource_name>_regionThe AWS region identifier
res_<resource_name>_imageNameThe file path of the Docker image
res_<resource_name>_imageTagThe version tag of the initial version of the Docker image
res_<resource_name>_autoPull Value of the autopull flag
  • No labels
Copyright © 2021 JFrog Ltd.