Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion _attributes/common-attributes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ endif::[]
:rh-app-icon: image:red-hat-applications-menu-icon.jpg[title="Red Hat applications"]
//pipelines
:pipelines-title: Red Hat OpenShift Pipelines
:pipelines-shortname: Pipelines
:pipelines-shortname: OpenShift Pipelines
:pipelines-ver: pipelines-1.9
:tekton-chains: Tekton Chains
:tekton-hub: Tekton Hub
Expand Down
8 changes: 4 additions & 4 deletions cicd/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ toc::[]
{product-title} is an enterprise-ready Kubernetes platform for developers, which enables organizations to automate the application delivery process through DevOps practices, such as continuous integration (CI) and continuous delivery (CD). To meet your organizational needs, the {product-title} provides the following CI/CD solutions:

* OpenShift Builds
* OpenShift Pipelines
* {pipelines-shortname}
* OpenShift GitOps

[id="openshift-builds"]
Expand All @@ -26,10 +26,10 @@ OpenShift Builds provides the following extensible support for build strategies:
For more information, see xref:../cicd/builds/understanding-image-builds.adoc#understanding-image-builds[Understanding image builds]

[id="openshift-pipelines"]
== OpenShift Pipelines
OpenShift Pipelines provides a Kubernetes-native CI/CD framework to design and run each step of the CI/CD pipeline in its own container. It can scale independently to meet the on-demand pipelines with predictable outcomes.
== {pipelines-shortname}
{pipelines-shortname} provides a Kubernetes-native CI/CD framework to design and run each step of the CI/CD pipeline in its own container. It can scale independently to meet the on-demand pipelines with predictable outcomes.

For more information, see xref:../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding OpenShift Pipelines]
For more information, see xref:../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding {pipelines-shortname}]

[id="openshift-gitops"]
== OpenShift GitOps
Expand Down
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
:_content-type: ASSEMBLY
//Jenkins-Tekton-Migration
[id="migrating-from-jenkins-to-openshift-pipelines_{context}"]
= Migrating from Jenkins to OpenShift Pipelines or Tekton
= Migrating from Jenkins to {pipelines-shortname} or Tekton
include::_attributes/common-attributes.adoc[]
:context: migrating-from-jenkins-to-openshift-pipelines

toc::[]

You can migrate your CI/CD workflows from Jenkins to xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Red Hat OpenShift Pipelines], a cloud-native CI/CD experience based on the Tekton project.
You can migrate your CI/CD workflows from Jenkins to xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[{pipelines-title}], a cloud-native CI/CD experience based on the Tekton project.

include::modules/jt-comparison-of-jenkins-and-openshift-pipelines-concepts.adoc[leveloffset=+1]

Expand All @@ -23,5 +23,5 @@ include::modules/jt-examples-of-common-use-cases.adoc[leveloffset=+1]

