Chapter 37. Create from URL
37.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.
37.2. Using an Image Stream and Image Tag
37.2.1. Query String Parameters
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
|
|
The value | true | string | |
|
|
The value | true | string | |
|
| The name of the namespace containing the image stream and image tag to use. | false | string |
|
|
| Identifies the resources created for this application. | false | string | |
|
| The Git repository URL containing the application source code. | false | string | |
|
|
The branch, tag, or commit for the application source code specified in | false | string | |
|
|
The subdirectory for the application source code specified in | false | string |
Reserved characters in parameter values should be URL encoded.
37.2.1.1. Example
create?imageStream=nodejs&imageTag=4&name=nodejs&sourceURI=https%3A%2F%2Fgithub.com%2Fopenshift%2Fnodejs-ex.git&sourceRef=master&contextDir=%2F
37.3. Using a Template
37.3.1. Query String Parameters
| Name | Description | Required | Schema | Default |
|---|---|---|---|---|
|
|
The value of | true | string | |
|
| A JSON parameters map containing the template parameter name and corresponding value you wish to override. | false | JSON | |
|
| The name of the namespace containing the template to use. | false | string |
|
Reserved characters in parameter values should be URL encoded.
37.3.1.1. Example
create?template=nodejs-mongodb-example&templateParamsMap={"SOURCE_REPOSITORY_URL"%3A"https%3A%2F%2Fgithub.com%2Fopenshift%2Fnodejs-ex.git"}