Merge pull request #64318 from abrennan89/cherrypick-main

[pipelines-docs] RHDEVDOCS-5518: Documenting Pipelines templates in the admin console

_topic_maps/_topic_map.yml

@@ -57,8 +57,8 @@ Distros: openshift-pipelines
 Topics:
 - Name: Creating CI/CD solutions for applications using OpenShift Pipelines
   File: creating-applications-with-cicd-pipelines
-- Name: Working with OpenShift Pipelines using the Developer perspective
-  File: working-with-pipelines-using-the-developer-perspective
+- Name: Working with OpenShift Pipelines in the web console
+  File: working-with-pipelines-web-console
 - Name: Specifying remote pipelines and tasks using resolvers
   File: remote-pipelines-tasks-resolvers
 - Name: Managing non-versioned and versioned cluster tasks

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

@@ -81,7 +81,7 @@ include::modules/op-validating-pull-requests-using-GitHub-interceptors.adoc[leve
 == Additional resources
 
 * To include {pac} along with the application source code in the same repository, see xref:../pac/about-pipelines-as-code.adoc#about-pipelines-as-code[About {pac}].
-* For more details on pipelines in the *Developer* perspective, see the xref:../create/working-with-pipelines-using-the-developer-perspective.adoc#working-with-pipelines-using-the-developer-perspective[working with pipelines in the *Developer* perspective] section.
+* For more details on pipelines in the *Developer* perspective, see the xref:../create/working-with-pipelines-web-console.adoc#working-with-pipelines-web-console[Working with OpenShift Pipelines in the web console] section.
 * To learn more about Security Context Constraints (SCCs), see the link:https://docs.openshift.com/container-platform/latest/authentication/managing-security-context-constraints.html[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:../hub/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using {tekton-hub} with {pipelines-title}].

create/working-with-pipelines-web-console.adoc

@@ -0,0 +1,49 @@
+:_content-type: ASSEMBLY
+include::_attributes/common-attributes.adoc[]
+[id="working-with-pipelines-web-console"]
+= Working with {pipelines-title} using the Developer perspective
+:context: working-with-pipelines-web-console
+
+toc::[]
+
+You can use the *Administrator* or *Developer* perspective to create and modify `Pipeline`, `PipelineRun`, and `Repository` objects from the *Pipelines* page in the {OCP} web console.
+You can also use the *+Add* page in the *Developer* perspective of the web console to create CI/CD pipelines for your software delivery process.
+
+// Dev console
+include::modules/op-odc-pipelines-abstract.adoc[leveloffset=+1]
+
+[discrete]
+[id="prerequisites_working-with-pipelines-web-console"]
+== Prerequisites
+
+* You have access to an {OCP} cluster and have switched to link:https://docs.openshift.com/container-platform/latest/web_console/web-console-overview.html#about-developer-perspective_web-console-overview[the *Developer* perspective].
+* You have the xref:../install_config/installing-pipelines.adoc#installing-pipelines[{pipelines-shortname} Operator installed] in your cluster.
+* You are a cluster administrator or a user with create and edit permissions.
+* You have created a project.
+
+include::modules/op-constructing-pipelines-using-pipeline-builder.adoc[leveloffset=+2]
+
+include::modules/op-creating-pipelines-along-with-applications.adoc[leveloffset=+2]
+
+include::modules/odc-adding-a-GitHub-repository-containing-pipelines.adoc[leveloffset=+2]
+
+include::modules/op-interacting-with-pipelines-using-the-developer-perspective.adoc[leveloffset=+2]
+
+include::modules/op-starting-pipelines-from-pipelines-view.adoc[leveloffset=+2]
+
+include::modules/op-starting-pipelines-from-topology-view.adoc[leveloffset=+2]
+
+include::modules/op-interacting-pipelines-from-topology-view.adoc[leveloffset=+2]
+
+include::modules/op-editing-pipelines.adoc[leveloffset=+2]
+
+include::modules/op-deleting-pipelines.adoc[leveloffset=+2]
+
+[role="_additional-resources"]
+[id="additional-resources_working-with-pipelines-web-console"]
+== Additional resources
+
+* xref:../hub/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using Tekton Hub with {pipelines-shortname}]
+
+// Admin console
+include::modules/op-creating-pipeline-templates-admin-console.adoc[leveloffset=+1]

