Chapter 39. Create from URL

39.1. Overview

Create From URL is a function that allows you to construct a URL from an image stream, image tag, or template.

Create from URL only works with image streams or templates from namespaces that have been explicitly whitelisted. The whitelist contains the openshift namespace by default. To add namespaces to the whitelist, see Configuring the Create From URL Namespace Whitelist.

You can define custom buttons.

These buttons leverage a defined URL pattern with an appropriate query string. The user is prompted to select the project. Then, the Create from URL workflow continues.

39.2. Using an Image Stream and Image Tag

39.2.1. Query String Parameters

Name

Description

Required

Schema

Default

imageStream

The value metadata.name as defined in the image stream to be used.

true

string

imageTag

The value spec.tags.name as defined in the image stream to be used.

true

string

namespace

The name of the namespace containing the image stream and image tag to use.

false

string

openshift

name

Identifies the resources created for this application.

false

string

sourceURI

The Git repository URL containing the application source code.

false

string

sourceRef

The branch, tag, or commit for the application source code specified in sourceURI.

false

string

contextDir

The subdirectory for the application source code specified in sourceURI, used as the context directory for the build.