[role="_additional-resources"]
== Additional resources
* xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding OpenShift Pipelines]
* xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding {pipelines-shortname}]
* xref:../../authentication/using-rbac.adoc#using-rbac[Role-based Access Control]
8 changes: 4 additions & 4 deletions cicd/pipelines/creating-applications-with-cicd-pipelines.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="creating-applications-with-cicd-pipelines"]
= Creating CI/CD solutions for applications using OpenShift Pipelines
= Creating CI/CD solutions for applications using {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: creating-applications-with-cicd-pipelines

Expand All @@ -27,8 +27,8 @@ This section uses the `pipelines-tutorial` example to demonstrate the preceding
== Prerequisites

* You have access to an {product-title} cluster.
* You have installed xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[OpenShift Pipelines] using the {pipelines-title} Operator listed in the OpenShift OperatorHub. After it is installed, it is applicable to the entire cluster.
* You have installed xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[OpenShift Pipelines CLI].
* You have installed xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[{pipelines-shortname}] using the {pipelines-title} Operator listed in the OpenShift OperatorHub. After it is installed, it is applicable to the entire cluster.
* You have installed xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[{pipelines-shortname} CLI].
* You have forked the front-end link:https://github.com/openshift/pipelines-vote-ui/tree/{pipelines-ver}[`pipelines-vote-ui`] and back-end link:https://github.com/openshift/pipelines-vote-api/tree/{pipelines-ver}[`pipelines-vote-api`] Git repositories using your GitHub ID, and have administrator access to these repositories.
* Optional: You have cloned the link:https://github.com/openshift/pipelines-tutorial/tree/{pipelines-ver}[`pipelines-tutorial`] Git repository.

Expand Down Expand Up @@ -80,7 +80,7 @@ include::modules/op-validating-pull-requests-using-GitHub-interceptors.adoc[leve
[id="pipeline-addtl-resources"]
== Additional resources

* To include pipelines as code along with the application source code in the same repository, see xref:../../cicd/pipelines/using-pipelines-as-code.adoc#using-pipelines-as-code[Using Pipelines as code].
* To include {pac} along with the application source code in the same repository, see xref:../../cicd/pipelines/using-pipelines-as-code.adoc#using-pipelines-as-code[Using {pac}].
* 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.
Expand Down
4 changes: 2 additions & 2 deletions cicd/pipelines/installing-pipelines.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="installing-pipelines"]
= Installing OpenShift Pipelines
= Installing {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: installing-pipelines

Expand All @@ -15,7 +15,7 @@ This guide walks cluster administrators through the process of installing the {p

* You have access to an {product-title} cluster using an account with `cluster-admin` permissions.
* You have installed `oc` CLI.
* You have installed xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[OpenShift Pipelines (`tkn`) CLI] on your local system.
* You have installed xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[{pipelines-shortname} (`tkn`) CLI] on your local system.
* Your cluster has the xref:../../post_installation_configuration/cluster-capabilities.adoc#cluster-capabilities[Marketplace capability] enabled or the Red Hat Operator catalog source configured manually.

ifdef::openshift-origin[]
Expand Down
2 changes: 1 addition & 1 deletion cicd/pipelines/op-release-notes.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ toc::[]
* Powerful CLI for interacting with pipelines.
* Integrated user experience with the *Developer* perspective of the {product-title} web console.

For an overview of {pipelines-title}, see xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding OpenShift Pipelines].
For an overview of {pipelines-title}, see xref:../../cicd/pipelines/understanding-openshift-pipelines.adoc#understanding-openshift-pipelines[Understanding {pipelines-shortname}].

include::modules/op-tkn-pipelines-compatibility-support-matrix.adoc[leveloffset=+1]

Expand Down
4 changes: 2 additions & 2 deletions cicd/pipelines/reducing-pipelines-resource-consumption.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="reducing-pipelines-resource-consumption"]
= Reducing resource consumption of OpenShift Pipelines
= Reducing resource consumption of {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: reducing-pipelines-resource-consumption

Expand All @@ -23,7 +23,7 @@ include::modules/op-mitigating-extra-pipeline-resource-consumption.adoc[leveloff
[id="additional-resources_reducing-pipelines-resource-consumption"]
== Additional resources

* xref:../../cicd/pipelines/setting-compute-resource-quota-for-openshift-pipelines.adoc#setting-compute-resource-quota-for-openshift-pipelines[Setting compute resource quota for OpenShift Pipelines]
* xref:../../cicd/pipelines/setting-compute-resource-quota-for-openshift-pipelines.adoc#setting-compute-resource-quota-for-openshift-pipelines[Setting compute resource quota for {pipelines-shortname}]
* xref:../../applications/quotas/quotas-setting-per-project.adoc#quotas-setting-per-project[Resource quotas per project]
* xref:../../nodes/clusters/nodes-cluster-limit-ranges.adoc#nodes-cluster-limit-ranges[Restricting resource consumption using limit ranges]
* link:https://kubernetes.io/docs/concepts/workloads/pods/init-containers/#resources[Resource requests and limits in Kubernetes]
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="setting-compute-resource-quota-for-openshift-pipelines"]
= Setting compute resource quota for OpenShift Pipelines
= Setting compute resource quota for {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: setting-compute-resource-quota-for-openshift-pipelines

Expand Down
8 changes: 4 additions & 4 deletions cicd/pipelines/understanding-openshift-pipelines.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="understanding-openshift-pipelines"]
= Understanding OpenShift Pipelines
= Understanding {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: understanding-openshift-pipelines

Expand All @@ -20,7 +20,7 @@ toc::[]
* You can use the {product-title} Developer console to create Tekton resources, view logs of pipeline runs, and manage pipelines in your {product-title} namespaces.

[id="op-detailed-concepts"]
== OpenShift Pipeline Concepts
== {pipelines-shortname} Concepts
This guide provides a detailed view of the various pipeline concepts.

//About tasks
Expand All @@ -44,7 +44,7 @@ include::modules/op-about-triggers.adoc[leveloffset=+2]
[role="_additional-resources"]
== Additional resources

* For information on installing pipelines, see xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines].
* For more details on creating custom CI/CD solutions, see xref:../../cicd/pipelines/creating-applications-with-cicd-pipelines.adoc#creating-applications-with-cicd-pipelines[Creating applications with CI/CD Pipelines].
* For information on installing {pipelines-shortname}, see xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing {pipelines-shortname}].
* For more details on creating custom CI/CD solutions, see xref:../../cicd/pipelines/creating-applications-with-cicd-pipelines.adoc#creating-applications-with-cicd-pipelines[Creating CI/CD solutions for applications using {pipelines-shortname}].
* 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.
2 changes: 1 addition & 1 deletion cicd/pipelines/uninstalling-pipelines.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="uninstalling-pipelines"]
= Uninstalling OpenShift Pipelines
= Uninstalling {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: uninstalling-pipelines

Expand Down
4 changes: 2 additions & 2 deletions cicd/pipelines/using-pipelines-as-code.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="using-pipelines-as-code"]
= Using Pipelines as Code
= Using {pac}
include::_attributes/common-attributes.adoc[]
:context: using-pipelines-as-code

Expand Down Expand Up @@ -131,7 +131,7 @@ include::modules/op-pipelines-as-code-command-reference.adoc[leveloffset=+1]

* link:https://github.com/openshift-pipelines/pipelines-as-code/tree/main/.tekton[An example of the `.tekton/` directory in the Pipelines as Code repository]

* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines]
* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing {pipelines-shortname}]

* xref:../../cli_reference/tkn_cli/installing-tkn.adoc#installing-tkn[Installing tkn]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ include::_attributes/common-attributes.adoc[]

toc::[]

The default configuration of OpenShift Pipelines 1.3.x and later versions does not allow you to run pods with privileged security context, if the pods result from pipeline run or task run.
The default configuration of {pipelines-shortname} 1.3.x and later versions does not allow you to run pods with privileged security context, if the pods result from pipeline run or task run.
For such pods, the default service account is `pipeline`, and the security context constraint (SCC) associated with the `pipeline` service account is `pipelines-scc`. The `pipelines-scc` SCC is similar to the `anyuid` SCC, but with minor differences as defined in the YAML file for the SCC of pipelines:

.Example `pipelines-scc.yaml` snippet
Expand All @@ -23,7 +23,7 @@ fsGroup:
...
----

In addition, the `Buildah` cluster task, shipped as part of the OpenShift Pipelines, uses `vfs` as the default storage driver.
In addition, the `Buildah` cluster task, shipped as part of the {pipelines-shortname}, uses `vfs` as the default storage driver.

include::modules/op-running-pipeline-and-task-run-pods-with-privileged-security-context.adoc[leveloffset=+1]

Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="using-tekton-chains-for-openshift-pipelines-supply-chain-security"]
= Using Tekton Chains for OpenShift Pipelines supply chain security
= Using Tekton Chains for {pipelines-shortname} supply chain security
include::_attributes/common-attributes.adoc[]
:context: using-tekton-chains-for-openshift-pipelines-supply-chain-security

Expand Down Expand Up @@ -45,5 +45,5 @@ include::modules/op-using-tekton-chains-to-sign-and-verify-image-and-provenance.
[id="additional-resources-tekton-chains"]
== Additional resources

* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines]
* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing {pipelines-shortname}]

4 changes: 2 additions & 2 deletions cicd/pipelines/using-tekton-hub-with-openshift-pipelines.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
:_content-type: ASSEMBLY
[id="using-tekton-hub-with-openshift-pipelines"]
= Using Tekton Hub with OpenShift Pipelines
= Using Tekton Hub with {pipelines-shortname}
include::_attributes/common-attributes.adoc[]
:context: using-tekton-hub-with-openshift-pipelines

Expand Down Expand Up @@ -32,6 +32,6 @@ include::modules/op-opting-out-of-tekton-hub-in-the-developer-perspective.adoc[l

* GitHub repository of link:https://github.com/tektoncd/hub[Tekton Hub]

* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing OpenShift Pipelines]
* xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[Installing {pipelines-shortname}]

* xref:../../cicd/pipelines/op-release-notes.adoc#op-release-notes[{pipelines-title} release notes]
Original file line number Diff line number Diff line change
Expand Up @@ -20,20 +20,14 @@ After you create the pipelines for your application, you can view and visually i
== Prerequisites

* You have access to an {product-title} cluster and have switched to xref:../../web_console/web-console-overview.adoc#about-developer-perspective_web-console-overview[the *Developer* perspective].
* You have the xref:../../cicd/pipelines/installing-pipelines.adoc#installing-pipelines[OpenShift Pipelines Operator installed] in your cluster.
* You have the xref:../../cicd/pipelines/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=+1]

== Creating OpenShift Pipelines along with applications

To create pipelines along with applications, use the *From Git* option in the *Add+* view of the *Developer* perspective. You can view all of your available pipelines and select the pipelines you want to use to create applications while importing your code or deploying an image.

The Tekton Hub Integration is enabled by default and you can see tasks from the Tekton Hub that are supported by your cluster. Administrators can opt out of the Tekton Hub Integration and the Tekton Hub tasks will no longer be displayed. You can also check whether a webhook URL exists for a generated pipeline. Default webhooks are added for the pipelines that are created using the *+Add* flow and the URL is visible in the side panel of the selected resources in the Topology view.

For more information, see xref:../../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-importing-codebase-from-git-to-create-application_odc-creating-applications-using-developer-perspective[Creating applications using the Developer perspective].
include::modules/op-creating-pipelines-along-with-applications.adoc[leveloffset=+1]

include::modules/odc-adding-a-GitHub-repository-containing-pipelines.adoc[leveloffset=+1]

Expand All @@ -55,4 +49,4 @@ include::modules/op-deleting-pipelines.adoc[leveloffset=+1]
[id="additional-resources-working-with-pipelines-using-the-developer-perspective"]
== Additional resources

* xref:../../cicd/pipelines/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using Tekton Hub with OpenShift Pipelines]
* xref:../../cicd/pipelines/using-tekton-hub-with-openshift-pipelines.adoc#using-tekton-hub-with-openshift-pipelines[Using Tekton Hub with {pipelines-shortname}]
Loading