Request to update documentation on how to use the plugin and to switch the plugin to deliver its plugins.jenkins.io documentation from GitHub rather than from the wiki. See JENKINS-59467 for a template that describes how to make that transition. That will allow editing the documentation in the README file with automatic publishing to plugins.jenkins.io.

      Basic usage steps of plugin required.

      There is a global section available for adding Gitea servers, but completely unclear on how to use it and where to use it.

      The Gitea plugin provides an organization folder implementation that should be included in the "Branches and Pull Requests" section of the jenkins.io documentation. A tutorial could be provided with a docker-compose configuration that would allow the reader to complete something like the End-to-End Multibranch Pipeline Project Creation without requiring an account on GitHub.

      Gitea is used as the git server in several courses that CloudBees offers as self-paced courses at no charge, including:

          [JENKINS-47533] Document the Gitea plugin

          Mark Waite added a comment - - edited

          The plugins site includes documentation for:

          • Initial setup
          • Setup Gitea user
          • Add a Gitea organization item

          That provides the basic usage steps of the plugin. The documentation is delivered from plugins.jenkins.io . That covers the first three paragraphs of this request.

          The "Branches and Pull Requests" page includes links to the Gitea plugin in the same sections that include links to the GitHub branch source plugin, the Bitbucket branch source plugin, and the GitLab branch source plugin. That covers much of the fourth paragraph of this request.

          The proposal for an end to end tutorial using Docker compose would be the first tutorial on jenkins.io that uses Docker compose. Significant work would be required to create and maintain that type of tutorial with multiple components running together. The CloudBees courses mentioned in the issue report are using a Docker compose configuration to deliver Jenkins and Gitea in single course.

          Mark Waite added a comment - - edited The plugins site includes documentation for: Initial setup Setup Gitea user Add a Gitea organization item That provides the basic usage steps of the plugin. The documentation is delivered from plugins.jenkins.io . That covers the first three paragraphs of this request. The " Branches and Pull Requests " page includes links to the Gitea plugin in the same sections that include links to the GitHub branch source plugin, the Bitbucket branch source plugin, and the GitLab branch source plugin. That covers much of the fourth paragraph of this request. The proposal for an end to end tutorial using Docker compose would be the first tutorial on jenkins.io that uses Docker compose. Significant work would be required to create and maintain that type of tutorial with multiple components running together. The CloudBees courses mentioned in the issue report are using a Docker compose configuration to deliver Jenkins and Gitea in single course.

          Delany added a comment -

          Basic setup steps urgently needed!

          What the heck is all this about? https://plugins.jenkins.io/gitea/#plugin-content-map-your-gitea-organizationuser

           

          Delany added a comment - Basic setup steps urgently needed! What the heck is all this about? https://plugins.jenkins.io/gitea/#plugin-content-map-your-gitea-organizationuser  

          Mark Waite added a comment - - edited

          delany refer to the several videos on Jenkins multibranch pipeline. I really like the video from darinpope at https://youtu.be/B_2FXWI6CWg . Likewise the concepts presented for GitHub in https://www.youtube.com/watch?v=LbXKUKQ24T8 apply also to Gitea.

          Mark Waite added a comment - - edited delany refer to the several videos on Jenkins multibranch pipeline. I really like the video from darinpope at https://youtu.be/B_2FXWI6CWg . Likewise the concepts presented for GitHub in https://www.youtube.com/watch?v=LbXKUKQ24T8 apply also to Gitea.

          Delany added a comment -

          markewaite where I always get stuck is setting up the credentials.

          I did your "initial setup" where I created the credential "gitea-token"

          But when I want to use that in a "new item" the Credentials drop-down doesn't have any, and I have to add a new with with the Add button

          If I add another credential with the Jenkins option, it gets added to the <jenkinsserver>/credentials/ page, but it doesn't appear in the "new item"s drop-down.

          If I add another credential with the commissioner option (the name of my item), it neither appears in the credentials page nor in this drop-down.

           

          Delany added a comment - markewaite where I always get stuck is setting up the credentials. I did your "initial setup" where I created the credential "gitea-token" But when I want to use that in a "new item" the Credentials drop-down doesn't have any, and I have to add a new with with the Add button If I add another credential with the Jenkins option, it gets added to the <jenkinsserver>/credentials/ page, but it doesn't appear in the "new item"s drop-down. If I add another credential with the commissioner option (the name of my item), it neither appears in the credentials page nor in this drop-down.  

          Delany added a comment -

          What does this mean?

          [Wed Mar 09 11:36:55 CAT 2022] Starting organization scan...
          [Wed Mar 09 11:36:55 CAT 2022] Updating actions...
          ERROR: [Wed Mar 09 11:36:55 CAT 2022] Could not refresh actions for navigator org.jenkinsci.plugin.gitea.GiteaSCMNavigator@77602b92
          org.jenkinsci.plugin.gitea.client.api.GiteaHttpStatusException: HTTP 404/Not Found
          	at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.getObject(DefaultGiteaConnection.java:865)
          	at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchUser(DefaultGiteaConnection.java:176)
          	at org.jenkinsci.plugin.gitea.GiteaSCMNavigator.retrieveActions(GiteaSCMNavigator.java:223)
          	at jenkins.scm.api.SCMNavigator.fetchActions(SCMNavigator.java:332)
          	at jenkins.branch.OrganizationFolder.computeChildren(OrganizationFolder.java:486)
          	at com.cloudbees.hudson.plugins.folder.computed.ComputedFolder.updateChildren(ComputedFolder.java:278)
          	at com.cloudbees.hudson.plugins.folder.computed.FolderComputation.run(FolderComputation.java:166)
          	at jenkins.branch.OrganizationFolder$OrganizationScan.run(OrganizationFolder.java:917)
          	at hudson.model.ResourceController.execute(ResourceController.java:99)
          	at hudson.model.Executor.run(Executor.java:432)
          [Wed Mar 09 11:36:55 CAT 2022] Consulting Gitea Organization
          ERROR: [Wed Mar 09 11:36:55 CAT 2022] Could not fetch sources from navigator org.jenkinsci.plugin.gitea.GiteaSCMNavigator@77602b92
          [Wed Mar 09 11:36:55 CAT 2022] Finished organization scan. Scan took 0,12 sec
          FATAL: Failed to recompute children of commissioner
          com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize value of type `org.jenkinsci.plugin.gitea.client.api.GiteaOrganization` from Array value (token `JsonToken.START_ARRAY`)
           at [Source: (sun.net.www.protocol.http.HttpURLConnection$HttpInputStream); line: 1, column: 1]
          	at com.fasterxml.jackson.databind.exc.MismatchedInputException.from(MismatchedInputException.java:59)
          	at com.fasterxml.jackson.databind.DeserializationContext.reportInputMismatch(DeserializationContext.java:1741)
          	at com.fasterxml.jackson.databind.DeserializationContext.handleUnexpectedToken(DeserializationContext.java:1515)
          	at com.fasterxml.jackson.databind.DeserializationContext.handleUnexpectedToken(DeserializationContext.java:1462)
          	at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeFromArray(BeanDeserializer.java:638)
          	at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeOther(BeanDeserializer.java:210)
          	at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:186)
          	at com.fasterxml.jackson.databind.deser.DefaultDeserializationContext.readRootValue(DefaultDeserializationContext.java:322)
          	at com.fasterxml.jackson.databind.ObjectReader._bindAndClose(ObjectReader.java:2051)
          	at com.fasterxml.jackson.databind.ObjectReader.readValue(ObjectReader.java:1427)
          	at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.getObject(DefaultGiteaConnection.java:862)
          	at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchOrganization(DefaultGiteaConnection.java:188)
          	at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchOwner(DefaultGiteaConnection.java:160)
          	at org.jenkinsci.plugin.gitea.GiteaSCMNavigator.visitSources(GiteaSCMNavigator.java:155)
          	at jenkins.branch.OrganizationFolder.computeChildren(OrganizationFolder.java:535)
          	at com.cloudbees.hudson.plugins.folder.computed.ComputedFolder.updateChildren(ComputedFolder.java:278)
          	at com.cloudbees.hudson.plugins.folder.computed.FolderComputation.run(FolderComputation.java:166)
          	at jenkins.branch.OrganizationFolder$OrganizationScan.run(OrganizationFolder.java:917)
          	at hudson.model.ResourceController.execute(ResourceController.java:99)
          	at hudson.model.Executor.run(Executor.java:432)
          Finished: FAILURE

          Delany added a comment - What does this mean? [Wed Mar 09 11:36:55 CAT 2022] Starting organization scan... [Wed Mar 09 11:36:55 CAT 2022] Updating actions... ERROR: [Wed Mar 09 11:36:55 CAT 2022] Could not refresh actions for navigator org.jenkinsci.plugin.gitea.GiteaSCMNavigator@77602b92 org.jenkinsci.plugin.gitea.client.api.GiteaHttpStatusException: HTTP 404/Not Found at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.getObject(DefaultGiteaConnection.java:865) at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchUser(DefaultGiteaConnection.java:176) at org.jenkinsci.plugin.gitea.GiteaSCMNavigator.retrieveActions(GiteaSCMNavigator.java:223) at jenkins.scm.api.SCMNavigator.fetchActions(SCMNavigator.java:332) at jenkins.branch.OrganizationFolder.computeChildren(OrganizationFolder.java:486) at com.cloudbees.hudson.plugins.folder.computed.ComputedFolder.updateChildren(ComputedFolder.java:278) at com.cloudbees.hudson.plugins.folder.computed.FolderComputation.run(FolderComputation.java:166) at jenkins.branch.OrganizationFolder$OrganizationScan.run(OrganizationFolder.java:917) at hudson.model.ResourceController.execute(ResourceController.java:99) at hudson.model.Executor.run(Executor.java:432) [Wed Mar 09 11:36:55 CAT 2022] Consulting Gitea Organization ERROR: [Wed Mar 09 11:36:55 CAT 2022] Could not fetch sources from navigator org.jenkinsci.plugin.gitea.GiteaSCMNavigator@77602b92 [Wed Mar 09 11:36:55 CAT 2022] Finished organization scan. Scan took 0,12 sec FATAL: Failed to recompute children of commissioner com.fasterxml.jackson.databind.exc.MismatchedInputException: Cannot deserialize value of type `org.jenkinsci.plugin.gitea.client.api.GiteaOrganization` from Array value (token `JsonToken.START_ARRAY`) at [Source: (sun.net.www.protocol.http.HttpURLConnection$HttpInputStream); line: 1, column: 1] at com.fasterxml.jackson.databind.exc.MismatchedInputException.from(MismatchedInputException.java:59) at com.fasterxml.jackson.databind.DeserializationContext.reportInputMismatch(DeserializationContext.java:1741) at com.fasterxml.jackson.databind.DeserializationContext.handleUnexpectedToken(DeserializationContext.java:1515) at com.fasterxml.jackson.databind.DeserializationContext.handleUnexpectedToken(DeserializationContext.java:1462) at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeFromArray(BeanDeserializer.java:638) at com.fasterxml.jackson.databind.deser.BeanDeserializer._deserializeOther(BeanDeserializer.java:210) at com.fasterxml.jackson.databind.deser.BeanDeserializer.deserialize(BeanDeserializer.java:186) at com.fasterxml.jackson.databind.deser.DefaultDeserializationContext.readRootValue(DefaultDeserializationContext.java:322) at com.fasterxml.jackson.databind.ObjectReader._bindAndClose(ObjectReader.java:2051) at com.fasterxml.jackson.databind.ObjectReader.readValue(ObjectReader.java:1427) at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.getObject(DefaultGiteaConnection.java:862) at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchOrganization(DefaultGiteaConnection.java:188) at org.jenkinsci.plugin.gitea.client.impl.DefaultGiteaConnection.fetchOwner(DefaultGiteaConnection.java:160) at org.jenkinsci.plugin.gitea.GiteaSCMNavigator.visitSources(GiteaSCMNavigator.java:155) at jenkins.branch.OrganizationFolder.computeChildren(OrganizationFolder.java:535) at com.cloudbees.hudson.plugins.folder.computed.ComputedFolder.updateChildren(ComputedFolder.java:278) at com.cloudbees.hudson.plugins.folder.computed.FolderComputation.run(FolderComputation.java:166) at jenkins.branch.OrganizationFolder$OrganizationScan.run(OrganizationFolder.java:917) at hudson.model.ResourceController.execute(ResourceController.java:99) at hudson.model.Executor.run(Executor.java:432) Finished: FAILURE

          delany That looks like an implementation bug or incompatible API change to me. It would be best to report that as a separate issue, as this issue is for documentation. I don't see references to com.fasterxml.jackson.databind.exc.MismatchedInputException in other gitea-plugin issues, so the error doesn't seem to have been reported before. Please include the versions of the Gitea server, Jenkins, and Jenkins plugins in your report.

          Kalle Niemitalo added a comment - delany That looks like an implementation bug or incompatible API change to me. It would be best to report that as a separate issue, as this issue is for documentation. I don't see references to com.fasterxml.jackson.databind.exc.MismatchedInputException in other gitea-plugin issues, so the error doesn't seem to have been reported before. Please include the versions of the Gitea server, Jenkins, and Jenkins plugins in your report.

          Steven added a comment -

          Hi delany. Are you referring to freestyle jobs when saying that the credentials cannot be configured properly?

          Steven added a comment - Hi  delany . Are you referring to freestyle jobs when saying that the credentials cannot be configured properly?

          Delany added a comment -

          justusbunsi all my builds are pipeline projects. I dont remember if I tried this with a multibranch pipeline project.

          Delany added a comment - justusbunsi all my builds are pipeline projects. I dont remember if I tried this with a multibranch pipeline project.

          Mark Waite added a comment -

          Closing issue as resolved by the earlier steps that deliver the Gitea plugin documentation.  The request to provide additional tutorials or other tutorial configurations is much broader than the "Document the Gitea plugin" request.

          Mark Waite added a comment - Closing issue as resolved by the earlier steps that deliver the Gitea plugin documentation.  The request to provide additional tutorials or other tutorial configurations is much broader than the "Document the Gitea plugin" request.

            Unassigned Unassigned
            sankethpb Sanketh PB
            Votes:
            4 Vote for this issue
            Watchers:
            6 Start watching this issue

              Created:
              Updated:
              Resolved: