Bring your own deploy
learn how to integrate deploy tools to as a user, you can leverage deploy service, our centralized service that displays all deployment results from various deployment tools within your devops pipeline our platform shows data from tools like argo cd and various cloud endpoints, as displayed in the following figure when data is populated with deploy service, you can easily bring in deployments from multiple tools and also post deployments from different tools to deploy by utilizing the apis that we provide this way, you can efficiently monitor and manage your deployments across your entire devops ecosystem bringing data into to bring your own deploy tools complete the following steps go to the tools configuration page and navigate to the tokens tab click on create token and give a unique token name select token type as deployments , then click on the create button a new entry will be added to the table in the table entry click on the vertical ellipsis icon on the respective row and select the view/regenerate token option copy that token by clicking copy icon in the token field note to post data to the apis mentioned below, add the service token ( create service token) to the authorization header of the request see the curl example for reference format step 1 token {the service token from step1} example token b8fkfcc3prvreztelhp0rpros2p6yzk swvlpp 36d7pd5hhlhx7uxqlh bvpqgo step 2 api reference api /services/deployments url https //{devops intelligence host}/dash/api/deployments/v4/technical services/deployments parameters parameter type explanation example value deployment body deployment data in json { { "id" "6325a4ce1bb54ed5487e5911", "connections" \[], "deploymentid" "256t767t7", "template name" "sampletechnicalservice", "provider" "gocd", "providercode" "gocd", "tool" "byod", "environment" "string", "release" "release 2022 09 30", "status" "deployed", "name" "di dashboard", "creation date" "2022 09 12t07 20 50 52z", "duration" 10057200, "endpoint technical service id" "di dashboard", "endpoint hostname" "https //travis com", "href" "https //appsvt2 di release multicloud ibm com/dash/api/deployments/v4/deployments/6325a4ce1bb54ed5487e5911", "servicehref" { "deployments" "https //appsvt2 di release multicloud ibm com/dash/api/deployments/v4/deployments/6325a4ce1bb54ed5487e5911/templates" }, "providerhref" "https //travis com/1234", "technical service" "sampletechnicalservice", "technical service id" "6325a67a2cf73f8af6382211", "unique technical service id" "6325a4ce7f9d5f0c984d2d5c", "application relationships" \[ { "application name" "domino1", "application id" "6325b3c277a1e154206b6985", "relationship types" \[ "uses" ] } ], "kcmp app href" "", "kcmp app name" "ccm", "technical service tag" { "service unique id" "gocd\ https //travis com\ di dashboard\ sampletechnicalservice", "additionalprop1" "string", "additionalprop2" "string", "additionalprop3" "string" }, "ismetered" true, "isproduction" true }, } curl example request curl x post \\ https //peer core gravitant net/dash/api/deployments/v4/technical services/dash aws/deployments \\ h 'authorization token zkkh kmdi2ib3 6i9efzdm72zg32utg4oqqkn63iduea5qomc9rcaxu1vy5svfeg' \\ h 'content type application/json' \\ h 'cache control no cache' \\ d '{ "creation date" "2020 07 26t05 06 10 949z", "deploymentid" "endpointid 1", "duration" 2345171, "name" "aws", "provider" "aws", "details" { "creationtime" "2020 07 27t13 30 39 181z" }, "technical service name" "mcmp devops intelligence/servicename", "technicalserviceoverride" true }' response 200 { "id" "5f22c301ac17b7ba55644fba","entityid" "endpointid 1" } build request body explained field data type explanation example value deploymentid string object id 5d69de78674bf10001ed4ce1 name string name of deployment 225 mcmp aws lamp job provider string provider name aws status string the deployment status deployed, deployed, deployed, failed, failed, failed duration int64 time required to run deployment in microseconds 1005720 creationdate string date and time of deployment 2019 10 12t07 20 50 52z providerhref string endpoint url https //ec2 164 8 1 us west 2 compute amazonaws com/api/v4/job templates/16/jobs/?id=225 details map\[string]interface{} additional details of a template(raw json file contents) raw json technical service name string technical servicename is an abstraction for deployments group mcmp devops intelligence/devproject1 serviceoverride boolean override flag for the service true isproduction boolean if deployment is production true