...
|_ extensions |_ <extension_name> |_ <extension_version> metainfo.xml |_ services |_ <service_name> metainfo.xml metrics.json |_ configuration {configuration files} |_ package {files, scripts, templates} |
An extension version is similar to a stack version but it only includes the metainfo.xml and the services directory. This means that the alerts, kerberos, metrics, role command order, widgets files are not supported and should be included at the service level. In addition, the repositories, hooks, configurations, and upgrades directories are not supported although upgrade support can be added at the service level.
Extension Inheritance
Extensions Extension versions can extend other Extensions Extension versions in order to share command scripts and configurations. This reduces duplication of code across Extensions with the following:
- add new Services in the child Extension version (not in the parent Extension version)
- override command scripts of the parent Services
- override configurations of the parent Services
For example, MyExtension 2.0 could extend MyExtension 1.0 so only the changes applicable to the MyExtension 2.0 extension are present in that Extension definition. This extension is defined in the metainfo.xml for MyExtension 2.0:
<metainfo> <extends>1.0</extends> |
Supported Stack Versions
Each Extension Version must support one or more Stack Versions. The Extension Version specifies the minimum Stack Version which it supports. This is included in the extension's metainfo.xml in the prerequisites section like so:
<metainfo>
<prerequisites>
<min-stack-versions>
<stack>
<name>HDP</name>
<version>2.4</version>
</stack>
<stack>
<name>OTHER</name>
<version>1.0</version>
</stack>
</min-stack-versions>
</prerequisites>
</metainfo> |
Installing Extensions
Once the extension version directory has been created under the resource/extensions directory with the required metainfo.xml file, you can restart ambari-server.
ambari-server restart |
Extension REST APIs
You can query for extensions by calling REST APIs.
Get all extensions
curl -u admin:admin -H 'X-Requested-By:ambari' -X GET 'http://<server>:<port>/api/v1/extensions' {
"href" : "http://<server>:<port>/api/v1/extensions/",
"items" : [
{
"href" : "http://<server>:<port>/api/v1/extensions/EXT",
"Extensions" : {
"extension_name" : "EXT"
}
}
]
} |
Get extension
curl -u admin:admin -H 'X-Requested-By:ambari' -X GET 'http://<server>:<port>/api/v1/extensions/EXT' {
"href" : "http://<server>:<port>/api/v1/extensions/EXT",
"Extensions" : {
"extension_name" : "EXT"
},
"versions" : [
{
"href" : "http://<server>:<port>/api/v1/extensions/EXT/versions/1.0",
"Versions" : {
"extension_name" : "EXT",
"extension_version" : "1.0"
}
}
]
} |
Get extension version
curl -u admin:admin -H 'X-Requested-By:ambari' -X GET 'http://<server>:<port>/api/v1/extensions/EXT/versions/1.0' {
"href" : "http://<server>:<port>/api/v1/extensions/EXT/versions/1.0/",
"Versions" : {
"extension-errors" : [],
"extension_name" : "EXT",
"extension_version" : "1.0",
"parent_extension_version" : null,
"valid" : true
}
} |
Extension Links
An Extension Link is a link between a stack version and an extension version. Once an extension version has been linked to the currently installed stack version, the custom services contained in the extension version may be added to the cluster in the same manner as if they were actually contained in the stack version.
Extension Link REST APIs
You can retrieve, create, update and delete extension links by calling REST APIs.
Create Extension Link
The following curl command will link an extension EXT/1.0 to the stack HDP/2.4
curl -u admin:admin -H 'X-Requested-By: ambari' -X POST -d '{"ExtensionLink": {"stack_name": "HDP", "stack_version": "2.4", "extension_name": "EXT", "extension_version": "1.0"}}' http://<server>:<port>/api/v1/links/ |
Get All Extension Links
curl -u admin:admin -H 'X-Requested-By:ambari' -X GET 'http://<server>:<port>/api/v1/links' {
"href" : "http://<server>:<port>/api/v1/links/",
"items" : [
{
"href" : "http://<server>:<port>:8080/api/v1/links/1",
"ExtensionLink" : {
"extension_name" : "EXT",
"extension_version" : "1.0",
"link_id" : 1,
"stack_name" : "HDP",
"stack_version" : "2.4"
}
}
]
} |
Get Extension Link
curl -u admin:admin -H 'X-Requested-By:ambari' -X GET 'http://<server>:<port>/api/v1/link/1' {
"href" : "http://<server>:<port>/api/v1/links/1",
"ExtensionLink" : {
"extension_name" : "EXT",
"extension_version" : "1.0",
"link_id" : 1,
"stack_name" : "HDP",
"stack_version" : "2.4"
}
} |
Delete Delete Extension Link
You must specify the ID of the Extension Link to be deleted.
| curl -u admin:admin -H 'X-Requested-By: ambari' -X DELETE http://<server>:<port>/api/v1/links/<link_id> |
Update All Extension Links
This will reread the stacks, extensions and services in order to make sure the state of the stack is up to date in memory.
| curl -u admin:admin -H 'X-Requested-By: ambari' -X PUT http://<server>:<port>/api/v1/links/ |