Merge pull request #47520 from shipsing/RHDEVDOCS-3905

RHDEVDOCS-3905: Creating a GitHub application in admin perspective

Author: bburt-rh

_attributes/common-attributes.adoc

@@ -82,7 +82,7 @@ endif::[]
 //pipelines
 :pipelines-title: Red Hat OpenShift Pipelines
 :pipelines-shortname: Pipelines
-:pipelines-ver: pipelines-1.7
+:pipelines-ver: pipelines-1.8
 :tekton-chains: Tekton Chains
 :tekton-hub: Tekton Hub
 //odo

cicd/pipelines/creating-applications-with-cicd-pipelines.adoc

@@ -35,6 +35,8 @@ This section uses the `pipelines-tutorial` example to demonstrate the preceding
 
 include::modules/op-creating-project-and-checking-pipeline-service-account.adoc[leveloffset=+1]
 
+include::modules/creating-a-github-application-in-administrator-perspective.adoc[leveloffset=+1]
+
 include::modules/op-creating-pipeline-tasks.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
@@ -77,6 +79,6 @@ include::modules/op-enabling-monitoring-of-event-listeners-for-triggers-for-user
 * For more details on pipelines in the *Developer* perspective, see the xref:../../cicd/pipelines/working-with-pipelines-using-the-developer-perspective.adoc#working-with-pipelines-using-the-developer-perspective[working with pipelines in the *Developer* perspective] section.
 * To learn more about Security Context Constraints (SCCs), see the xref:../../authentication/managing-security-context-constraints.adoc#managing-pod-security-policies[Managing Security Context Constraints] section.
 * For more examples of reusable tasks, see the link:https://github.com/openshift/pipelines-catalog[OpenShift Catalog] repository. Additionally, you can also see the Tekton Catalog in the Tekton project.
-* To install and deploy a custom instance of Tekton Hub for reusable tasks and pipelines, see xref:../../cicd/pipelines/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using {tekton-hub} with {pipelines-title}]. 
+* To install and deploy a custom instance of Tekton Hub for reusable tasks and pipelines, see xref:../../cicd/pipelines/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using {tekton-hub} with {pipelines-title}].
 * For more details on re-encrypt TLS termination, see link:https://docs.openshift.com/container-platform/3.11/architecture/networking/routes.html#re-encryption-termination[Re-encryption Termination].
 * For more details on secured routes, see the xref:../../networking/routes/secured-routes.adoc#secured-routes[Secured routes] section.

images/Github-app-details.png

@@ -0,0 +1,29 @@
+// Module included in the following assemblies:
+//
+// * cicd/pipelines/creating-applications-with-cicd-pipelines.adoc
+
+:_content-type: PROCEDURE
+[id="creating-a-github-application-in-administrator-perspective_{context}"]
+
+= Creating a GitHub application in administrator perspective
+
+As a cluster administrator, you can configure your GitHub application with the {product-title} cluster to use a pipeline as code. This configuration allows you to execute a set of tasks required for build deployment.
+
+.Prerequisites
+You have installed the {pipelines-title} {pipelines-ver} operator from the Operator Hub.
+
+.Procedure
+. In the administrator perspective, navigate to *Pipelines* using the navigation pane.
+. Click *Setup GitHub App* on the *Pipelines* page.
+. Enter your GitHub application name, for example, `pipelines-ci-clustername-ss-test`.
+. Click *Setup*.
+. Enter your Git password when prompted in the browser.
+. Click *Create GitHub App for `username`*. The variable `username` denotes your actual user name.
+
+.Verification
+After the Git application is successfully created, the {product-title} web console opens and provides you with details about the application.
+
+image::Github-app-details.png[]
+
+The details of the created application are saved as a secret in the `openShift-pipelines` namespace.
+To view the details of the GitHub applications created, navigate to *Pipelines* and click *View GitHub App*. The details include the name, link, and secret associated with the application.