diff --git a/_attributes/common-attributes.adoc b/_attributes/common-attributes.adoc index 1694b3bc1e..0735f64e75 100644 --- a/_attributes/common-attributes.adoc +++ b/_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 diff --git a/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc b/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc index 7811e689bc..6261e791c5 100644 --- a/cicd/pipelines/creating-applications-with-cicd-pipelines.adoc +++ b/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. diff --git a/images/Github-app-details.png b/images/Github-app-details.png new file mode 100644 index 0000000000..d047e1a4e2 Binary files /dev/null and b/images/Github-app-details.png differ diff --git a/modules/creating-a-github-application-in-administrator-perspective.adoc b/modules/creating-a-github-application-in-administrator-perspective.adoc new file mode 100644 index 0000000000..4ba5233ef1 --- /dev/null +++ b/modules/creating-a-github-application-in-administrator-perspective.adoc @@ -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.