選択できるのは25トピックまでです。 トピックは、先頭が英数字で、英数字とダッシュ('-')を使用した35文字以内のものにしてください。

runners.go 5.4KB

Implement actions (#21937) Close #13539. Co-authored by: @lunny @appleboy @fuxiaohei and others. Related projects: - https://gitea.com/gitea/actions-proto-def - https://gitea.com/gitea/actions-proto-go - https://gitea.com/gitea/act - https://gitea.com/gitea/act_runner ### Summary The target of this PR is to bring a basic implementation of "Actions", an internal CI/CD system of Gitea. That means even though it has been merged, the state of the feature is **EXPERIMENTAL**, and please note that: - It is disabled by default; - It shouldn't be used in a production environment currently; - It shouldn't be used in a public Gitea instance currently; - Breaking changes may be made before it's stable. **Please comment on #13539 if you have any different product design ideas**, all decisions reached there will be adopted here. But in this PR, we don't talk about **naming, feature-creep or alternatives**. ### ⚠️ Breaking `gitea-actions` will become a reserved user name. If a user with the name already exists in the database, it is recommended to rename it. ### Some important reviews - What is `DEFAULT_ACTIONS_URL` in `app.ini` for? - https://github.com/go-gitea/gitea/pull/21937#discussion_r1055954954 - Why the api for runners is not under the normal `/api/v1` prefix? - https://github.com/go-gitea/gitea/pull/21937#discussion_r1061173592 - Why DBFS? - https://github.com/go-gitea/gitea/pull/21937#discussion_r1061301178 - Why ignore events triggered by `gitea-actions` bot? - https://github.com/go-gitea/gitea/pull/21937#discussion_r1063254103 - Why there's no permission control for actions? - https://github.com/go-gitea/gitea/pull/21937#discussion_r1090229868 ### What it looks like <details> #### Manage runners <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205870657-c72f590e-2e08-4cd4-be7f-2e0abb299bbf.png"> #### List runs <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205872794-50fde990-2b45-48c1-a178-908e4ec5b627.png"> #### View logs <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205872501-9b7b9000-9542-4991-8f55-18ccdada77c3.png"> </details> ### How to try it <details> #### 1. Start Gitea Clone this branch and [install from source](https://docs.gitea.io/en-us/install-from-source). Add additional configurations in `app.ini` to enable Actions: ```ini [actions] ENABLED = true ``` Start it. If all is well, you'll see the management page of runners: <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205877365-8e30a780-9b10-4154-b3e8-ee6c3cb35a59.png"> #### 2. Start runner Clone the [act_runner](https://gitea.com/gitea/act_runner), and follow the [README](https://gitea.com/gitea/act_runner/src/branch/main/README.md) to start it. If all is well, you'll see a new runner has been added: <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205878000-216f5937-e696-470d-b66c-8473987d91c3.png"> #### 3. Enable actions for a repo Create a new repo or open an existing one, check the `Actions` checkbox in settings and submit. <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205879705-53e09208-73c0-4b3e-a123-2dcf9aba4b9c.png"> <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205879383-23f3d08f-1a85-41dd-a8b3-54e2ee6453e8.png"> If all is well, you'll see a new tab "Actions": <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205881648-a8072d8c-5803-4d76-b8a8-9b2fb49516c1.png"> #### 4. Upload workflow files Upload some workflow files to `.gitea/workflows/xxx.yaml`, you can follow the [quickstart](https://docs.github.com/en/actions/quickstart) of GitHub Actions. Yes, Gitea Actions is compatible with GitHub Actions in most cases, you can use the same demo: ```yaml name: GitHub Actions Demo run-name: ${{ github.actor }} is testing out GitHub Actions 🚀 on: [push] jobs: Explore-GitHub-Actions: runs-on: ubuntu-latest steps: - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event." - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!" - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}." - name: Check out repository code uses: actions/checkout@v3 - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner." - run: echo "🖥️ The workflow is now ready to test your code on the runner." - name: List files in the repository run: | ls ${{ github.workspace }} - run: echo "🍏 This job's status is ${{ job.status }}." ``` If all is well, you'll see a new run in `Actions` tab: <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205884473-79a874bc-171b-4aaf-acd5-0241a45c3b53.png"> #### 5. Check the logs of jobs Click a run and you'll see the logs: <img width="1792" alt="image" src="https://user-images.githubusercontent.com/9418365/205884800-994b0374-67f7-48ff-be9a-4c53f3141547.png"> #### 6. Go on You can try more examples in [the documents](https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions) of GitHub Actions, then you might find a lot of bugs. Come on, PRs are welcome. </details> See also: [Feature Preview: Gitea Actions](https://blog.gitea.io/2022/12/feature-preview-gitea-actions/) --------- Co-authored-by: a1012112796 <1012112796@qq.com> Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com> Co-authored-by: delvh <dev.lh@web.de> Co-authored-by: ChristopherHX <christopher.homberger@web.de> Co-authored-by: John Olheiser <john.olheiser@gmail.com>
1年前
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190
  1. // Copyright 2022 The Gitea Authors. All rights reserved.
  2. // SPDX-License-Identifier: MIT
  3. package actions
  4. import (
  5. "errors"
  6. "net/http"
  7. "strings"
  8. actions_model "code.gitea.io/gitea/models/actions"
  9. "code.gitea.io/gitea/models/db"
  10. "code.gitea.io/gitea/modules/base"
  11. "code.gitea.io/gitea/modules/context"
  12. "code.gitea.io/gitea/modules/log"
  13. "code.gitea.io/gitea/modules/util"
  14. "code.gitea.io/gitea/modules/web"
  15. "code.gitea.io/gitea/services/forms"
  16. )
  17. // RunnersList render common runners list page
  18. func RunnersList(ctx *context.Context, tplName base.TplName, opts actions_model.FindRunnerOptions) {
  19. count, err := actions_model.CountRunners(ctx, opts)
  20. if err != nil {
  21. ctx.ServerError("AdminRunners", err)
  22. return
  23. }
  24. runners, err := actions_model.FindRunners(ctx, opts)
  25. if err != nil {
  26. ctx.ServerError("AdminRunners", err)
  27. return
  28. }
  29. if err := runners.LoadAttributes(ctx); err != nil {
  30. ctx.ServerError("LoadAttributes", err)
  31. return
  32. }
  33. // ownid=0,repo_id=0,means this token is used for global
  34. var token *actions_model.ActionRunnerToken
  35. token, err = actions_model.GetUnactivatedRunnerToken(ctx, opts.OwnerID, opts.RepoID)
  36. if errors.Is(err, util.ErrNotExist) {
  37. token, err = actions_model.NewRunnerToken(ctx, opts.OwnerID, opts.RepoID)
  38. if err != nil {
  39. ctx.ServerError("CreateRunnerToken", err)
  40. return
  41. }
  42. } else if err != nil {
  43. ctx.ServerError("GetUnactivatedRunnerToken", err)
  44. return
  45. }
  46. ctx.Data["Keyword"] = opts.Filter
  47. ctx.Data["Runners"] = runners
  48. ctx.Data["Total"] = count
  49. ctx.Data["RegistrationToken"] = token.Token
  50. ctx.Data["RunnerOnwerID"] = opts.OwnerID
  51. ctx.Data["RunnerRepoID"] = opts.RepoID
  52. pager := context.NewPagination(int(count), opts.PageSize, opts.Page, 5)
  53. ctx.Data["Page"] = pager
  54. ctx.HTML(http.StatusOK, tplName)
  55. }
  56. // RunnerDetails render runner details page
  57. func RunnerDetails(ctx *context.Context, tplName base.TplName, page int, runnerID, ownerID, repoID int64) {
  58. runner, err := actions_model.GetRunnerByID(ctx, runnerID)
  59. if err != nil {
  60. ctx.ServerError("GetRunnerByID", err)
  61. return
  62. }
  63. if err := runner.LoadAttributes(ctx); err != nil {
  64. ctx.ServerError("LoadAttributes", err)
  65. return
  66. }
  67. if !runner.Editable(ownerID, repoID) {
  68. err = errors.New("no permission to edit this runner")
  69. ctx.NotFound("RunnerDetails", err)
  70. return
  71. }
  72. ctx.Data["Runner"] = runner
  73. opts := actions_model.FindTaskOptions{
  74. ListOptions: db.ListOptions{
  75. Page: page,
  76. PageSize: 30,
  77. },
  78. Status: actions_model.StatusUnknown, // Unknown means all
  79. IDOrderDesc: true,
  80. RunnerID: runner.ID,
  81. }
  82. count, err := actions_model.CountTasks(ctx, opts)
  83. if err != nil {
  84. ctx.ServerError("CountTasks", err)
  85. return
  86. }
  87. tasks, err := actions_model.FindTasks(ctx, opts)
  88. if err != nil {
  89. ctx.ServerError("FindTasks", err)
  90. return
  91. }
  92. if err = tasks.LoadAttributes(ctx); err != nil {
  93. ctx.ServerError("TasksLoadAttributes", err)
  94. return
  95. }
  96. ctx.Data["Tasks"] = tasks
  97. pager := context.NewPagination(int(count), opts.PageSize, opts.Page, 5)
  98. ctx.Data["Page"] = pager
  99. ctx.HTML(http.StatusOK, tplName)
  100. }
  101. // RunnerDetailsEditPost response for edit runner details
  102. func RunnerDetailsEditPost(ctx *context.Context, runnerID, ownerID, repoID int64, redirectTo string) {
  103. runner, err := actions_model.GetRunnerByID(ctx, runnerID)
  104. if err != nil {
  105. log.Warn("RunnerDetailsEditPost.GetRunnerByID failed: %v, url: %s", err, ctx.Req.URL)
  106. ctx.ServerError("RunnerDetailsEditPost.GetRunnerByID", err)
  107. return
  108. }
  109. if !runner.Editable(ownerID, repoID) {
  110. ctx.NotFound("RunnerDetailsEditPost.Editable", util.NewPermissionDeniedErrorf("no permission to edit this runner"))
  111. return
  112. }
  113. form := web.GetForm(ctx).(*forms.EditRunnerForm)
  114. runner.Description = form.Description
  115. runner.CustomLabels = splitLabels(form.CustomLabels)
  116. err = actions_model.UpdateRunner(ctx, runner, "description", "custom_labels")
  117. if err != nil {
  118. log.Warn("RunnerDetailsEditPost.UpdateRunner failed: %v, url: %s", err, ctx.Req.URL)
  119. ctx.Flash.Warning(ctx.Tr("actions.runners.update_runner_failed"))
  120. ctx.Redirect(redirectTo)
  121. return
  122. }
  123. log.Debug("RunnerDetailsEditPost success: %s", ctx.Req.URL)
  124. ctx.Flash.Success(ctx.Tr("actions.runners.update_runner_success"))
  125. ctx.Redirect(redirectTo)
  126. }
  127. // RunnerResetRegistrationToken reset registration token
  128. func RunnerResetRegistrationToken(ctx *context.Context, ownerID, repoID int64, redirectTo string) {
  129. _, err := actions_model.NewRunnerToken(ctx, ownerID, repoID)
  130. if err != nil {
  131. ctx.ServerError("ResetRunnerRegistrationToken", err)
  132. return
  133. }
  134. ctx.Flash.Success(ctx.Tr("actions.runners.reset_registration_token_success"))
  135. ctx.Redirect(redirectTo)
  136. }
  137. // RunnerDeletePost response for deleting a runner
  138. func RunnerDeletePost(ctx *context.Context, runnerID int64,
  139. successRedirectTo, failedRedirectTo string,
  140. ) {
  141. if err := actions_model.DeleteRunner(ctx, runnerID); err != nil {
  142. log.Warn("DeleteRunnerPost.UpdateRunner failed: %v, url: %s", err, ctx.Req.URL)
  143. ctx.Flash.Warning(ctx.Tr("actions.runners.delete_runner_failed"))
  144. ctx.JSON(http.StatusOK, map[string]interface{}{
  145. "redirect": failedRedirectTo,
  146. })
  147. return
  148. }
  149. log.Info("DeleteRunnerPost success: %s", ctx.Req.URL)
  150. ctx.Flash.Success(ctx.Tr("actions.runners.delete_runner_success"))
  151. ctx.JSON(http.StatusOK, map[string]interface{}{
  152. "redirect": successRedirectTo,
  153. })
  154. }
  155. func splitLabels(s string) []string {
  156. labels := strings.Split(s, ",")
  157. for i, v := range labels {
  158. labels[i] = strings.TrimSpace(v)
  159. }
  160. return labels
  161. }