porter_app.go 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726
  1. package client
  2. import (
  3. "context"
  4. "fmt"
  5. "github.com/porter-dev/porter/api/server/handlers/porter_app"
  6. "github.com/porter-dev/porter/internal/models"
  7. appInternal "github.com/porter-dev/porter/internal/porter_app"
  8. "github.com/porter-dev/porter/api/types"
  9. )
  10. func (c *Client) NewGetPorterApp(
  11. ctx context.Context,
  12. projectID, clusterID uint,
  13. appName string,
  14. ) (*types.PorterApp, error) {
  15. resp := &types.PorterApp{}
  16. err := c.getRequest(
  17. fmt.Sprintf(
  18. "/projects/%d/clusters/%d/applications/%s",
  19. projectID, clusterID, appName,
  20. ),
  21. nil,
  22. resp,
  23. )
  24. return resp, err
  25. }
  26. func (c *Client) NewCreatePorterApp(
  27. ctx context.Context,
  28. projectID, clusterID uint,
  29. appName string,
  30. req *types.CreatePorterAppRequest,
  31. ) (*types.PorterApp, error) {
  32. resp := &types.PorterApp{}
  33. err := c.postRequest(
  34. fmt.Sprintf(
  35. "/projects/%d/clusters/%d/applications/%s",
  36. projectID, clusterID, appName,
  37. ),
  38. req,
  39. resp,
  40. )
  41. return resp, err
  42. }
  43. // NewCreateOrUpdatePorterAppEvent will create a porter app event if one does not exist, or else it will update the existing one if an ID is passed in the object
  44. func (c *Client) NewCreateOrUpdatePorterAppEvent(
  45. ctx context.Context,
  46. projectID, clusterID uint,
  47. appName string,
  48. req *types.CreateOrUpdatePorterAppEventRequest,
  49. ) (types.PorterAppEvent, error) {
  50. resp := &types.PorterAppEvent{}
  51. err := c.postRequest(
  52. fmt.Sprintf(
  53. "/projects/%d/clusters/%d/applications/%s/events",
  54. projectID, clusterID, appName,
  55. ),
  56. req,
  57. resp,
  58. )
  59. return *resp, err
  60. }
  61. // TODO: remove these functions once they are no longer called (check telemetry)
  62. func (c *Client) GetPorterApp(
  63. ctx context.Context,
  64. projectID, clusterID uint,
  65. stackName string,
  66. ) (*types.PorterApp, error) {
  67. resp := &types.PorterApp{}
  68. err := c.getRequest(
  69. fmt.Sprintf(
  70. "/projects/%d/clusters/%d/stacks/%s",
  71. projectID, clusterID, stackName,
  72. ),
  73. nil,
  74. resp,
  75. )
  76. return resp, err
  77. }
  78. func (c *Client) CreatePorterApp(
  79. ctx context.Context,
  80. projectID, clusterID uint,
  81. name string,
  82. req *types.CreatePorterAppRequest,
  83. ) (*types.PorterApp, error) {
  84. resp := &types.PorterApp{}
  85. err := c.postRequest(
  86. fmt.Sprintf(
  87. "/projects/%d/clusters/%d/stacks/%s",
  88. projectID, clusterID, name,
  89. ),
  90. req,
  91. resp,
  92. )
  93. return resp, err
  94. }
  95. // CreateOrUpdatePorterAppEvent will create a porter app event if one does not exist, or else it will update the existing one if an ID is passed in the object
  96. func (c *Client) CreateOrUpdatePorterAppEvent(
  97. ctx context.Context,
  98. projectID, clusterID uint,
  99. name string,
  100. req *types.CreateOrUpdatePorterAppEventRequest,
  101. ) (types.PorterAppEvent, error) {
  102. resp := &types.PorterAppEvent{}
  103. err := c.postRequest(
  104. fmt.Sprintf(
  105. "/projects/%d/clusters/%d/stacks/%s/events",
  106. projectID, clusterID, name,
  107. ),
  108. req,
  109. resp,
  110. )
  111. return *resp, err
  112. }
  113. // ListEnvGroups (List all Env Groups for a given cluster)
  114. func (c *Client) ListEnvGroups(
  115. ctx context.Context,
  116. projectID, clusterID uint,
  117. ) (types.ListEnvironmentGroupsResponse, error) {
  118. resp := &types.ListEnvironmentGroupsResponse{}
  119. err := c.getRequest(
  120. fmt.Sprintf(
  121. "/projects/%d/clusters/%d/environment-groups",
  122. projectID, clusterID,
  123. ),
  124. nil,
  125. resp,
  126. )
  127. return *resp, err
  128. }
  129. // ParseYAML takes in a base64 encoded porter yaml and returns an app proto
  130. func (c *Client) ParseYAML(
  131. ctx context.Context,
  132. projectID, clusterID uint,
  133. b64Yaml string,
  134. appName string,
  135. ) (*porter_app.ParsePorterYAMLToProtoResponse, error) {
  136. resp := &porter_app.ParsePorterYAMLToProtoResponse{}
  137. req := &porter_app.ParsePorterYAMLToProtoRequest{
  138. B64Yaml: b64Yaml,
  139. AppName: appName,
  140. }
  141. err := c.postRequest(
  142. fmt.Sprintf(
  143. "/projects/%d/clusters/%d/apps/parse",
  144. projectID, clusterID,
  145. ),
  146. req,
  147. resp,
  148. )
  149. return resp, err
  150. }
  151. // ValidatePorterAppInput is the input struct to ValidatePorterApp
  152. type ValidatePorterAppInput struct {
  153. ProjectID uint
  154. ClusterID uint
  155. AppName string
  156. Base64AppProto string
  157. Base64AppOverrides string
  158. DeploymentTarget string
  159. CommitSHA string
  160. }
  161. // ValidatePorterApp takes in a base64 encoded app definition that is potentially partial and returns a complete definition
  162. // using any previous app revisions and defaults
  163. func (c *Client) ValidatePorterApp(
  164. ctx context.Context,
  165. inp ValidatePorterAppInput,
  166. ) (*porter_app.ValidatePorterAppResponse, error) {
  167. resp := &porter_app.ValidatePorterAppResponse{}
  168. req := &porter_app.ValidatePorterAppRequest{
  169. AppName: inp.AppName,
  170. Base64AppProto: inp.Base64AppProto,
  171. Base64AppOverrides: inp.Base64AppOverrides,
  172. DeploymentTargetId: inp.DeploymentTarget,
  173. CommitSHA: inp.CommitSHA,
  174. }
  175. err := c.postRequest(
  176. fmt.Sprintf(
  177. "/projects/%d/clusters/%d/apps/validate",
  178. inp.ProjectID, inp.ClusterID,
  179. ),
  180. req,
  181. resp,
  182. )
  183. return resp, err
  184. }
  185. // ApplyPorterAppInput is the input struct to ApplyPorterApp
  186. type ApplyPorterAppInput struct {
  187. ProjectID uint
  188. ClusterID uint
  189. Base64AppProto string
  190. DeploymentTarget string
  191. AppRevisionID string
  192. ForceBuild bool
  193. Variables map[string]string
  194. Secrets map[string]string
  195. HardEnvUpdate bool
  196. }
  197. // ApplyPorterApp takes in a base64 encoded app definition and applies it to the cluster
  198. func (c *Client) ApplyPorterApp(
  199. ctx context.Context,
  200. inp ApplyPorterAppInput,
  201. ) (*porter_app.ApplyPorterAppResponse, error) {
  202. resp := &porter_app.ApplyPorterAppResponse{}
  203. req := &porter_app.ApplyPorterAppRequest{
  204. Base64AppProto: inp.Base64AppProto,
  205. DeploymentTargetId: inp.DeploymentTarget,
  206. AppRevisionID: inp.AppRevisionID,
  207. ForceBuild: inp.ForceBuild,
  208. Variables: inp.Variables,
  209. Secrets: inp.Secrets,
  210. HardEnvUpdate: inp.HardEnvUpdate,
  211. }
  212. err := c.postRequest(
  213. fmt.Sprintf(
  214. "/projects/%d/clusters/%d/apps/apply",
  215. inp.ProjectID, inp.ClusterID,
  216. ),
  217. req,
  218. resp,
  219. )
  220. return resp, err
  221. }
  222. // UpdateAppInput is the input struct to UpdateApp
  223. type UpdateAppInput struct {
  224. ProjectID uint
  225. ClusterID uint
  226. Name string
  227. GitSource porter_app.GitSource
  228. DeploymentTargetId string
  229. CommitSHA string
  230. AppRevisionID string
  231. Base64AppProto string
  232. Base64PorterYAML string
  233. IsEnvOverride bool
  234. }
  235. // UpdateApp updates a porter app
  236. func (c *Client) UpdateApp(
  237. ctx context.Context,
  238. inp UpdateAppInput,
  239. ) (*porter_app.UpdateAppResponse, error) {
  240. resp := &porter_app.UpdateAppResponse{}
  241. req := &porter_app.UpdateAppRequest{
  242. Name: inp.Name,
  243. GitSource: inp.GitSource,
  244. DeploymentTargetId: inp.DeploymentTargetId,
  245. CommitSHA: inp.CommitSHA,
  246. AppRevisionID: inp.AppRevisionID,
  247. Base64AppProto: inp.Base64AppProto,
  248. Base64PorterYAML: inp.Base64PorterYAML,
  249. IsEnvOverride: inp.IsEnvOverride,
  250. }
  251. err := c.postRequest(
  252. fmt.Sprintf(
  253. "/projects/%d/clusters/%d/apps/update",
  254. inp.ProjectID, inp.ClusterID,
  255. ),
  256. req,
  257. resp,
  258. )
  259. return resp, err
  260. }
  261. // DefaultDeploymentTarget returns the default deployment target for a given project and cluster
  262. func (c *Client) DefaultDeploymentTarget(
  263. ctx context.Context,
  264. projectID, clusterID uint,
  265. ) (*porter_app.DefaultDeploymentTargetResponse, error) {
  266. resp := &porter_app.DefaultDeploymentTargetResponse{}
  267. req := &porter_app.DefaultDeploymentTargetRequest{}
  268. err := c.getRequest(
  269. fmt.Sprintf(
  270. "/projects/%d/clusters/%d/default-deployment-target",
  271. projectID, clusterID,
  272. ),
  273. req,
  274. resp,
  275. )
  276. return resp, err
  277. }
  278. // CurrentAppRevision returns the currently deployed app revision for a given project, app name and deployment target
  279. func (c *Client) CurrentAppRevision(
  280. ctx context.Context,
  281. projectID uint, clusterID uint,
  282. appName string, deploymentTarget string,
  283. ) (*porter_app.LatestAppRevisionResponse, error) {
  284. resp := &porter_app.LatestAppRevisionResponse{}
  285. req := &porter_app.LatestAppRevisionRequest{
  286. DeploymentTargetID: deploymentTarget,
  287. }
  288. err := c.getRequest(
  289. fmt.Sprintf(
  290. "/projects/%d/clusters/%d/apps/%s/latest",
  291. projectID, clusterID, appName,
  292. ),
  293. req,
  294. resp,
  295. )
  296. return resp, err
  297. }
  298. // CreatePorterAppDBEntryInput is the input struct to CreatePorterAppDBEntry
  299. type CreatePorterAppDBEntryInput struct {
  300. AppName string
  301. GitRepoName string
  302. GitRepoID uint
  303. GitBranch string
  304. ImageRepository string
  305. PorterYamlPath string
  306. ImageTag string
  307. Local bool
  308. DeploymentTargetID string
  309. }
  310. // CreatePorterAppDBEntry creates an entry in the porter app
  311. func (c *Client) CreatePorterAppDBEntry(
  312. ctx context.Context,
  313. projectID uint, clusterID uint,
  314. inp CreatePorterAppDBEntryInput,
  315. ) error {
  316. var sourceType appInternal.SourceType
  317. var image *appInternal.Image
  318. if inp.Local {
  319. sourceType = appInternal.SourceType_Local
  320. }
  321. if inp.GitRepoName != "" {
  322. sourceType = appInternal.SourceType_Github
  323. }
  324. if inp.ImageRepository != "" {
  325. sourceType = appInternal.SourceType_DockerRegistry
  326. image = &appInternal.Image{
  327. Repository: inp.ImageRepository,
  328. Tag: inp.ImageTag,
  329. }
  330. }
  331. req := &porter_app.CreateAppRequest{
  332. Name: inp.AppName,
  333. SourceType: sourceType,
  334. GitSource: porter_app.GitSource{
  335. GitBranch: inp.GitBranch,
  336. GitRepoName: inp.GitRepoName,
  337. GitRepoID: inp.GitRepoID,
  338. },
  339. Image: image,
  340. PorterYamlPath: inp.PorterYamlPath,
  341. DeploymentTargetID: inp.DeploymentTargetID,
  342. }
  343. err := c.postRequest(
  344. fmt.Sprintf(
  345. "/projects/%d/clusters/%d/apps/create",
  346. projectID, clusterID,
  347. ),
  348. req,
  349. &types.PorterApp{},
  350. )
  351. return err
  352. }
  353. // CreateSubdomain returns a subdomain for a given service that point to the ingress-nginx service in the cluster
  354. func (c *Client) CreateSubdomain(
  355. ctx context.Context,
  356. projectID uint, clusterID uint,
  357. appName string, serviceName string,
  358. ) (*porter_app.CreateSubdomainResponse, error) {
  359. resp := &porter_app.CreateSubdomainResponse{}
  360. req := &porter_app.CreateSubdomainRequest{
  361. ServiceName: serviceName,
  362. }
  363. err := c.postRequest(
  364. fmt.Sprintf(
  365. "/projects/%d/clusters/%d/apps/%s/subdomain",
  366. projectID, clusterID, appName,
  367. ),
  368. req,
  369. resp,
  370. )
  371. return resp, err
  372. }
  373. // PredeployStatus checks the current status of a predeploy job for an app revision
  374. func (c *Client) PredeployStatus(
  375. ctx context.Context,
  376. projectID uint, clusterID uint,
  377. appName string, appRevisionId string,
  378. ) (*porter_app.PredeployStatusResponse, error) {
  379. resp := &porter_app.PredeployStatusResponse{}
  380. err := c.getRequest(
  381. fmt.Sprintf(
  382. "/projects/%d/clusters/%d/apps/%s/%s/predeploy-status",
  383. projectID, clusterID, appName, appRevisionId,
  384. ),
  385. nil,
  386. resp,
  387. )
  388. if resp.Status == "" {
  389. return nil, fmt.Errorf("no predeploy status found")
  390. }
  391. return resp, err
  392. }
  393. // GetRevision returns an app revision
  394. func (c *Client) GetRevision(
  395. ctx context.Context,
  396. projectID uint, clusterID uint,
  397. appName string, appRevisionId string,
  398. ) (*porter_app.GetAppRevisionResponse, error) {
  399. resp := &porter_app.GetAppRevisionResponse{}
  400. err := c.getRequest(
  401. fmt.Sprintf(
  402. "/projects/%d/clusters/%d/apps/%s/revisions/%s",
  403. projectID, clusterID, appName, appRevisionId,
  404. ),
  405. nil,
  406. resp,
  407. )
  408. return resp, err
  409. }
  410. // UpdateRevisionStatus updates the status of an app revision
  411. func (c *Client) UpdateRevisionStatus(
  412. ctx context.Context,
  413. projectID uint, clusterID uint,
  414. appName string, appRevisionId string,
  415. status models.AppRevisionStatus,
  416. ) (*porter_app.UpdateAppRevisionStatusResponse, error) {
  417. resp := &porter_app.UpdateAppRevisionStatusResponse{}
  418. req := &porter_app.UpdateAppRevisionStatusRequest{
  419. Status: status,
  420. }
  421. err := c.postRequest(
  422. fmt.Sprintf(
  423. "/projects/%d/clusters/%d/apps/%s/revisions/%s",
  424. projectID, clusterID, appName, appRevisionId,
  425. ),
  426. req,
  427. resp,
  428. )
  429. return resp, err
  430. }
  431. // GetBuildEnv returns the build environment for a given app proto
  432. func (c *Client) GetBuildEnv(
  433. ctx context.Context,
  434. projectID uint, clusterID uint,
  435. appName string, appRevisionId string,
  436. ) (*porter_app.GetBuildEnvResponse, error) {
  437. resp := &porter_app.GetBuildEnvResponse{}
  438. err := c.getRequest(
  439. fmt.Sprintf(
  440. "/projects/%d/clusters/%d/apps/%s/revisions/%s/build-env",
  441. projectID, clusterID, appName, appRevisionId,
  442. ),
  443. nil,
  444. resp,
  445. )
  446. return resp, err
  447. }
  448. // GetBuildFromRevision returns the build environment for a given app proto
  449. func (c *Client) GetBuildFromRevision(
  450. ctx context.Context,
  451. projectID uint, clusterID uint,
  452. appName string, appRevisionId string,
  453. ) (*porter_app.GetBuildFromRevisionResponse, error) {
  454. resp := &porter_app.GetBuildFromRevisionResponse{}
  455. err := c.getRequest(
  456. fmt.Sprintf(
  457. "/projects/%d/clusters/%d/apps/%s/revisions/%s/build",
  458. projectID, clusterID, appName, appRevisionId,
  459. ),
  460. nil,
  461. resp,
  462. )
  463. return resp, err
  464. }
  465. // ReportRevisionStatusInput is the input struct to ReportRevisionStatus
  466. type ReportRevisionStatusInput struct {
  467. ProjectID uint
  468. ClusterID uint
  469. AppName string
  470. AppRevisionID string
  471. PRNumber int
  472. CommitSHA string
  473. }
  474. // ReportRevisionStatus reports the status of an app revision to external services
  475. func (c *Client) ReportRevisionStatus(
  476. ctx context.Context,
  477. inp ReportRevisionStatusInput,
  478. ) (*porter_app.ReportRevisionStatusResponse, error) {
  479. resp := &porter_app.ReportRevisionStatusResponse{}
  480. req := &porter_app.ReportRevisionStatusRequest{
  481. PRNumber: inp.PRNumber,
  482. CommitSHA: inp.CommitSHA,
  483. }
  484. err := c.postRequest(
  485. fmt.Sprintf(
  486. "/projects/%d/clusters/%d/apps/%s/revisions/%s/status",
  487. inp.ProjectID, inp.ClusterID, inp.AppName, inp.AppRevisionID,
  488. ),
  489. req,
  490. resp,
  491. )
  492. return resp, err
  493. }
  494. // CreateOrUpdateAppEnvironment updates the app environment group and creates it if it doesn't exist
  495. func (c *Client) CreateOrUpdateAppEnvironment(
  496. ctx context.Context,
  497. projectID uint, clusterID uint,
  498. appName string,
  499. deploymentTargetID string,
  500. variables map[string]string,
  501. secrets map[string]string,
  502. Base64AppProto string,
  503. ) (*porter_app.UpdateAppEnvironmentResponse, error) {
  504. resp := &porter_app.UpdateAppEnvironmentResponse{}
  505. req := &porter_app.UpdateAppEnvironmentRequest{
  506. DeploymentTargetID: deploymentTargetID,
  507. Variables: variables,
  508. Secrets: secrets,
  509. HardUpdate: false,
  510. Base64AppProto: Base64AppProto,
  511. }
  512. err := c.postRequest(
  513. fmt.Sprintf(
  514. "/projects/%d/clusters/%d/apps/%s/update-environment",
  515. projectID, clusterID, appName,
  516. ),
  517. req,
  518. resp,
  519. )
  520. return resp, err
  521. }
  522. // PorterYamlV2Pods gets all pods for a given deployment target id and app name
  523. func (c *Client) PorterYamlV2Pods(
  524. ctx context.Context,
  525. projectID, clusterID uint,
  526. porterAppName string,
  527. req *types.PorterYamlV2PodsRequest,
  528. ) (*types.GetReleaseAllPodsResponse, error) {
  529. resp := &types.GetReleaseAllPodsResponse{}
  530. err := c.getRequest(
  531. fmt.Sprintf(
  532. "/projects/%d/clusters/%d/apps/%s/pods",
  533. projectID, clusterID,
  534. porterAppName,
  535. ),
  536. req,
  537. resp,
  538. )
  539. return resp, err
  540. }
  541. // UpdateImage updates the image for a porter app (porter yaml v2 only)
  542. func (c *Client) UpdateImage(
  543. ctx context.Context,
  544. projectID, clusterID uint,
  545. appName, deploymentTargetId, tag string,
  546. ) (*porter_app.UpdateImageResponse, error) {
  547. req := &porter_app.UpdateImageRequest{
  548. Tag: tag,
  549. DeploymentTargetId: deploymentTargetId,
  550. }
  551. resp := &porter_app.UpdateImageResponse{}
  552. err := c.postRequest(
  553. fmt.Sprintf(
  554. "/projects/%d/clusters/%d/apps/%s/update-image",
  555. projectID, clusterID, appName,
  556. ),
  557. &req,
  558. resp,
  559. )
  560. return resp, err
  561. }
  562. // ListAppRevisions lists the last ten app revisions for a given app
  563. func (c *Client) ListAppRevisions(
  564. ctx context.Context,
  565. projectID, clusterID uint,
  566. appName string,
  567. deploymentTargetID string,
  568. ) (*porter_app.ListAppRevisionsResponse, error) {
  569. resp := &porter_app.ListAppRevisionsResponse{}
  570. req := &porter_app.ListAppRevisionsRequest{
  571. DeploymentTargetID: deploymentTargetID,
  572. }
  573. err := c.getRequest(
  574. fmt.Sprintf(
  575. "/projects/%d/clusters/%d/apps/%s/revisions",
  576. projectID, clusterID,
  577. appName,
  578. ),
  579. req,
  580. resp,
  581. )
  582. return resp, err
  583. }
  584. // RollbackRevision reverts an app to a previous revision
  585. func (c *Client) RollbackRevision(
  586. ctx context.Context,
  587. projectID, clusterID uint,
  588. appName string,
  589. deploymentTargetID string,
  590. ) (*porter_app.RollbackAppRevisionResponse, error) {
  591. resp := &porter_app.RollbackAppRevisionResponse{}
  592. req := &porter_app.RollbackAppRevisionRequest{
  593. DeploymentTargetID: deploymentTargetID,
  594. }
  595. err := c.postRequest(
  596. fmt.Sprintf(
  597. "/projects/%d/clusters/%d/apps/%s/rollback",
  598. projectID, clusterID,
  599. appName,
  600. ),
  601. req,
  602. resp,
  603. )
  604. return resp, err
  605. }
  606. // UseNewApplyLogic checks whether the CLI should use the new apply logic
  607. func (c *Client) UseNewApplyLogic(
  608. ctx context.Context,
  609. projectID, clusterID uint,
  610. ) (*porter_app.UseNewApplyLogicResponse, error) {
  611. resp := &porter_app.UseNewApplyLogicResponse{}
  612. req := &porter_app.UseNewApplyLogicRequest{}
  613. err := c.getRequest(
  614. fmt.Sprintf(
  615. "/projects/%d/clusters/%d/apps/use-new-apply-logic",
  616. projectID, clusterID,
  617. ),
  618. req,
  619. resp,
  620. )
  621. return resp, err
  622. }