...
Code Block |
---|
language | bash |
---|
title | POST |
---|
linenumbers | true |
---|
|
POST
URL: /v2/projects
POST BODY:
{
"metadata": {
"name": "<name>", //must be unique
"description": "<description>",
"userData1": "<user data>",
"descriptionuserData2": "<description><user data>"
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
"name": "Name of Project", //must be unique""<name>",
"description": "<description>",
"userData1": "<user data>",
"descriptionuserData2": "<description><user data>"
}
} |
GET, DELETE
Code Block |
---|
language | bash |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
"name": "Name of Project<name>", //must be unique
"description": "<description>",
}
}
DELETE
URL: "userData1": "<user data>",
"userData2": "<user data>"
}
}
DELETE
URL: /v2/projects/{project-name}
RETURN STATUS: 204 |
Composite Application API
Composite Application names are unique within a Project. Composite application resource represents a collection of applications and each application is represented by helm charts. Each Helm chart is wrapped in tar.gz format.
POST
Code Block |
---|
language | jsbash |
---|
title | POSTGET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps
POST BODY:
{
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
"name": "<name>", //must be unique
"description": "<description>"
},
"versionuserData1": "<version of the composite app>"
}
RETURN STATUS: 201
RETURN BODY: { "metadata": {
"name": "<name>", //must be unique
"description": "<description>"
},
"version": "<version of the composite app>"} |
...
<user data>",
"userData2": "<user data>"
}
}
DELETE
URL: /v2/projects/{project-name}
RETURN STATUS: 204
|
Composite Application API
Composite Application names are unique within a Project. Composite application resource represents a collection of applications and each application is represented by helm charts. Each Helm chart is wrapped in tar.gz format.
POST
Code Block |
---|
language | js |
---|
title | GET, DELETEPOST |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}
RETURN STATUS: 200
RETURN BODY:
{
POST BODY:
{
"metadata": {
"name": "<name>",
//must be unique
"description": "<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"version": "<version of the composite app>"
}
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}
RETURN STATUS: 201
RETURN STATUS: 204 |
Adding applications to composite app
Format of the Helm chart for the application wrapped in tar.gz
...
>
cd
vagrant
/tests/vnfs/testrb/helm
>
find
vault-consul-dev
vault-consul-dev
vault-consul-dev
/Chart
.yaml
vault-consul-dev
/values
.yaml
vault-consul-dev
/templates
vault-consul-dev
/templates/service
.yaml
vault-consul-dev
/templates/deployment
.yaml
vault-consul-dev
/charts
vault-consul-dev
/charts/common/values
.yaml
vault-consul-dev
/charts/common/templates/_service
.tpl
vault-consul-dev
/charts/common/templates/_repository
.tpl
vault-consul-dev
/charts/common/templates/_name
.tpl
vault-consul-dev
/charts/common/templates/_namespace
.tpl
vault-consul-dev
/charts/common/templates
vault-consul-dev
/charts/common/Chart
.yaml
vault-consul-dev
/charts/common
>
tar
-cf vault-consul-dev.
tar
vault-consul-dev
>
gzip
vault-consul-dev.
tar
BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"version":"<version of the composite app>"
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"version":"<version of the composite app>"
}
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}
RETURN STATUS: 204 |
Adding applications to composite app
Format of the Helm chart for the application wrapped in tar.gz
> cd vagrant /tests/vnfs/test/helm
> find vault-consul-dev
vault-consul-dev
vault-consul-dev /Chart .yaml
vault-consul-dev /values .yaml
vault-consul-dev /templates
vault-consul-dev /templates/service .yaml
vault-consul-dev /templates/deployment .yaml
vault-consul-dev /charts
vault-consul-dev /charts/common/values .yaml
vault-consul-dev /charts/common/templates/_service .tpl
vault-consul-dev /charts/common/templates/_repository .tpl
vault-consul-dev /charts/common/templates/_name .tpl
vault-consul-dev /charts/common/templates/_namespace .tpl
vault-consul-dev /charts/common/templates
vault-consul-dev /charts/common/Chart .yaml
vault-consul-dev /charts/common
> tar -cf vault-consul-dev. tar vault-consul-dev
> gzip vault-consul-dev. tar
|
POST
This POST is a multipart POST. With the POST body containing the data about the application and the tar.gz uploaded in multipart form.
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps/{app-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
}
Multipart response containing the tar.gz of the Helm chart for the app
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps/{app-name}
RETURN STATUS: 204 |
Profile API
Once the definitions for applications are created, profiles are created to customize the applications. Later on, they are instantiated in Kubernetes by the instantiation API.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{verison}/composite-profiles
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{app-name}/{app-version}/composite-profiles/{composite-profile-name}
RETURN STATUS: 204 |
Adding profile per application
A per application profile contains the following:
- manifest.yaml
- Contains the details for the profile and everything contained within
- A HELM values override yaml file.
- It can have any name as long as it matches the corresponding entry in the manifest.yaml
- Any number of files organized in a folder structure
- All these files should have a corresponding entry in manifest.yaml file
Sample Profile is described below:
Create the profile artifact
Creating a Profile Artifact
1 2 3 4 5 6 7 8 9 10 11 12 13 | > cd vagrant /tests/vnfs/test/helm/profile
> find .
manifest.yaml
override_values.yaml
testfol
testfol /subdir
testfol /subdir/deployment .yaml
> cd profile
> tar -cf profile. tar *
> gzip profile. tar
> mv profile. tar .gz ../
|
The manifest file contains the following:
manifest.yaml
1 2 3 4 5 6 7 | ---
version: v1
type:
values: "values_override.yaml"
configresource:
- filepath : testfol/subdir/deployment.yaml
chartpath: vault-consul-dev/templates/deployment.yaml
|
POST
This POST is a multipart POST. With the POST body containing the data about the profile and the profile tar.gz uploaded in multipart form.
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{verison}/composite-profiles/{composite-profile-name}/profiles
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name": "<name>", // Must match the name given in composite-apps/apps API
}
}
Multipart request containg tar.gz of the profile
RETURN STATUS: 201
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name": "<name>", // Must match the name given in composite-apps/apps API
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}/profiles/{profile-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name": "<name>", // Must match the name given in composite-apps/apps API
}
}
Multipart response containing the tar.gz of the profile
GET (Query)
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}/profiles?app-name=<app-name>
RETURN STATUS: 200
RETURN BODY:
{
"app-name": "<name>"
}
Multipart response containing the tar.gz of the profile
DELETE
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}/profiles/{profile-name}
RETURN STATUS: 204 |
Generic Placement Intent API
Generic Placement Intent API is used to create generic placement intents for sub-applications in an application. Intent created using this API will be added to an Intent Group for use during instantiation.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intents
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"logical-cloud": "logical-cloud-name" //name of logical cloud to use for instantiation. The DCM API will provide the list of clusters that are part of the logical-cloud
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"logical-cloud": "logical-cloud-name" //name of logical cloud to use for instantiation. The DCM API will provide the list of clusters that are part of the logical-cloud
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intents/{intent-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"logical-cloud": "logical-cloud-name" //name of logical cloud to use for instantiation. The DCM API will provide the list of clusters that are part of the logical-cloud
}
}
DELETE
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intents/{intent-name}
RETURN STATUS: 204
|
Adding placement intent for each application in the composite-app
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intent/{intent-name}/app-intents
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name":"name",
"intent":{
"allOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
},
{
"anyOf":[
{
"provider-name":"aws"
"cluster-label-name":"east-us1"
},
{
"provider-name":"aws"
"cluster-label-name":"east-us2"
}
]
}
]
}
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name":"name",
"intent":{
"allOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
},
{
"anyOf":[
{
"provider-name":"aws"
"cluster-label-name":"east-us1"
},
{
"provider-name":"aws"
"cluster-label-name":"east-us2"
}
]
}
]
}
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intent/{intent-name}/app-intents
RETURN STATUS: 200
RETURN BODY:
{
"applications":[
{
"name":"app1",
"anyOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
}
]
},
{
"name":"app2",
"allOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
}
]
},
{
"name":"app3",
"allOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
},
{
"anyOf":[
{
"provider-name":"aws"
"cluster-label-name":"east-us1"
},
{
"provider-name":"aws"
"cluster-label-name":"east-us2"
}
]
}
]
}
]
}
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intent/{intent-name}/app-intents/{intent-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"app-name":"name",
"intent":{
"allOf":[
{
"provider-name":"aws"
"cluster-name":"edge1"
},
{
"provider-name":"aws"
"cluster-name":"edge2"
},
{
"anyOf":[
{
"provider-name":"aws"
"cluster-label-name":"east-us1"
},
{
"provider-name":"aws"
"cluster-label-name":"east-us2"
}
]
}
]
}
}
}
GET (Query)
URL: /v2/project |
POST
This POST is a multipart POST. With the POST body containing the data about the application and the tar.gz uploaded in multipart form.
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps
POST BODY:
{
"metadata": {
"app-name": "<name>", // Name of the application
"description": "<description>"
}
}
RETURN STATUS: 201
RETURN BODY: { "name": "<name>",
"description": "<description>"} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps/{app-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
"app-name": "<name>", // Name of the application
"description": "<description>"
}
}
Multipart response containing the tar.gz of the Helm chart for the app
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/apps/{app-name}
RETURN STATUS: 204 |
Profile API
Once the definitions for applications are created, profiles are created to customize the applications. Later on, they are instantiated in Kubernetes by the instantiation API.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{verison}/composite-profiles
POST BODY:
{
"metadata": {
"composite-profile-name": "test",
"description": "<description>",
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
"composite-profile-name": "test",
"description": "<description>",
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
"composite-profile-name": "test",
"description": "<description>",
}
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{app-name}/{app-version}/composite-profiles/{composite-profile-name}
RETURN STATUS: 204 |
Adding profile per application
A per application profile contains the following:
- manifest.yaml
- Contains the details for the profile and everything contained within
- A HELM values override yaml file.
- It can have any name as long as it matches the corresponding entry in the manifest.yaml
- Any number of files organized in a folder structure
- All these files should have a corresponding entry in manifest.yaml file
Sample Profile is described below:
Create the profile artifact
Creating a Profile Artifact
...
1
2
3
4
5
6
7
8
9
10
11
12
13
...
>
cd
vagrant
/tests/vnfs/testrb/helm/profile
>
find
.
manifest.yaml
override_values.yaml
testfol
testfol
/subdir
testfol
/subdir/deployment
.yaml
>
cd
profile
>
tar
-cf profile.
tar
*
>
gzip
profile.
tar
>
mv
profile.
tar
.gz ../
The manifest file contains the following:
manifest.yaml
...
1
2
3
4
5
6
7
...
---
version:
v1
type:
values:
"values_override.yaml"
configresource:
-
filepath
:
testfol/subdir/deployment.yaml
chartpath:
vault-consul-dev/templates/deployment.yaml
POST
This POST is a multipart POST. With the POST body containing the data about the profile and the profile tar.gz uploaded in multipart form.
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{verison}/composite-profiles/{composite-profile-name}/profiles
POST BODY:
{
"metadata": {
"profile-name": "test",
"description": "<description>"
},
"app-name": "<name>", // Must match the name given in composite-apps/apps API
}
Multipart request containg tar.gz of the profile
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
"profile-name": "test",
"description": "<description>"
},
"app-name": "<name>"
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | GET, DELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}/profiles/{profile-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
"profile-name": "test",
"description": "<description>"
},
"app-name": "<name>"
}
Multipart response containing the tar.gz of the profile
DELETE
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/composite-profiles/{composite-profile-name}/profiles/{profile-name}
RETURN STATUS: 204 |
Generic Placement Intent API
Generic Placement Intent API is used to create generic placement intents for sub-applications in an application. Intent created using this API will be added to an Intent Group for use during instantiation.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intent/{intent-name}/generic-placement-intents
POSTapp-intents?app-name=<app-name>
RETURN STATUS: 200
RETURN BODY:
{
"metadataintent": {
"generic-placement-intent-nameallOf":[
"test",
"description": "<description>" {
},
"logicalprovider-cloudname":"aws"
"logicalcluster-cloud-name" //name of logical cloud to use for instantiation. The DCM API will provide the list of clusters that are part of the logical-cloud
}
RETURN STATUS: 201
RETURN BODY:
:"edge1"
},
{
"metadata": {
"generic-placement-intentprovider-name":"aws"
"cluster-name": "test",
edge2"
},
"description": "<description>"
{
},
"logical-cloudanyOf": "logical-cloud-name" //name of logical cloud to use for instantiation. The DCM API will provide the list of clusters that are part of the logical-cloud
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intents/{intent-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": {
[
{
"provider-name":"aws"
"cluster-label-name":"east-us1"
},
{
"generic-placement-intentprovider-name":"aws"
"cluster-label-name": "test",
east-us2"
"description": "<description>"
},
"logical-cloud": "logical-cloud-name" //name of logical cloud to use for instantiation.]
The DCM API will provide the list of clusters}
that are part of the logical-cloud
]
}
}
DELETE
URL: /v2/project/{project-name}/rbcomposite-apps/{rbcomposite-app-name}/{rb-version}/generic-placement-intent/{intent-name}/apps-intents/{intent-name}
RETURN STATUS: 204
|
...
Deployment Intent Group API
Deployment Intent Group API is used to create Intent Groups that can then will be used at instantiation time. Some intents that can be part of an Intent Group are Generic Placement Intent, HPA Intent, and traffic controller Intent.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projectprojects/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placementdeployment-intent/{intent-name}/app-intents-groups
POST BODY:
{
"metadata": {
"intent-name": "test<name>",
"description": "<description>",
}"userData1":"<user data>",
"app-name "userData2":"name"<user data>"
},
"intentspec":
{
{
"profile":"<profile-name>",
"version":"<version of the deployment>",
"allOfoverride-values":[
{
"clusterapp-name":"edge1<name>",
}, "values":[
{
"cluster-nameimageRepository":"edge2registry.hub.docker.com"
},
}
{
]
"anyOf":[
},
{
"cluster-label-"app-name":"east-us1<name>",
},
"values":[
{
"cluster-label-nameimageRepository":"east-us2registry.hub.docker.com"
}
]
}
]
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
"intent-name": "test<name>",
"description": "<description>",
} "userData1":"<user data>",
"app-nameuserData2":"<user "name"data>"
},
"intentspec":
{
"profile":"<profile-name>",
"allOfversion":["<version of the deployment>",
"override-values":[
{
"clusterapp-name":"edge1<name>",
},
"values":[
{
"cluster-name "imageRepository":"edge2registry.hub.docker.com"
},
}
{
]
"anyOf":[},
{
"cluster-labelapp-name":"east-us1<name>",
},
"values":[
{
"cluster-label-name"imageRepository":"east-us2registry.hub.docker.com"
}
]
}
]
]
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projectprojects/{project-name}/composite-apps/{composite-app-name}/{version}/genericdeployment-placementintent-intentgroups/{deployment-intent-group-name}/app-intents
RETURN STATUS: 200
RETURN BODY:
{
"applicationsmetadata":[
{
"name":"app1<name>",
"anyOf":[
{
"cluster-name":"edge1"
},
{
"description":"<description>",
"cluster-nameuserData1":"edge2<user data>",
"userData2":"<user data>"
},
"spec":{
]"profile":"<profile-name>",
},
{ "version":"<version of the deployment>",
"namestatus": "app2approved",
// approved or not-approved
"allOfoverride-values":[
{
"clusterapp-name":"edge1<name>",
},"values":
{
{
"cluster-nameimageRepository":"edge2"
registry.hub.docker.com",
"another_key":"another_value"
}
}
]
},
{
"name":"app3"},
"allOf":[{
{
"app-name":"<name>",
"cluster-namevalues":"edge1"
},
{
{
"imageRepository":"registry.hub.docker.com",
"cluster-name"another_key":"edge2another_value"
},
}
{
"anyOf":[}
]
}
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}
RETURN STATUS: {
"cluster-label-name":"east-us1"
},
{
204
|
Adding intents to an Intent group
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents
POST BODY:
{
"metadata":{
"name":"<name>",
"cluster-label-name"description":"east-us2<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
]"intent":{
}
]
"generic-placement-intent":"xyz-generic-placement-intent"
}
]
}
GET
URL: /v2/project/{project-name}/composite-apps/{composite-app-name}/{version}/generic-placement-intent/{intent-name}/app-intents/{intent-name}
RETURN STATUS: 200201
RETURN BODY:
{
"metadata":{ {
"intent-name": "test<name>",
"description":"<description>",
"<description>"
"userData1":"<user data>",
"userData2":"<user data>"
},
"app-name "spec":{ "name",
"intent":
{
"allOfgeneric-placement-intent":["xyz-generic-placement-intent"
}
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents/{intent-name}
{
"metadata":{
{
"cluster-name":"edge1<name>",
}"description":"<description>",
{
"userData1":"<user data>",
"cluster-nameuserData2":"edge2<user data>"
},
"spec":{
"intent":{ {
"anyOf":["generic-placement-intent":"xyz-generic-placement-intent"
}
}
}
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents
RETURN STATUS: 200
RETURN BODY:
{
"intent":[
{
"clustergeneric-labelplacement-nameintent":"east-us1"
generic-placement-intent-name"
},
{
"hpa":"hpa-placement-intent-name"
{
},
{
"cluster-label-nametraffic":"easttraffic-intent-us2name"
}
]
}
GET }
](Query)
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents?intent=<intent>
{
}
]
}"generic-placement-intent":"xyz-generic-placement-intent"
}
DELETE
URL: /v2/projectprojects/{project-name}/composite-apps/{composite-app-name}/{version}/genericdeployment-placementintent-intentgroups/{deployment-intent-group-name}/apps-intents/{intent-name}
RETURN STATUS: 204
|
Deployment Intent Group API
...
Instantiation, Destroy, Status API
Instantiation API to instantiate composite app based on intent-group. Destroy API deletes the app and Status API returns the resources
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups
POST BODY:
{
"metadata": {
"/{deployment-intent-group-name": "test",
"description": "<description>"
},
"profile": "<profile-name>",
"version": "<version of the deployment>"
//override-values overrides values from the helm charts and allows for instantiation time
//variable overrides.
"override-values": [
{"app-name":[{"imageRepository":"registry.hub.docker.com"}]},
{"app-name":[{"imageRepository":"registry.hub.docker.com"}]}
]
}
}/approve
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
}
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/instantiate
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
}
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/destroy
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
"}
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name": "test",
"description": "<description>"
},
"profile": "<profile-name>}/status
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
"name": "<name>",
"versioncomposite-app-name": "<version of the deployment>"test-app",
//override-values overrides values from the helm charts and allows for instantiation time
//variable overrides.
"override-values": [
{"app-name":[{"imageRepository":"registry.hub.docker.com"}]},
{"app-name":[{"imageRepository":"registry.hub.docker.com"}]}
]
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata": "composite-app-version": "v1",
"profile-name": "test-app-profile",
"intent-group": "intent-group-1"
"namespace": "testinstallns",
"resources":
[
{
"app-name": "collectd",
"clusters": [
{
"name": "cluster1",
"resources": [
{
"deployment-intent-group-name": "test",
"GVK": {
"descriptionGroup": "<description>",
},
"profileVersion": "<profile-name>v1",
"version": "<version of the deployment>"
//override-values overrides values from the helm charts and allows for instantiation time
"Kind": "Service"
//variable overrides. },
"override-values": [
{"app-name":[{"imageRepository":"registry.hub.docker.com"}]},
{"app-nameName":[{ "imageRepository":"registry.hub.docker.com"}]}
mongo",
]
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}
RETURN STATUS: 204
|
Adding intents to an Intent group
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents
POST BODY:
{
"metadata": {
"status": "Running"
},
{
"GVK": {
"Group": "",
"intent-name "Version": "testv1",
"descriptionKind": "<description>Service"
},
"intent":
{},
"genericName": "xyz-generic-placement-intent"mongo-read",
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadatastatus": {"Terminated"
"intent-name": "test", }
"description": "<description>"
]
},
"intent":]
}
]
Status Queries:
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/status?output=<output-type>&app=<app-name>&cluster=<cluster-name>&resource=<resource-name>
output-type can {
be small or full.
Query can be a "generic":"xyz-generic-placement-intent"
}
} |
...
combination of the app, cluster and resources.
|
Cluster Registration API
API to support Reachability for a Kubernetes Cloud. This API will be used to upload configuration information for the cluster
POST
Code Block |
---|
language | js |
---|
title | Get, DeletePOST |
---|
linenumbers | true |
---|
|
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents/{intent-name}
{
/cluster-providers
POST BODY:
{
"metadata": {
"intent-name": "test<name>",
"description": "<description>",
},
"intentuserData1":
{
"<user data>",
"genericuserData2":"xyz-generic-placement-intent<user data>"
}
}
GET
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents}
}
RETURN STATUS: 200201
RETURN BODY:
{
"metadata":{
"intentname":["<name>",
{"description":"<description>",
"userData1":"<user data>",
"generic-placement-intentuserData2":"generic-placement-intent-name<user data>"
},
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"hpa-placement-intentname":"hpa-placement-intent-name"<name>",
}"description":"<description>",
{
"userData1":"<user data>",
"traffic-intentuserData2":"traffic-intent-name<user data>"
}
]
}
DELETE
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/intents/{intent }
}
DELETE
URL: /v2/cluster-providers/{provider-name}
RETURN STATUS: 204
|
Instantiation, Destroy, Status API
Instantiation API to instantiate composite app based on intent-group. Destroy API deletes the app and Status API returns the resources
POST
This POST is a multipart POST. With the POST body containing the data about the cluster and the kubeconfig uploaded in multipart form.
...
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/initantiate /v2/cluster-providers/{provider-name}/clusters
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
}
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/status
POST BODY:
{
}
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
}
}
RETURN STATUS: 201
RETURN BODY:
{
"namemetadata": "<name>",
{
"composite-app-name": "test-rbdef<name>",
"composite-app-version": "v1",
"profile-namedescription": "test-rbdef<description>",
"intent-group": "intent-group-1"
"namespaceuserData1":"<user "testinstallnsdata>",
"resourcesuserData2":"<user [data>"
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}
RETURN STATUS: 200
RETURN BODY:
{
"GVKmetadata": {
"name":"<name>",
"Groupdescription": "<description>",
"VersionuserData1":"<user "v1data>",
"KinduserData2":"<user "Servicedata>"
}
}
DELETE
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}
RETURN STATUS: 204
|
Add Label to a cluster
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels
POST BODY:
{
“label-name” : “<label>”
}
RETURN STATUS: 201
RETURN BODY:
{
“label-name” : “<label>”
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels/<label>
RETURN STATUS: 200
RETURN BODY:
{
“label-name” : “<label>”
}
GET (Query)
URL: /v2/cluster-providers/{provider-name}/clusters?label=<label>
RETURN STATUS: 200
RETURN BODY:
[<list of clusters>]
DELETE
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels/<label>
RETURN STATUS: 204
|
Add key-value pair to a cluster
Add property to a cluster without the need for change to the API.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/kv-pairs },
"cluster-name": "cluster1",
"Name": "mongo",
"status": "Running"
},
{
"GVK": {
"Group": "",
"Version": "v1",
"Kind": "Service"
},
"cluster-name": "cluster2",
"Name": "mongo-read",
"status": "Terminated"
}
]
}
URL: /v2/projects/{project-name}/composite-apps/{composite-app-name}/{version}/deployment-intent-groups/{deployment-intent-group-name}/destroy
POST BODY:
{
}
RETURN STATUS: 201
RETURN BODY:
{
} |
Cluster Registration API
API to support Reachability for a Kubernetes Cloud. This API will be used to upload configuration information for the cluster
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/cluster-providers
POST BODY:
{
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"metadatakv":[
{
“provider-name” : “<name>”, // Must be unique {
"descriptionkey1": <description>"val1"
},
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
“provider-name” : “<name>”, // Must be unique "key2":"val2"
"description": <description>
}
]
}
} |
...
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}
RETURN STATUS: 200201
RETURN BODY:
{
"metadata": {
“provider-name” : “<name>”, "name":"<name>",
"description": "<description>",
}
}
DELETE
URL: /v2/cluster-providers/{provider-name}
RETURN STATUS: 204
|
POST
This POST is a multipart POST. With the POST body containing the data about the cluster and the kubeconfig uploaded in multipart form.
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/cluster-providers/{provider-name}/clusters
POST BODY:
{
"metadata": {
“cluster-name” : “<name>”, // Must be unique
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"kv":[
{
"descriptionkey1": <description>
"val1"
}
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
“cluster-name” : “<name>”,
"description": <description>
,
{
"key2":"val2"
}
]
}
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/kv-pairs/<name>
RETURN STATUS: 200
RETURN BODY:
{
“cluster-name” : “<name>”, // Must be unique across
"metadata":{
"name":"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"descriptionkv": <description>
}
DELETE
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}
RETURN STATUS: 204
|
Add Label to a cluster
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels
POST BODY:
{
“label-name” : “<label>”
}
RETURN STATUS: 201
RETURN BODY:
{
“label-name” : “<label>”
} |
GET, DELETE
Code Block |
---|
language | js |
---|
title | Get, Delete |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels/<label>
RETURN STATUS: 200
RETURN BODY:
{
“label-name” : “<label>”
}
DELETE[
{
"key1":"val1"
},
{
"key2":"val2"
}
]
}
}
GET (Query)
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/labels/<label>kv-pairs/<name>?key=<key>
RETURN STATUS: 204
|
Add key-value pair to a cluster
Add property to a cluster without the need for change to the API.
POST
Code Block |
---|
language | js |
---|
title | POST |
---|
linenumbers | true |
---|
|
200
RETURN BODY:
{
"value": "<value>"
}
DELETE
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/kv-pairs/<name>
RETURN STATUS: 204
|
Orchestrator Controller Registration API
This API allows controllers to register themselves as gRPC servers consumed by the orchestrator.
POST
Code Block |
---|
language | bash |
---|
title | POST |
---|
linenumbers | true |
---|
|
POST/PUT
URL: /v2/controllers
POST BODY:
{POST BODY:
{
"metadata": {
“name” : “<name>”, // Must be unique
"description": <description>
},
"kvmetadata":[
{
"key1name":"val1"
}<name>",
{
"key2"description":"val2<description>",
}
]
}
RETURN STATUS: 201
RETURN BODY:
{
"metadata": {
“name” : “<name>”, // Must be unique "userData1":"<user data>",
"descriptionuserData2":"<user <description>data>"
},
"kvspec":[{
{"host": "10.7.100.4",
"port": 9029,
"key1type": "val1"
<type of controller>, // }placement,
action are 2 types {supported
"key2priority":"val2"
2
}
]
} |
GET, DELETE
Code Block |
---|
language | jsbash |
---|
title | GetGET, DeleteDELETE |
---|
linenumbers | true |
---|
|
GET
URL: /v2/cluster-providers/{provider-name}/clusterscontrollers/{clustercontroller-name}/kv-pairs/<name>
RETURN STATUS: 200
RETURN BODY:
{
"metadata":{
"metadataname": {
“name” : “<name>”, // Must be unique
"description": <description>
},
"kv":[
{"<name>",
"description":"<description>",
"userData1":"<user data>",
"userData2":"<user data>"
},
"spec":{
"host": "10.7.100.4",
"port": 9029,
"type": "<type of controller>,
"key1priority":"val1"
2
},
{
"key2":"val2"
}
]
}
DELETE
URL: /v2/cluster-providers/{provider-name}/clusters/{cluster-name}/kv-pairs/<name>
RETURN STATUS: 204
}
}
DELETE
URL: /v2/controllers/{controller-name}
RETURN STATUS: 204 |
Example CURL Command:
Code Block |
---|
language | bash |
---|
title | POST |
---|
linenumbers | true |
---|
|
curl -X GET "http://10.7.100.1:9015/v2/controllers/hpa-placement-controller" -H "accept: */*" -H "Content-Type: application/json"
curl -X DELETE "http://10.7.100.1:9015/v2/controllers/hpa-placement-controller" -H "accept: */*" |