...
The openshift component is a component for managing your OpenShift applications.
Maven users will need to add the following dependency to their pom.xml
for this component:
...
You can append query options to the URI in the following format, ?option=value&option=value&...
Options
Div |
---|
class | confluenceTableSmall |
---|
|
Wiki Markup |
---|
{div:class=confluenceTableSmall}
|| Name || Default Value || Description ||
| {{domain}} | {{null}} | Domain name. If not specified then the default domain is used. |
| {{username}} | | *Mandatory*: The username to login to openshift server. |
| {{password}} | | *Mandatory:* The password for login to openshift server. |
| {{server}} | | Url to the openshift server. If not specified then the default value from the local openshift configuration file {{Name | Default Value | Description |
---|
domain
| null
| Domain name. If not specified then the default domain is used. | username
| | Mandatory: The username to login to openshift server. | password
| | Mandatory: The password for login to openshift server. | server
| | Url to the openshift server. If not specified then the default value from the local openshift configuration file |
~/.openshift/express.conf
|
}} is used. |
| {{operation}} | {{list}} | The operation to perform which can be: {{list}}, {{start}}, {{stop}}, {{restart}}, and {{state}}. The {{list}} operation returns information about all the applications in json format. The {{state}} operation returns the state such as: started, stopped etc. The other operations does not return any value. |
| {{application}} | | The application name to {{start}}, {{stop}}, {{restart}}, or get the {{state}}. |
{div} is used. And if that fails as well then "openshift.redhat.com" is used. | delay
| 10s
| Consumer only: How frequent to poll for state changes for the applications. By default we poll every 10 seconds. | operation
| list
| Producer only: The operation to perform which can be: list, start, stop, restart, and state . The list operation returns information about all the applications in json format. The state operation returns the state such as: started, stopped etc. The other operations does not return any value. From Camel 2.16: getStandaloneCartridge, getEmbeddedCartridges, addEmbeddedCartridge, removeEmbeddedCartridge The getStandaloneCartridge return the display name of the standalone cartridge. The getEmbeddedCartridges returns the list of the installed embedded cartridge. The addEmbeddedCartridge operation adds the latest version of an embeddable cartridge by specifying its name with the interface IEmbeddableCartridge in the header CamelOpenShiftEmbeddedCartridgeName and return the cartridge display name. The removeEmbeddedCartridge operation remove an embedded cartridge by specifying its name with the interface IEmbeddableCartridge in the header CamelOpenShiftEmbeddedCartridgeName and return the cartridge display name. | application
| | Producer only: The application name to start , stop , restart , or get the state . | mode
| | Producer only: Whether to output the message body as a pojo or json. For pojo the message is a List<com.openshift.client.IApplication> type. |
|
Examples
Listing all applications
...
In this case the information about all the applications is returned as pojo. If you want a json response, then set mode=json.
Stopping an application
Code Block |
---|
// sending routestopping the foobar application
from("direct:control")
.to("openshift:myClient?username=foo&password=secret&operation=stop&application=foobar");
|
In the example above we stop the application named foobar.
Polling for gear state changes
The consumer is used for polling state changes in gears. Such as when a new gear is added/removed/ or its lifecycle is changed, eg started, or stopped etc.
Code Block |
---|
// trigger when state changes on our gears
from("openshift:myClient?username=foo&password=secret&delay=30s")
.log("Event ${header.CamelOpenShiftEventType} on application ${body.name} changed state to ${header.CamelOpenShiftEventNewState}"); |
When the consumer emits an Exchange then the body contains the com.openshift.client.IApplication
as the message body. And the following headers is included.
Header | May be null | Description |
---|
CamelOpenShiftEventType | No | The type of the event which can be one of: added, removed or changed. |
CamelOpenShiftEventOldState | Yes | The old state, when the event type is changed. |
CamelOpenShiftEventNewState | No | The new state, for any of the event types |
Include Page |
---|
| Endpoint See Also |
---|
| Endpoint See Also |
---|
|