install_config/customizing-configurations-in-the-tektonconfig-cr.adoc

@@ -52,5 +52,5 @@ include::modules/op-annotations-for-automatic-pruning-taskruns-pipelineruns.adoc
 
 * xref:../secure/authenticating-pipelines-using-git-secret.adoc#op-configuring-ssh-authentication-for-git_authenticating-pipelines-using-git-secret[Configuring SSH authentication for Git]
 * xref:../create/managing-nonversioned-and-versioned-cluster-tasks.adoc#managing-nonversioned-and-versioned-cluster-tasks[Managing non-versioned and versioned cluster tasks]
-* xref:../create/working-with-pipelines-using-the-developer-perspective.adoc#using-custom-pipeline-template-for-git-import_working-with-pipelines-using-the-developer-perspective[Using a custom pipeline template for creating and deploying an application from a Git repository]
+* xref:../create/working-with-pipelines-web-console.adoc#using-custom-pipeline-template-for-git-import_working-with-pipelines-web-console[Creating pipeline templates in the Administrator perspective]
 * link:https://docs.openshift.com/container-platform/latest/applications/pruning-objects.html[Pruning objects to reclaim resources]

modules/odc-adding-a-GitHub-repository-containing-pipelines.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="odc-adding-a-GitHub-repository-containing-pipelines_{context}"]

modules/op-constructing-pipelines-using-pipeline-builder.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-constructing-pipelines-using-pipeline-builder_{context}"]

modules/op-creating-pipeline-templates-admin-console.adoc

@@ -0,0 +1,39 @@
+// This module is included in the following assemblies:
+// * create/working-with-pipelines-web-console.adoc
+
+:_content-type: PROCEDURE
+[id="op-creating-pipeline-templates-admin-console_{context}"]
+= Creating pipeline templates in the Administrator perspective
+
+As a cluster administrator, you can create pipeline templates that developers can reuse when they create a pipeline on the cluster.
+
+.Prerequisites
+
+* You have access to an {OCP} cluster with cluster administrator permissions, and have switched to the *Administrator* perspective.
+* You have installed the {pipelines-shortname} Operator in your cluster.
+
+.Procedure
+
+. Navigate to the *Pipelines* page to view existing pipeline templates.
+
+. Click the image:../images/import-icon.png[title="Import"] icon to go to the *Import YAML* page.
+
+. Add the YAML for your pipeline template. The template must include the following information:
++
+[source,yaml]
+----
+apiVersion: tekton.dev/v1beta1
+kind: Pipeline
+metadata:
+# ...
+  namespace: openshift # <1>
+  labels:
+    pipeline.openshift.io/runtime: <runtime> # <2>
+    pipeline.openshift.io/type: <pipeline-type> # <3>
+# ...
+----
+<1> The template must be created in the `openshift` namespace.
+<2> The template must contain the `pipeline.openshift.io/runtime` label. The accepted runtime values for this label are `nodejs`, `golang`, `dotnet`, `java`, `php`, `ruby`, `perl`, `python`, `nginx`, and `httpd`.
+<3> The template must contain the `pipeline.openshift.io/type:` label. The accepted type values for this label are `openshift`, `knative`, and `kubernetes`.
+
+. Click *Create*. After the pipeline has been created, you are taken to the *Pipeline details* page, where you can view information about or edit your pipeline.

modules/op-creating-pipelines-along-with-applications.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: CONCEPT
 [id="op-creating-pipelines-along-with-applications_{context}"]

modules/op-deleting-pipelines.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-deleting-pipelines_{context}"]

