create.go 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539
  1. package deploy
  2. import (
  3. "context"
  4. "fmt"
  5. "os"
  6. "path/filepath"
  7. "strings"
  8. api "github.com/porter-dev/porter/api/client"
  9. "github.com/porter-dev/porter/api/types"
  10. "github.com/porter-dev/porter/cli/cmd/docker"
  11. "github.com/porter-dev/porter/internal/templater/utils"
  12. )
  13. // CreateAgent handles the creation of a new application on Porter
  14. type CreateAgent struct {
  15. Client *api.Client
  16. CreateOpts *CreateOpts
  17. }
  18. // CreateOpts are required options for creating a new application on Porter: the
  19. // "kind" (web, worker, job) and the name of the application.
  20. type CreateOpts struct {
  21. *SharedOpts
  22. Kind string
  23. ReleaseName string
  24. RegistryURL string
  25. // Suffix for the name of the image in the repository. By default the suffix is the
  26. // target namespace.
  27. RepoSuffix string
  28. }
  29. // GithubOpts are the options for linking a Github source to the app
  30. type GithubOpts struct {
  31. Branch string
  32. Repo string
  33. }
  34. // CreateFromGithub uses the branch/repo to link the Github source for an application.
  35. // This function attempts to find a matching repository in the list of linked repositories
  36. // on Porter. If one is found, it will use that repository as the app source.
  37. func (c *CreateAgent) CreateFromGithub(
  38. ghOpts *GithubOpts,
  39. overrideValues map[string]interface{},
  40. ) (string, error) {
  41. opts := c.CreateOpts
  42. // get all linked github repos and find matching repo
  43. resp, err := c.Client.ListGitInstallationIDs(
  44. context.Background(),
  45. c.CreateOpts.ProjectID,
  46. )
  47. if err != nil {
  48. return "", err
  49. }
  50. gitInstallations := *resp
  51. var gitRepoMatch int64
  52. for _, gitInstallationID := range gitInstallations {
  53. // for each git repo, search for a matching username/owner
  54. resp, err := c.Client.ListGitRepos(
  55. context.Background(),
  56. c.CreateOpts.ProjectID,
  57. gitInstallationID,
  58. )
  59. if err != nil {
  60. return "", err
  61. }
  62. githubRepos := *resp
  63. for _, githubRepo := range githubRepos {
  64. if githubRepo.FullName == ghOpts.Repo {
  65. gitRepoMatch = gitInstallationID
  66. break
  67. }
  68. }
  69. if gitRepoMatch != 0 {
  70. break
  71. }
  72. }
  73. if gitRepoMatch == 0 {
  74. return "", fmt.Errorf("could not find a linked github repo for %s. Make sure you have linked your Github account on the Porter dashboard.", ghOpts.Repo)
  75. }
  76. latestVersion, mergedValues, err := c.getMergedValues(overrideValues)
  77. if err != nil {
  78. return "", err
  79. }
  80. if opts.Kind == "web" || opts.Kind == "worker" {
  81. mergedValues["image"] = map[string]interface{}{
  82. "repository": "public.ecr.aws/o1j4x7p4/hello-porter",
  83. "tag": "latest",
  84. }
  85. } else if opts.Kind == "job" {
  86. mergedValues["image"] = map[string]interface{}{
  87. "repository": "public.ecr.aws/o1j4x7p4/hello-porter-job",
  88. "tag": "latest",
  89. }
  90. }
  91. regID, imageURL, err := c.GetImageRepoURL(opts.ReleaseName, opts.Namespace)
  92. if err != nil {
  93. return "", err
  94. }
  95. subdomain, err := c.CreateSubdomainIfRequired(mergedValues)
  96. if err != nil {
  97. return "", err
  98. }
  99. err = c.Client.DeployTemplate(
  100. context.Background(),
  101. opts.ProjectID,
  102. opts.ClusterID,
  103. opts.Namespace,
  104. &types.CreateReleaseRequest{
  105. CreateReleaseBaseRequest: &types.CreateReleaseBaseRequest{
  106. TemplateName: opts.Kind,
  107. TemplateVersion: latestVersion,
  108. Values: mergedValues,
  109. Name: opts.ReleaseName,
  110. },
  111. ImageURL: imageURL,
  112. GithubActionConfig: &types.CreateGitActionConfigRequest{
  113. GitRepo: ghOpts.Repo,
  114. GitBranch: ghOpts.Branch,
  115. ImageRepoURI: imageURL,
  116. DockerfilePath: opts.LocalDockerfile,
  117. FolderPath: ".",
  118. GitRepoID: uint(gitRepoMatch),
  119. RegistryID: regID,
  120. ShouldCreateWorkflow: true,
  121. },
  122. },
  123. )
  124. if err != nil {
  125. return "", err
  126. }
  127. return subdomain, nil
  128. }
  129. // CreateFromRegistry deploys a new application from an existing Docker repository + tag.
  130. func (c *CreateAgent) CreateFromRegistry(
  131. image string,
  132. overrideValues map[string]interface{},
  133. ) (string, error) {
  134. if image == "" {
  135. return "", fmt.Errorf("image cannot be empty")
  136. }
  137. // split image into image-path:tag format
  138. imageSpl := strings.Split(image, ":")
  139. if len(imageSpl) != 2 {
  140. return "", fmt.Errorf("invalid image format: must be image-path:tag format")
  141. }
  142. opts := c.CreateOpts
  143. latestVersion, mergedValues, err := c.getMergedValues(overrideValues)
  144. if err != nil {
  145. return "", err
  146. }
  147. mergedValues["image"] = map[string]interface{}{
  148. "repository": imageSpl[0],
  149. "tag": imageSpl[1],
  150. }
  151. subdomain, err := c.CreateSubdomainIfRequired(mergedValues)
  152. if err != nil {
  153. return "", err
  154. }
  155. err = c.Client.DeployTemplate(
  156. context.Background(),
  157. opts.ProjectID,
  158. opts.ClusterID,
  159. opts.Namespace,
  160. &types.CreateReleaseRequest{
  161. CreateReleaseBaseRequest: &types.CreateReleaseBaseRequest{
  162. TemplateName: opts.Kind,
  163. TemplateVersion: latestVersion,
  164. Values: mergedValues,
  165. Name: opts.ReleaseName,
  166. },
  167. ImageURL: imageSpl[0],
  168. },
  169. )
  170. if err != nil {
  171. return "", err
  172. }
  173. return subdomain, nil
  174. }
  175. // CreateFromDocker uses a local build context and a local Docker daemon to build a new
  176. // container image, and then deploys it onto Porter.
  177. func (c *CreateAgent) CreateFromDocker(
  178. overrideValues map[string]interface{},
  179. imageTag string,
  180. extraBuildConfig *types.BuildConfig,
  181. ) (string, error) {
  182. opts := c.CreateOpts
  183. // detect the build config
  184. if opts.Method != "" {
  185. if opts.Method == DeployBuildTypeDocker {
  186. if opts.LocalDockerfile == "" {
  187. hasDockerfile := c.HasDefaultDockerfile(opts.LocalPath)
  188. if !hasDockerfile {
  189. return "", fmt.Errorf("Dockerfile not found")
  190. }
  191. opts.LocalDockerfile = "Dockerfile"
  192. }
  193. }
  194. } else {
  195. // try to detect dockerfile, otherwise fall back to `pack`
  196. hasDockerfile := c.HasDefaultDockerfile(opts.LocalPath)
  197. if !hasDockerfile {
  198. opts.Method = DeployBuildTypePack
  199. } else {
  200. opts.Method = DeployBuildTypeDocker
  201. opts.LocalDockerfile = "Dockerfile"
  202. }
  203. }
  204. // overwrite with docker image repository and tag
  205. regID, imageURL, err := c.GetImageRepoURL(opts.ReleaseName, opts.Namespace)
  206. if err != nil {
  207. return "", err
  208. }
  209. latestVersion, mergedValues, err := c.getMergedValues(overrideValues)
  210. if err != nil {
  211. return "", err
  212. }
  213. mergedValues["image"] = map[string]interface{}{
  214. "repository": imageURL,
  215. "tag": imageTag,
  216. }
  217. // create docker agent
  218. agent, err := docker.NewAgentWithAuthGetter(c.Client, opts.ProjectID)
  219. if err != nil {
  220. return "", err
  221. }
  222. env, err := GetEnvForRelease(c.Client, mergedValues, opts.ProjectID, opts.ClusterID, opts.Namespace)
  223. if err != nil {
  224. env = map[string]string{}
  225. }
  226. // add additional env based on options
  227. for key, val := range opts.SharedOpts.AdditionalEnv {
  228. env[key] = val
  229. }
  230. buildAgent := &BuildAgent{
  231. SharedOpts: opts.SharedOpts,
  232. client: c.Client,
  233. imageRepo: imageURL,
  234. env: env,
  235. imageExists: false,
  236. }
  237. if opts.Method == DeployBuildTypeDocker {
  238. basePath, err := filepath.Abs(".")
  239. if err != nil {
  240. return "", err
  241. }
  242. err = buildAgent.BuildDocker(agent, basePath, opts.LocalPath, opts.LocalDockerfile, imageTag, "")
  243. } else {
  244. err = buildAgent.BuildPack(agent, opts.LocalPath, imageTag, "", extraBuildConfig)
  245. }
  246. if err != nil {
  247. return "", err
  248. }
  249. // create repository
  250. err = c.Client.CreateRepository(
  251. context.Background(),
  252. opts.ProjectID,
  253. regID,
  254. &types.CreateRegistryRepositoryRequest{
  255. ImageRepoURI: imageURL,
  256. },
  257. )
  258. if err != nil {
  259. return "", err
  260. }
  261. err = agent.PushImage(fmt.Sprintf("%s:%s", imageURL, imageTag))
  262. if err != nil {
  263. return "", err
  264. }
  265. subdomain, err := c.CreateSubdomainIfRequired(mergedValues)
  266. if err != nil {
  267. return "", err
  268. }
  269. err = c.Client.DeployTemplate(
  270. context.Background(),
  271. opts.ProjectID,
  272. opts.ClusterID,
  273. opts.Namespace,
  274. &types.CreateReleaseRequest{
  275. CreateReleaseBaseRequest: &types.CreateReleaseBaseRequest{
  276. TemplateName: opts.Kind,
  277. TemplateVersion: latestVersion,
  278. Values: mergedValues,
  279. Name: opts.ReleaseName,
  280. },
  281. ImageURL: imageURL,
  282. },
  283. )
  284. if err != nil {
  285. return "", err
  286. }
  287. return subdomain, nil
  288. }
  289. // HasDefaultDockerfile detects if there is a dockerfile at the path `./Dockerfile`
  290. func (c *CreateAgent) HasDefaultDockerfile(buildPath string) bool {
  291. dockerFilePath := filepath.Join(buildPath, "./Dockerfile")
  292. info, err := os.Stat(dockerFilePath)
  293. return err == nil && !os.IsNotExist(err) && !info.IsDir()
  294. }
  295. // GetImageRepoURL creates the image repository url by finding the first valid image
  296. // registry linked to Porter, and then generates a new name of the form:
  297. // `{registry}/{name}-{namespace}`
  298. func (c *CreateAgent) GetImageRepoURL(name, namespace string) (uint, string, error) {
  299. // get all image registries linked to the project
  300. // get the list of namespaces
  301. resp, err := c.Client.ListRegistries(
  302. context.Background(),
  303. c.CreateOpts.ProjectID,
  304. )
  305. registries := *resp
  306. if err != nil {
  307. return 0, "", err
  308. } else if len(registries) == 0 {
  309. return 0, "", fmt.Errorf("must have created or linked an image registry")
  310. }
  311. // get the first non-empty registry
  312. var imageURI string
  313. var regID uint
  314. for _, reg := range registries {
  315. if c.CreateOpts.RegistryURL != "" {
  316. if c.CreateOpts.RegistryURL == reg.URL {
  317. regID = reg.ID
  318. if c.CreateOpts.RepoSuffix != "" {
  319. imageURI = fmt.Sprintf("%s/%s-%s", reg.URL, name, c.CreateOpts.RepoSuffix)
  320. } else {
  321. imageURI = fmt.Sprintf("%s/%s-%s", reg.URL, name, namespace)
  322. }
  323. break
  324. }
  325. } else if reg.URL != "" {
  326. regID = reg.ID
  327. if c.CreateOpts.RepoSuffix != "" {
  328. imageURI = fmt.Sprintf("%s/%s-%s", reg.URL, name, c.CreateOpts.RepoSuffix)
  329. } else {
  330. imageURI = fmt.Sprintf("%s/%s-%s", reg.URL, name, namespace)
  331. }
  332. break
  333. }
  334. }
  335. return regID, imageURI, nil
  336. }
  337. // GetLatestTemplateVersion retrieves the latest template version for a specific
  338. // Porter template from the chart repository.
  339. func (c *CreateAgent) GetLatestTemplateVersion(templateName string) (string, error) {
  340. resp, err := c.Client.ListTemplates(
  341. context.Background(),
  342. &types.ListTemplatesRequest{},
  343. )
  344. if err != nil {
  345. return "", err
  346. }
  347. templates := *resp
  348. var version string
  349. // find the matching template name
  350. for _, template := range templates {
  351. if templateName == template.Name {
  352. version = template.Versions[0]
  353. break
  354. }
  355. }
  356. if version == "" {
  357. return "", fmt.Errorf("matching template version not found")
  358. }
  359. return version, nil
  360. }
  361. // GetLatestTemplateDefaultValues gets the default config (`values.yaml`) set for a specific
  362. // template.
  363. func (c *CreateAgent) GetLatestTemplateDefaultValues(templateName, templateVersion string) (map[string]interface{}, error) {
  364. chart, err := c.Client.GetTemplate(
  365. context.Background(),
  366. templateName,
  367. templateVersion,
  368. &types.GetTemplateRequest{},
  369. )
  370. if err != nil {
  371. return nil, err
  372. }
  373. return chart.Values, nil
  374. }
  375. func (c *CreateAgent) getMergedValues(overrideValues map[string]interface{}) (string, map[string]interface{}, error) {
  376. // deploy the template
  377. latestVersion, err := c.GetLatestTemplateVersion(c.CreateOpts.Kind)
  378. if err != nil {
  379. return "", nil, err
  380. }
  381. // get the values of the template
  382. values, err := c.GetLatestTemplateDefaultValues(c.CreateOpts.Kind, latestVersion)
  383. if err != nil {
  384. return "", nil, err
  385. }
  386. // merge existing values with overriding values
  387. mergedValues := utils.CoalesceValues(values, overrideValues)
  388. return latestVersion, mergedValues, err
  389. }
  390. func (c *CreateAgent) CreateSubdomainIfRequired(mergedValues map[string]interface{}) (string, error) {
  391. subdomain := ""
  392. // check for automatic subdomain creation if web kind
  393. if c.CreateOpts.Kind == "web" {
  394. // look for ingress.enabled and no custom domains set
  395. ingressMap, err := getNestedMap(mergedValues, "ingress")
  396. if err == nil {
  397. enabledVal, enabledExists := ingressMap["enabled"]
  398. customDomVal, customDomExists := ingressMap["custom_domain"]
  399. if enabledExists && customDomExists {
  400. enabled, eOK := enabledVal.(bool)
  401. customDomain, cOK := customDomVal.(bool)
  402. // in the case of ingress enabled but no custom domain, create subdomain
  403. if eOK && cOK && enabled && !customDomain {
  404. dnsRecord, err := c.Client.CreateDNSRecord(
  405. context.Background(),
  406. c.CreateOpts.ProjectID,
  407. c.CreateOpts.ClusterID,
  408. c.CreateOpts.Namespace,
  409. c.CreateOpts.ReleaseName,
  410. )
  411. if err != nil {
  412. return "", fmt.Errorf("Error creating subdomain: %s", err.Error())
  413. }
  414. subdomain = dnsRecord.ExternalURL
  415. if ingressVal, ok := mergedValues["ingress"]; !ok {
  416. mergedValues["ingress"] = map[string]interface{}{
  417. "porter_hosts": []string{
  418. subdomain,
  419. },
  420. }
  421. } else {
  422. ingressValMap := ingressVal.(map[string]interface{})
  423. ingressValMap["porter_hosts"] = []string{
  424. subdomain,
  425. }
  426. }
  427. }
  428. }
  429. }
  430. }
  431. return subdomain, nil
  432. }