/docs/install/Recent content in Installation on Pipelines as CodeHugo -- gohugo.ioen-us/docs/install/overview/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/overview/Pipelines-as-Code - Installation # Pipelines-as-Code support different installation method to Git provider platforms (i.e: GitHub, Bitbucket and so on) The preferred method to use Pipelines-as-Code is configured with a GitHub Application. Install Pipelines-as-Code infrastructure # Pipelines-as-Code support different installation method to Git provider platforms (ie: GitHub, Bitbucket and so on) The preferred method to use Pipelines-as-Code is configured with a GitHub Application. To get started with Pipelines-as-Code, you need to/docs/install/getting-started/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/getting-started/Getting started with Pipelines-as-Code # This guide will walk you through the process of getting started with Pipelines-as-Code. This will start with the installation of Pipelines-as-Code on your cluster, then the creation of a GitHub Application, the creation of a Repository CR to specify which repository you want to use with Pipelines-as-Code, and finally, we are going to create a simple Pull Request to test that configuration and see how the Pipelines-as-Code flow looks like./docs/install/operator_installation/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/operator_installation/Installation Through Operator # The easiest way to install Pipelines-as-Code on OpenShift is with the Red Hat OpenShift Pipelines Operator. On the OpenShift Pipelines Operator, the default namespace is openshift-pipelines. Note: When Pipelines-as-Code is installed through the Tekton Operator the configurations of Pipelines-as-Code is controlled by TektonConfig Custom Resource. That means Tekton Operator will revert the configurations changes done directly on pipeline-as-code configmap or OpenShiftPipelinesAsCode custom resource. The default configurations for Pipelines-as-Code in TektonConfig looks like below/docs/install/installation/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/installation/Installation # Operator Install # Follow Operator Installation to install Pipelines As Code on OpenShift. Manual Install # Prerequisite # Before installing Pipelines As Code, please verify tektoncd/pipeline is installed. You can install the latest released version using the following command kubectl apply --filename https://storage.googleapis.com/tekton-releases/pipeline/latest/release.yaml If you are not installing the most recent version, ensure that you have Tekton Pipeline installed and running at a version that is higher than v0./docs/install/settings/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/settings/Pipelines-as-Code configuration settings # There is a few things you can configure through the config map pipelines-as-code in the pipelines-as-code namespace. application-name The name of the application for example when showing the results of the pipelinerun. If you’re using the GitHub App you will need to customize the label on the github app setting as well. . Default to Pipelines-as-Code CI secret-auto-create Whether to auto create a secret with the token generated through the GitHub application to be used with private repositories./docs/install/certs/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/certs/Custom certificates # If you need to configure Pipelines-as-Code with a Git repository that requires a privately signed or custom certificate to access, then you will need to expose the certificate to Pipelines-as-Code. OpenShift # If you have installed Pipelines-as-Code through the OpenShift Pipelines operator, then you will need to add your custom certificate to the cluster via the Proxy object. The operator will expose the certificate in all OpenShift Pipelines components and workloads, including Pipelines-as-Code./docs/install/global_repositories_setting/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/global_repositories_setting/Global repository settings is a Technology Preview feature only. Technology Preview features are not currently supported and might not be functionally complete. We do not recommend using them in production. These features provide early access to an upcoming Pipelines-as-Code features, enabling you to test functionality and provide feedback during the development process. Pipelines-as-Code Global Repository Settings # Pipelines-as-Code lets you have a global repository for settings of all your local repositories./docs/install/github_apps/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/github_apps/Create a Pipelines-as-Code GitHub App # The GitHub App install is different from the other install methods since it acts as the integration point with OpenShift Pipelines and brings the Git workflow into Tekton pipelines. You only need one GitHub App for every user on the cluster usually setup by the admin. You need the webhook of the GitHub App to point to your Pipelines-as-Code Controller route or ingress endpoint which would listen to GitHub events./docs/install/github_webhook/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/github_webhook/Use Pipelines-as-Code with GitHub Webhook # If you are not able to create a GitHub application you can use Pipelines-as-Code with GitHub Webhook on your repository. Using Pipelines-as-Code through GitHub webhook does not give you access to the GitHub CheckRun API, therefore the status of the tasks will be added as a Comment on the PullRequest and not through the Checks Tab. gitops comment (ie: /retest /ok-to-test) with GitHub webhook is not supported./docs/install/gitlab/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/gitlab/Use Pipelines-as-Code with GitLab Webhook # Pipelines-As-Code supports on GitLab through a webhook. Follow the pipelines-as-code installation according to your Kubernetes cluster. Create GitLab Personal Access Token # Follow this guide to generate a personal token as the manager of the Org or the Project: https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html Note: You can create a token scoped only to the project. Since the token needs to be able to have api access to the forked repository from where the MR come from, it will fail to do it with a project scoped token./docs/install/bitbucket_cloud/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/bitbucket_cloud/Use Pipelines-as-Code with Bitbucket Cloud # Pipelines-As-Code supports on Bitbucket Cloud through a webhook. Follow the Pipelines-As-Code installation according to your Kubernetes cluster. Create Bitbucket Cloud App Password # Follow this guide to create an app password: https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/ Check these boxes to add the permissions to the token: Account: Email, Read Workspace membership: Read, Write Projects: Read, Write Issues: Read, Write Pull requests: Read, Write NOTE: If you are going to configure webhook through CLI, you must also add additional permission/docs/install/bitbucket_datacenter/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/bitbucket_datacenter/Install Pipelines-As-Code on Bitbucket Data Center # Pipelines-As-Code has a full support of Bitbucket Data Center. After following the installation: You will have to generate a personal token as the manager of the Project, follow the steps here: https://confluence.atlassian.com/bitbucketserver/personal-access-tokens-939515499.html The token will need to have the PROJECT_ADMIN and REPOSITORY_ADMIN permissions. Note that the token needs to be able to have access to the forked repository in pull requests, or it would not be able to process and access the pull request./docs/install/metrics/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/metrics/Metrics Overview # The metrics for pipelines-as-code can be accessed through the pipelines-as-code-watcher service on port 9090. pipelines-as-code supports various exporters, such as Prometheus, Google Stackdriver, and more. You can configure these exporters by referring to the observability configuration. Name Type Description pipelines_as_code_pipelinerun_count Counter Number of pipelineruns created by pipelines-as-code pipelines_as_code_pipelinerun_duration_seconds_sum Counter Number of seconds all pipelineruns have taken in pipelines-as-code pipelines_as_code_running_pipelineruns_count Gauge Number of running pipelineruns in pipelines-as-code/docs/install/kubernetes/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/kubernetes/Kubernetes # Pipelines-as-Code works on kubernetes/minikube/kind. Prerequisites # You will need to pre-install the pipeline release.yaml file on your kubernetes cluster. You will need at least a kubernetes version greater than 1.23 Install # The release YAML to install pipelines are for the released version : kubectl apply -f https://raw.githubusercontent.com/openshift-pipelines/pipelines-as-code/stable/release.k8s.yaml and for the nightly : kubectl apply -f https://raw.githubusercontent.com/openshift-pipelines/pipelines-as-code/nightly/release.k8s.yaml Verify # Ensure that the pipelines-as-code controller, webhook, and watcher have come up healthy, for example:/docs/install/second_controller/Mon, 01 Jan 0001 00:00:00 +0000/docs/install/second_controller/Multi-GitHub Application Configuration # Multi-GitHub Apps Support is a Technology Preview feature only. Technology Preview features are not currently supported and might not be functionally complete. We do not recommend using them in production. These features provide early access to an upcoming Pipelines-as-Code features, enabling you to test functionality and provide feedback during the development process. Pipelines-as-Code allows multiple GitHub applications to operate on the same cluster, enabling integration with different GitHub instances (e.