modules/op-editing-pipelines.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-editing-pipelines_{context}"]

modules/op-interacting-pipelines-from-topology-view.adoc

@@ -1,13 +1,13 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: CONCEPT
 [id="op-interacting-pipelines_from_topology_view{context}"]
 = Interacting with pipelines from Topology view
 
-The side panel of the application node in the *Topology* page displays the status of a pipeline run and you can interact with it. 
+The side panel of the application node in the *Topology* page displays the status of a pipeline run and you can interact with it.
 
-* If a pipeline run does not start automatically, the side panel displays a message that the pipeline cannot be automatically started, hence it would need to be started manually. 
-* If a pipeline is created but the user has not started the pipeline, its status is not started. When the user clicks the *Not started* status icon, the start dialog box opens in the *Topology* view. 
+* If a pipeline run does not start automatically, the side panel displays a message that the pipeline cannot be automatically started, hence it would need to be started manually.
+* If a pipeline is created but the user has not started the pipeline, its status is not started. When the user clicks the *Not started* status icon, the start dialog box opens in the *Topology* view.
 * If the pipeline has no build or build config, the *Builds* section is not visible. If there is a pipeline and build config, the *Builds section* is visible.
 * The side panel displays a *Log Snippet* when a pipeline run fails on a specific task run. You can view the *Log Snippet* in the *Pipeline Runs* section, under the *Resources* tab. It provides a general error message and a snippet of the log. A link to the *Logs* section provides quick access to the details about the failed run.

modules/op-interacting-with-pipelines-using-the-developer-perspective.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-interacting-with-pipelines-using-the-developer-perspective_{context}"]
@@ -19,7 +19,7 @@ The *Pipelines* view in the *Developer* perspective lists all the pipelines in a
 . In the *Pipelines* view of the *Developer* perspective, select a project from the *Project* drop-down list to see the pipelines in that project.
 . Click the required pipeline to see the *Pipeline details* page.
 +
-By default, the *Details* tab displays a visual representation of all the `serial` tasks, `parallel` tasks, `finally` tasks, and `when` expressions in the pipeline. The tasks and the `finally` tasks are listed in the lower right portion of the page. 
+By default, the *Details* tab displays a visual representation of all the `serial` tasks, `parallel` tasks, `finally` tasks, and `when` expressions in the pipeline. The tasks and the `finally` tasks are listed in the lower right portion of the page.
 +
 To view the task details, click the listed *Tasks* and *Finally* tasks. In addition, you can do the following:
 +

modules/op-odc-pipelines-abstract.adoc

@@ -0,0 +1,13 @@
+// Module included in the following assemblies:
+//
+// * create/working-with-pipelines-web-console.adoc
+
+:_content-type: CONCEPT
+[id="op-odc-pipelines-abstract_{context}"]
+= Working with {pipelines-title} in the Developer perspective
+
+In the *Developer* perspective, you can access the following options for creating pipelines from the *+Add* page:
+
+* Use the *+Add* -> *Pipelines* -> *Pipeline builder* option to create customized pipelines for your application.
+* Use the *+Add* -> *From Git* option to create pipelines using pipeline templates and resources while creating an application.
+After you create the pipelines for your application, you can view and visually interact with the deployed pipelines in the *Pipelines* view. You can also use the *Topology* view to interact with the pipelines created using the *From Git* option. You must apply custom labels to pipelines created using the *Pipeline builder* to see them in the *Topology* view.

modules/op-starting-pipelines-from-pipelines-view.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-starting-pipelines_from_pipelines_view_{context}"]

modules/op-starting-pipelines-from-topology-view.adoc

@@ -1,5 +1,5 @@
 // This module is included in the following assemblies:
-// * create/working-with-pipelines-using-the-developer-perspective.adoc
+// * create/working-with-pipelines-web-console.adoc
 
 :_content-type: PROCEDURE
 [id="op-starting-pipelines_from_topology_view{context}"]